Visão geral dos relatórios

ondemand_video Vídeo: workshop do GAQL

Com a unificação de relatórios e consultas, não é mais necessário definir um relatório. É possível consultar recursos diretamente usando SearchGoogleAdsStreamRequest ou SearchGoogleAdsRequest.

Para começar seu planejamento de migração de relatórios, consulte as tabelas de mapeamento de campo apropriadas. Essas tabelas mostram o nome do campo da API AdWords e seus equivalentes 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 Google AdWords mais usados. Fornecemos uma comparação das consultas equivalentes na linguagem de consulta do Google AdWords (AWQL, na sigla em inglês) e na linguagem de consulta do Google Ads (GAQL, na sigla em inglês):

# 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

# 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

Relatórios de atribuição única x várias atribuições

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

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

• Relatórios de várias atribuições, como o Relatório de desempenho por gênero ou de desempenho por posição, 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 específicos por tipo de critério. Ao contrário da atribuição única, em que uma linha pode conter tipos de critérios diferentes, cada Relatório de atribuição múltipla contém critérios para apenas um tipo de critério.

Na API Google Ads, não há relatórios de atribuição individuais. Todos os relatórios no nível da API Google Ads são de atribuição múltipla, no sentido de que cada relatório é específico a um grupo de tipos de critério 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 levaria à contagem dupla e a totais incorretos.

Cabeçalho HTTP includeZeroImpressions

API AdWords

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

Defina o cabeçalho como true. A saída do relatório inclui essas linhas, e no false, não.

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 apenas impressões, para ser excluída quando o cabeçalho estiver definido como false.

API Google Ads

Esse cabeçalho não existe na Google Ads API. Assim, você não pode mapear as consultas da Google AdWords API diretamente para as consultas da Google Ads API.

Como uma aproximação, é possível especificar o predicado metrics.impressions > 0 na sua consulta para excluir as linhas do relatório com impressões zero. Na maioria dos casos, isso produz resultados equivalentes, como definir o cabeçalho includeZeroImpressions da API AdWords como false, já que quando as impressões são diferentes de zero, outros valores de métricas também costumam ser diferentes de zero.

No entanto, lembre-se de que os 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 e, portanto, uma linha do relatório ainda pode ser retornada.