A interface do Google Ads oferece recursos de geração de relatórios. Para criar um relatório, faça login na sua conta do Google Ads. Clique em Campanhas à 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 podem ser gerados usando a linguagem de consulta do Google Ads (GAQL) e a API Google Ads. Você também pode seguir as instruções na interface para criar o relatório mais adequado às suas necessidades.
Ferramentas e recursos
Para exemplos mais detalhados e ajuda automatizada no mapeamento de telas da interface com a API, consulte os seguintes recursos:
- Livro de receitas de consultas: 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 da interface
A tabela a seguir resume alguns dos termos comuns usados na interface e os mapeamentos deles para 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 GAQL. |
| Período | Os períodos correspondem a uma cláusula WHERE que filtra 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 GAQL. |
| Paginação | A paginação divide o conjunto de resultados da consulta em várias páginas. |
Colunas
As colunas na interface são equivalentes ao uso de uma cláusula SELECT para Campos de recursos, Campos de segmento ou Métricas na GAQL.
Consulte 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 GAQL.
Filtros
Os filtros na interface são equivalentes a uma ou mais condições na cláusula WHERE da GAQL.
Consulte Filtrar a visualização dos dados de performance.
Segmentação
Para estatísticas mais detalhadas, divida os dados por segmentos. Por exemplo, suponha que você queira ver o número de impressões específico da rede de pesquisa do Google separadamente da Rede de Display do Google. Nesse caso, segmente o 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 mudar de página e selecionar o número de resultados a serem mostrados em um conjunto definido de tamanhos.
A paginação de resultados está disponível ao recuperar relatórios com
GoogleAdsService.Search até
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, você pode usar a cláusula ORDER BY e a cláusula LIMIT para ordenar o resultado 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 oferece suporte direto a diferentes formatos na saída, então você precisa realizar algum pós-processamento. Confira este exemplo de código que mostra 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 do mapa para recursos da API
Confira uma lista de visualizações comuns da interface e o nome do recurso 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, vincule uma conta do Google Search Console à sua conta do Google Ads no nível do cliente.
Como exemplo da tabela anterior, use a seguinte GAQL para gerar o relatório de conta:
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 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 padrão da interface, adicione um filtro, geralmente
usando um campo status, para excluir as linhas removidas. Exemplo:
SELECT campaign.name
FROM campaign
WHERE campaign.status != 'REMOVED'