Google Ads Data Manager API: razões para acompanhar o tema

A Google Ads Data Manager API automatiza o envio de conversões offline, substituindo uploads manuais de CSV. Se você gerencia campanhas e precisa provar quais leads e vendas vieram dos anúncios, essa API reduz erros, acelera a atribuição e melhora os dados para lances automáticos. Diferente do upload manual, ela permite integração direta com CRMs e sistemas de agendamento, enviando conversões em tempo real ou lotes frequentes.

O que é a Google Ads Data Manager API?

É uma interface RESTful que conecta CRMs, plataformas de agendamento e sistemas de vendas diretamente ao Google Ads, sem planilhas ou scripts. Ela faz parte do Google Ads Data Manager, central para gerenciar conversões offline, enhanced conversions e dados de primeira parte. A autenticação usa OAuth 2.0 e o endpoint principal é https://googleads.googleapis.com/v15/customers/{customer_id}/conversionActions:upload. Cada requisição envia um array de conversões com campos obrigatórios como gclid, conversionDateTime e conversionValue.

Por que isso importa para quem roda Google Ads?

Enviar conversões offline manualmente via CSV ou Google Sheets é frágil: dados desatualizados, erros de formatação, GCLIDs perdidos e atrasos na otimização são comuns. Um exemplo concreto: uma agência de leads para seguros perdia 30% das conversões por GCLID não capturado em formulários. Após integrar a Data Manager API via Apointoo, passou a enviar cada lead qualificado em minutos, melhorando o ROAS em 20% nos primeiros 30 dias. A API automatiza esse fluxo, enviando cada lead qualificado, agendamento ou venda em tempo real ou lotes frequentes. Isso melhora a atribuição e permite que lances automáticos (CPA ou ROAS) aprendam com dados mais precisos.

Problemas comuns que a Data Manager API resolve

• GCLID perdido: Quando o lead preenche um formulário sem capturar o GCLID, a conversão offline não pode ser atribuída ao clique correto. A API permite enviar o GCLID junto com a conversão, desde que capturado no site via parâmetro gclid na URL. Tecnicamente, o GCLID é extraído do cookie _gcl_aw ou do parâmetro da URL e armazenado no CRM. Na chamada da API, o campo gclid é enviado como string.
• UTMs apagadas: Muitas ferramentas de formulário cortam UTMs ou GCLID da URL. Com a API, você pode enviar conversões com identificadores únicos (email ou phone) para matching via enhanced conversions, usando hash SHA-256.
• Leads sem origem: Sem integração direta, leads de formulários ficam sem rastreamento de campanha. A API conecta o lead ao anúncio original via click ID ou identificadores de usuário, permitindo atribuição first-touch ou last-touch.

Como funciona na prática?

Um usuário clica no anúncio, visita o site e preenche um formulário de agendamento. O GCLID é capturado e armazenado no CRM. Dias depois, o lead vira cliente. Com a Data Manager API, você envia essa conversão de volta ao Google Ads informando: GCLID, horário da conversão, valor da venda e dados de enhanced conversions (email com hash). O Google Ads atribui a venda ao clique original, mesmo após dias. Exemplo de payload JSON:

{ "conversions": [{ "gclid": "EAIaIQobChMI…", "conversionDateTime": "2024-03-15 14:30:00", "conversionValue": 150.00, "currencyCode": "BRL", "userIdentifiers": [{"hashedEmail": "a1b2c3d4e5f6…"}] }] }

Data Manager API vs. upload manual: diferenças principais

CaracterísticaUpload manual (CSV)Data Manager APIFrequênciaDiária ou semanalEm tempo real ou lotes frequentesErros de formataçãoComunsReduzidos (validação automática)EscalabilidadeLimitadaAlta (milhares de conversões)Integração com CRMManualAutomática via APICusto de implementaçãoBaixo (planilha)Médio (requer desenvolvimento ou plataforma parceira)Complexidade técnicaBaixaMédia (requer OAuth e endpoints REST)

Quando você deve começar a usar?

Se você já envia conversões offline manualmente e enfrenta atrasos ou erros, ou se quer melhorar a qualidade dos dados para otimização de lances, a Data Manager API é o próximo passo. Ferramentas como Apointoo já se integram a essa API para conectar cliques, formulários, agendamentos e receita diretamente ao Google Ads, eliminando uploads manuais.

FAQ

Como lidar com GCLIDs ausentes?

Se o GCLID não foi capturado, use enhanced conversions com identificadores como email ou telefone com hash. A API aceita userIdentifiers para matching probabilístico.

Preciso de um desenvolvedor para implementar?

Sim, a implementação direta exige conhecimento de OAuth 2.0 e REST APIs. Alternativamente, plataformas como Apointoo oferecem integração pronta, sem código.

A API suporta conversões offline com valor variável?

Sim, o campo conversionValue aceita valores decimais, permitindo enviar o valor exato da venda ou lead.

Quanto tempo leva para a conversão aparecer no Google Ads?

Com a API, as conversões podem aparecer em minutos ou horas, dependendo da configuração. O Google processa lotes a cada 30 minutos em média.

Próximos passos

Solicite acesso ao Apointoo se você já roda campanhas em Google Ads e precisa provar quais conversões viraram receita. Nossa plataforma conecta clique, lead, agendamento, venda e receita de volta ao Google Ads usando a Data Manager API e outras integrações.