Envio de conversões às plataformas de anúncios: API de Conversões, Events API e conversões offline do Google Ads

Enviar conversões à plataforma de anúncios é o jeito de contar ao Facebook, ao TikTok ou ao Google quais cliques viraram leads e vendas. Sem isso, o algoritmo otimiza para cliques e ações baratas, e não para compradores.

Rastreamento e análise10 min de leitura
Envio de conversões às plataformas de anúncios: API de Conversões, Events API e conversões offline do Google Ads
Conteúdo
  1. Por que enviar conversões à plataforma de anúncios
  2. Formas de enviar conversões
  3. O que enviar: leads, hold ou aprovação
  4. Como preparar a conta de anúncios para receber conversões
  5. Erros comuns no envio de conversões
  6. Envio de conversões no ArtisanClo
  7. Resumo

O algoritmo do Facebook ou do TikTok é um aluno muito aplicado, mas só aprende com os exemplos que você mostra. Se a plataforma vê apenas cliques, ela traz gente que gosta de clicar. Se vê leads, traz quem preenche formulário. Se vê vendas aprovadas, traz quem compra. Enviar conversões à plataforma de anúncios — pela API de Conversões da Meta, pela Events API do TikTok ou pelas conversões offline do Google Ads — é justamente o jeito de mostrar esses exemplos.

Por que enviar conversões à plataforma de anúncios

No marketing de afiliados a conversão não acontece no seu site, e sim na rede de afiliados: você fica sabendo pelo postback, às vezes dias depois do clique, quando o lead é aprovado. A conta de anúncios não sabe de nada disso. Daí três problemas:

  1. Otimização para a meta errada. A campanha roda «para cliques» ou «para visualizações de página», e o algoritmo traz tráfego barato e inútil.
  2. Estatística errada no gerenciador. Você não vê o custo por lead nos próprios anúncios e não consegue desligar criativos ruins pelos dados da plataforma.
  3. Sem sinal para escalar. Públicos semelhantes (lookalike) e estratégias automáticas de lance precisam de eventos de conversão.

O envio de conversões pelo servidor resolve tudo isso: ao receber o postback da rede, o tracker envia o evento à conta de anúncios com o ID de clique da plataforma.

clique (fbclid / ttclid / gclid)
  → o tracker grava o clique e o ID da plataforma
  → a rede de afiliados envia o postback: lead ou venda
  → o tracker envia o evento à conta de anúncios

Como o tracker recebe o postback da rede está explicado no artigo «Postback no marketing de afiliados».

Formas de enviar conversões

Forma Plataformas Como funciona
Postback para a fonte Push, pop, nativo, muitas redes A plataforma fornece uma URL, o tracker a chama com o ID de clique dela
API de Conversões (CAPI) Meta: Facebook, Instagram O servidor envia o evento com ID do pixel e token de acesso
Events API TikTok Equivalente à CAPI: ID do pixel, token, evento
Conversões offline por API Google Ads Upload pela API com gclid
Conversões offline por arquivo Google Ads Arquivo com gclid, nome da conversão e horário — manual ou programado

Postback para a fonte

A opção mais simples. A rede de tráfego push ou pop fornece uma URL assim:

https://tracker.example/conversion?click_id={clickid}&payout={payout}

…onde {clickid} é o ID de clique da própria rede de anúncios. Ele deve ir no link do anúncio pelo macro da rede, ser guardado no tracker e substituído na hora do envio. Mais sobre esse tráfego no artigo sobre tráfego push e pop.

API de Conversões (Meta)

A API de Conversões (Conversions API) é o canal de servidor da Meta para eventos. Para enviar, você precisa do ID do pixel (conjunto de dados) e de um token de acesso gerado no Gerenciador de Eventos (como ligar isso aos macros e ao fbclid está no artigo tracking de anúncios no Facebook). Cada evento contém:

  • nome do evento: Lead, Purchase ou personalizado;
  • horário do evento;
  • fbc — valor montado a partir do fbclid do clique;
  • dados para correspondência: IP, user agent e, se houver, contatos em hash;
  • na compra, valor e moeda;
  • ID do evento para deduplicar com o pixel.

Exemplo de corpo da requisição (simplificado):

{
  "data": [{
    "event_name": "Lead",
    "event_time": 1759312800,
    "action_source": "website",
    "user_data": {
      "fbc": "fb.1.1759310000000.IwAR2Xk9vQ7mP3",
      "client_ip_address": "203.0.113.10",
      "client_user_agent": "Mozilla/5.0 ..."
    }
  }]
}

Quanto mais precisos os dados do usuário, maior a qualidade da correspondência de eventos (Event Match Quality) no Gerenciador de Eventos.

Events API (TikTok)

A lógica é a mesma: ID do pixel, token de acesso, evento e dados para correspondência. O campo-chave é o ttclid do link do anúncio. Sem ele o TikTok faz uma correspondência pior. Como não perdê-lo pelo caminho está no material ttclid e Events API no TikTok.

Conversões offline do Google Ads

O Google trabalha com o gclid (e, em parte do tráfego iOS, com wbraid e gbraid; mais no artigo gclid, ValueTrack e conversões offline). No Google Ads você cria uma ação de conversão com origem «Importação» e depois envia as conversões pela API ou por arquivo. O conjunto mínimo de colunas do arquivo:

Google Click ID,Conversion Name,Conversion Time,Conversion Value,Conversion Currency
Cj0KCQjw8eTFBhCX,Lead,2026-09-08 14:32:00+03:00,0,USD
Cj0KCQjw1aBcDeFg,Sale,2026-09-08 18:05:00+03:00,24,USD

O upload pode ser programado: o próprio Google busca o arquivo num endereço. É uma boa opção se você não quer lidar com chaves de API. O que é o gclid e de onde ele vem está descrito no artigo fbclid, gclid, ttclid, yclid.

O que enviar: leads, hold ou aprovação

A rede de afiliados informa a conversão várias vezes: lead, depois aprovação ou recusa. Qual evento passar à plataforma é uma decisão estratégica.

O que enviamos Prós Contras
Todos os leads Muitos eventos, o algoritmo aprende rápido Aprende também com leads lixo e recusados
Só aprovações A plataforma busca compradores reais Poucos eventos, e chegam com atraso
Os dois, como eventos diferentes Flexibilidade: a meta da campanha é escolhida no gerenciador É preciso cuidar da configuração das metas

Outra questão são os leads recusados. Em geral as plataformas não conseguem «desfazer» um evento já enviado, então se você mandou um lead e depois a rede o recusou, o algoritmo continuará contando como sucesso. É mais um argumento para enviar vendas aprovadas assim que o volume permitir aprender com elas.

Dica. Se a aprovação no seu nicho leva alguns dias e o volume é pequeno, comece otimizando para leads e, em paralelo, envie as vendas como evento separado. Quando houver vendas suficientes, troque a meta da campanha.

O que cada status significa e por que hold não pode ser contado como receita está no artigo «Status de conversão: lead, hold, aprovado, recusado, lixo».

Como preparar a conta de anúncios para receber conversões

Antes de ativar o envio no tracker, prepare o lado da plataforma. Sem isso, os eventos vão «para o vazio».

Meta

  1. No Gerenciador de Eventos, crie ou escolha um conjunto de dados (pixel) ligado à conta de anúncios.
  2. Gere um token de acesso para a API de Conversões nas configurações do conjunto de dados.
  3. Decida quais eventos padrão usar: normalmente Lead para cadastro e Purchase para venda.
  4. Depois dos primeiros eventos, confira na aba de teste e na visão geral do conjunto de dados se chegaram e se foram correspondidos aos cliques.

TikTok

  1. No Gerenciador de Eventos do TikTok, crie um pixel com conexão via Events API.
  2. Gere um token de acesso.
  3. Escolha os eventos para otimização e confira se aparecem como ativos após os primeiros envios.
  1. Crie uma ação de conversão com origem «Importação» (conversões offline de cliques).
  2. Defina a janela de conversão e o modelo de atribuição.
  3. Para upload por API, prepare o acesso à conta; para upload por arquivo, uma programação com o endereço do arquivo.
  4. Depois de um ou dois dias, confira o histórico de uploads: o Google mostra quantas linhas foram aceitas e por que as outras foram recusadas.

Dica. Os nomes das ações de conversão no Google Ads devem coincidir exatamente com os que chegam no arquivo ou pela API, inclusive maiúsculas e minúsculas. A diferença é a causa mais comum do erro «conversão não encontrada».

Erros comuns no envio de conversões

Sem o ID de clique da plataforma. Se fbclid, ttclid ou gclid não foram guardados no tracker, o evento não é correspondido ou é mal correspondido. Confira se os parâmetros não se perdem nos redirects.

Duplicata com o pixel. Pixel na página de obrigado e evento de servidor sem ID comum = contagem dupla. Use deduplicação ou só um dos dois.

Reenvio na mudança de status. A rede mandou «hold», depois «aprovado», e os dois foram para a plataforma como compras separadas. O envio deve ser feito uma vez por conversão e status.

Fuso horário errado. O Google Ads é sensível ao horário da conversão: se for anterior ao clique ou sem fuso, a linha é recusada.

Envio sem conferência depois do lançamento. Configurou, viu o primeiro evento e esqueceu. Uma semana depois o token expirou ou alguém recriou o pixel, e a campanha continua «otimizando» sem sinal. A cada poucos dias compare o número de conversões no tracker e no gerenciador da plataforma.

Valor na moeda errada. O payout é em euros, mas o evento diz USD — a plataforma calcula mal o retorno e define lances com valor distorcido.

Token em texto aberto no chat da equipe. Chaves de acesso são acesso à conta de anúncios. Guarde-as num sistema que as criptografa e não as mostra de novo.

Envio de conversões no ArtisanClo

No ArtisanClo o envio de conversões é configurado no cartão da fonte de tráfego e funciona nos fluxos com tracker (modos «Tracker» e «Cloaking + Tracker»). Opções:

  • Postback para a fonte — a plataforma recebe o próprio ID de clique e o status da conversão. Dá para escolher quais status informar. O envio é feito uma vez por conversão e status, então a passagem de hold para venda não cria duplicata.
  • Meta, TikTok e Google Ads diretamente (a partir do plano Professional) — as conversões vão para a sua conta de anúncios com as suas chaves: ID do pixel e token para Meta e TikTok; ID da conta e chave da conta de serviço do seu Google Cloud para o Google Ads.
  • Google Ads por arquivo programado (a partir do Professional) — sem chaves: cole o endereço do arquivo no Google Ads («Metas → Conversões → Uploads → Programações»). O arquivo traz leads e vendas dos últimos 90 dias de cliques com gclid.

Chaves e tokens são guardados criptografados e não são exibidos de novo depois de salvos.

De onde vêm as conversões: a rede de afiliados, um tracker externo ou o seu site as enviam à seção «Recebimento de conversões». Os status da rede são convertidos automaticamente (approved — venda, pending — hold, refund — recusada, fraud — lixo). Na seção «Conversões», cada registro tem o histórico do clique: dados do clique, o que a rede enviou, mudanças de status e o envio à plataforma de anúncios — por ele dá para ver se o evento saiu.

No plano Business existe também a direção inversa — a importação de gasto: toda manhã é buscado o gasto dos últimos 3 dias da Meta, do TikTok e do Google Ads, e a campanha é associada ao fluxo pelo ID da campanha nos cliques. Assim o ROI é calculado com os valores reais da conta. Os planos podem ser comparados na página de planos.

Configurações para cada plataforma estão no catálogo de fontes de tráfego, por exemplo para o Facebook Ads.

Resumo

O envio de conversões às plataformas de anúncios fecha o ciclo: clique → postback da rede → evento na plataforma → o algoritmo aprende com os seus compradores. Guarde o ID de clique da plataforma, decida quais status enviar e cuide para que um evento não saia duas vezes. E para saber se a campanha ficou mais lucrativa depois disso, calcule o resultado corretamente — veja os artigos como calcular lucro e ROI e métricas do marketing de afiliados.

Perguntas frequentes

01

Por que enviar conversões ao Facebook se o pixel já está instalado?

O pixel na página de obrigado só vê o que aconteceu no navegador e perde eventos por bloqueadores e limitações do iOS. Além disso, ele não sabe se a rede de afiliados aprovou o lead. O envio pelo servidor via API de Conversões manda o evento depois do postback da rede, inclusive para vendas aprovadas.

02

Quais eventos enviar: lead ou só aprovação?

Depende do volume. O algoritmo precisa de eventos suficientes para aprender, por isso no começo muita gente envia leads. Quando há muitas vendas aprovadas, otimizar para a aprovação traz tráfego de mais qualidade. Muitos enviam os dois eventos com nomes diferentes e escolhem a meta na campanha.

03

Dá para enviar conversões ao Google Ads sem acesso à API?

Sim. O Google Ads aceita upload de conversões offline por arquivo: manualmente ou de forma programada a partir de um endereço onde o arquivo fica. O arquivo traz gclid, nome da conversão, horário e valor. É mais simples que a API, mas as conversões aparecem com atraso.

04

Quanto tempo tenho para enviar uma conversão offline ao Google Ads?

A conversão pode ser enviada enquanto a janela de conversão definida na ação de conversão não expirar, em geral até 90 dias após o clique. Por isso o gclid deve ser guardado junto com o clique, e não só em cookies.

05

O que acontece se eu enviar a mesma conversão duas vezes?

A plataforma pode contar duas vezes e inflar o resultado da campanha, e o algoritmo passa a otimizar com dados distorcidos. Para evitar duplicatas usa-se um ID de evento ou de transação, e o envio é feito uma só vez por conversão e status.

Leia também

Veja o seu tráfego na prática

Conecte o ArtisanClo ao seu site, veja quem realmente chega pelos anúncios e por que cada clique recebeu a sua decisão.