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 critérios. Cada visualização se une ao recurso de critério que corresponde ao nível de segmentação (por exemplo, keyword_view se une a ad_group_criterion, enquanto location_view se une a campaign_criterion). 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 ao 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 os campos metrics na cláusula SELECT para recuperar métricas de palavras-chave.

É possível selecionar campos de recursos pai até customer em uma visualização de critérios. Por exemplo, ao selecionar FROM em 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, verifique a linha Recursos atribuídos da página de referência. Por exemplo, para keyword_view, é possível 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 essas informações pode ajudar você a reconciliar os dados da API com o que aparece na interface. Para uma lista maior de mapeamentos, consulte Relatórios na interface.

Veja a seguir alguns relatórios comuns baseados em critérios e os locais típicos deles na 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.