YouTube 基準

廣告主和代理商可透過BenchmarksService，比較自家 YouTube 廣告與產業基準的成效。這項服務可評估廣告活動相對於產業垂直領域或特定產品和服務類別中所有廣告主的成效。

主要功能

BenchmarksService 的功能包括：

  • 比較成效：評估客戶的平均費率指標 (例如千次曝光出價、單次收視出價、點閱率和可視度)，並與匯總的業界平均值比較。
  • 分析市占率：透過廣告曝光占有率 (相對曝光次數) 和支出占有率，瞭解顧客的相對市場曝光度。
  • 評估競爭地位：使用百分位數指標評估客戶的競爭地位，將主要維度的效能分類為競爭層級 (例如「市場領導者」或「競爭對手」)。
  • 按時間區隔：依每週、每月或每季的時間精細程度，將基準指標分組。
  • 探索支援的基準維度：查詢可用的日期範圍、地理位置、廣告產品和基準來源 (產業垂直領域或產品和服務類別)。

探索方法

產生基準指標前，請先使用探索方法，擷取要求的有效參數和範圍條件。

列出可預約的日期

ListBenchmarksAvailableDates 方法會傳回 ListBenchmarksAvailableDatesResponse 中支援基準資料的歷史日期範圍。

回應會提供兩個不同的日期範圍：

  • supported_dates：支援基準指標的整體日期範圍 (含)。基準要求可查詢此範圍內的日期。
  • supported_dates_for_all_metrics：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：產品的專屬 ID 字串，用於建構 ProductFilter。
  • marketing_objective：相關聯的行銷目標 (BenchmarksMarketingObjective)：
    • AWARENESS：專為提高品牌或產品認知度而設計的廣告活動。
    • CONSIDERATION：這類廣告活動旨在鼓勵潛在顧客考慮品牌或產品。
    • ACTION：專為促成特定轉換動作而設計的廣告活動。

列出基準來源

ListBenchmarksSources 方法會擷取可用的基準來源。使用 BenchmarksSourceType 指定要擷取的來源類型：

  • INDUSTRY_VERTICAL：產業區隔的分類 (例如「科技」或「金融」)。
  • CATEGORY：產品和服務類別 (例如「/Apparel/Clothing」)。與所有廣告主比較時，可使用類別做為篩選條件，縮小基準化範圍。

回應會傳回 BenchmarksSourceMetadata 物件清單，其中包含下列任一項目：

  • IndustryVerticalInfo：包含 industry_vertical_name、industry_vertical_id 和 parent_industry_vertical_id (如適用)。
  • CategoryInfo：包含 category_name、category_id 和 category_path (完整類別階層)。

產生基準指標

撥打 GenerateBenchmarksMetrics，比較客戶的 YouTube 廣告指標與業界基準。

要求參數

GenerateBenchmarksMetricsRequest 範圍 分析。您至少必須指定用戶端 customer_id、地理區域 location、benchmarks_source (例如特定產業別或以 category_filter 為範圍的所有廣告主)，以及 product_filter。您可以選擇性提供 date_range、使用 breakdown_definition 分組指標、指定 currency_code，或透過 supplemental_data 要求其他功能，例如 PERCENTILE_DATA。

如需完整的參數定義和規定，請參閱GenerateBenchmarksMetricsRequest參考文件。

日期細目

您可以設定 breakdown_definition.date_breakdown，依 BenchmarksTimeGranularity 分組指標：

  • WEEK：依每週匯總指標。date_range 必須從星期日開始，並於星期六結束 (請注意，這與 ISO 8601 不同)。
  • MONTH：按月匯總指標。date_range必須從當月第一天開始，並於當月最後一天結束。
  • QUARTER：依日曆季匯總指標。date_range必須在當季的第一天開始，並在當季的最後一天結束。

回覆指標

GenerateBenchmarksMetricsResponse 會傳回：

如需完整的欄位規格，請參閱GenerateBenchmarksMetricsResponse參考文件。

百分位數指標

百分位數指標代表客戶在範圍內分析中，與其他廣告主相比的競爭地位。

必要條件

如要擷取百分位數指標，要求必須符合下列規定：

  1. 基準來源：benchmarks_source 必須選取 all_advertisers = true。
  2. 類別篩選器：必須提供 category_filter，其中包含一或多個從 ListBenchmarksSources 擷取的有效 category_ids。
  3. 補充資料：你必須在 supplemental_data 欄位中新增 GenerateBenchmarksMetricsRequestPERCENTILE_DATA。

百分位數等級

系統會將客戶的成效歸類為其中一個 BenchmarksCustomerPercentileTier 列舉值 (從較低層級的 DEVELOPING 到頂尖廣告主的 MARKET_LEADER)。如要瞭解各層級的說明和百分位數界線，請參閱 BenchmarksCustomerPercentileTier 參考文件。

要求範例

以下範例說明如何使用 REST JSON 要求酬載，為使用者產生百分位數層級的基準指標，比較客戶的 YouTube 廣告成效與在「/Apparel/Clothing」類別中放送廣告的其他廣告主：

{
  "customer_id": "1234567890",
  "location": {
    "geo_target_constant": "geoTargetConstants/2840"
  },
  "benchmarks_source": {
    "all_advertisers": true
  },
  "category_filter": {
    "category_ids": ["10176"]
  },
  "product_filter": {
    "marketing_objective_list": {
      "marketing_objectives": ["AWARENESS", "CONSIDERATION"]
    }
  },
  "supplemental_data": [
    "PERCENTILE_DATA"
  ]
}

回應 (包含要求的額外百分位數資料)：

{
  "customer_metrics": {
    "average_rate_metrics": {
      "average_cpm": 5.42,
      "click_through_rate": 0.0185
    },
    "share_metrics": {
      "share_of_voice": 0.0345,
      "share_of_spend": 0.0410
    },
    "aggregate_metrics": {
      "cost": 15200.0,
      "impressions": 2800000.0,
      "clicks": 51800.0
    },
    "percentile_metrics": {
      "cost_percentile_tier": "STRONG_COMPETITOR",
      "impressions_percentile_tier": "STRONG_COMPETITOR",
      "clicks_percentile_tier": "MARKET_LEADER",
      "video_trueview_views_percentile_tier": "COMPETITOR",
      "viewable_impressions_percentile_tier": "STRONG_COMPETITOR",
      "interactions_percentile_tier": "MARKET_LEADER",
      "engagements_percentile_tier": "COMPETITOR"
    }
  },
  "average_benchmarks_metrics": {
    "average_rate_metrics": {
      "average_cpm": 6.15,
      "click_through_rate": 0.0142
    }
  }
}

處理錯誤

呼叫 BenchmarksService 時，您可能會在 BenchmarksError 中遇到基準查詢專屬的錯誤：

  • MAX_QUERY_COMPLEXITY_EXCEEDED：要求的輸入組合過於複雜，無法處理。如要降低查詢複雜度，請採取下列做法：
    • 選取更具體或精細的基準來源或類別篩選器。
    • 縮短要求的 date_range。
    • 減少 product_filter 中的產品數量。
  • NO_METRICS_FOUND：系統找不到所要求輸入組合的指標 (例如，特定地點和日期範圍內沒有廣告主放送廣告活動的利基類別)。請嘗試調整類別、位置、日期範圍或產品。

如需一般 API 錯誤處理和最佳做法，請參閱錯誤處理指南。

上一頁
YouTube 創作者洞察