Analyze Youtube Affiliate Performance (Alpha)

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

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

前提条件

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

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

查询 Alpha 版端点

请注意，由于此功能处于公开 Alpha 版阶段，因此端点有所不同。如需检索 YouTube 联盟营销效果数据，您需要向 v1alpha 端点发送 POST 请求。以下是请求示例：

POST https://merchantapi.googleapis.com/reports/v1alpha/accounts/{ACCOUNT_ID}/reports:search

  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' \
  --compressed

按创作者查看效果

如需了解哪些 YouTube 创作者带来了最多的互动和销售额， 您可以查询 youtube_creator_performance_view。 此视图按各个 YouTube 创作者汇总指标，并包含创作者标题和频道 ID。

以下是一个 MCQL SELECT 语句示例，您可以使用它来获取销售额排名前 3 的创作者：2025 年 5 月 1 日至 5 月 2 日期间

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。

如需检索观看次数排名前 3 的视频 2025 年 5 月 1 日至 5 月 2 日期间， 请将以下 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 语句示例，您可以使用它来获取观看次数排名前 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_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 种商品的销售数据、佣金和关键指标。

重要注意事项

• 日期：请务必使用 WHERE 子句按 date 过滤查询，以 指定报告期。日期采用 YYYY-MM-DD 格式。
• 延迟时间：查询的延迟时间取决于请求的数据量。 涵盖大型数据集的查询需要更长时间，并且可能会导致超时。