Analyze YouTube Affiliate Performance (Alpha)

Reports API を使用すると、YouTube アフィリエイト プログラムに参加している商品の主要なパフォーマンス指標を取得できます。このガイドでは、さまざまなクリエイター、動画コンテンツ、個々の商品に帰属する、YouTube 固有のアフィリエイト データ（販売、コミッション、注文、視聴回数、クリック数など）をクエリする方法について説明します。

MCQL を使用すると、専用の YouTube アフィリエイトの「ビュー」から指標とディメンションを選択できます。これは、クエリのテーブルのように機能します。

前提条件

このガイドを使用する前に、次のことを確認してください。

アルファ版のエンドポイントをクエリする

これは公開アルファ版であるため、エンドポイントが異なります。YouTube アフィリエイトのパフォーマンス データを取得するには、v1alpha エンドポイントに POST リクエストを送信する必要があります。リクエストの例を次に示します。

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 が含まれます。

2025 年 5 月 1 日から 5 月 2 日までの売上高で上位 3 人のクリエイターを取得するために使用できる MCQL SELECT ステートメントの例を次に示します。

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 が含まれます。

2025 年 5 月 1 日から 5 月 2 日までの視聴回数上位 3 本の動画を取得するために使用できる MCQL SELECT ステートメントの例を次に示します。

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 が含まれます。

2025 年 5 月 1 日から 5 月 2 日までの売上額上位 3 つの商品を検索するために使用できる MCQL SELECT ステートメントの例を次に示します。

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、パフォーマンス指標を返します。

重要な考慮事項

  • 日付: 常に date でクエリをフィルタし、WHERE 句を使用してレポート期間を指定します。日付は YYYY-MM-DD 形式です。
  • レイテンシ: クエリのレイテンシは、リクエストされたデータの量によって異なります。クエリが大きいと、時間がかかり、タイムアウトが発生する可能性があります。