A venda no checkout não marca na campanha quando o pagamento e o clique chegam a sistemas diferentes sem uma chave comum. A LP conhece a URL do anúncio. O checkout conhece o pedido. O webhook conhece a aprovação. Se nenhum índice atravessar essas três etapas, a venda aparece correta no financeiro e fica sem campanha na plataforma de mídia.
O conserto é criar um índice first-party curto na LP, gravar no servidor o vínculo entre esse índice e os dados do clique, enviar o índice por um parâmetro que o checkout devolve no webhook e recuperá-lo quando a venda aprovada chegar. Na Hotmart, esse parâmetro existe e se chama xcod. Na Kiwify e na Cakto, que não têm xcod, o transporte é o sck.
Principais pontos
- Na Hotmart,
xcodé um campo nativo do checkout e volta no webhook empurchase.origin.xcod. Use-o para o índice e deixe oscklivre para o rótulo de campanha. - Na Kiwify e na Cakto, o índice viaja no
sck. - O mapa entre o índice e o clique precisa existir no servidor antes do redirecionamento ao pagamento, e a LP não pode travar se o mapa falhar.
- Cookie e localStorage ajudam no navegador, mas o webhook não consegue lê-los.
- Venda recebida e venda atribuída são estados diferentes. Teste os dois.
A venda chega sem a chave do clique
Confirmar uma transação não identifica o anúncio que trouxe a pessoa. O webhook costuma carregar o pedido, o status financeiro e os dados liberados do comprador. Já a atribuição de mídia depende de informações observadas antes, como UTM, identificador de clique ou uma referência própria.
Quando o botão da LP manda o visitante para outro domínio sem preservar um índice, o checkout cria o pedido sem conhecer o registro da visita. Mais tarde o webhook informa a aprovação, mas não tem como consultar o navegador que iniciou a jornada. A tag server side pode disparar e o endpoint pode responder 200. Mesmo assim, a plataforma recebe uma venda sem a referência que a liga à campanha.
Esse é um problema de junção de dados. O evento financeiro existe; falta a chave que aponta para a linha certa do clique.
A chave precisa ser opaca
Em setembro de 2026 diagnosticamos uma junção quebrada no container de um parceiro, numa operação brasileira com pagamentos via Pix. O servidor guardava o contexto do navegador (client_id do GA4, fbp, fbc, IP, user agent, identificadores de clique) num documento cuja chave era o e-mail que o site colocava no dataLayer. O webhook de pagamento lia o mesmo documento pelo e-mail do comprador.
Numa tarde, o site passou a enviar o e-mail já com hash SHA-256. Os documentos novos nasceram com a chave em hash, o webhook continuou procurando pelo e-mail em texto, e todo enriquecimento passou a voltar vazio. O GA4 descarta compra do Measurement Protocol sem client_id, então a cobertura de compras caiu de 97% para 67%, 26% e 18% em três dias. Nada deu erro: o lado bancário seguiu normal, o servidor respondeu 200 e os pixels continuaram disparando. Quem avisou foi a verificação diária de proporção entre compras no GA4 e no banco, no terceiro dia.
Desde então a regra nas nossas implementações é esta: a junção usa um identificador opaco que os dois lados carregam sem alteração. E-mail e telefone são carga do evento, nunca a chave. E toda junção tem uma taxa de acerto diária que alguém olha.
O índice first-party da LP
O índice é um identificador opaco, criado num domínio controlado pela operação, que representa uma visita ou tentativa de compra. Ele não precisa explicar a campanha. Só precisa apontar, sem colisão, para um registro server side com o contexto permitido: horário, página de entrada, UTMs, identificadores de clique, o que cada destino vai exigir e o estado de consentimento usado na coleta.
Um valor como 7F4K9M2Q8R6T3V5X é melhor que um texto longo com nome de campanha. Cabe em mais integrações, não expõe dados pessoais e permite mudar o esquema interno sem alterar o checkout.
First-party aqui descreve controle e contexto do dado. Não significa ignorar consentimento, finalidade ou retenção.
xcod na Hotmart, sck na Kiwify e na Cakto
Na Hotmart, xcod e sck são dois campos nativos. A referência do Webhook 2.0 descreve purchase.origin.sck como “Código UTM de origem da página de pagamento (checkout)” e purchase.origin.xcod como “Código de UTM que pode ser personalizado para receber informações de origem da venda” (verificado em 17/10/2026). A ajuda da Hotmart sobre UTMs diz que os parâmetros estruturados de UTM não são repassados nos envios do Webhook e indica o xcod como alternativa.
O uso natural, então, é abrir o checkout com ?xcod=<índice> e ler o valor em purchase.origin.xcod na aprovação. O sck fica para o rótulo de origem que você já usa no relatório de vendas, onde a Central de Ajuda fala em códigos de até 30 caracteres.
A Kiwify não lista xcod. Os parâmetros aceitos na URL são src, sck, as cinco UTMs e s1 a s3 (parâmetros de rastreamento da Kiwify, verificado em 17/10/2026). Ali o índice viaja no sck. A Cakto expõe sck no objeto do pedido, conforme a referência de pedidos, e o índice vai no mesmo campo.
O nome “xcod” vem do parâmetro da Hotmart. Fora dela, chame o conceito de índice first-party e use o campo que a plataforma devolve.
| Elemento | Quem define | Função | Exemplo |
|---|---|---|---|
xcod | Hotmart (campo nativo) | Transportar o índice até purchase.origin.xcod | ?xcod=7F4K9M2Q8R6T3V5X |
sck | Checkout (Hotmart, Kiwify, Cakto) | Na Hotmart, rótulo de origem; na Kiwify e na Cakto, transporte do índice | ?sck=7F4K9M2Q8R6T3V5X |
| Índice first-party | Sua operação | Apontar para o registro do clique | 7F4K9M2Q8R6T3V5X |
| Mapa first-party | Seu servidor | Ligar o índice aos dados coletados na LP | índice associado ao clique e à campanha |
Na Kiwify, há duas consequências do modo como ela guarda esses valores. A página de parâmetros diz que as informações ficam em cookies e são usadas toda vez que é feita uma compra. Um comprador que volta sem parâmetros novos pode herdar um índice antigo; compare o horário do índice com a sua janela de atribuição e trate entradas velhas como não atribuídas ou como último toque, conforme a regra que você escolheu. A mesma página diz que, para o rastreamento funcionar na página de vendas, a URL dela precisa estar cadastrada nos links do produto.
Gravar o índice antes de abrir o checkout
Comece no primeiro carregamento elegível da LP. Leia os parâmetros permitidos, gere um índice aleatório e grave o mapa num endpoint first-party. Ao montar o botão, acrescente o índice ao parâmetro do checkout, preservando qualquer query string que já exista.
A gravação precisa terminar antes de abrir a página de pagamento, mas o comprador não pode ficar preso nela. Dê ao endpoint um tempo limite curto, de um a dois segundos. Se ele falhar ou demorar, abra o checkout mesmo assim com um índice gerado no navegador e registre uma “tentativa não atribuída” para investigar depois. Perder a atribuição de uma venda é melhor que perder a venda.
O que gravar depende do que cada destino vai pedir quando a venda chegar:
| Destino | Gravar no mapa | Observação |
|---|---|---|
| Meta (API de Conversões) | client_user_agent, client_ip_address, fbc, fbp, URL da página | User agent é obrigatório em evento de site; o resto melhora a correspondência |
| Google Ads | gclid, gbraid ou wbraid | O que veio na URL do anúncio |
| TikTok | ttclid | O que veio na URL do anúncio |
| GA4 (Measurement Protocol) | client_id e session_id | Eventos aceitam até 72 horas de atraso. Para ligar a compra à sessão: o mesmo session_id, envio em até 24 horas do início da sessão e, se usar timestamp_micros, um horário dentro dela |
| Todos | Horário da gravação e estado de consentimento | Para aplicar a janela de atribuição e o consentimento no envio |
A exigência da Meta está na página de parâmetros de cliente e as janelas do GA4 no guia de envio do Measurement Protocol e na seção de atribuição de sessão (todos verificados em 17/10/2026). O guia de envio também fala em 48 horas para processar o evento junto com os do navegador, mas a ligação com a sessão segue a regra mais estrita de 24 horas. Uma aprovação que chega depois disso entra com o horário real; não recue o horário para forçar a atribuição.
Achar o índice no mapa prova só que o contexto gravado foi recuperado. Envio, recebimento no destino e atribuição na campanha são três verificações separadas.
Uma sequência segura fica assim:
- A LP recebe a visita e aplica a regra de consentimento do projeto.
- O backend gera um índice aleatório, curto e alfanumérico.
- O backend grava o vínculo entre índice e contexto do clique, com prazo de retenção definido.
- O botão abre o checkout com
xcod=<índice>na Hotmart ousck=<índice>na Kiwify e na Cakto. - A venda aprovada chega ao endpoint autenticado.
- O processador extrai o índice, busca o mapa e envia a conversão.
- O ID do pedido e o ID da notificação controlam duplicidade e reconciliação.
O índice liga compra e clique; ele não serve para impedir reenvio do mesmo webhook. Uma pessoa pode comprar duas vezes partindo da mesma visita, e uma transação gera notificações distintas de aprovação, reembolso e chargeback. Se você já recebe a aprovação no server GTM, o guia de rastreamento Hotmart por webhook cobre autenticação, estados financeiros e idempotência.
Um adaptador por plataforma
Use a mesma arquitetura, mas confirme o contrato de cada checkout. Na Kiwify, a referência de webhooks mostra o campo sck no JSON de exemplo. Na Cakto, o webhook usa eventos como purchase_approved, descritos na documentação de webhooks. Se o payload entregue ao seu endpoint não trouxer o campo, consulte o pedido pela API usando o identificador recebido, em vez de presumir um caminho que não foi documentado para aquele evento.
Não escreva uma função que tenta adivinhar dezenas de nomes. Crie um adaptador por plataforma e versão. Cada adaptador recebe o payload bruto e devolve uma estrutura interna com order_id, event_id, status, value, currency e o índice. Payload desconhecido vai para quarentena, com log suficiente para investigação e sem disparar compra.
O mapa precisa sobreviver ao navegador e ao container. Cookie, sessionStorage e localStorage mantêm continuidade na LP, mas nenhum deles está disponível para uma chamada server-to-server feita horas ou dias depois.
Teste da LP até o destino
Teste a cadeia em ordem, com uma compra controlada e um índice conhecido. Abra a LP com uma URL de campanha de teste e confirme a resposta do endpoint que grava o mapa. Inspecione o link final do botão: o parâmetro deve carregar exatamente o índice salvo, sem perder caracteres na concatenação de ? e &. No checkout, conclua o pedido e confira se o valor aparece nos detalhes da venda.
Depois abra a entrega real do webhook, pois o evento sintético não traz todas as condições do pedido. Localize o índice no caminho esperado, valide o ID do pedido e consulte o mapa. Por último, confira no destino se a conversão foi recebida uma vez e associada à campanha de teste. O código de resposta do endpoint prova recebimento; não prova atribuição.
Use estes controles negativos:
- envie um webhook sem índice e confirme que ele vai para a fila de não atribuídos, sem inventar campanha;
- repita a mesma notificação e confirme que a compra não conta de novo;
- use um índice inexistente e verifique se o erro fica pesquisável pelo ID do pedido;
- altere um caractere do índice no link e confirme que o sistema não casa por aproximação;
- derrube o endpoint do mapa e confirme que o botão ainda abre o checkout;
- na Kiwify, compre de novo sem parâmetros e veja qual índice o segundo pedido herda.
Acompanhe também, todo dia, a parcela de vendas aprovadas cujo índice foi encontrado no mapa. É esse número que teria avisado no primeiro dia do caso acima.
Se a venda chega, mas a campanha segue vazia, o primeiro ponto quebrado do teste indica o dono da correção. A ATA implementa essa ponte da LP ao checkout e do webhook ao destino, com adaptadores por plataforma, armazenamento do índice e teste de compra real. Veja o escopo de rastreamento e atribuição da Advanced Tracking Academy.
Quando a venda chega mais de uma vez, o próximo diagnóstico é separar order bump, upsell e pixel duplicado no Meta antes de remover qualquer evento.