Relatórios na interface do Google Ads

Este guia mapeia os conceitos e as convenções de nomenclatura dos relatórios na interface do Google Ads com os relatórios que podem ser gerados usando a linguagem de consulta do Google Ads (GAQL) e a API 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 a Campos de recursos, Campos de segmento e Métricas na GAQL.

Filtragem

É possível filtrar e organizar os dados nos seus relatórios.

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.

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. Eles 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.

Relatórios predefinidos

Você pode criar uma lista de relatórios predefinidos na interface do Google Ads.

Confira uma lista dos relatórios básicos predefinidos e os respectivos nomes de recursos da GAQL.

Relatórios predefinidos básicos	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
Pagos e orgânicos	paid_organic_search_term_view
Página de destino	landing_page_view
Página de destino expandida	expanded_landing_page_view

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"