Relatórios na IU

Este guia mapeia os conceitos e as convenções de nomenclatura dos relatórios na interface do Google Ads para os relatórios que você pode gerar 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 as relações com a Google Ads Query Language (GAQL).

Interface	GAQL
Colunas	Qualquer recurso, campo de segmento ou métrica na cláusula SELECT de uma consulta GQL.
Período	Os períodos são associados a uma cláusula WHERE que filtra em 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 do 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 recurso, campos de segmento e métricas no GAQL.

Filtragem

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 no GAQL filtrando em segments.date na cláusula WHERE de uma consulta do GAQL.

Filtros

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

Segmentação

Para estatísticas mais detalhadas, você pode dividir os dados por segmentos. Por exemplo, você pode querer saber o número de impressões específicas da rede de pesquisa do Google separadamente da Rede de Display do Google. Nesse caso, você segmentaria o relatório por rede. Consulte Segmentação para saber como incluir campos de segmento na cláusula SELECT.

Paginação

Você navega pelos relatórios na interface usando os controles disponíveis na parte de baixo de cada tabela de dados, que permitem alternar as páginas 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 extrair relatórios com GoogleAdsService.Search até next_page_token. Para buscar o conjunto de resultados inteiro sem paginação, use GoogleAdsService.SearchStream.

Ordenar resultados

Na interface, é possível ordenar os resultados selecionando uma coluna.

No 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 salvos em vários formatos, como CSV, TSV ou XML.

A API não oferece suporte direto a diferentes formatos na saída. Portanto, você precisa realizar algum pós-processamento. Confira um exemplo de código que mostra como implementar a formatação CSV em um cliente.

Programação e relatórios de e-mail

A programação e o envio de um relatório por e-mail estão disponíveis na interface, mas não são compatíveis com a API.

Relatórios predefinidos

É possível criar uma lista de relatórios predefinidos na interface do Google Ads.

Confira uma lista dos relatórios predefinidos básicos e o nome do recurso do GAQL correspondente.

Relatórios predefinidos básicos	Nome do recurso do 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 acima, use o 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 entidades removidas, enquanto a API não.

Para replicar uma visualização de interface padrão, adicione um filtro, geralmente usando um campo status, para excluir linhas removidas, por exemplo:

SELECT campaign.name
FROM campaign
WHERE campaign.status != "REMOVED"