DocumentaçãoExperience PlatformGuia dos conectores de origem

Google Ads (V2)

Última atualização: 2 de outubro de 2026

Criado para:

  • Developer
IMPORTANT
A origem Google Ads está disponível como parte da SKU Customer Journey Analytics.

Google Ads (V2) é um conector de origem de mídia paga da Adobe Experience Platform que assimila dados de conta de publicidade, campanha, grupo de publicidade, anúncio, ativo, experiência e desempenho da API Google Ads na Experience Platform.

O conector mapeia os dados do Google Ads para estruturas padronizadas do Experience Data Model (XDM) de mídia paga, permitindo que você analise os dados do Google Ads junto com dados de outras redes de publicidade, propriedades da Web, sistemas de comércio e aplicativos do cliente.

Google Ads (V2) usa acesso somente leitura para recuperar dados de relatórios e metadados de publicidade. Ele não cria, modifica ou exclui Google Ads recursos.

Casos de uso de exemplo

Caso de uso
Meta
Como o Google Ads (V2) ajuda
Análise de publicidade entre canais
Comparar o desempenho de Google Ads com Meta Ads e outros canais de mídia paga.
Assimila dados Google Ads em estruturas XDM de mídia paga comuns com identificadores padronizados em cada nível de entidade.
Modelagem e atribuição de mix de mídia
Avaliar a contribuição da mídia paga para os resultados dos negócios.
Fornece dados de desempenho da campanha e de anúncios, incluindo impressões, cliques, gastos, conversões e valor de conversão para análise de downstream.
Otimização de campanha e orçamento
Entenda quais campanhas, estratégias de lance e configurações de direcionamento produzem os melhores resultados.
Assimila metadados de campanha, orçamentos, estratégias de lance, tipos de canal, status, datas e critérios de direcionamento selecionados.
Creative e desempenho de ativos
Identifique quais ativos criativos, formatos de anúncio e experiências têm melhor desempenho.
Assimila metadados criativos no nível do anúncio, incluindo associações de ativos, tipos e rótulos de desempenho.
Análise de desempenho máximo
Analisar grupos de ativos Desempenho máximo e seus ativos associados.
Usa os dados de Desempenho máximo do grupo de ativos para representar o desempenho do grupo de ativos e as relações de experiência em que o Google Ads não expõe uma estrutura de nível de anúncio tradicional.
Análise de jornada do cliente
Relacione o envolvimento de publicidade com a Web, comércio, CRM e outros eventos do cliente.
Disponibiliza os dados do Google Ads no Experience Platform para uso com fluxos de trabalho downstream de análise e ativação.

Pré-requisitos

Antes de conectar Google Ads (V2) ao Experience Platform, verifique se você tem o seguinte:

Configurar permissões no Experience Platform

Você deve ter as permissões Exibir Fontes e Gerenciar Fontes habilitadas para sua conta da Experience Platform.

Entre em contato com o administrador do produto se você não tiver as permissões necessárias. Para obter mais informações, leia o guia da interface do usuário de controle de acesso.

Configurar o acesso à API Google Ads

O Experience Platform gerencia o fluxo de autorização OAuth 2.0 para Google Ads (V2). Você não cria um projeto da Google Cloud, um cliente OAuth ou não atualiza o token.

Você deve ter:

  • Um token de desenvolvedor Google Ads válido.
  • Acesso à conta de anunciante Google Ads que você deseja assimilar.
  • Permissão para acessar as contas de anunciante relevantes por meio de uma conta de gerente Google Ads ou Google Ads.

Acesso de gerente de conta

Se a conta do anunciante for acessada por meio de uma conta de gerente Google Ads, forneça também a ID de cliente de gerente apropriada como loginCustomerId.

O loginCustomerId não é necessário quando o usuário autorizado OAuth pode acessar diretamente a conta de anunciante de destino e nenhuma hierarquia de gerente é necessária.

O Google Ads (V2) enumera contas acessíveis, identifica contas de gerente, percorre a hierarquia de conta de gerente e resolve as contas de anunciante disponíveis para assimilação.

Coletar credenciais necessárias

Para conectar Google Ads (V2) ao Experience Platform, forneça os seguintes valores.

Credencial
Descrição
developerToken
O token de desenvolvedor Google Ads usado para autorizar solicitações de API.
loginCustomerId
A ID numérica do cliente da conta de gerente usada para acessar a conta de anunciante. Essa credencial é necessária para acesso de gerente de conta.

Autenticação e descoberta de conta

Google Ads (V2) usa o OAuth 2.0 para autorizar o acesso à API Google Ads. O Experience Platform gerencia o fluxo de autorização para que você não configure escopos ou permissões OAuth no lado Google Ads.

Após autorizar sua conta, a Experience Platform usa o token do desenvolvedor para acessar os recursos de relatórios do Google Ads. Para configurações de conta de gerente, o conector resolve a hierarquia da conta e identifica as contas do anunciante disponíveis para assimilação.

O fluxo de trabalho de descoberta de conta inclui as seguintes operações:

  1. Enumerar contas acessíveis ao usuário autorizado.
  2. Determine se uma conta acessível é uma conta de gerente.
  3. Percorra a hierarquia de conta do gerente.
  4. Identifique contas de anunciante que não são gerentes.
  5. Use o loginCustomerId apropriado quando as solicitações forem roteadas por meio da hierarquia de conta de gerente.
  6. Recupere metadados da conta, como ID da conta, nome da conta, moeda e fuso horário.

Google Ads (V2) executa operações de API somente leitura. Ele não emite solicitações de mutação, criação, atualização ou exclusão contra recursos Google Ads.

Seleção e assimilação de dados

O Google Ads (V2) usa o GAQL (Linguagem de Consulta) do Google Ads para recuperar metadados de conta, metadados de campanha e dados de relatórios.

O conector usa consultas específicas de recursos para recuperar os atributos, segmentos e métricas necessários para cada entidade. O conector usa SearchStream para recursos de relatórios e grandes conjuntos de resultados em que o processamento incremental de linhas é benéfico.

O inventário de consultas compatível inclui recursos como:

  • customer
  • customer_client
  • campaign
  • campaign_budget
  • campaign_criterion
  • geo_target_constant
  • ad_group
  • ad_group_criterion
  • ad_group_ad
  • ad_group_ad_asset_view
  • ad_group_ad_asset_combination_view
  • asset
  • asset_group
  • asset_group_asset
  • change_status

As métricas de desempenho são recuperadas usando segmentos baseados em data, como segments.date.

Configuração do esquema

O Google Ads (V2) mapeia os dados de origem para estruturas XDM de mídia paga padronizadas. O conector organiza os dados por nível de entidade para que os metadados e as métricas de desempenho possam ser unidos em registros de conta, campanha, grupo de anúncios, anúncio, ativo e experiência.

Entidade
Recursos Google Ads principais
Dados representados
Conta
customer, customer_client
ID da conta, nome da conta, moeda, fuso horário, status do gerente e metadados da conta.
Campaign
campaign, campaign_budget, campaign_criterion
Nome da campanha, status, canal de publicidade, subtipo, objetivo, orçamentos, estratégia de lances, datas, rastreamento de URL e configuração de direcionamento.
Grupo de publicidade
ad_group, ad_group_criterion
ID do grupo de anúncios, nome, status, ofertas, direcionamento, palavras-chave, disposições e relacionamento de campanha.
Anúncio
ad_group_ad
ID do anúncio, tipo de anúncio, conteúdo criativo, URLs de destino, status da entrega, política e informações de revisão e relacionamentos entre campanhas e grupos de anúncios.
Ativo
asset, ad_group_ad_asset_view, asset_group_asset
ID do ativo, tipo de ativo, texto, metadados de imagem ou vídeo, dimensões, uso, rótulo de desempenho e anúncios ou campanhas associadas.
Experiência
ad_group_ad_asset_combination_view, asset_group, asset_group_asset
Composição criativa derivada, ativos servidos, títulos, descrições, planos de ação, URLs de página inicial e relacionamentos de experiência.
Métricas de resumo
Campos metrics.* específicos do recurso e segments.date
Impressões no nível da data, cliques, gastos, conversões, valor de conversão, CTR, CPC, CPM, métricas de vídeo e outras medidas de desempenho compatíveis.

Convenções do identificador

O mapeamento V2 define identificadores qualificados de plataforma para entidades de mídia paga. Por exemplo:

  • O conector deriva identificadores de conta da ID de cliente Google Ads.
  • Os identificadores de campanha combinam a ID do cliente Google Ads e a ID da campanha.
  • O grupo de anúncios e os identificadores de anúncios incluem a hierarquia principal.
  • Os identificadores de ativos combinam a ID do cliente Google Ads e a ID do ativo.
  • O conector deriva os identificadores de experiência da combinação criativa ou do contexto do grupo de ativos.
  • Os caminhos de hierarquia representam o relacionamento entre entidades de conta, campanha, grupo de anúncios, anúncio, experiência e ativo.

Dados de desempenho máximo

Desempenho Máximo de campanhas nem sempre expõem os mesmos relacionamentos de entidade que os tipos de campanha tradicionais.

Para dados de Desempenho máximo:

  • asset_group representa o agrupamento principal de ativos.
  • asset_group_asset representa relações ativo-para-grupo.
  • As métricas do grupo de ativos fornecem o contexto necessário para analisar o desempenho do ativo.
  • Os grupos de ativos atuam como um proxy de experiência quando uma entidade de experiência nativa não está disponível.

Limitações e considerações de dados

Considere as limitações a seguir ao planejar a implementação do Google Ads (V2).

Suporte a métricas específicas a recursos

Google Ads não expõe todas as métricas para cada recurso. Por exemplo, alguns recursos não são compatíveis com métricas ou segmentos, enquanto outros são compatíveis apenas com um conjunto limitado de métricas.

A disponibilidade da métrica também varia entre consultas de anúncio, ativo, experiência, campanha e Desempenho máximo.

Registros de experiência derivados

Google Ads não fornece uma única entidade de experiência universal equivalente ao modelo de experiência usado pelos esquemas XDM de mídia paga.

O conector deriva os registros de experiência dos dados de anúncio, combinação de ativos e grupo de ativos disponíveis.

Metadados de vídeo

A API Google Ads fornece identificadores de vídeo e referências de ativos relacionados. No entanto, algumas propriedades de mídia, como duração do vídeo, codec, taxa de bits, taxa de quadros e presença de áudio, não estão diretamente disponíveis por meio da API Google Ads.

Esses campos são nulos, a menos que um serviço de enriquecimento aprovado seja adicionado.

Disponibilidade de ativos

Os metadados de ativos e o suporte ao desempenho variam de acordo com o tipo de ativo. Por exemplo, os metadados de imagem e texto estão disponíveis diretamente, enquanto algumas propriedades de vídeo exigem enriquecimento adicional.

Campos específicos do Google

Google Ads conceitos sem um equivalente XDM de mídia paga direta são representados usando additionalDetails ou definidos como nulos, de acordo com o mapeamento aprovado.

Mapeamentos de enumeração

O conector mapeia Google Ads valores de enumeração de API para valores XDM usando correspondências exatas, correspondências semânticas de fechamento ou valores de fallback aprovados. Valores incompatíveis, desconhecidos, obsoletos ou não especificados são ignorados ou definidos como nulos.

Próximas etapas

Depois de confirmar suas credenciais do Google Ads e o modelo de acesso à conta, continue criando uma conexão com o Google Ads usando a interface do usuário do Experience Platform.

recommendation-more-help
experience-platform-help-sources