A interface do Google Ads oferece recursos de relatórios. Para criar um relatório, faça login na sua conta do Google Ads, clique em Campanhas no menu de navegação à esquerda e em Insights e relatórios. Para criar um relatório do zero, clique em Editor de relatórios.
Este guia mapeia conceitos comuns de relatórios e convenções de nomenclatura na interface do Google Ads para relatórios que você pode gerar usando a Linguagem de consulta do Google Ads (GAQL, na sigla em inglês) e a API Google Ads. Também é possível seguir as instruções na interface para criar o relatório que melhor atende aos seus requisitos.
Ferramentas e recursos
Para exemplos mais detalhados e ajuda automatizada no mapeamento de telas da interface para a API, consulte os seguintes recursos:
- Query Cookbook: uma coleção de consultas da GAQL que replicam os dados encontrados em muitas telas comuns da interface do Google Ads.
- Extensão de relatórios da API Google Ads: uma extensão do Chrome que ajuda a identificar nomes de recursos e campos da API diretamente na interface do Google Ads.
Termos comuns de IU
A tabela a seguir resume alguns dos termos comuns usados na interface e as correspondências deles com a linguagem de consulta do Google Ads (GAQL).
| Interface | GAQL |
|---|---|
| Colunas | Qualquer recurso, campo de segmento ou métrica na cláusula SELECT de uma consulta da GAQL. |
| Período | Os períodos são mapeados para uma cláusula WHERE
que filtra em segments.date. |
| Filtros | Uma ou mais condições na cláusula WHERE. |
| Campos de segmento | Aplique a segmentação incluindo campos de segmento na sua consulta da GAQL. |
| Paginação | A paginação divide o conjunto de resultados da consulta em várias páginas. |
Colunas
As colunas na interface equivalem ao uso de uma cláusula SELECT para
campos de recurso,
campos de segmento ou
métricas na GAQL.
Saiba mais sobre as colunas da tabela de estatísticas.
Períodos
A interface do Google Ads tem uma tabela que mostra as estatísticas da conta e um menu suspenso para controlar o período dessas estatísticas.
Você tem o mesmo controle na GAQL ao filtrar
segments.date na cláusula WHERE de uma consulta
da GAQL.
Filtros
Os filtros na interface equivalem a uma ou mais condições na
cláusula WHERE da GAQL.
Para mais informações, consulte Filtrar a visualização dos dados de performance.
Segmentação
Para estatísticas mais detalhadas, divida os dados por segmentos. Por exemplo, imagine que você queira ver o número de impressões específicas da rede de pesquisa do Google separadamente da Rede de Display do Google. Nesse caso, segmente seu relatório por
rede. Consulte Segmentação para saber como incluir campos de segmento na cláusula SELECT.
Paginação
Navegue pelos relatórios na interface usando os controles disponíveis na parte de baixo de cada tabela de dados, que permitem alternar entre as páginas e selecionar o número de resultados a serem exibidos em um conjunto definido de tamanhos.
Para paginar os resultados ao recuperar relatórios, use
GoogleAdsService.Search com
next_page_token. Para buscar todo o conjunto de resultados
sem paginação, use
GoogleAdsService.SearchStream.
Ordenar resultados
Na interface, é possível ordenar os resultados selecionando uma coluna.
Na GAQL, é possível usar as cláusulas ORDER BY e
LIMIT para ordenar e limitar os resultados da consulta.
Formatos de download
Na interface, os relatórios podem ser baixados em vários formatos, como CSV, TSV ou XML.
A API não formata diretamente a saída em arquivos como CSV. Portanto, o aplicativo cliente precisa formatar a resposta. Consulte o exemplo de código do relatório de campanha para CSV para saber como implementar a formatação CSV em um cliente.
Programação e relatórios de e-mail
É possível programar e enviar um relatório por e-mail na interface, mas esses recursos não são compatíveis com a API.
Mapear visualizações da interface para recursos da API
Confira uma lista de visualizações comuns da interface e o nome do recurso da GAQL correspondente.
| Visualizações de interface | Nome do recurso da GAQL (especifique na cláusula FROM) |
|---|---|
| Conta | cliente |
| Campanha, Detalhes da campanha |
campaign |
| Grupo de anúncios, Detalhes do grupo de anúncios |
ad_group |
|
Anúncio, URL final |
ad_group_ad |
| Pesquisar palavra-chave | keyword_view |
| Termos de pesquisa | search_term_view |
| Pago e orgânico (modelo de visibilidade competitiva)* |
paid_organic_search_term_view |
| Página de destino | landing_page_view |
| Página de destino expandida | expanded_landing_page_view |
| Conteúdo > Canais | managed_placement_view |
| Conteúdo > Onde os anúncios foram exibidos | group_placement_view |
| Conteúdo > Onde os anúncios foram exibidos > Ver detalhes | detail_placement_view |
| Públicos-alvo > Informações demográficas > Idade | age_range_view |
| Públicos-alvo > Informações demográficas > Gênero | gender_view |
| Locais | location_view |
| Conteúdo > Tópicos | topic_view |
| Locais > Relatório geográfico | geographic_view |
* Para gerar o relatório Pago e orgânico, você precisa vincular uma conta do Google Search Console à sua conta do Google Ads no nível do cliente.
Como exemplo da tabela anterior, use a seguinte consulta da GAQL para gerar um relatório agregado da conta nos últimos sete dias (adicione segments.date à cláusula SELECT se quiser métricas detalhadas por dia):
SELECT
customer.descriptive_name,
customer.id,
metrics.clicks,
metrics.impressions,
metrics.ctr,
metrics.average_cpc,
metrics.cost_micros,
metrics.absolute_top_impression_percentage,
metrics.top_impression_percentage,
metrics.average_cpm
FROM customer
WHERE segments.date DURING LAST_7_DAYS
Diferenças comuns
Ao comparar os relatórios da interface com os da API, uma das diferenças mais comuns é que a interface filtra implicitamente as entidades removidas, enquanto a API não faz isso.
Para replicar uma visualização de interface padrão, adicione um filtro usando um campo status para excluir
linhas removidas (ou inclua explicitamente as entidades ENABLED e PAUSED). Por
exemplo:
SELECT campaign.name
FROM campaign
WHERE campaign.status != 'REMOVED'