你可以使用 Reporting 子 API，擷取參與 YouTube 聯盟計畫的產品主要成效指標。本指南說明如何查詢 YouTube 專屬聯盟資料，例如歸因於不同創作者、影片內容、個別產品和指定廣告活動的銷售額、佣金、訂單、觀看次數和點擊次數。
使用 YouTube 聯盟計畫 API 和相關資料時，必須遵守 YouTube Shopping 開發人員政策。
你可以使用 Merchant Center 查詢語言 (MCQL)，從專屬的 YouTube 聯盟檢視畫面中選取指標和維度，這些檢視畫面在查詢中會以表格形式呈現。
必要條件
使用本指南前，請先確認下列事項：
- 用於驗證 API 呼叫的帳戶具有「成效和洞察資料」角色，可存取成效指標。
- 你的 Google Merchant Center 帳戶已加入 YouTube 聯盟計畫。
查詢 Alpha 端點
由於這項功能為公開 Alpha 版，端點有所不同。如要擷取 YouTube 聯盟計畫成效資料，請將 POST 要求傳送至 v1alpha 端點。如要進一步瞭解如何擷取報表，請參閱 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
這項查詢會擷取影片標題、影片格式 (content_type)、標記的產品標題，以及前 10 部影片的關鍵成效指標，這些影片是根據指定創作者頻道、廣告活動和日期的總 views 數排序。
按產品查看廣告活動成效
如要瞭解廣告活動中個別產品的成效，請查詢 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 的產品主要成效指標。
重要注意事項
- 日期：請務必使用
date透過WHERE子句篩選查詢，指定報表統計期。日期格式為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。
- 延遲時間：查詢的延遲時間取決於要求的資料量。涵蓋大型資料集的查詢需要較長時間，且可能會導致逾時。