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 à 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'