DocumentaçãoExperience PlatformGuia dos conectores de origem

[beta]{class="badge informative"}

Google Ads

Última atualização: 29 de julho de 2026

Criado para:

  • {"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

O Google Ads é a plataforma de publicidade online da Google que ajuda você a alcançar clientes em potencial nos sites de Pesquisa, YouTube, Mapas e parceiros. Você pode direcionar o público-alvo correto, controlar seu orçamento e rastrear resultados para gerar conscientização, leads e vendas.

Use a origem Google Ads para autenticar na API Google Ads, conectar contas de anunciante ou hierarquias de conta de gerente e assimilar dados de relatórios na Experience Platform para análise downstream e fluxos de trabalho de ativação.

IMPORTANT
A origem Google Ads na interface do usuário do Experience Platform está atualmente na versão beta e oferece suporte apenas para assimilação única. Para assimilação incremental, use a conexão baseada em API e o fluxo de dados.

Pré-requisitos

Antes de conectar sua conta do Google Ads à Experience Platform, verifique se os seguintes requisitos foram atendidos.

INCLUO NA LISTA DE PERMISSÕES de endereços IP

Você deve adicionar endereços IP específicos da região ao incluo na lista de permissões antes de conectar suas fontes à Experience Platform. Para obter mais informações, leia o guia sobre como ler os endereços IP de incluir na lista de permissões para se conectar ao Experience Platform para obter mais informações.

Configurar permissões no Experience Platform

Você deve ter as permissões Exibir Fontes e Gerenciar Fontes habilitadas para sua conta a fim de conectar sua conta do Google Ads à Experience Platform. Entre em contato com o administrador do produto para obter as permissões necessárias. Para obter mais informações, leia o guia da interface do usuário de controle de acesso.

Você deve ter credenciais de API Google Ads válidas e acesso à conta Google Ads da qual deseja ler. Se a conta do anunciante de destino for gerenciada por meio de uma MCC (conta de gerente) Google Ads, a conexão também deverá incluir a ID de cliente de logon correta, para que as solicitações possam ser roteadas por meio da hierarquia de gerente adequada.

Na prática:

  • Se a conta do anunciante de destino for diretamente acessível pelo usuário autorizado por OAuth, loginCustomerId pode não ser necessário.
  • Se a conta do anunciante estiver acessível somente por meio de uma hierarquia MCC, loginCustomerId deverá identificar a conta de gerente usada para acessar essa conta filha.
  • Um loginCustomerId incorreto ou ausente pode resultar em falhas de autorização ao tentar consultar contas secundárias gerenciadas.

Coletar credenciais necessárias

Para conectar Google Ads ao Experience Platform, você deve fornecer valores para as seguintes propriedades de conexão.

Credencial
Descrição
clientCustomerId
O número da conta de cliente Google Ads que você deseja gerenciar com a API Google Ads. Normalmente, essa ID segue o formato 123-456-7890.
loginCustomerId
O número da conta de gerente Google Ads usada para buscar dados de relatório para um cliente operacional específico. Isso é necessário quando o acesso à conta de destino é mediado por uma hierarquia MCC.
developerToken
O token do desenvolvedor usado para acessar a API Google Ads. Um único token de desenvolvedor pode ser usado em contas do Google Ads que seu aplicativo está autorizado a acessar.
refreshToken
O token de atualização OAuth 2.0 usado para obter novos tokens de acesso após a expiração.
clientId
A ID do cliente OAuth 2.0 associada ao aplicativo do Google.
clientSecret
O segredo do cliente OAuth 2.0 associado ao aplicativo do Google.
googleAdsApiVersion
A versão da API Google Ads usada pelo conector. Atualmente, o Experience Platform oferece suporte à versão v19 e mais recente.
connectionSpec.id
A ID de especificação de conexão Google Ads necessária para solicitações de API de Serviço de Fluxo: d771e9c1-4f26-40dc-8617-ce58c4b53702.

SobreloginCustomerId

O valor loginCustomerId é um dos campos de configuração mais importantes na origem Google Ads.

Usar loginCustomerId quando:

  • O usuário autorizado OAuth tem acesso por meio de uma conta de gerente,
  • A conta do anunciante de destino é uma conta filho em um MCC,
  • A conta não é retornada diretamente como uma conta acessível de nível superior.

Não defina loginCustomerId desnecessariamente para contas de anunciante diretamente acessíveis. Quando possível, valide se a conta está diretamente acessível primeiro e forneça apenas uma ID de gerente quando o acesso realmente depender dessa hierarquia.

Comportamento de autenticação e conexão

A origem Google Ads usa OAuth 2.0 para autenticar solicitações na API Google Ads. O Experience Platform armazena os detalhes da conexão em uma conexão base e usa as credenciais fornecidas para autorizar chamadas de API Google Ads em nome do cliente.

Para cenários de conta de gerente, o conector pode precisar resolver a hierarquia de gerente apropriada para acessar com êxito a conta de anunciante de destino. Internamente, isso normalmente envolve:

  1. Enumerando contas acessíveis,
  2. Determinar se uma conta é uma conta de gerente,
  3. Identificação de contas de folha que não sejam do gerente,
  4. Resolução do loginCustomerId correto quando a conta de destino puder ser acessada somente por meio de uma hierarquia MCC.

Esse comportamento é especialmente importante para clientes que gerenciam várias contas de anunciante de uma única estrutura de conta de gerente.

Seleção de dados e comportamento de relatório

A seleção de dados Google Ads baseia-se em Google AdsGAQL (Linguagem de Consulta). Durante a configuração, você especifica os atributos, segmentos e métricas que devem ser recuperados para assimilação.

Para extrações de relatórios grandes, o Google Ads oferece suporte aos padrões de pesquisa padrão e recuperação de streaming. Internamente, a recuperação de transmissão é preferida para conjuntos de resultados maiores, pois permite que as linhas de relatório sejam consumidas de forma incremental, em vez de página em buffer por página.

Ao configurar a seleção de dados na interface do Experience Platform, use o Google AdsConstrutor de Consultas para escolher o tipo de recurso e os campos que deseja assimilar, validar a consulta e copiar os atributos necessários no fluxo de trabalho de origem.

Caminhos de conexão compatíveis

Você pode conectar Google Ads ao Experience Platform usando APIs ou a interface do usuário.

Uso de APIs

Use a Flow Service API quando precisar de configuração programática, configuração repetível ou suporte para assimilação incremental. Em um nível superior, o fluxo de trabalho da API inclui:

  1. Criação de uma conexão básica,
  2. Explorando a configuração de origem,
  3. Criação de conexão de origem e destino,
  4. Criação de um fluxo de dados para assimilação

Uso da interface

Use o espaço de trabalho de Fontes do Experience Platform para obter uma configuração guiada quando quiser conectar Google Ads por meio da interface. O fluxo da interface do usuário oferece suporte à entrada de credenciais, seleção de atributos, visualização e criação de fluxos de dados. No momento, o caminho da interface do usuário permanece beta e oferece suporte somente à assimilação única.

Limitações e observações conhecidas

  • Atualmente, a origem Google Ads na interface do usuário é beta.
  • Atualmente, a interface do usuário do oferece suporte somente à assimilação única.
  • Use o caminho baseado em API para assimilação incremental.
  • Atualmente, o Experience Platform oferece suporte à API Google Ads versão v19 e mais recente.
  • As hierarquias de conta de gerente exigem manipulação cuidadosa de loginCustomerId; valores incorretos podem impedir o acesso a contas de anunciante filho.

Próximas etapas

Depois de obter as credenciais e confirmar o padrão de acesso à conta, continue com um dos seguintes caminhos de configuração:

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