YouTube のベンチマーク

BenchmarksService を使用すると、広告主と代理店は YouTube 広告のパフォーマンスを業種別ベンチマークと比較できます。このサービスを使用すると、特定の業種や、特定の商品やサービス カテゴリのすべての広告主と比較して、キャンペーンのパフォーマンスを評価できます。

主な機能

BenchmarksService を使用すると、次のことができます。

  • パフォーマンスを比較する: 顧客の平均レート指標（CPM、CPV、CTR、視認性など）を、集計された業界平均と比較して評価します。
  • マーケット シェアを分析する: 広告シェア（相対的なインプレッション数）と費用シェアを通じて、お客様の相対的な市場プレゼンスを把握します。
  • 競合状況を評価する: 主要なディメンションのパフォーマンスを競合ティア（マーケット リーダーや競合他社など）に分類するパーセンタイル指標を使用して、お客様の競合状況を測定します。
  • 期間で分割: ベンチマーク指標を週、月、四半期の時間粒度でグループ化します。
  • サポートされているベンチマーク ディメンションを検出する: 利用可能な期間、地理的位置、広告商品、ベンチマーク ソース（業種、商品、サービス カテゴリ）をクエリします。

検出方法

ベンチマーク指標を生成する前に、検出メソッドを使用して、リクエストの有効なパラメータとスコープ条件を取得します。

利用可能な日付を一覧表示する

ListBenchmarksAvailableDates メソッドは、ListBenchmarksAvailableDatesResponse でベンチマーク データをサポートする過去の期間を返します。

レスポンスには、次の 2 つの異なる期間が含まれます。

  • supported_dates: ベンチマーク指標がサポートされている全体的な期間（この値を含む）。ベンチマーク リクエストでは、この範囲内の日付をクエリできます。
  • supported_dates_for_all_metrics（v25 以降）: ベンチマーク指標の完全なセットをサポートする supported_dates のサブセット。特定の指標（具体的には、顧客シェア指標（share_of_voice と share_of_spend）とベンチマーク ソースの平均レート指標）は、データの可用性が限られているため、この期間内でのみ使用できます。リクエストされた date_range が supported_dates_for_all_metrics 内に完全に収まらない場合、これらの指標はレスポンスから除外されます。

ロケーションの一覧表示

ListBenchmarksLocations メソッドは、ベンチマーク データをサポートする地理的位置（国など）のリストを返します。

レスポンスの各 BenchmarksLocation には、次のものが含まれます。

  • location_name: 英語の一意のロケーション名（例: "United States"）。
  • location_type: Google Ads API の target_type に対応する場所のタイプ（例: "Country"）。
  • location_info: 地域ターゲット定数（geo_target_constant: "geoTargetConstants/2840" など）を含む LocationInfo オブジェクト。

商品を一覧表示する

ListBenchmarksProducts メソッドは、ベンチマークに使用できるサービスとマーケティングの目標のリストを返します。

各 BenchmarksProductMetadata エントリには次のものが含まれます。

  • product_name: ユーザー フレンドリーな商品名。
  • product_code: ProductFilter の作成時に使用される、商品の固有識別子文字列。
  • marketing_objective: 関連付けられているマーケティング目標（BenchmarksMarketingObjective）:
    • AWARENESS: ブランドや商品の認知度を高めることを目的としたキャンペーン。
    • CONSIDERATION: 見込み顧客にブランドや商品を検討してもらうことを目的としたキャンペーン。
    • ACTION: 特定のコンバージョン アクションを促進するように設計されたキャンペーン。

ベンチマーク ソースを一覧表示する

ListBenchmarksSources メソッドは、利用可能なベンチマーク ソースを取得します。BenchmarksSourceType を使用して、取得するソースタイプを指定します。

  • INDUSTRY_VERTICAL: 業界セグメントの分類（"Technology"、"Finance" など）。
  • CATEGORY（v25 以降）: 商品とサービスのカテゴリ（例: "/Apparel/Clothing"）。カテゴリは、すべての広告主と比較する際に、ベンチマークの範囲を絞り込むフィルタとして使用できます。

レスポンスは、次のいずれかを含む BenchmarksSourceMetadata オブジェクトのリストを返します。

  • IndustryVerticalInfo: industry_vertical_name、industry_vertical_id、parent_industry_vertical_id（該当する場合）が含まれます。
  • CategoryInfo（v25 以降）: category_name、category_id、category_path（完全なカテゴリ階層）が含まれます。

ベンチマーク指標を生成する

GenerateBenchmarksMetrics を呼び出して、お客様の YouTube 広告の指標を業種別ベンチマークと比較します。

リクエスト パラメータ

GenerateBenchmarksMetricsRequest は分析のスコープを設定します。少なくとも、クライアント customer_id、地理的な location（LocationInfo）、benchmarks_source（industry_vertical_id、または v25 以降では category_filter でスコープ設定された all_advertisers）、product_filter を指定する必要があります。必要に応じて、次の操作を行うこともできます。

  • date_range を指定します（省略すると、データが利用可能な最新の四半期のデータが返されます）。
  • breakdown_definition を使用して指標をグループ化します。
  • 3 文字の ISO 4217 currency_code を指定します（省略した場合、CPM や費用などの金額指標はデフォルトで USD になります）。
  • 計画対象のお客様のユーザー定義の customer_benchmarks_group 名を指定します。
  • supplemental_data を介して PERCENTILE_DATA などの追加機能をリクエストする（v25 以降）。

パラメータの定義と要件の詳細については、GenerateBenchmarksMetricsRequest のリファレンス ドキュメントをご覧ください。

日付の内訳

BenchmarksTimeGranularity を使用して breakdown_definition.date_breakdown を設定することで、指標をグループ化できます。date_breakdown が設定されている場合、GenerateBenchmarksMetricsRequest の date_range は必須であり、選択した粒度の境界に合わせる必要があります。

  • WEEK: 指標を週ごとに集計します。date_range は日曜日に始まり、土曜日に終わる必要があります（これは ISO 8601 とは異なることに注意してください）。
  • MONTH: 指標を月ごとに集計します。date_range は、毎月 1 日に開始し、毎月末日に終了する必要があります。
  • QUARTER: 指標を暦四半期ごとに集計します。date_range は、四半期の初日に開始し、四半期の最終日に終了する必要があります。

レスポンス指標

GenerateBenchmarksMetricsResponse は以下を返します。

  • customer_metrics（v25 以降では CustomerMetrics 型、v24 以前では average_rate_metrics のみを含む Metrics 型）: 顧客の YouTube 広告のパフォーマンスを表す指標。以下が含まれます。
    • average_rate_metrics: 顧客の平均レート指標。
    • share_metrics（v25 以降）: 相対的な市場プレゼンス指標（share_of_voice と share_of_spend）。benchmarks_source が all_advertisers = true を選択し（category_filter が設定されている場合）、date_range が supported_dates_for_all_metrics 内にある場合にのみ入力されます。
    • aggregate_metrics（v25 以降）: 顧客の集計合計（cost、impressions、clicks、video_trueview_views など）。
    • percentile_metrics（v25 以降）: 主要なディメンションにおける競合状況のパーセンタイル ティア。
  • average_benchmarks_metrics: 選択したベンチマーク ソース全体の集計レート指標（RateMetrics）。
  • breakdown_metrics: breakdown_definition で定義された内訳でセグメント化された指標のリスト。

フィールドの完全な仕様については、GenerateBenchmarksMetricsResponse リファレンス ドキュメントをご覧ください。

パーセンタイル指標

パーセンタイル指標は、分析対象の他の広告主と比較した、お客様の競争力をパーセンタイル階層として表します。

前提条件

パーセンタイル指標を取得するには、リクエストが次の要件を満たしている必要があります。

  1. ベンチマーク ソース: benchmarks_source は all_advertisers = true を選択する必要があります。
  2. カテゴリ フィルタ: category_filter を指定する必要があります。これには、ListBenchmarksSources から取得した 1 つ以上の有効な category_ids が含まれます。
  3. 補助データ: GenerateBenchmarksMetricsRequest の supplemental_data フィールドに PERCENTILE_DATA を追加する必要があります。

パーセンタイル ティア

お客様のパフォーマンスは、次の BenchmarksCustomerPercentileTier 列挙値のいずれかに分類されます。

  • DEVELOPING: 10 パーセンタイル未満（[0%, 10%)）。
  • ENTRY_LEVEL: 10 ～ 25 パーセンタイル（[10%, 25%)）。
  • EMERGING_PLAYER: 25 ～ 50 パーセンタイル（[25%, 50%)）。
  • COMPETITOR: 50 ～ 75 パーセンタイル（[50%, 75%)）。
  • STRONG_COMPETITOR: 75 ～ 90 パーセンタイル（[75%, 90%)）。
  • MARKET_LEADER: 90 パーセンタイル（[90%, 100%]）以上。

リクエスト例

次の例は、/Apparel/Clothing カテゴリで広告を掲載している他の広告主と顧客の YouTube 広告のパフォーマンスを比較するユーザーの、パーセンタイル ティアを含むベンチマーク指標を生成する REST JSON リクエスト ペイロードを示しています。

{
  "customerId": "1234567890",
  "location": {
    "geoTargetConstant": "geoTargetConstants/2840"
  },
  "benchmarksSource": {
    "allAdvertisers": true
  },
  "categoryFilter": {
    "categoryIds": ["10176"]
  },
  "productFilter": {
    "marketingObjectiveList": {
      "marketingObjectives": ["AWARENESS", "CONSIDERATION"]
    }
  },
  "supplementalData": [
    "PERCENTILE_DATA"
  ]
}

リクエストされた追加のパーセンタイル データを含むレスポンス:

{
  "customerMetrics": {
    "averageRateMetrics": {
      "averageCpm": 5.42,
      "clickThroughRate": 0.0185
    },
    "shareMetrics": {
      "shareOfVoice": 0.0345,
      "shareOfSpend": 0.0410
    },
    "aggregateMetrics": {
      "cost": 15200.0,
      "impressions": 2800000.0,
      "clicks": 51800.0
    },
    "percentileMetrics": {
      "costPercentileTier": "STRONG_COMPETITOR",
      "impressionsPercentileTier": "STRONG_COMPETITOR",
      "clicksPercentileTier": "MARKET_LEADER",
      "videoTrueviewViewsPercentileTier": "COMPETITOR",
      "viewableImpressionsPercentileTier": "STRONG_COMPETITOR",
      "interactionsPercentileTier": "MARKET_LEADER",
      "engagementsPercentileTier": "COMPETITOR"
    }
  },
  "averageBenchmarksMetrics": {
    "averageRateMetrics": {
      "averageCpm": 6.15,
      "clickThroughRate": 0.0142
    }
  }
}

エラー処理

BenchmarksService を呼び出すと、BenchmarksError のベンチマーク クエリに固有のエラーが発生することがあります。

  • MAX_QUERY_COMPLEXITY_EXCEEDED: リクエストされた入力の組み合わせが複雑すぎて処理できません。クエリの複雑さを軽減するには、次の操作を行います。
    • より具体的または詳細なベンチマーク ソースまたはカテゴリ フィルタを選択します。
    • リクエストされた date_range を短くします。
    • product_filter の商品の数を減らします。
  • NO_METRICS_FOUND（v25 以降）: リクエストされた入力の組み合わせ（たとえば、広告主がキャンペーンを実施していない特定の地域と期間のニッチなカテゴリ）に指標が見つかりませんでした。カテゴリ、地域、期間、商品を調整してみてください。

一般的な API エラー処理とベスト プラクティスについては、エラー処理ガイドをご覧ください。

Google Issue Tracker

Google Issue Tracker を使用して、サポートに関する質問、バグの報告、機能リクエストの送信を行います。Google は、Issue Tracker でリクエストを直接追跡し、優先順位を付けて、更新情報を投稿します。詳細については、Google Issue Tracker で問題を作成するをご覧ください。

次のいずれかの Issue Tracker テンプレートを使用して問題を作成します。

Google がリクエストを再現して優先順位を付けられるように、テンプレートのすべてのフィールドに詳細な情報を入力します。不完全なレポートはクローズされ、不足している詳細情報を記載した新しい問題を送信するよう求められることがあります。

前へ
YouTube クリエイター インサイト