您可以使用 Reporting 子 API 检索参与 YouTube 联属营销计划的商品的关键效果指标。本指南介绍了如何查询归因于不同创作者、视频内容、单个商品、商品类别和目标广告系列的 YouTube 专属联属营销数据，例如销售额、佣金、订单、观看次数和点击次数。
您在使用 YouTube 联属营销计划 API 及相关数据时，必须遵守 YouTube 购物开发者政策。
您可以使用 Merchant Center 查询语言 (MCQL) 从专用 YouTube 联属营销视图中选择指标和维度，这些视图在查询中的作用类似于表。
前提条件
在使用本指南之前，请确保：
- 用于对 API 调用进行身份验证的账号具有效果和数据洞见角色，该角色授予对效果指标的访问权限。
- 您的 Google Merchant Center 账号参与了 YouTube 联属营销计划。
查询 Alpha 版端点
由于此功能处于公开 Alpha 版阶段，因此端点有所不同。如需检索 YouTube 联属营销效果数据，您需要向 v1alpha 端点发送 POST 请求。如需详细了解如何检索报告，请参阅 accounts.reports.search。
以下是请求示例：
HTTP
POST https://merchantapi.googleapis.com/reports/v1alpha/accounts/{ACCOUNT_ID}/reports:search
{
"query": "SELECT title, channel_id, gross_sales, net_sales, commissions, orders, clicks, views FROM youtube_creator_performance_view WHERE date >= '2025-05-01' AND date < '2025-05-02' ORDER BY gross_sales DESC LIMIT 3"
}
cURL
curl -X POST \
'https://merchantapi.googleapis.com/reports/v1alpha/accounts/{ACCOUNT_ID}/reports:search?key={YOUR_API_KEY}' \
--header 'Authorization: Bearer {YOUR_ACCESS_TOKEN}' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"query": "SELECT title, channel_id, gross_sales, net_sales, commissions, orders, clicks, views FROM youtube_creator_performance_view WHERE date >= '\''2025-05-01'\'' AND date < '\''2025-05-02'\'' ORDER BY gross_sales DESC LIMIT 3"
}' \
--compressed
按创作者查看效果
如需了解哪些 YouTube 创作者带来的互动和销售最多，您可以查询 youtube_creator_performance_view。
此视图按各个 YouTube 创作者汇总指标，并包含创作者标题和频道 ID。
以下是一个 MCQL SELECT 语句示例，可用于获取 2025 年 5 月 1 日至 5 月 2 日期间销售额排名前 3 的创作者：
SELECT title, channel_id, gross_sales, net_sales, commissions, orders, clicks, views FROM youtube_creator_performance_view WHERE date >= '2025-05-01' AND date < '2025-05-02' ORDER BY gross_sales DESC LIMIT 3
此查询会提取在指定日期范围内按总销售额指标排名的前 3 位创作者的创作者标题、频道 ID 和关键效果指标。
按内容查看效果
如需查看哪些特定 YouTube 视频的效果最好，您可以查询 youtube_content_performance_view。
此视图按各个 YouTube 视频汇总指标，并包含视频标题和 ID。对于购物平台，请添加 account_id，以便按各个子卖家账号细分效果。如需查看由子卖家和购物平台资助的佣金金额，请添加 seller_commissions 和 platform_commissions。
如需检索 2025 年 5 月 1 日至 5 月 2 日期间观看次数排名前 3 的视频，请将以下 MCQL 语句传递给 accounts.reports.search 方法：
SELECT title, video_id, account_id, gross_sales, net_sales, commissions, seller_commissions, platform_commissions, orders, clicks, views FROM youtube_content_performance_view WHERE date >= '2025-05-01' AND date < '2025-05-02' ORDER BY views DESC LIMIT 3
此查询会检索指定日期范围内按views总数排名前 3 的视频的视频标题、视频 ID、子卖家账号 ID (account_id)、总佣金 (commissions)、卖家资助的佣金 (seller_commissions)、平台资助的佣金 (platform_commissions) 以及其他关键指标。注意：您不能在 MCQL WHERE 子句中使用 account_id 来过滤结果。
查看互动度最高的带标签商品
如需了解哪些链接商品获得的互动和销售最多，您可以查询 youtube_product_tagged_stats_view。此视图按各个带标签的商品（包括其名称和优惠 ID）汇总指标。
以下是一个 MCQL SELECT 语句示例，可用于获取 2026 年 1 月 20 日至 21 日期间浏览量排名前 10 的商品：
SELECT title, offer_id, tagged_creator_count, tagged_video_count, gross_sales, net_sales, commissions, views, clicks, impressions, orders, conversion_rate FROM youtube_product_tagged_stats_view WHERE date >= '2026-01-20' AND date < '2026-01-21' ORDER BY views DESC LIMIT 10
此查询会检索在指定日期范围内按views总数排名的前 10 个商品的标题、链接了商品的视频数量和关键指标。
按链接商品类别查看效果
如需了解哪些链接商品类别带来的互动和销售最多，请查询 youtube_product_category_tagged_stats_view。
此视图按商品类目中的商品类别 (product_type) 汇总指标，包括为每个类别中的商品添加了链接的不同创作者和视频的数量。
使用以下 MCQLSELECT语句以获取按总销售额排名的前 10 个带标签的商品类别2026 年 9 月 1 日：
SELECT product_type, tagged_creator_count, tagged_video_count, gross_sales, net_sales, commissions, views, clicks, impressions, orders, conversion_rate FROM youtube_product_category_tagged_stats_view WHERE date = '2026-09-01' ORDER BY gross_sales DESC LIMIT 10
此查询会检索指定日期按 gross_sales 排名的前 10 个商品类别的商品类别 (product_type)、链接了商品的创作者数量、链接了商品的视频数量以及关键效果指标。
查看最畅销的商品
如需了解哪些产品的销量最高，您可以查询 youtube_product_sold_stats_view。
以下是一个 MCQL SELECT 语句示例，可用于获取 2026 年 1 月 20 日至 21 日期间按总销售额排名的前 10 件商品：
SELECT title, offer_id, gross_sales, net_sales, commissions, orders FROM youtube_product_sold_stats_view WHERE date >= '2026-01-20' AND date < '2026-01-21' ORDER BY gross_sales DESC LIMIT 10
此查询会检索指定日期范围内按总销售额排序的前 10 种商品的销售数据、佣金和关键指标。
查看所有广告系列的效果
如需了解联属营销广告系列的整体效果，请查询 youtube_campaigns_stats_view。
此视图汇总了所有广告系列的指标，包括广告系列名称、开始和结束日期、活跃创作者数量以及销售和互动指标。
使用以下 MCQL SELECT 语句，获取 2026 年 4 月 23 日按订单量排名前 10 的广告系列：
SELECT campaign_id, campaign_name, start_date, end_date, active_creators, gross_sales, net_sales, commissions, views, clicks, impressions, orders, conversion_rate FROM youtube_campaigns_stats_view WHERE date = '2026-04-23' ORDER BY orders DESC LIMIT 10
此查询会检索在指定日期按orders总数排名前 10 的广告系列的广告系列 ID、广告系列名称、日期范围、活跃创作者数量和关键效果指标。
按创作者查看广告系列效果
如需分析参与特定广告系列的各个创作者的表现，请查询 youtube_individual_campaign_stats_view。
此视图会汇总广告系列中每个创作者的指标，包括频道标题、视频数量和链接的商品标题。
使用以下 MCQL SELECT 语句，获取 2026 年 4 月 23 日特定广告系列中观看次数排名前 10 的创作者：
SELECT channel_title, video_count, product_titles, gross_sales, net_sales, commissions, views, clicks, impressions, orders, conversion_rate FROM youtube_individual_campaign_stats_view WHERE date = '2026-04-23' AND campaign_id = 'YOUR_CAMPAIGN_ID' ORDER BY views DESC LIMIT 10
此查询会检索在指定广告系列和日期范围内，按总观看次数排名前 10 的创作者的频道标题、视频数量、商品标题和关键效果指标。
按视频查看广告系列效果
如需查看特定创作者视频在广告系列中的效果，请查询 youtube_campaign_videos_stats_view。
此视图提供广告系列中创作者的视频级效果指标，包括视频标题、视频格式和链接的商品。
使用以下 MCQL SELECT 语句，获取特定创作者和广告系列在 2026 年 5 月 20 日观看次数排名前 10 的视频：
SELECT video_title, content_type, product_titles, gross_sales, net_sales, commissions, views, clicks, impressions, orders, conversion_rate FROM youtube_campaign_videos_stats_view WHERE date = '2026-05-20' AND campaign_id = 'YOUR_CAMPAIGN_ID' AND channel_id = 'YOUR_CHANNEL_ID' ORDER BY views DESC LIMIT 10
此查询会检索指定创作者频道、广告系列和日期范围内，按views总数排名前 10 的视频的视频标题、视频格式 (content_type)、链接的商品标题和关键效果指标。
按产品查看广告系列效果
如需了解单个产品在广告系列中的效果，请查询 youtube_campaign_products_stats_view。
此视图提供广告系列中的商品级效果指标，包括商品名、关联的视频详情和销售指标。
使用以下 MCQL SELECT 语句，获取 2026 年 6 月 20 日特定广告系列中浏览量排名前 10 的商品：
SELECT channel_title, product_title, video_title, video_url, gross_sales, net_sales, commissions, views, clicks, impressions, orders, conversion_rate FROM youtube_campaign_products_stats_view WHERE date = '2026-06-20' AND campaign_id = 'YOUR_CAMPAIGN_ID' ORDER BY views DESC LIMIT 10
此查询会检索指定广告系列和日期内按views总数排名前 10 的商品的创作者频道标题、商品标题、视频标题、视频网址和关键效果指标。
重要注意事项
- 日期：始终使用
WHERE子句按date过滤查询，以指定报告期。日期采用YYYY-MM-DD格式。 - 必需的过滤条件：某些广告系列视图需要在
WHERE子句中添加额外的过滤条件：youtube_individual_campaign_stats_view：campaign_id和date。youtube_campaign_videos_stats_view：campaign_id、channel_id和date。youtube_campaign_products_stats_view：campaign_id和date。
- 延迟时间：查询的延迟时间取决于请求的数据量。涵盖大型数据集的查询需要更长时间，并且可能会导致超时。