Reporting サブ API を使用すると、YouTube アフィリエイト プログラムに参加している商品の主要なパフォーマンス指標を取得できます。このガイドでは、さまざまなクリエイター、動画コンテンツ、個々の商品、ターゲット設定されたキャンペーンに起因する、売上、コミッション、注文、視聴回数、クリック数など、YouTube 固有のアフィリエイト データをクエリする方法について説明します。
YouTube アフィリエイト プログラム API と関連データの使用は、YouTube ショッピング デベロッパー ポリシーに準拠している必要があります。
Merchant Center クエリ言語（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 が含まれます。
2025 年 5 月 1 日から 5 月 2 日までの期間の販売額上位 3 人のクリエイターを取得するために使用できる MCQL SELECT ステートメントの例を次に示します。
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 なども含まれます。
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_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。
- レイテンシ: クエリのレイテンシは、リクエストされたデータの量によって異なります。大規模なデータセットを対象とするクエリは時間がかかり、タイムアウトが発生する可能性があります。