您可以使用 Reporting 子 API，擷取參與 YouTube 聯盟計畫的產品主要成效指標。本指南說明如何查詢 YouTube 專屬聯盟資料，例如歸因於不同創作者、影片內容、個別產品、產品類別和指定廣告活動的銷售量、佣金、訂單、觀看次數和點擊次數。
使用 YouTube 聯盟計畫 API 和相關資料時，必須遵守《YouTube Shopping 開發人員政策》。
您可以使用 Merchant Center 查詢語言 (MCQL)，從專屬的 YouTube Affiliate 檢視畫面中選取指標和維度，這些檢視畫面的功能就像查詢中的資料表。
必要條件
使用本指南前，請確認下列事項：
- 用於驗證 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
這項查詢會擷取創作者名稱、頻道 ID，以及在指定日期範圍內，總銷售額指標排名前 3 的創作者主要成效指標。
依內容查看成效
如要查看哪些 YouTube 影片成效最佳，可以查詢 youtube_content_performance_view。這個檢視畫面會匯總各個 YouTube 影片的指標，並包含影片標題和 ID。如果是市集，請加入 account_id，按個別子賣家帳戶細分成效。如要查看子賣家和市集平台支付的佣金金額，請加入 seller_commissions 和 platform_commissions。
如要擷取 2025 年 5 月 1 日至 5 月 2 日觀看次數前 3 名的影片，請將下列 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 陳述式範例，可用來取得 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_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
這項查詢會擷取指定日期排名前 10 的產品類別 (依 gross_sales 排序) 的產品類別 (product_type)、標記的創作者人數、標記的影片數量，以及主要成效指標。
查看最暢銷的產品
如要瞭解哪些產品的銷售量最高，可以查詢 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
這項查詢會擷取廣告活動 ID、廣告活動名稱、日期範圍、活躍創作者人數，以及指定日期orders總數前 10 名廣告活動的主要成效指標。
依創作者查看廣告活動成效
如要分析參與特定廣告活動的個別創作者成效，請查詢 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 的產品主要成效指標。
重要注意事項
- 日期：請一律使用
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。
- 延遲：查詢延遲時間取決於要求的資料量。查詢大型資料集需要較長時間，可能會導致逾時。