Relatórios na IU

Este guia mapeia os conceitos e as convenções de nomenclatura de relatórios na interface do Google Ads aos relatórios que você pode gerar usando a Linguagem de consulta do Google Ads (GAQL, na sigla em inglês) e API Google Ads.

Termos comuns da interface

A tabela a seguir resume alguns dos termos comuns usados na interface do usuário e suas mapeamentos para a Linguagem de consulta do Google Ads (GAQL, na sigla em inglês).

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 um WHERE cláusula filtrando segments.date.
Filtros	Uma ou mais condições na cláusula WHERE.
Segmentar campos	Aplicar a segmentação incluindo campos de segmento na consulta GAQL.
Paginação	A Paging divide o conjunto de resultados dos a consulta em várias páginas.

Colunas

As colunas na interface do usuário são equivalentes a Recurso campos, Segmento campos e Métricas na GAQL.

Filtragem

Períodos

A interface do Google Ads tem uma tabela que exibe 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 segments.date na cláusula WHERE de uma GAQL consulta.

Filtros

Os filtros na interface do usuário são equivalentes a uma ou mais condições no(a) WHERE cláusula da GAQL.

Segmentação

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

Paginação

Navegue pelos relatórios na interface usando os controles disponíveis na parte inferior de cada tabela de dados que permitem trocar de página e selecionar o número de resultados a serem exibidos a partir de um conjunto definido de tamanhos.

A paginação dos resultados está disponível ao recuperar relatórios com GoogleAdsService.Search a 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 a cláusula ORDER BY cláusula e LIMIT cláusula para ordenar o resultado da consulta.

Formatos de download

Na interface, é possível fazer o download dos relatórios em vários formatos, como CSV, TSV ou XML

A API não suporta diretamente formatos diferentes em sua saída, então você usaria precisa fazer o pós-processamento. Consulte um exemplo de código que mostra como implementar a formatação CSV em uma cliente.

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

A programação e o envio de relatórios por e-mail estão disponíveis na interface, mas não são suportados no a API.

Relatórios predefinidos

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

Veja uma lista dos relatórios básicos predefinidos e o recurso GAQL correspondente Nome:

Relatórios predefinidos básicos	Nome do recurso 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
Pesquisa paga e orgânica	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, você pode usar a GAQL a seguir 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 de interface com relatórios de API, uma das diferenças mais comuns é que a IU filtra implicitamente entidades removidas, enquanto a API não faz isso.

Para replicar uma visualização padrão da interface, é preciso adicionar um filtro, que normalmente usando um campo status para excluir linhas removidas, por exemplo:

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