True Conversionsby Nexopath

Conectando o Google Ads

O Google Ads se conecta via OAuth. Depois de autorizar, você informa o Customer ID e a ação de conversão para onde o True Conversions deve enviar as conversões correspondidas via Enhanced Conversions for Leads.

Pré-requisitos

Faça isto antes de conectar — é a causa mais comum de "conectei tudo e nada chega no Google":

  1. Uma conta Google Ads com acesso de administrador ou padrão.
  2. Uma ação de conversão criada, do tipo Import → Other data sources or CRMs (veja o Passo 2 abaixo).
  3. "Conversões otimizadas para leads" ativada + termos de dados aceitos (veja abaixo). Sem isso, todo envio falha com o erro CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS.
  4. A ação de conversão deve ser exclusiva do True Conversions — não reutilize uma ação que sua tag do site (Google Ads Tag / GTM) já dispara. Se a mesma ação receber conversões de duas fontes, elas se somam e inflam os resultados.

Ativando "Conversões otimizadas para leads"

  1. No Google Ads, vá em Metas → Conversões → Configurações.
  2. Ative "Conversões otimizadas para leads".
  3. Aceite os termos de dados do cliente quando solicitado.

A interface do Google (desde abr/2026) só oferece o método "Tag do Google / GTM" nessa tela — não existe mais uma opção separada de "API". Ativar com a opção de tag é suficiente: o Google aceita envios por tag e por API juntos assim que o recurso está ativado na conta. Você não precisa instalar nada além do que já está aqui.

Passo 1: Autorizar o Google Ads

  1. No painel do True Conversions, abra a conta (cliente).
  2. Clique em Integrações de anúncios.
  3. No card do Google Ads, clique em Conectar Google Ads.
  4. Selecione a conta Google que tem acesso à conta Google Ads desejada.
  5. Revise as permissões e autorize.
  6. Você será redirecionado de volta ao True Conversions com uma mensagem de sucesso.

Passo 2: Configurar a integração

Customer ID

O ID da conta Google Ads, no canto superior direito da interface do Google Ads (formato 123-456-7890, com ou sem traços).

ID da conta de administrador (opcional)

Preencha apenas se você acessa a conta Google Ads por uma MCC (Manager Account). Deixe em branco se acessa diretamente.

Ação de conversão

Clique em Carregar ações para buscar as ações de conversão disponíveis na conta e selecione a correta na lista.

Se ainda não existir uma ação de conversão:

  1. No Google Ads, vá em Metas → Conversões → Resumo.
  2. Clique em Nova ação de conversão.
  3. Selecione Importar → Outras fontes de dados ou CRMs → Rastrear conversões de cliques.
  4. Dê um nome só para o True Conversions (ex.: "TC - CRM") — lembre-se, esta ação precisa ser exclusiva (veja Pré-requisitos).
  5. Configure valor, contagem e janela de atribuição conforme necessário.
  6. Salve, volte ao True Conversions e clique em Carregar ações para selecioná-la.

O botão Salvar configuração só fica habilitado depois que Customer ID e ação de conversão estiverem preenchidos. Enquanto a ação de conversão não for escolhida, a etapa 2 · Plataforma de anúncios do checklist da conta mostra "Conectado — falta configurar" em âmbar — o Google está autorizado, mas nenhum envio vai funcionar até você concluir esta parte. Um aviso âmbar equivalente aparece nesta página, abaixo do campo de ação de conversão, até que uma seja selecionada.

Como funciona

Quando o True Conversions processa um evento de conversão:

  1. O PII do contato (email, telefone, nome) recebe hash SHA-256.
  2. Se houver um gclid mapeado (veja Mapeamento de campos), ele é incluído como sinal principal de correspondência — mas não é obrigatório: sem ele, o Google ainda tenta correspondência pelo PII hashado.
  3. Os dados hashados e os detalhes da conversão (valor, moeda, timestamp) são enviados via Google Ads API.
  4. Se a conta usa Otimização de valor, o valor evolui conforme o negócio avança pelas etapas, e é reafirmado automaticamente até o Fechado-Ganho.

O resultado da entrega fica visível em Eventos recentes, na página da conta, e resumido em Envios e qualidade.

Re-autorização

Se o token OAuth expirar, o status mostrará Expirada com um aviso na página de Integrações de anúncios ("Token expirado. Reautorize para restaurar a conexão."). Clique em Reautorizar — Customer ID e ação de conversão são preservados.

Desconectando

Clique em Desconectar no card do Google Ads. Isso remove as credenciais e configurações armazenadas no True Conversions. Nada é alterado na conta Google Ads.

Problemas comuns

Veja a tabela de erros de entrega em Solução de problemas — inclui o passo a passo para CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS e outros erros do Google.