Integração da API de Conversões do Google Ads (CAPI)

Visão geral

Quando alguém clica em um anúncio do Google, o Google adiciona um identificador de clique (GCLID) ao URL de destino, e a AffClix o armazena junto com o clique. Quando esse clique gera uma conversão depois — uma venda, um lead, um cadastro — e a conversão é aprovada, a AffClix a envia ao Google Ads com o mesmo GCLID, pela importação de conversões off-line do Google.

A configuração é feita uma vez por ação de conversão: você conecta sua conta do Google, escolhe a conta do Ads e a ação de conversão em uma lista e define quais metas enviar. Não é preciso instalar código no site do anunciante nem criar credenciais OAuth ou token de desenvolvedor.

Por que esta integração é importante

• Lances baseados em resultados reais — o Smart Bidding (Maximizar conversões, CPA desejado, ROAS desejado) aprende com as vendas que seus parceiros fecham, não com cliques.
• Conversões que uma tag de navegador não vê — vendas confirmadas depois, off-line ou em outro dispositivo também chegam ao Google.
• Imune a bloqueadores e limites de cookies — o envio é de servidor para servidor, então ITP, banners de consentimento e bloqueadores não conseguem perdê-lo.
• Apenas conversões aprovadas — conversões pendentes, rejeitadas ou com corte nunca são enviadas, então o Google otimiza com a receita que você de fato mantém.
• Valores de receita reais — cada envio inclui o valor da venda e a moeda, para que o ROAS desejado trabalhe com números reais.
• Sem duplicatas — cada conversão é enviada uma única vez por destino e, quando há um ID de pedido, o Google descarta qualquer repetição.
• Histórico completo — cada tentativa é registrada com a resposta do Google no relatório CAPI Delivery.

Pré-requisitos

• Um plano da AffClix que inclua Conversions API. Se Integrations → Conversions API não aparece no seu menu, seu plano não inclui o recurso.
• Uma conta do Google com acesso pelo menos Padrão à conta do Google Ads que veicula os anúncios.
• A codificação automática ativada nessa conta do Google Ads, para que cada clique em anúncio tenha um GCLID.
• Uma ação de conversão off-line do tipo Track conversions from clicks (acompanhar conversões de cliques) — veja a etapa 1.
• Tráfego do Google Ads que chegue ao anunciante por um link de rastreamento da AffClix, para que a AffClix registre o clique e o GCLID.
• Conversões desse tráfego chegando à AffClix por postback, pixel ou integração de e-commerce, e aprovadas.

Assista ao passo a passo

Etapa 1: Crie uma ação de conversão off-line no Google Ads

O Google só aceita conversões off-line em uma ação de conversão criada para recebê-las. Os outros tipos — tags de site, app, ligações — não aparecem na lista da AffClix.

Etapa 2: Conecte o Google Ads na AffClix

01

Abra Conversions API

No painel da AffClix, acesse Integrations → Conversions API e clique em Add destination.

02

Escolha o Google Ads

Selecione o bloco Google Ads. O formulário abaixo é montado para a plataforma escolhida; Change platform leva de volta aos blocos.

03

Dê um nome ao destino e defina o escopo

Use um nome como Google Ads – Vendas. Deixe Campaign ID vazio para enviar as conversões de todas as campanhas, ou informe o ID de uma campanha para enviar só as dela. API version e Timeout podem ficar no padrão.

04

Conecte o Google Ads

Clique em Connect Google Ads e faça login com a conta do Google que tem acesso à conta do Ads. O Google mostra o acesso solicitado pela AffClix — seus dados do Google Ads, que a AffClix usa apenas para listar suas contas e ações de conversão e para enviar conversões. Aprove e você volta ao formulário. A AffClix nunca vê sua senha do Google.

05

Escolha a conta e a ação de conversão

Selecione a Google Ads account e depois a Conversion action criada na etapa 1. O indicador de etapas no topo do card fica verde conforme cada etapa é concluída.

Etapa 3: Escolha quais metas enviar

Cada destino envia para exatamente uma ação de conversão do Google. O mapa de eventos define quais das suas metas da AffClix são enviadas para ela.

01

Mapeie as metas

Em Event Mapping & Matching, escolha uma meta em Your goal — a lista mostra as metas ativas do seu espaço de trabalho; digite para pesquisar — e informe um rótulo em Platform event, por exemplo Purchase. No Google o rótulo serve só como referência; o Google registra a ação de conversão escolhida na etapa 2.

02

Envie tudo ou só algumas metas

O mapeamento padrão, *, envia todas as conversões aprovadas. Para enviar só vendas, substitua-o por uma única linha com a sua meta de venda. Uma meta sem linha própria, e sem linha *, não é enviada.

03

Mantenha Click IDs selecionado

Em Match keys to send, deixe todas as chaves desmarcadas — assim todos os sinais disponíveis são enviados — ou confirme que Click IDs está marcado. O Google vincula apenas pelo ID do clique.

Etapa 4: Salve e teste

Exemplo real

Uma loja de eletrônicos veicula anúncios de pesquisa no Google que levam os compradores à loja por um link de rastreamento da AffClix. Ela configura um destino, “Google Ads – Vendas”, mapeado para sua meta de venda.

1. Um comprador clica no anúncio. O Google adiciona gclid=Cj0KCQ… ao URL e a AffClix o armazena junto com o clique.
2. Dois dias depois, o comprador compra um notebook por ₹24.999. O postback da loja registra a venda na AffClix, aguardando revisão.
3. O anunciante aprova a venda. A AffClix a envia imediatamente ao Google Ads com o GCLID, o valor 24.999 e a moeda INR.
4. O Google atribui a compra ao clique original no anúncio, e o ROAS desejado passa a dar lances nessa pesquisa com o valor real da venda por trás.

Resultado: o Google Ads informa as vendas que a loja de fato manteve — devoluções e pedidos rejeitados nunca são enviados — e os lances melhoram nas pesquisas que geram receita.

Gerenciar e monitorar a integração

• Pausar sem excluir — use o botão na linha do destino ou desative Active no formulário.
• Alterar o que é enviado — edite o destino quando quiser; o novo mapeamento vale para as conversões aprovadas a partir de então.
• Alertas de credenciais — a AffClix verifica cada destino a cada hora. Se o Google começar a rejeitar os envios porque o acesso foi removido ou revogado, a linha mostra Reconnect credentials e o proprietário do espaço de trabalho recebe um e-mail.
• Reconectar — abra o destino e clique em Reconnect Google Ads. A conta, a ação de conversão e o mapeamento continuam como estão.
• Status de CAPI em cada conversão — quando existe um destino, o relatório de conversões ganha uma coluna CAPI com Delivered, Failed ou Partial.

Registros do CAPI Delivery

Cada tentativa de envio é registrada em Reports → Delivery Logs → CAPI Delivery. Filtre por data, plataforma, destino e status.

Solução de problemas

Avançado: use seu próprio projeto do Google Cloud

Agências que gerenciam o acesso ao Google Ads com o próprio projeto do Google Cloud podem abrir Advanced — use my own Google Cloud project no formulário e informar diretamente o ID do cliente, o ID de administrador, o ID da ação de conversão, o ID do cliente OAuth, a chave secreta do cliente e o token de atualização. Os segredos são criptografados e nunca mais exibidos; ao editar, deixe um campo secreto vazio para manter o valor salvo. O Google não exige mais token de desenvolvedor.

Conclusão

Com o Google Ads conectado, cada conversão aprovada gerada pelos seus parceiros é enviada vinculada ao clique original no anúncio — assim o Google Ads informa vendas reais e o Smart Bidding otimiza com elas. Configure uma vez por ação de conversão e acompanhe o relatório CAPI Delivery até o primeiro envio bem-sucedido.

Relacionados: Visão geral da Conversions API · API de Conversões da Meta · Google Ads com o WebSDK