分析 YouTube 联属营销效果（Alpha 版）

您可以使用 Reporting 子 API 检索参与 YouTube 联属营销计划的商品的关键效果指标。本指南介绍了如何查询 YouTube 特定的联属营销数据，例如归因于不同创作者、视频内容、单个产品和目标广告系列的销售额、佣金、订单、观看次数和点击次数。

您对 YouTube 联属营销计划 API 和相关数据的使用必须遵守 YouTube 购物开发者政策。

您可以使用 Merchant Center 查询语言 (MCQL) 从专用 YouTube 联属营销视图中选择指标和维度，这些视图在查询中充当表格。

前提条件

在使用本指南之前，请确保：

• 用于对 API 调用进行身份验证的账号具有效果和数据分析角色，该角色授予对效果指标的访问权限。
• 您的 Google Merchant Center 账号已加入 YouTube 联属营销计划。

实验性： 商家报告子 API 中的 YouTube 联属营销绩效视图处于 Alpha 版发布阶段。功能可能会发生变化，也可能会更新或终止。

查询 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。

如需检索 2025 年 5 月 1 日至 5 月 2 日期间观看次数最多的前 3 个视频，请将以下 MCQL 语句传递给 accounts.reports.search 方法：

SELECT
  title,
  video_id,
  gross_sales,
  net_sales,
  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 和关键指标。

查看互动度最高的链接商品

如需了解哪些添加了标记的商品获得的互动和销售最多，您可以查询 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_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。
• 延迟时间：查询的延迟时间取决于所请求的数据量。涵盖大型数据集的查询需要更长时间，并且可能会导致超时。