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 antigo | Data Manager API |
|---|---|
| Endpoints separados por tipo de dado (conversões, audiências) | Caminho unificado |
| Escopo de OAuth da Google Ads API | Escopo próprio, sujeito a aprovação do Google |
| Normalização e hashing por conta do integrador | Mesmos requisitos de normalização, formato de payload distinto |
| Ajuste de valor de conversões já enviadas | Não cobre; continua na Google Ads API |
| Legado, sem data pública de desligamento para integrações existentes | Caminho recomendado para novas integrações |
O Que Fazer Agora
Um checklist prático, na ordem em que faz sentido resolver:
- 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.
- 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.
- 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.
- 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.