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 à 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 para a API, consulte os seguintes recursos:
- Query Cookbook: uma coleção de consultas 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 recursos da API e nomes de campos diretamente na interface do Google Ads.
Termos comuns da interface
A tabela a seguir resume alguns dos termos comuns usados na interface e os respectivos mapeamentos 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 são mapeados para 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 consulta GAQL. |
| Paginação | A paginação divide o conjunto de resultados de 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 na 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 filtrando em
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íficas 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 exibidos em um conjunto definido de tamanhos.
A paginação de resultados está disponível ao recuperar relatórios com
GoogleAdsService.Search usando
next_page_token. Para buscar todo o conjunto de resultados
sem paginação, use
GoogleAdsService.SearchStream.
Ordenar resultados
Na interface, você pode ordenar os resultados selecionando uma coluna.
Na GAQL, você pode usar as cláusulas ORDER BY e 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. Por isso, é necessário realizar algum pós-processamento. Consulte 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 para recursos da API
Confira uma lista de visualizações comuns da interface e o nome do recurso GAQL correspondente.
| Visualizações da interface | Nome do recurso GAQL (especifique na cláusula FROM) |
|---|---|
| Conta | customer |
| Campanha, Detalhes da campanha |
campaign |
| Grupo de anúncios, Detalhes do grupo de anúncios |
ad_group |
|
Anúncio, URL final |
ad_group_ad |
| Palavra-chave da rede de pesquisa | 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, você pode usar a seguinte GAQL para gerar o relatório da 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 relatórios da API, uma das diferenças mais comuns é que a interface filtra implicitamente as entidades removidas, enquanto a API não.
Para replicar uma visualização padrão da interface, adicione um filtro, normalmente usando um campo status, para excluir linhas removidas. Por exemplo:
SELECT campaign.name
FROM campaign
WHERE campaign.status != 'REMOVED'