Nexopath Guias True Conversions
— Atualizado em

Data Manager API do Google: O Que Muda nas Conversões Offline

O Google introduziu a Data Manager API como o caminho unificado recomendado para enviar dados first-party — conversões offline, conversões otimizadas para leads, Customer Match — para as contas de anúncios do Google. O caminho antigo, via Google Ads API (UploadClickConversions e endpoints equivalentes), passou a ser tratado como legado: novas integrações são direcionadas para a Data Manager API, e integrações existentes devem migrar. Onde a API entra no fluxo completo, ao lado do upload manual e das integrações prontas, está no guia de conversões offline no Google Ads.

Isso não é uma troca cosmética de endpoint. Muda o escopo de autenticação e o processo de aprovação que qualquer time ou ferramenta precisa passar para continuar enviando conversões.

O Que Isso Não É

Até a última atualização deste artigo, não encontramos uma data pública de desligamento do envio de conversões pela Google Ads API para integrações já existentes. Se você encontrar conteúdo afirmando que o caminho antigo “vai parar de funcionar em [data específica]”, confira a fonte antes de planejar em cima disso.

O que está claro é mais útil para planejamento: o caminho recomendado já mudou, e novos integradores são levados à Data Manager API. APIs legadas costumam ganhar uma janela de migração e depois ser cortadas. Migração feita sob pressão de prazo é mais cara e mais arriscada: bugs de normalização passam despercebidos, testes ficam incompletos, e a integração antiga é desligada antes de a nova estar validada.

A pergunta certa não é “quando isso vai quebrar”, é “quanto vai custar migrar quando eu precisar, e por que não fazer agora, com tempo”.

Quem é Afetado, Concretamente

Agências e times com scripts próprios. Se alguém escreveu um script — Python, Node, Apps Script — que chama a Google Ads API diretamente para enviar conversões do CRM, essa integração está no caminho legado. A migração é de quem mantém o script.

Fluxos de Zapier ou Make com ações de Google Ads. Esses fluxos dependem do fornecedor migrar a integração dele. Se o fornecedor atrasar, o fluxo fica preso ao caminho legado sem que o usuário veja isso. Vale perguntar diretamente ao suporte qual é o plano de migração. O comportamento de falha silenciosa desses fluxos já é um problema hoje — veja Zapier e conversões offline: quando funciona, quando vira imposto.

Quem importa conversões por arquivo (CSV ou planilha) na interface do Google Ads não é afetado por esta mudança. O upload pela interface não passa pela API. E, ao contrário do que às vezes se diz, ele aceita dados para conversões otimizadas para leads: o modelo de importação tem colunas de e-mail e telefone, que podem ir com hash. O ponto fraco do arquivo manual é outro — atraso de dias ou semanas entre o marco no CRM e o envio, e a disciplina de alguém repetir o processo sempre. Não ser afetado pela migração não significa que o setup seja bom.

O Que Muda Na Prática

A Data Manager API reúne em um único caminho o que antes eram fluxos separados: conversões offline, conversões otimizadas e audiências. Para quem já tem hashing e normalização corretos, a lógica central do payload não muda de forma radical — e-mail e telefone continuam indo com hash SHA-256, normalizados antes do hash. Os requisitos de normalização (minúsculas, sem espaços, pontos removidos em endereços Gmail, telefone em E.164) são os mesmos — veja LGPD e conversões offline para o detalhamento e a parte legal.

O atrito real está em outro lugar: escopo de OAuth e aprovação. A Data Manager API exige um escopo próprio, e o Google exige aprovação antes de liberar acesso de produção para uma ferramenta de terceiros. Se a sua integração depende de uma ferramenta, o cronograma não depende só de esforço técnico — depende de o fornecedor conseguir essa aprovação.

Um detalhe que pesa para quem atualiza o valor de conversões já enviadas: o ajuste (restatement) continua na Google Ads API. A Data Manager API cobre o envio inicial; quem depende de ajuste de valor vai conviver com as duas APIs.

Caminho antigoData Manager API
Endpoints separados por tipo de dado (conversões, audiências)Caminho unificado
Escopo de OAuth da Google Ads APIEscopo próprio, sujeito a aprovação do Google
Normalização e hashing por conta do integradorMesmos requisitos de normalização, formato de payload distinto
Ajuste de valor de conversões já enviadasNão cobre; continua na Google Ads API
Legado, sem data pública de desligamento para integrações existentesCaminho recomendado para novas integrações

O Que Fazer Agora

Um checklist prático, na ordem em que faz sentido resolver:

  1. Faça o inventário de como suas conversões offline chegam ao Google hoje. Script próprio? Zapier/Make? Arquivo manual? Um middleware dedicado? Sem esse inventário, não dá para saber quem precisa migrar. Se a resposta for “não temos nada rodando ainda”, o ponto de partida é configurar enhanced conversions sem desenvolvedor — já no caminho novo.
  2. Se depende de uma ferramenta terceira, pergunte qual é o plano de migração — e se o escopo da Data Manager API já está aprovado pelo Google ou ainda em processo. Resposta vaga é sinal de risco.
  3. Se depende de script próprio, trate a migração como item de backlog com prioridade — não urgência, mas também não algo a ignorar. Orçar o trabalho agora custa menos do que migrar sob pressão.
  4. Se está construindo uma integração nova, não construa sobre o caminho legado. Qualquer integração nova deve mirar a Data Manager API diretamente.

Onde o True Conversions Está Nessa Transição

O True Conversions já envia pela Data Manager API: o escopo foi aprovado pelo Google em julho de 2026, e desde 14 de julho de 2026 a produção usa esse caminho. A escolha é feita por conexão: contas que autorizaram o escopo datamanager enviam pela Data Manager API; conexões mais antigas, autorizadas só com o escopo da Google Ads API, continuam funcionando pelo caminho anterior e passam para o novo quando alguém clica em Reautorizar. As chaves de correspondência (GCLID e e-mail/telefone com hash) são as mesmas nos dois caminhos, então a troca de API não muda a taxa de correspondência por si só.

Para quem usa um middleware dedicado, essa migração é responsabilidade do fornecedor, não do usuário final — o mesmo raciocínio que vale para hashing, retry e deduplicação. O trade-off é o inverso do script próprio: você depende de o fornecedor priorizar a migração, mas não aloca tempo de desenvolvimento interno.

Próximo Passo

Veja como funciona a infraestrutura server-side do True Conversions, que já envia conversões offline pela Data Manager API. São 60 dias grátis, sem cartão, a partir de R$49/mês.