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

Anterior

Nova

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

Anterior

Nova

A IU do Google AdWords tem 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 utilizando os mesmos períodos predefinidos, como Últimos 7 dias, em dateRangeType.

Filtros

Anterior

Nova

Os filtros na IU são equivalentes aos predicados na API. Com eles, você pode restringir os resultados dos relatórios, por exemplo, quando houver menos de cinco conversões. 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

Anterior

Nova

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

Anterior

Nova

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ê quer 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

Anterior

Nova

É 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

Anterior

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

Nova

Para acessar o Relatório de estratégia de lances de portfólio mostrado acima, clique no ícone de três pontos na barra superior e, depois, em Estratégias de lances de portfólio, na seção BIBLIOTECA COMPARTILHADA.

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

Relatório de orçamentos

Anterior

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

Nova

Este relatório ainda não está disponível na nova experiência do AdWords.

Os dados de orçamentos são mapeados para o Relatório de desempenho por 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

Anterior

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

Nova

Para acessar o Relatório de campanhas, navegue até o menu Campanhas à esquerda. Se você estiver visualizando uma campanha específica, esse menu Campanhas não aparecerá. Nesse caso, clique no texto Todas as campanhas na barra superior.

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

Relatório de palavras-chave negativas

Anterior

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

Nova

Para acessar a tabela de palavras-chave negativas mostrada acima, navegue até o menu Palavras-chave à esquerda e selecione a guia PALAVRAS-CHAVE NEGATIVAS na parte superior do gráfico.

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

Anterior

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.

Nova

Para acessar a tabela de canais negativos mostrada acima, navegue até o menu Canais à esquerda e clique na guia EXCLUSÕES na parte superior da página.

Os dados de exclusão 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 programação de anúncios das campanhas

Anterior

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

Nova

Para acessar o Relatório de programação de anúncios da campanha mostrado acima, navegue até o menu Programação de anúncios à esquerda.

Os dados de programação de anúncios da campanha são mapeados para o Relatório de segmentação por programação de anúncios da campanha na API.

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

Anterior

Para acessar o Relatório de local de segmentação da campanha mostrado acima, navegue até a guia superior Configurações e clique na guia interna Locais.

Nova

Para acessar o Relatório de local de segmentação da campanha mostrado acima, navegue até o menu Locais à esquerda. As regiões de segmentação de todas as campanhas serão exibidas. Clique no nome de uma campanha se você quer ver as regiões de apenas uma campanha.

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

Grupos de anúncios

Anterior

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

Nova

Para acessar o Relatório de grupos de anúncios mostrado acima, navegue até o menu Grupos de anúncios à esquerda.

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

Relatório de grupos de produtos

Anterior

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.

Nova

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é o menu Grupos de produtos à esquerda.

O Relatório de grupos de produtos é mapeado para o Relatório de partição de produtos 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

Anterior

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

Nova

Para acessar o Relatório de anúncios mostrado acima, navegue até o menu Anúncios e extensões à esquerda.

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

Relatório de extensões de anúncio

Anterior

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 visualização específica que você quer 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.

Nova

Para acessar o Relatório de extensões de anúncio mostrado acima, navegue até o menu Anúncios e extensões à esquerda e selecione a guia EXTENSÕES na parte superior. Isso mostrará todos os tipos de extensão. Use filtros para exibir apenas as extensões do seu interesse.

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

Relatório de detalhes da chamada

Anterior

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

Nova

Para acessar o Relatório de detalhes da chamada mostrado acima, clique no ícone do gráfico na barra superior, selecione Relatórios predefinidos (anteriormente Dimensões) e clique em Detalhes da chamada no submenu Básico.

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

Relatório de categorias sem palavra-chave

Anterior

Para acessar o Relatório de categorias 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....

Escolher Categorias de nível superior na lista suspensa é equivalente a selecionar "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 de uma categoria no relatório da API.

Nova

Este relatório ainda não está disponível na nova experiência do AdWords.

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

Relatório de consulta sem palavra-chave

Anterior

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

Nova

Para acessar o Relatório de consulta sem palavra-chave mostrado acima, navegue até o menu Segmentações dinâmicas de anúncios à esquerda e selecione TERMOS DE PESQUISA na barra superior.

Os dados da consulta sem palavra-chave são mapeados para o Relatório de consulta sem palavra-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

Anterior

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

Nova

Para acessar o Relatório de palavras-chave mostrado acima, navegue até o menu Palavras-chave à esquerda.

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

Relatório de palavras-chave da Rede de Display

Anterior

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.

Nova

Para acessar o Relatório de palavras-chave da Rede de Display mostrado acima, navegue até o menu Palavras-chave à esquerda e, em seguida, clique na guia PALAVRAS-CHAVE DE ANÚNCIOS EM VÍDEO/REDE DE DISPLAY na barra superior.

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

Anterior

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 estiver definida como Automático mostram os canais que veicularam seus anúncios com base em critérios diferentes dos canais.

Nova

Para acessar o Relatório de seleções automáticas de canais mostrado acima, navegue até o menu Canais à esquerda e, em seguida, até a guia ONDE OS ANÚNCIOS FORAM EXIBIDOS na parte superior.

O Relatório de seleções automáticas de canais é mapeado para o Relatório de desempenho por seleções automáticas de canais na API. Os dados dessas seleções na API só estão disponíveis por meio desse relatório, e não pelo 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

Anterior

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 verifique se todas as opções estão 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 estiver definida como Seleção manual mostram os canais que veicularam seus anúncios com base nos critérios de canais.

Nova

Para acessar o Relatório de seleções manuais de canais mostrado acima, navegue até o menu Canais à esquerda.

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

Anterior

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.

Nova

Para acessar o Relatório de tópicos mostrado acima, navegue até o menu Tópicos à esquerda.

O Relatório de tópicos inclui todas as estatísticas agregadas no nível do tópico e contém 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

Anterior

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.

Nova

Para acessar o Relatório de público-alvo mostrado acima, navegue até o menu Públicos-alvo à esquerda.

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

Relatório de sexo

Anterior

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

Nova

Para acessar o Relatório de sexo mostrado acima, navegue até o menu Informações demográficas à esquerda e, em seguida, clique na guia Sexo na barra superior.

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

Relatório de faixa etária / Relatório de idade

Anterior

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

Nova

Para acessar o Relatório de idade mostrado acima, navegue até o menu Informações demográficas à esquerda e, em seguida, clique na guia IDADE na barra superior.

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

Anterior

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

Nova

Para acessar o Relatório de status parental mostrado acima, navegue até o menu Informações demográficas à esquerda e, em seguida, clique na guia STATUS PARENTAL na barra superior.

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

Relatório de conteúdo principal

Anterior

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.

Nova

Este relatório ainda não está disponível na nova experiência do AdWords.

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

Anterior

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

Nova

Como os URLs de destino foram substituídos pelos URLs finais, esse relatório não está disponível na nova experiência do AdWords.

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

Relatório de URL final

Anterior

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

Nova

Para acessar o Relatório de URL final mostrado acima, clique no ícone do gráfico da barra superior, selecione Relatórios predefinidos (anteriormente Dimensões) e clique em URL final no submenu Básico.

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

Relatório de URL

Anterior

Para acessar o Relatório de URL mostrado acima, navegue até a guia Rede de Display na barra superior 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.

Nova

Este relatório ainda não está disponível na nova experiência do AdWords.

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

Relatório de termos de pesquisa

Anterior

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

Nova

Para acessar o Relatório de termos de pesquisa mostrado acima, clique no ícone do gráfico na barra superior, selecione Relatórios predefinidos (anteriormente Dimensões) e clique em Termos de pesquisa no submenu Básico.

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

Anterior

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

Nova

Para acessar o Relatório pago e orgânico mostrado acima, clique no ícone do gráfico na barra superior, selecione Relatórios predefinidos (anteriormente Dimensões) e clique em Pago e orgânico no submenu Básico.

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

Anterior

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

Nova

Para acessar o Relatório geográfico mostrado acima, navegue até o menu Locais à esquerda, depois clique na guia MAIS na barra superior e, por fim, clique em Relatório 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

Anterior

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

Nova

Para acessar o Relatório de locais do usuário mostrado acima, navegue até o menu Locais à esquerda, depois clique na guia MAIS na barra superior e, por fim, clique em Relatório de 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

Anterior

Para acessar o Relatório de cliques gratuitos mostrado acima, navegue até a guia Dimensões na barra superior e selecione a visualização Cliques gratuitos.

Nova

Para acessar o Relatório de cliques gratuitos mostrado acima, clique no ícone de gráfico na barra superior, selecione Relatórios predefinidos (anteriormente Dimensões) e clique em Cliques gratuitos no submenu Básico.

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ão de criativos na API.

Enviar comentários sobre…

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