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

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

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

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

前提条件

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

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

实验性功能： Merchant Reporting 子 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。对于购物平台，请添加 account_id 以按各个子卖家 账号细分效果。如需查看由 子卖家和购物平台出资的佣金金额，请添加seller_commissions和platform_commissions。

如需检索观看次数排名前 3 的视频 2025 年 5 月 1 日至 5 月 2 日期间， 请将以下 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 语句示例，您可以使用它来获取观看次数排名前 10 的商品 2026 年 1 月 20 日至 21 日期间：

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) 汇总指标，包括在每个 类别中链接了商品的创作者和视频的数量。

使用以下 MCQL SELECT 语句获取 2026 年 9 月 1 日 总销售额排名前 10 的链接商品类别：

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
    

此查询会检索商品类别 (product_type)、链接创作者数量、链接视频数量和关键效果指标，以获取指定日期按 gross_sales 排名的前 10 个商品类别。

查看最畅销的商品

如需了解哪些商品的销售额最高，您可以查询 youtube_product_sold_stats_view。

以下是一个 MCQL SELECT 语句示例，您可以使用它来获取 总销售额排名前 10 的商品 2026 年 1 月 20 日至 21 日期间：

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 语句获取 订单数排名前 10 的广告系列：2026 年 4 月 23 日

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 语句获取 特定广告系列的观看次数排名前 10 的创作者：2026 年 4 月 23 日

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 语句获取 特定广告系列的观看次数排名前 10 的商品：2026 年 6 月 20 日

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。
• 延迟时间：查询的延迟时间取决于请求的数据量。 涵盖大型数据集的查询需要更长时间，并且可能会导致超时。