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 em purchase.origin.xcod. Use-o para o índice e deixe o sck livre 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.

ElementoQuem defineFunçãoExemplo
xcodHotmart (campo nativo)Transportar o índice até purchase.origin.xcod?xcod=7F4K9M2Q8R6T3V5X
sckCheckout (Hotmart, Kiwify, Cakto)Na Hotmart, rótulo de origem; na Kiwify e na Cakto, transporte do índice?sck=7F4K9M2Q8R6T3V5X
Índice first-partySua operaçãoApontar para o registro do clique7F4K9M2Q8R6T3V5X
Mapa first-partySeu servidorLigar 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.

Fluxo em que a LP cria um índice, salva o vínculo com o clique, envia o índice no parâmetro do checkout e o recupera no webhook da venda.
O checkout transporta o índice. O mapa first-party guarda o contexto. Sem as duas partes, o webhook confirma a venda, mas não encontra a campanha.

O que gravar depende do que cada destino vai pedir quando a venda chegar:

DestinoGravar no mapaObservação
Meta (API de Conversões)client_user_agent, client_ip_address, fbc, fbp, URL da páginaUser agent é obrigatório em evento de site; o resto melhora a correspondência
Google Adsgclid, gbraid ou wbraidO que veio na URL do anúncio
TikTokttclidO que veio na URL do anúncio
GA4 (Measurement Protocol)client_id e session_idEventos 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
TodosHorário da gravação e estado de consentimentoPara 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:

  1. A LP recebe a visita e aplica a regra de consentimento do projeto.
  2. O backend gera um índice aleatório, curto e alfanumérico.
  3. O backend grava o vínculo entre índice e contexto do clique, com prazo de retenção definido.
  4. O botão abre o checkout com xcod=<índice> na Hotmart ou sck=<índice> na Kiwify e na Cakto.
  5. A venda aprovada chega ao endpoint autenticado.
  6. O processador extrai o índice, busca o mapa e envia a conversão.
  7. 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.