YouTube 업계 기준치

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

주요 기능

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

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

검색 방법

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

사용 가능한 날짜 나열

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: 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 참조 문서를 참고하세요.

날짜 분류

BenchmarksTimeGranularity를 사용하여 breakdown_definition.date_breakdown를 설정하여 측정항목을 그룹화할 수 있습니다.

  • WEEK: 주별로 측정항목을 집계합니다. date_range은 일요일에 시작하고 토요일에 끝나야 합니다 (ISO 8601과 다름).
  • MONTH: 월별로 측정항목을 집계합니다. date_range은 월의 첫날에 시작하여 월의 마지막 날에 종료되어야 합니다.
  • QUARTER: 캘린더 분기별로 측정항목을 집계합니다. date_range는 분기의 첫날에 시작하여 분기의 마지막 날에 종료되어야 합니다.

응답 측정항목

GenerateBenchmarksMetricsResponse은 다음을 반환합니다.

전체 필드 사양은 GenerateBenchmarksMetricsResponse 참조 문서를 참고하세요.

백분위수 측정항목

백분위수 측정항목은 범위가 지정된 분석 내 다른 광고주 사이에서 고객의 경쟁력을 백분위수 등급으로 나타냅니다.

기본 요건

백분위수 측정항목을 가져오려면 요청이 다음 요구사항을 충족해야 합니다.

  1. 업계 기준치 소스: benchmarks_source는 all_advertisers = true를 선택해야 합니다.
  2. 카테고리 필터: ListBenchmarksSources에서 가져온 하나 이상의 유효한 category_ids이 포함된 category_filter를 제공해야 합니다.
  3. 보조 데이터: GenerateBenchmarksMetricsRequest의 supplemental_data 필드에 PERCENTILE_DATA를 추가해야 합니다.

백분위수 등급

고객의 실적은 BenchmarksCustomerPercentileTier enum 값 중 하나로 분류됩니다 (하위 등급의 DEVELOPING부터 실적이 가장 우수한 광고주의 MARKET_LEADER까지). 각 등급과 백분위수 경계에 대한 설명은 BenchmarksCustomerPercentileTier 참조 문서를 참고하세요.

요청 예시

다음 예는 고객의 YouTube 광고 실적을 /Apparel/Clothing 카테고리에서 광고를 운영하는 다른 광고주와 비교하는 사용자를 위한 백분위수 등급이 포함된 벤치마크 측정항목을 생성하는 REST JSON 요청 페이로드를 보여줍니다.

{
  "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 크리에이터 통계