Como mapear relatórios para a IU do Google AdWords

Este guia mapeia conceitos e convenções de nomenclatura dos relatórios da interface do usuário (IU) do Google AdWords para os relatórios comparáveis da AdWords API.

Termos comuns

A tabela a seguir resume alguns dos termos comuns usados na IU e seus respectivos mapeamentos para a API.

Interface do usuário API
Colunas fields
Período dateRange
Filtros predicates
Segmentação Alguns campos causam segmentação
Paginação paging
Formatos de download downloadFormat

Colunas

As colunas na IU são equivalentes aos fields na API.

É possível personalizar as colunas na IU navegando até o menu de colunas. Já na API, é possível incluí-las no relatório por meio da propriedade fields.

Consulte a documentação de referência Tipos de relatório para ver todos os campos disponíveis por relatório. Nessas páginas, Nome se refere ao nome do campo, como deve ser usado na definição de relatório da API, enquanto que Nome de exibição se refere ao nome da coluna, como é exibido na IU.

Filtragem

Períodos

A IU do Google AdWords apresenta uma tabela que exibe as estatísticas da conta e um menu suspenso usado para controlar o período dessas estatísticas. Você tem acesso ao mesmo controle na API usando os mesmos períodos predefinidos, tais como Últimos 7 dias, em dateRangeType.

Filtros

Os filtros na IU são equivalentes aos predicados na API. Com eles, você pode restringir os resultados dos relatórios, por exemplo, quando as conversões forem inferiores a 5. Os predicados são compostos por um campo de relatório (por exemplo, Conversions), um operador (por exemplo, LESS_THAN) e um valor (por exemplo, 5). Conforme você inclui predicados no seu relatório, eles são tratados como condições inclusivas (AND). Se um predicado apresentar um código inválido, o resultado será uma resposta vazia.

Segmentação

Para estatísticas mais detalhadas, você pode dividir os dados por segmentos. Por exemplo, se tiver interesse em ver a quantidade de impressões específicas da rede de pesquisa do Google separadamente da Rede de Display do Google, convém segmentar seu relatório por rede.

Para mais informações, consulte segmentação.

Paginação

Você pode navegar pelos seus relatórios na IU usando os controles disponíveis na parte inferior de cada tabela de dados. Com eles, é possível mudar de página e selecionar quantos resultados você deseja visualizar a partir de um conjunto definido de tamanhos. Enquanto estiverem disponíveis nos serviços de SOAP da API, todos os parâmetros de paginação especificados nos relatórios serão ignorados.

Ordem de exibição

Na IU, você pode organizar os resultados com base em uma coluna específica. Para isso, basta selecionar a coluna desejada. Embora esse recurso esteja disponível nos serviços SOAP da API, ele não é compatível com relatórios no momento.

Formatos de download

É possível fazer o download dos relatórios na IU em vários formatos (CSV, TSV, XML etc.). A maioria desses formatos também é compatível com a API.

Agendamento e relatórios de e-mail

O agendamento e o envio do relatório por e-mail estão disponíveis na IU, mas não são compatíveis com a API.

Colunas comuns

A IU compartilha um conjunto de colunas comuns entre diferentes relatórios, assim como os relatórios da API. Campos como impressões, cliques, conversões e outros estão disponíveis em diferentes tipos de relatório.

Tipos de relatório

As seções a seguir descrevem como os relatórios da IU são mapeados para cada tipo de relatório da API. Elas também descrevem o nível de segmentação padrão de cada relatório e como navegar na IU para acessar esses relatórios.

A página Tipos de relatório lista cada relatório da API e o mapeamento entre o nome da coluna da IU, ou Nome de exibição, e o nome de campo da API, ou apenas Nome.

Conta

As seções a seguir mapeiam os vários tipos de relatórios relacionados ao nível da conta ou a objetos que podem ser compartilhados entre campanhas.

Relatório de estratégias de lances

Para acessar o Relatório de estratégias de lances mostrado acima, navegue até a guia Biblioteca compartilhada à esquerda e, em seguida, clique no menu suspenso interno Estratégias de lances.

Os dados das estratégias de lances são mapeados para o Relatório de desempenho de meta de lance na API.

Relatório de orçamentos

Para acessar o Relatório de orçamentos mostrado acima, navegue até a guia Biblioteca compartilhada à esquerda e, em seguida, clique no menu suspenso interno Orçamentos.

Os dados de orçamentos são mapeados para o Relatório de desempenho do orçamento na API.

Campanhas

As seções a seguir mapeiam os vários tipos de relatórios relacionados às campanhas.

Relatório de campanhas

Para acessar o Relatório de campanhas mostrado acima, navegue até a guia superior Campanhas e, em seguida, até a guia interna Campanhas à esquerda da guia Grupos de anúncios. Se estiver olhando para uma campanha específica, a guia interna Campanhas não aparecerá. Nesse caso, clique na opção Todas as campanhas do lado superior esquerdo do painel de navegação.

O Relatório de campanhas é mapeado para o Relatório de desempenho da campanha na API.

Relatório de palavras-chave negativas

Para acessar a tabela de palavras-chave negativas mostrada acima, navegue até a guia superior Palavras-chave e, em seguida, escolha Palavras-chave negativas.

Os dados das palavras-chave negativas são mapeados para o Relatório de desempenho por palavra-chave negativa da campanha na API.

Relatório de exclusão de canais

Para acessar a tabela de canais negativos mostrada acima, navegue até a guia superior Rede de Display e, em seguida, vá até o final da página.

Os dados de exclusões de canais são mapeados para o Relatório de canais negativos da campanha na API.

Para recuperar dados de exclusões de canais no nível da campanha, consulte CampaignCriterionService.

Relatório de segmentação por agendamento de anúncios da campanha

Para acessar o Relatório de agendamento de anúncios da campanha mostrado acima, navegue até a guia superior Configurações e, em seguida, clique na guia interna Agendamento de anúncios.

Os dados de agendamento de anúncios da campanha são mapeados para o Relatório de destinos de agendamento de anúncios da campanha na API.

Relatório de segmentação por local das campanhas

Para acessar o relatório de segmentação por local das campanhas mostrado acima, navegue até a guia superior Configurações e, em seguida, clique na guia interna Locais.

Os dados de segmentação por local da campanha são mapeados para o Relatório de segmentação por local das campanhas na API.

Grupos de anúncios

Para acessar o Relatório de grupos de anúncios mostrado acima, navegue até a guia superior Grupos de anúncios.

O Relatório de grupos de anúncios é mapeado para o Relatório de desempenho do grupo de anúncios na API.

Relatório de grupos de produtos

Para acessar o Relatório de grupos de produtos mostrado acima, selecione um grupo de anúncios de uma Campanha do Shopping e navegue até a guia superior Grupos de produtos.

O Relatório de grupos de produtos é mapeado para o Relatório de partição de produto na API.

Anúncios

As seções a seguir mapeiam os vários tipos de relatórios relacionados aos anúncios.

Relatório de anúncios

Para acessar o Relatório de anúncios mostrado acima, navegue até a guia superior Anúncios.

O Relatório de anúncios é mapeado para o Relatório de desempenho do anúncio na API.

Relatório de extensões de anúncio

Para acessar o Relatório de extensões de anúncio mostrado acima, navegue até a guia superior Extensões de anúncio e selecione a vista específica que deseja exibir (por exemplo Extensões de sitelinks). Se a guia Extensões de anúncio não estiver visível, clique na seta para baixo à extrema direita e marque Extensões de anúncio.

O Relatório de extensões de anúncio é mapeado para o Relatório de itens de feed do marcador de posição e o Relatório do marcador de posição na API. Além disso, os campos PlaceholderType e ExtensionPlaceholderType podem ser filtrados pelo ID do tipo de marcador de posição para filtrar por tipo de extensão, como na IU.

Relatório de detalhes da chamada

Para acessar o Relatório de detalhes da chamada mostrado acima, navegue até a guia superior Dimensões e selecione a vista Detalhes da chamada.

O Relatório de detalhes da chamada é mapeado para o Relatório de detalhes da chamada das métricas de chamada na API.

Relatório de categoria sem palavra-chave

Para acessar o Relatório de categoria sem palavra-chave mostrado acima, navegue até a guia superior Segmentações automáticas e, em seguida, selecione Todas na caixa de lista Ver categorias....

Os dados da categoria sem palavra-chave são mapeados para o Relatório de categoria sem palavra-chave na API.

Escolher Categorias de nível superior na lista suspensa é equivalente a escolher "ONLY Category0" no relatório da API. Escolher Subcategorias de primeiro nível na lista suspensa é equivalente a escolher "ONLY Category1" no relatório da API. Escolher Subcategorias de segundo nível na lista suspensa é equivalente a escolher "ONLY Category2" no relatório da API. Não existe um equivalente na interface do usuário do Google AdWords para escolher mais que uma categoria no relatório da API.

Relatório de consulta sem palavra-chave

Para acessar o Relatório de consulta sem palavra-chave mostrado acima, navegue até a guia superior Segmentações automáticas e, em seguida, selecione Todos na caixa de lista Ver termos de pesquisa....

Os dados da consulta sem palavra-chave são mapeados para o Relatório de consulta sem palavras-chave na API.

Critérios

As seções a seguir mapeiam os vários tipos de relatórios relacionados aos critérios.

Relatório de palavras-chave

Para acessar o Relatório de palavras-chave mostrado acima, navegue até a guia superior Palavras-chave.

O Relatório de palavras-chave é mapeado para o Relatório de desempenho de palavras-chave na API.

Relatório de palavras-chave da Rede de Display

Para acessar o Relatório de palavras-chave da Rede de Display mostrado acima, navegue até a guia superior Rede de Display e, em seguida, até a guia interna Palavras-chave.

O Relatório de palavras-chave da Rede de Display é mapeado para o Relatório de desempenho por palavra-chave da Rede de Display na API.

Relatório de seleções automáticas de canais

Para acessar o Relatório de seleções automáticas de canais mostrado acima, navegue até a guia superior Rede de Display e, em seguida, até a guia interna Canais. As linhas em que a coluna Status é igual a Automático mostram os canais que veicularam seus anúncios com base em critérios diferentes dos critérios de canais.

O Relatório de seleções automáticas de canais é mapeado para o Relatório de desempenho da seleção automática de canais na API. Os dados da seleção automática na API só estão disponíveis por meio desse relatório, e não por meio do AdGroupCriterionService. A linha de estatísticas Outros domínios não está disponível para relatórios da API.

Relatório de seleções manuais de canais

Para acessar o Relatório de seleções manuais de canais, siga estas etapas:

  1. Na IU do Google AdWords, vá para a guia Rede de Display.
  2. Selecione Canais.
  3. Crie um filtro. Selecione Status como filtro e certifique-se de que todas as opções estejam marcadas, exceto Seleção não manual, conforme exibido acima.
  4. Clique em Aplicar.
  5. A linha na parte inferior mostra os valores filtrados para Impressões, Cliques e Custo. As linhas em que a coluna Status é igual a Seleção manual mostram os canais que veicularam seus anúncios com base nos critérios de canais.

O Relatório de seleções manuais de canais é mapeado para o Relatório de desempenho em canais na API. A consulta AWQL a seguir gera o mesmo relatório com valores correspondentes aos da IU:

SELECT Criteria, Clicks, Impressions, Cost
FROM PLACEMENT_PERFORMANCE_REPORT
WHERE IsRestrict = 'TRUE'

Aqui, é importante que isRestrict seja definido como TRUE.

Relatório de tópicos

Para acessar o Relatório de tópicos mostrado acima, clique na guia superior Rede de Display e, em seguida, na guia interna Tópicos. Se a guia Tópicos não estiver visível, clique na seta para baixo à extrema direita e marque Tópicos.

O Relatório de tópicos inclui todas as estatísticas agregadas no nível do tópico, sendo uma linha por tópico. Se outros campos de segmento forem utilizados, você poderá ter mais de uma linha por tópico. Para mais informações, consulte segmentação.

Os tópicos são conhecidos na API como indústria. Os Relatório de tópicos é mapeado para o Relatório de desempenho por tópicos da Rede de Display na API.

Relatório de público-alvo

Para acessar o Relatório de público-alvo mostrado acima, navegue até a guia superior Rede de Display e, em seguida, até a guia interna Interesses e remarketing. Se a guia Interesses e remarketing não estiver visível, clique na seta para baixo à extrema direita e marque Interesses e remarketing.

O Relatório de público-alvo é mapeado para o Relatório de desempenho do público-alvo na API.

Relatório de sexo

Para acessar o Relatório de sexo mostrado acima, navegue até a guia superior Rede de Display, em seguida, até a guia interna Informações demográficas e, por fim, até a guia Sexo.

O Relatório de sexo é mapeado para o Relatório de desempenho por sexo na API.

Relatório de faixa etária

Para acessar o Relatório de faixa etária mostrado acima, navegue até a guia superior Rede de Display, em seguida, até a guia interna Informações demográficas e, por fim, até a guia Idade.

O Relatório de faixa etária é mapeado para o Relatório de desempenho por faixa etária na API.

Relatório de status parental

Para acessar o Relatório de status parental mostrado acima, navegue até a guia superior Rede de Display, em seguida, até a guia interna Informações demográficas e, por fim, até a guia Status parental.

O Relatório de status parental é mapeado para o Relatório de desempenho de status parental na API.

Relatório de conteúdo principal

Para acessar o Relatório de conteúdo principal mostrado acima, selecione primeiro um grupo de anúncios de uma campanha da Rede de Display. Navegue até a guia superior Configurações e, em seguida, até a guia interna Conteúdo principal.

O Relatório de conteúdo principal é mapeado para o Relatório de desempenho de conteúdo principal na API.

Outros

Os relatórios descritos abaixo se aplicam a áreas funcionais diversas dentro da API.

Relatório de URL de destino

Para acessar o Relatório de URL de destino mostrado acima, navegue até a guia superior Dimensões e selecione a vista URL de destino.

O Relatório de URL de destino é mapeado para o Relatório de URL de destino na API.

Relatório de URL final

Para acessar o Relatório de URL final mostrado acima, navegue até a guia superior Dimensões e selecione a vista URL final.

O Relatório de URL final é mapeado para o Relatório de URL final na API.

Relatório de URL

Para acessar o Relatório de URL mostrado acima, navegue até a guia superior Rede de Display e, em seguida, até a guia interna Canais. Expanda sua seleção manual de canais clicando no menu Ver detalhes -> Tudo na parte superior da tabela de dados.

O Relatório de URL é mapeado para o Relatório de desempenho de URL na API.

Relatório de termos de pesquisa

Para acessar o Relatório de termos de pesquisa mostrado acima, navegue até a guia superior Dimensões e selecione a vista Termos de pesquisa.

O Relatório de termos de pesquisa é mapeado para o Relatório de desempenho da consulta da pesquisa na API.

Para acessar o Relatório pago e orgânico mostrado acima, navegue até a guia superior Dimensões e selecione a vista Pago e orgânico.

O Relatório pago e orgânico é mapeado para o Relatório de consulta de pesquisa orgânica paga na API.

Relatório geográfico

Para acessar o Relatório geográfico mostrado acima, navegue até a guia superior Dimensões e selecione a vista Geográfico.

O Relatório geográfico é mapeado para o Relatório de desempenho geográfico na API, com predicados específicos. Para detalhes, consulte a documentação sobre relatórios da API.

Relatório de locais do usuário

Para acessar o Relatório de locais do usuário mostrado acima, navegue até a guia superior Dimensões e selecione a vista Locais do usuário.

O Relatório de locais do usuário é mapeado para o Relatório de desempenho geográfico na API, com predicados específicos. Para detalhes, consulte a documentação sobre relatórios da API.

Relatório de cliques gratuitos

Cliques gratuitos são interações que ocorrem antes de uma taxa de cliques para anúncios em vídeo, anúncios gráficos, extensões de produtos e extensões de local. Exemplos dessas interações incluem "Reprodução de 25% do vídeo" ou "Como chegar".

O Relatório de cliques gratuitos é mapeado para o Relatório de conversões de criativos na API.

Enviar comentários sobre…

Precisa de ajuda? Acesse nossa página de suporte.