你可以使用 Reports API，擷取參與 YouTube 聯盟計畫的產品主要成效指標。本指南說明如何查詢 YouTube 專屬的聯盟資料，例如歸因於不同創作者、影片內容和個別產品的銷售額、佣金、訂單、觀看次數和點擊次數。
您可以使用 MCQL，從專屬的 YouTube 聯盟「檢視」中選取指標和維度，這些檢視在查詢中會以表格形式運作。
必要條件
使用本指南前，請確認下列事項：
- 用於驗證 API 呼叫的帳戶具有「成效與洞察」角色，可存取成效指標。
- 你的 Google Merchant Center 帳戶已加入 YouTube 聯盟計畫。
查詢 Alpha 端點
請注意，由於這是公開 Alpha 版，端點有所不同。如要擷取 YouTube 聯盟計畫成效資料，請將 POST 要求傳送至 v1alpha 端點。以下是範例要求：
HTTP
POST https://merchantapi.googleapis.com/reports/v1alpha/accounts/{ACCOUNT_ID}/reports:search
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' \
--compressed
依創作者查看成效
如要瞭解哪些 YouTube 創作者帶來最多參與度和銷售量，
可以查詢 youtube_creator_performance_view。
這個檢視畫面會依個別 YouTube 創作者匯總指標，並包含創作者名稱和頻道 ID。
以下是 MCQL SELECT 陳述式範例，可用於取得 2025 年 5 月 1 日至 5 月 2 日期間，銷售業績前 3 名的創作者。
SELECT
title,
channel_id,
sales,
commissions,
orders,
clicks,
views
FROM youtube_creator_performance_view
WHERE date BETWEEN '2025-05-01' AND '2025-05-02'
ORDER BY sales DESC LIMIT 3
這項查詢會擷取指定日期範圍內，依銷售指標排名前 3 名的創作者名稱、頻道 ID 和重要成效指標。
依內容查看成效
如要查看哪些特定 YouTube 影片的成效最佳，可以查詢 youtube_content_performance_view。
這個檢視畫面會匯總個別 YouTube 影片的指標，並包含影片標題和 ID。
以下是 MCQL SELECT 陳述式範例，可用於取得 2025 年 5 月 1 日至 5 月 2 日期間觀看次數前 3 名的影片。
SELECT
title,
video_id,
views,
clicks,
sales
FROM youtube_content_performance_view
WHERE date BETWEEN '2025-05-01' AND '2025-05-02'
ORDER BY views DESC LIMIT 3
這項查詢會擷取指定日期範圍內，views總數排名前 3 的影片標題、影片 ID 和重要指標。
依產品查看成效
如要分析 YouTube 聯盟計畫中個別產品的成效，可以查詢 youtube_product_performance_view。這個檢視畫面會依產品匯總指標，並包含產品名稱和商品 ID。
以下是 MCQL SELECT 陳述式範例，可用於找出 2025 年 5 月 1 日至 5 月 2 日期間銷售額前 3 名的產品：
SELECT
title,
offer_id,
sales,
commissions,
orders,
clicks
FROM youtube_product_performance_view
WHERE date BETWEEN '2025-05-01' AND '2025-05-02'
ORDER BY sales DESC LIMIT 3
這項查詢會傳回指定期間內，依 sales 指標排序的前 3 項產品的產品名稱、方案 ID 和成效指標。
重點須知
- 日期：請務必使用
dateWHERE子句篩選查詢，指定報表期間。日期格式為YYYY-MM-DD。 - 延遲時間：查詢的延遲時間取決於要求的資料量。大型查詢需要較長時間，且可能會導致逾時。