Comparativos de mercado do YouTube

O BenchmarksService permite que anunciantes e agências comparem a performance dos anúncios do YouTube com comparativos de mercado do setor. Com esse serviço, você pode avaliar a performance das suas campanhas em relação a verticais do setor ou a todos os anunciantes em categorias específicas de produtos e serviços.

Principais recursos

Com o BenchmarksService, é possível:

  • Comparar a performance: avalie as métricas de taxa média de um cliente (como CPM, CPV, CTR e visibilidade) em comparação com as médias agregadas do setor.
  • Analise a participação de mercado: entenda a presença relativa de um cliente no mercado com a participação de voz (impressões relativas) e a parcela de gastos.
  • Avalie a posição competitiva: meça a posição competitiva de um cliente usando métricas de percentil que classificam a performance em dimensões principais em níveis competitivos (como Líder de mercado ou Concorrente).
  • Segmentar por tempo: agrupe as métricas de comparativo de mercado por granularidades de tempo semanais, mensais ou trimestrais.
  • Descobrir dimensões de comparativo de mercado compatíveis: consulte intervalos de datas, locais geográficos, produtos de publicidade e fontes de comparativo de mercado (segmentos verticais do setor ou categorias de produtos e serviços) disponíveis.

Métodos de descoberta

Antes de gerar métricas de comparativo de mercado, use os métodos de descoberta para extrair os parâmetros e critérios de escopo válidos para suas solicitações.

Listar datas disponíveis

O método ListBenchmarksAvailableDates retorna os períodos históricos que oferecem suporte a dados de comparativo de mercado em um ListBenchmarksAvailableDatesResponse.

A resposta fornece dois períodos distintos:

  • supported_dates: o período geral em que as métricas de comparação são compatíveis (inclusive). As solicitações de comparativo de mercado podem consultar datas dentro desse período.
  • supported_dates_for_all_metrics: um subconjunto de supported_dates que oferece suporte ao conjunto completo de métricas de comparativo de mercado. Algumas métricas, especificamente as de participação do cliente (share_of_voice e share_of_spend) e as de taxa média da fonte de comparativo de mercado, só estão disponíveis nesse período devido à disponibilidade limitada de dados. Essas métricas são omitidas da resposta se o date_range solicitado não estiver totalmente dentro de supported_dates_for_all_metrics.

Listar locais

O método ListBenchmarksLocations retorna a lista de locais geográficos (como países) que oferecem suporte a dados de comparativo de mercado.

Cada BenchmarksLocation na resposta inclui:

  • location_name: o nome exclusivo do local em inglês (por exemplo, "United States").
  • location_type: o tipo de local correspondente ao target_type na API Google Ads (por exemplo, "Country").
  • location_info: um objeto LocationInfo que contém a constante de segmentação geográfica (como geo_target_constant: "geoTargetConstants/2840").

Listar produtos

O método ListBenchmarksProducts retorna a lista de produtos e objetivos de marketing disponíveis para comparativo de mercado.

Cada entrada de BenchmarksProductMetadata inclui:

  • product_name: o nome do produto fácil de usar.
  • product_code: a string de identificador exclusivo do produto, usada ao construir um ProductFilter.
  • marketing_objective: o objetivo de marketing associado (BenchmarksMarketingObjective):
    • AWARENESS: campanhas criadas para aumentar o reconhecimento da marca ou do produto.
    • CONSIDERATION: campanhas criadas para incentivar clientes em potencial a considerar a marca ou os produtos.
    • ACTION: campanhas criadas para gerar uma ação de conversão específica.

Listar fontes de comparativos de mercado

O método ListBenchmarksSources recupera as fontes de comparativo de mercado disponíveis. Especifique os tipos de origem a serem recuperados usando BenchmarksSourceType:

  • INDUSTRY_VERTICAL: classificações de segmentos do setor (por exemplo, "Tecnologia" ou "Finanças").
  • CATEGORY: categorias de produtos e serviços (por exemplo, "/Apparel/Clothing"). As categorias podem ser usadas como filtros para definir o escopo da comparação de mercado ao comparar com todos os anunciantes.

A resposta retorna uma lista de objetos BenchmarksSourceMetadata que contêm um destes itens:

  • IndustryVerticalInfo: contém industry_vertical_name, industry_vertical_id e parent_industry_vertical_id (se aplicável).
  • CategoryInfo: contém category_name, category_id e category_path (a hierarquia completa de categorias).

Gerar métricas de comparativo de mercado

Chame GenerateBenchmarksMetrics para comparar as métricas de anúncios do YouTube de um cliente com comparativos de mercado.

Parâmetros de solicitação

Um GenerateBenchmarksMetricsRequest define o escopo da análise. No mínimo, é necessário especificar um customer_id do cliente, uma location geográfica, um benchmarks_source (como um setor vertical específico ou todos os anunciantes no escopo de category_filter) e um product_filter. Você pode fornecer um date_range, agrupar métricas com um breakdown_definition, especificar um currency_code ou solicitar recursos adicionais, como PERCENTILE_DATA, usando supplemental_data.

Para conferir as definições e os requisitos completos dos parâmetros, consulte a documentação de referência do GenerateBenchmarksMetricsRequest.

Detalhamentos por data

É possível agrupar métricas definindo breakdown_definition.date_breakdown usando BenchmarksTimeGranularity:

  • WEEK: agrega métricas por semana. O date_range precisa começar em um domingo e terminar em um sábado (observação: isso é diferente do ISO 8601).
  • MONTH: agrega métricas por mês. O date_range precisa começar no primeiro dia do mês e terminar no último dia do mês.
  • QUARTER: agrega métricas por trimestre civil. O date_range precisa começar no primeiro dia do trimestre e terminar no último dia dele.

Métricas de resposta

O GenerateBenchmarksMetricsResponse retorna:

Para conferir as especificações completas dos campos, consulte a documentação de referência GenerateBenchmarksMetricsResponse.

Métricas de percentil

As métricas de percentil representam a posição competitiva de um cliente como níveis de percentil entre outros anunciantes na análise no escopo.

Pré-requisitos

Para recuperar métricas de percentil, sua solicitação precisa atender aos seguintes requisitos:

  1. Origem dos comparativos de mercado: benchmarks_source precisa selecionar all_advertisers = true.
  2. Filtro de categoria: category_filter precisa ser fornecido, contendo um ou mais category_ids válidos recuperados de ListBenchmarksSources.
  3. Dados complementares: você precisa adicionar PERCENTILE_DATA ao campo supplemental_data em GenerateBenchmarksMetricsRequest.

Níveis de percentil

A performance de um cliente é classificada em um dos valores de enumeração BenchmarksCustomerPercentileTier (que variam de DEVELOPING para os níveis mais baixos até MARKET_LEADER para anunciantes de alta performance). Para uma descrição de cada nível e dos limites de percentil, consulte a documentação de referência BenchmarksCustomerPercentileTier.

Exemplo de solicitação

O exemplo a seguir ilustra uma carga útil de solicitação JSON REST para gerar métricas de comparativo de mercado com níveis de percentil para um usuário que compara a performance dos anúncios do YouTube do cliente com outros anunciantes que veiculam anúncios na categoria /Vestuário/Roupas:

{
  "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"
  ]
}

A resposta incluindo os dados de percentil adicionais solicitados:

{
  "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
    }
  }
}

Tratamento de erros

Ao chamar o BenchmarksService, você pode encontrar erros específicos para consultas de comparativos de mercado em BenchmarksError:

  • MAX_QUERY_COMPLEXITY_EXCEEDED: a combinação de entradas solicitadas é muito complexa para ser processada. Para reduzir a complexidade da consulta:
    • Selecione uma origem de comparativo ou um filtro de categoria mais específico ou granular.
    • Reduza o date_range solicitado.
    • Reduza o número de produtos em product_filter.
  • NO_METRICS_FOUND: nenhuma métrica foi encontrada para a combinação solicitada de entradas (por exemplo, uma categoria de nicho em um local e período específicos em que nenhum anunciante veiculou campanhas). Tente ajustar a categoria, o local, o período ou os produtos.

Para conferir práticas recomendadas e informações gerais sobre o tratamento de erros de API, consulte o guia de tratamento de erros.

Anterior
Insights para criadores de conteúdo do YouTube