Como rastrear vendas do Hotmart, Kiwify e Eduzz no Meta Ads

Para traquear vendas do Hotmart, Kiwify e Eduzz no Meta Ads, a solução é a API de Conversões enviando o evento Purchase direto do servidor da plataforma, com a reconciliação da venda feita no próprio checkout. O Pixel sozinho não resolve. O checkout fica em domínio terceiro, e o script do Meta que está no seu site não consegue disparar o Purchase na confirmação da compra, porque ela acontece em checkout.hotmart.com, não no seu domínio.

O resultado sem a configuração correta: o Meta registra as visitas, mas não recebe as vendas. Sem o evento Purchase, o algoritmo otimiza para quem clica, não para quem compra. O custo por venda real sobe enquanto o painel mostra "conversões" que não pagam a conta.

Para o contexto de como a API de Conversões resolve esse problema, veja o guia completo de traqueamento de conversões e o artigo sobre API de Conversões do Meta.

Por que o Pixel sozinho não funciona em plataformas terceiras

O Pixel do Meta é um script JavaScript que precisa estar instalado na página onde o evento acontece. Para disparar o evento Purchase, o script precisa rodar na página de obrigado, a página que o usuário vê depois de confirmar o pagamento.

Na Hotmart, Kiwify e Eduzz, a página de obrigado está em um domínio controlado pela plataforma. Você não tem como instalar seu próprio GTM lá. Hotmart, Kiwify e Eduzz permitem adicionar um Pixel ID nas configurações do produto, mas essa implementação nativa geralmente tem problemas:

• Não envia FBC e FBP (os identificadores do clique de anúncio), porque a plataforma não tem acesso aos cookies do seu domínio
• Pode não enviar o valor correto da transação
• Não envia Advanced Matching com email/telefone do comprador
• Pode ser bloqueado por ad blockers no navegador do comprador

Ou seja: o Pixel nativo da plataforma é melhor do que nada, mas ainda tem todos os problemas do client-side. A solução real é a API de Conversões, que envia o evento diretamente do servidor da plataforma para o Meta, sem depender do navegador do comprador.

A UTM e os cookies que morrem no checkout

Tem um problema anterior ao Pixel, e é o mais caro. Quando o comprador sai do seu site e cai em checkout.hotmart.com, ele troca de domínio. E na troca de domínio, os parâmetros de UTM da URL e os cookies primários do seu site (_fbc, _fbp, sessão) não atravessam. A plataforma recebe a venda sem saber de onde ela veio.

Ou seja: você pode ter a API de Conversões configurada e ainda assim atribuir a venda errado, porque o dado de origem ficou para trás no seu domínio. O Meta recebe um Purchase, mas sem o _fbc daquele clique de anúncio o Connect Rate cai, e a campanha que realmente gerou a venda não leva o crédito.

E é aí que entra a decoração de links de checkout. O App Tracker reescreve o link do checkout (Hotmart, Kiwify, Eduzz, Voomp) no momento do clique, anexando os parâmetros de origem e os identificadores de clique ao destino. Assim a UTM e o _fbc chegam junto com o comprador ao checkout, e o checkout passa a ser a fonte da verdade da atribuição, não um buraco no meio do funil.

As 3 opções para traquear vendas em plataformas terceiras

Opção 1: integração nativa CAPI da plataforma

Hotmart e Kiwify têm integração nativa com a API de Conversões do Meta. Você configura nas definições do produto ou da conta, e a plataforma envia automaticamente o evento Purchase para o Meta a cada venda aprovada, direto do servidor deles, sem passar pelo navegador do comprador.

Vantagens: simples, não exige código, funciona para todas as vendas independente do dispositivo ou navegador do comprador.

Limitação: a plataforma não tem acesso ao FBC e FBP do seu domínio, então o matching é feito com email e telefone do comprador. Se o email/telefone do comprador não bate com um perfil no Meta, o Connect Rate fica mais baixo.

Opção 2: GTM Server-Side com webhook da plataforma

Hotmart, Kiwify e Eduzz enviam webhooks de confirmação de venda para uma URL de sua escolha. Com o GTM Server-Side configurado, você pode criar um cliente personalizado que recebe esse webhook, extrai os dados da venda, e envia o evento Purchase para o Meta via CAPI.

A vantagem dessa abordagem é que você pode enriquecer o payload: se o usuário passou pelo seu site antes de ir para o checkout, você pode ter armazenado o FBC e FBP no seu banco de dados (associados ao email, por exemplo) e incluir esses identificadores no evento enviado para o Meta.

É a opção mais robusta e com melhor Connect Rate potencial, mas exige desenvolvimento para armazenar os identificadores e um servidor GTM configurado.

Opção 3: Pixel customizado via postback

Plataformas como a Eduzz aceitam um "postback pixel", uma URL que a plataforma chama com parâmetros dinâmicos quando uma venda é confirmada. Você configura a URL no formato da API de Conversões do Meta e a plataforma faz o disparo automaticamente.

É tecnicamente server-side (a chamada sai do servidor da plataforma), mas mais limitado do que a integração nativa CAPI em termos de dados disponíveis. Não é a opção mais recomendada para a maioria dos casos: use a integração nativa quando disponível.

Passo a passo: Hotmart com API de Conversões

Pré-requisitos: Pixel do Meta criado no Gerenciador de Eventos, token de acesso do sistema gerado (em Configurações do Negócio, Usuários do sistema, adicionar usuário do sistema com permissão de anunciar, gerar token).

1. Acesse a Hotmart, Ferramentas, Integrações de Marketing, Meta (Facebook)
2. Clique em "Nova integração"
3. Insira o Pixel ID (os 15-16 dígitos)
4. Insira o token de acesso do sistema
5. Em "Eventos a enviar", selecione pelo menos "Purchase" (você pode adicionar InitiateCheckout se quiser)
6. Salve e teste: faça uma compra teste e verifique no Gerenciador de Eventos se o Purchase chegou com origem "Servidor"

A Hotmart envia os dados: valor, moeda, produto, email do comprador (em hash) e telefone (se disponível). Não envia FBC/FBP.

Passo a passo: Kiwify com API de Conversões

Pré-requisitos: os mesmos da Hotmart (Pixel ID + token de acesso).

1. Acesse a Kiwify, Configurações, Integrações, Pixel Meta (API de Conversões)
2. Insira o Pixel ID
3. Insira o token de acesso
4. A Kiwify envia o evento Purchase com dados da venda e email do comprador em hash
5. Para o evento de InitiateCheckout, a Kiwify tem uma integração separada via Pixel web: configure nas configurações do produto em "Pixel Facebook"

Obs.: Kiwify tem dois campos de Pixel separados, um para o Pixel web (que dispara eventos no checkout deles via JavaScript) e um para a API de Conversões (que envia Purchase do servidor). Configure os dois, mas use o mesmo Pixel ID nos dois campos para que a deduplicação funcione.

Passo a passo: Eduzz com API de Conversões

A Eduzz tem menos maturidade de integração nativa CAPI do que Hotmart e Kiwify, e os rótulos das telas mudam com frequência. Por isso, aqui o caminho é descrito pelo mecanismo, não por nomes de campo que podem já ter mudado quando você ler. Confira sempre a documentação atual da Eduzz antes de configurar.

O mecanismo é o mesmo das outras plataformas: a cada compra aprovada, a Eduzz dispara um webhook de compra (postback) para uma URL. Esse evento carrega os dados da venda e do comprador (valor, produto, email e telefone). A partir dele, o evento Purchase é montado e enviado à API de Conversões do Meta com esses dados em hash.

Na prática, você tem dois caminhos. Um: se a Eduzz oferecer integração nativa com o Meta na sua conta, informe o Pixel ID e o token de acesso, exatamente como na Hotmart. Dois: se não houver, aponte o webhook de compra da Eduzz para o seu GTM Server-Side (ou um endpoint próprio), que recebe o postback e envia o Purchase ao Meta via CAPI.

Obs.: em qualquer um dos dois caminhos, use o ID do pedido da Eduzz como event_id. É ele que permite deduplicar o Purchase do servidor contra o Pixel web, caso você também dispare o evento no navegador.

Evitando duplicação: o deduplication_key

O problema mais frequente após configurar a integração nativa + Pixel web: o evento Purchase chega duas vezes no Meta. Uma vez do Pixel (client-side) na página de obrigado e uma vez da CAPI (server-side) da plataforma.

O Meta deduplica automaticamente se ambos os eventos usam o mesmo event_id. Sem o event_id igual nos dois envios, o Meta conta como dois eventos separados, inflando o número de conversões.

Na prática: o ID do pedido (order_id) ou transaction_id da plataforma é o candidato natural para o event_id. Se o Pixel web da página de obrigado consegue ler o order_id (geralmente via parâmetro de URL ou DataLayer), passe esse valor como event_id no Pixel. Configure a integração CAPI para usar o mesmo ID.

Para verificar se a deduplicação está funcionando: no Gerenciador de Eventos, Detalhes do evento Purchase, você deve ver "1 event server" e "1 event browser" com o mesmo event_id, e o Meta vai mostrar "deduplicado: 1 evento único". Se aparecer "2 eventos únicos", a deduplicação não está ativa.

Como verificar se está chegando no Meta

Depois de configurar a integração:

1. Faça um pedido teste (use os recursos de teste de cada plataforma, não precisa fazer uma compra real)
2. Abra o Gerenciador de Eventos, Teste de Eventos
3. Você deve ver o evento Purchase aparecer em tempo real com origem "Servidor"
4. Verifique os parâmetros: value, currency, user_data.em (email em hash)
5. Se o user_data.fbc estiver presente, o matching será de alta qualidade

Veja também o artigo sobre por que o Meta infla conversões para entender como interpretar esses números depois que o traqueamento estiver configurado.

FAQ

Preciso do Pixel instalado no meu site se estou usando a integração CAPI da Hotmart?

Sim. O Pixel no seu site (página de vendas) captura eventos de topo do funil (PageView, ViewContent, InitiateCheckout) e captura o FBC/FBP do clique de anúncio. Sem ele, o Meta não sabe que o usuário visitou sua página antes de ir para o checkout. A integração CAPI da Hotmart só cobre o Purchase final.

A integração nativa da Hotmart funciona para assinaturas e cobranças recorrentes?

Depende da configuração. Por padrão, a integração envia o Purchase para cada pagamento aprovado, incluindo renovações. Se você não quer que renovações sejam contadas como novas conversões no Meta, configure um filtro de tipo de transação. Verifique a documentação da Hotmart para a versão atual da integração.

A Eduzz tem integração nativa com a API de Conversões como Hotmart e Kiwify?

Depende da sua conta e da versão atual da plataforma. Quando não há integração nativa madura, o caminho é o webhook de compra (postback) da Eduzz apontando para um GTM Server-Side, que monta e envia o Purchase ao Meta. O mecanismo é o mesmo, muda quem faz o disparo. Confira a documentação atual da Eduzz.

Meu produto está em um checkout próprio (não em plataforma terceira). Essa configuração se aplica?

Com checkout no seu domínio, você tem controle total: pode instalar o Pixel na página de obrigado via GTM e disparar o evento Purchase diretamente. A integração CAPI via GTM Server-Side ainda agrega valor (recupera os eventos bloqueados por iOS e ad blockers), mas a configuração é diferente da descrita aqui.

Conclusão

Configurar a API de Conversões no Hotmart, na Kiwify e na Eduzz recupera o Purchase que o Pixel sozinho não vê. Mas o que separa a atribuição correta da venda órfã é a origem chegar inteira ao checkout: sem o _fbc do clique junto da compra, o Meta recebe a conversão e credita a campanha errada.

Preservar a UTM e os identificadores de clique na troca de domínio recupera facilmente 20% das vendas que a integração nativa sozinha não consegue atribuir. É esse o trabalho da decoração de links de checkout do App Tracker: ela reescreve os links de Hotmart, Kiwify, Eduzz e Voomp para que a origem sobreviva, e trata o checkout como a fonte da verdade da atribuição, independente do que a plataforma repassa.

Se quiser ver suas vendas atribuídas à campanha certa, sessão por sessão, comece os 30 dias grátis.