Visão geral dos relatórios

Vídeo: workshop do GAQL

Com a unificação de relatórios e consultas, você não precisa mais definir um relatório. É possível consultar recursos diretamente para dados usando um SearchGoogleAdsStreamRequest ou um SearchGoogleAdsRequest.

Para iniciar o planejamento da migração dos relatórios, consulte as tabelas de mapeamento de campo apropriadas. Essas tabelas mostram o nome do campo e o equivalente na API Google Ads.

Exemplo

O Relatório de desempenho do grupo de anúncios e o Relatório de desempenho da campanha são dois dos relatórios da API do AdWords mais usados. Fornecemos comparações para as consultas equivalentes na linguagem de consulta do Google Ads (AWQL, na sigla em inglês) e na linguagem de consulta do Google Ads (GAQL, na sigla em inglês):

Relatório de desempenho do grupo de anúncios
# AWQL
SELECT CampaignId, AdGroupId, Impressions, Clicks, Cost
FROM ADGROUP_PERFORMANCE_REPORT
DURING LAST_7_DAYS

# Google Ads Query Language
SELECT campaign.id, ad_group.id, metrics.impressions, metrics.clicks,
       metrics.cost_micros
FROM ad_group
WHERE segments.date DURING LAST_7_DAYS
Relatório de desempenho da campanha
# AWQL
SELECT CampaignName, CampaignStatus, Device, Impressions, Clicks,
       Ctr, AverageCpc, Cost
FROM CAMPAIGN_PERFORMANCE_REPORT
DURING LAST_30_DAYS

# Google Ads Query Language
SELECT campaign.name, campaign.status, segments.device, metrics.impressions,
       metrics.clicks, metrics.ctr, metrics.average_cpc, metrics.cost_micros
FROM campaign
WHERE segments.date DURING LAST_30_DAYS

Diferenças entre os Relatórios de atribuição única e múltipla

Durante a migração, determinados relatórios específicos de critérios na API Google AdWords podem exigir considerações especiais, como o Relatório de desempenho por palavras-chave ou o Relatório de desempenho por faixa etária. Existem dois tipos de relatórios:

  • Relatórios de atribuição única, como o Relatório de desempenho de critérios ou o Relatório de desempenho de palavras-chave, em que somente um dos critérios de acionamento (como canal, idade, palavra-chave etc.) é registrado para uma determinada impressão: uma impressão pode ser acionada por vários critérios, mas, em um único Relatório de atribuição, a impressão e todas as estatísticas correspondentes são atribuídas a um único critério.

  • Relatórios de múltipla atribuição, como Relatório de desempenho por gênero ou Relatório de desempenho em canais, em que até um critério em cada dimensão que acionou a impressão tem a impressão registrada: vários Relatórios de atribuição podem ser considerados relatórios de tipos específicos de critérios. Ao contrário da atribuição única, em que uma linha pode conter tipos de critérios diferentes, cada relatório de atribuição contém critérios para apenas um tipo de critério.

Na API Google Ads, não há relatórios de atribuição únicos. Todos os relatórios no nível da API Google Ads são de atribuição múltipla, porque cada relatório é específico de um grupo de tipos de critérios e resume as estatísticas de acordo com os critérios desse tipo. Não adicione estatísticas de diferentes recursos criteria_view, porque isso resultaria em contagem dupla e totais incorretos.

Cabeçalho HTTP includeZeroImpressions

API AdWords

Na API AdWords, use o cabeçalho includeZeroImpressions para controlar se as linhas do relatório em que todos os campos de métricas especificadas na consulta têm valores zero serão retornadas.

Defina o cabeçalho como true. A saída do relatório incluirá essas linhas. Para false, ele não faz isso.

Embora o nome do cabeçalho mencione "Impressões", uma linha de relatório precisa ter zero em todos os campos de métricas especificados na solicitação (não somente impressões) para que ela seja excluída quando o cabeçalho estiver definido como false.

Essa cabeçalho não existe na API Google Ads. Portanto, não é possível mapear as consultas da API AdWords diretamente para as consultas da API.

Como aproximação, você pode especificar o predicado metrics.impressions > 0 na sua consulta para excluir as linhas do relatório em que as impressões são zero. Na maioria dos casos, isso gera resultados equivalentes à configuração do cabeçalho includeZeroImpressions da API AdWords como false, já que, quando as impressões são diferentes de zero, outros valores de métricas geralmente também são diferentes de zero.

No entanto, esteja ciente de casos em que metrics.impressions é zero, mas outros valores de métricas (como o metrics.search_impression_share baseado em previsão) podem não ser, portanto, uma linha de relatório ainda pode ser retornada.