Relatórios na interface do Google Ads

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 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 que melhor atende aos seus requisitos.

Ferramentas e recursos

Para exemplos mais detalhados e ajuda automatizada no mapeamento de telas da interface com a API, consulte os seguintes recursos:

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.

Para mais informações, 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 por segments.date na cláusula WHERE de uma consulta da GAQL.

Filtros

Os filtros na interface são equivalentes a uma ou mais condições na cláusula WHERE da GAQL.

Para mais informações, consulte Filtrar sua visualização de 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 mostrados em um conjunto definido de tamanhos.

Para paginar os resultados ao extrair 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 de relatório de campanha para CSV e saiba 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 com recursos da API

Confira uma lista de visualizações comuns da interface e o nome do recurso correspondente da GAQL.

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 veiculados > 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 consulta 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 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 usando um campo status para excluir linhas removidas ou inclua explicitamente entidades ENABLED e PAUSED. Por exemplo:

SELECT campaign.name
FROM campaign
WHERE campaign.status != 'REMOVED'
Anterior
Paging
Avançar
Mapear parâmetros ValueTrack com campos de relatório