YouTube 업계 기준치

BenchmarksService를 사용하면 광고주와 대행사가 YouTube 광고 실적을 업계 벤치마크와 비교할 수 있습니다. 이 서비스를 사용하면 업종 카테고리 또는 특정 제품 및 서비스 카테고리의 모든 광고주와 비교하여 캠페인 실적을 평가할 수 있습니다.

주요 기능

BenchmarksService를 사용하면 다음 작업을 할 수 있습니다.

  • 실적 비교: 고객의 평균 요율 측정항목 (예: CPM, CPV, CTR, 조회가능성)을 집계된 업계 평균과 비교하여 평가합니다.
  • 시장 점유율 분석: 광고 점유율 (상대적 노출수) 및 지출 점유율을 통해 고객의 상대적 시장 점유율을 파악합니다.
  • 경쟁력 평가: 주요 측정기준 전반의 실적을 경쟁 등급 (예: 시장 선두업체 또는 경쟁업체)으로 분류하는 백분위수 측정항목을 사용하여 고객의 경쟁력을 측정합니다.
  • 시간별 분류: 주별, 월별 또는 분기별 시간 단위로 벤치마크 측정항목을 그룹화합니다.
  • 지원되는 업계 기준치 측정기준 검색: 사용 가능한 기간, 지리적 위치, 광고 제품, 업계 기준치 소스 (업종 카테고리 또는 제품 및 서비스 카테고리)를 쿼리합니다.

탐색 방법

벤치마크 측정항목을 생성하기 전에 탐색 메서드를 사용하여 요청에 유효한 매개변수와 범위 지정 기준을 가져옵니다.

사용 가능한 날짜 나열

ListBenchmarksAvailableDates 메서드는 ListBenchmarksAvailableDatesResponse에서 벤치마크 데이터를 지원하는 이전 기간을 반환합니다.

응답은 두 가지 기간을 제공합니다.

  • 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는 해당 월의 첫 번째 날에 시작하고 해당 월의 마지막 날에 종료되어야 합니다.
  • 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에서 가져온 유효한 category_ids가 하나 이상 포함되어야 합니다.
  3. 보조 데이터: PERCENTILE_DATA를 GenerateBenchmarksMetricsRequest의 supplemental_data 필드에 추가해야 합니다.

백분위수 등급

고객의 실적은 다음 BenchmarksCustomerPercentileTier enum 값 중 하나로 분류됩니다.

  • 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에서 요청을 재현하고 우선순위를 지정할 수 있도록 템플릿의 모든 필드를 자세한 정보로 작성합니다. Google은 불완전한 신고를 종료하고 누락된 세부정보를 포함하여 새로운 문제를 제출하도록 요청할 수 있습니다.

이전
YouTube 크리에이터 통계