Métricas de critérios

Na API Google Ads, cada relatório de critérios é representado por um recurso separado. A menos que seja necessário, os recursos *_view contêm apenas um campo resource_name.

Os clientes da API Google Ads precisam especificar os campos ad_group_criterion ou campaign_criterion correspondentes se for necessário buscar dados específicos de algum critério. Isso permite que os clientes da API Google Ads solicitem campos ad_group_criterion ou campaign_criterion e o recurso *_view na mesma solicitação para o método GoogleAdsService.SearchStream.

Exemplo de solicitação de consulta

SELECT
  ad_group_criterion.keyword.text,
  ad_group.name,
  campaign.name,
  metrics.impressions,
  metrics.clicks,
  metrics.ctr,
  metrics.average_cpc
FROM keyword_view
WHERE segments.date DURING LAST_30_DAYS

Para recuperar dados de performance (métricas) de um tipo de critério específico, especifique o recurso de visualização correspondente na cláusula FROM. Por exemplo, use keyword_view na cláusula FROM e alguns campos metrics na cláusula SELECT para recuperar métricas de palavra-chave.

É possível selecionar campos de recursos principais até customer em uma visualização de critérios. Por exemplo, ao selecionar FROM e keyword_view, é possível solicitar campos de todos os seguintes recursos:

• ad_group_criterion
• ad_group
• campaign
• customer

Para descobrir os recursos que podem ser solicitados dessa forma para um determinado recurso, confira a linha Recursos de atributo na página de referência. Por exemplo, para keyword_view, você pode encontrar os recursos na página de referência.

Mapeamento para a interface

Cada relatório de critérios corresponde a uma visualização específica na interface do Google Ads. Mapear esses dados pode ajudar você a conciliar os dados da API com o que aparece na interface. Para uma lista maior de mapeamentos, consulte Relatórios na interface.

Confira alguns relatórios comuns baseados em critérios e os locais típicos da interface:

• Campanhas > Públicos-alvo, palavras-chave e conteúdo > Palavras-chave da rede de pesquisa: retorna dados equivalentes a keyword_view.
• Campanhas > Públicos-alvo, palavras-chave e conteúdo > Públicos-alvo > Informações demográficas: retorna dados equivalentes a age_range_view e gender_view.
• Campanhas > Locais: retorna dados equivalentes a location_view.