Reporting サブ API を使用すると、YouTube アフィリエイト プログラムに参加している商品の主要なパフォーマンス指標を取得できます。このガイドでは、さまざまなクリエイター、動画コンテンツ、個々の商品、商品カテゴリ、ターゲット キャンペーンに起因する、販売、コミッション、注文、視聴回数、クリック数など、YouTube 固有のアフィリエイト データをクエリする方法について説明します。
YouTube アフィリエイト プログラム API と関連データの使用は、YouTube ショッピング デベロッパー ポリシーに準拠している必要があります。
Merchant Center Query Language（MCQL）を使用すると、専用の YouTube アフィリエイト ビューから指標とディメンションを選択できます。これらのビューは、クエリ内のテーブルのように機能します。
前提条件
このガイドを使用する前に、次のことを確認してください。
- API 呼び出しの認証に使用されるアカウントには、パフォーマンス指標へのアクセス権を付与するパフォーマンスと分析情報のロールがあります。
- Google Merchant Center アカウントが YouTube アフィリエイト プログラムに参加している。
アルファ版エンドポイントをクエリする
この機能は公開アルファ版であるため、エンドポイントが異なります。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 を含めます。
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 など）ごとに指標が集計されます。
以下は、2026 年 1 月 20 日から 21 日までの閲覧数上位 10 件の商品を取得するために使用できる MCQL SELECT ステートメントの例です。
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
このクエリは、指定された日付に gross_sales でランク付けされた上位 10 個の商品カテゴリについて、商品カテゴリ（product_type）、タグ付けされたクリエイター数、タグ付けされた動画数、主要なパフォーマンス指標を取得します。
売れ筋商品を確認する
どの商品の売上が最も多いかを確認するには、youtube_product_sold_stats_view をクエリします。
2026 年 1 月 20 日から 21 日までの間の総売上高で上位 10 個の商品を取得するために使用できる MCQL SELECT ステートメントの例を次に示します。
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
このクエリは、指定されたクリエイター チャンネル、キャンペーン、日付の views の合計数で上位 10 件の動画の動画タイトル、動画フォーマット（content_type）、タグ付けされた商品タイトル、主要なパフォーマンス指標を取得します。
商品別にキャンペーンのパフォーマンスを確認する
キャンペーン内の個々の商品のパフォーマンスを把握するには、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 位の商品について、クリエイター チャンネルのタイトル、商品のタイトル、動画のタイトル、動画の URL、主要なパフォーマンス指標を取得します。
重要な考慮事項
- 日付: 常に
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。
- レイテンシ: クエリのレイテンシは、リクエストされたデータの量によって異なります。大規模なデータセットを対象とするクエリは時間がかかり、タイムアウトが発生する可能性があります。