Script no funil
Captura o clique, gera
LeadId e reporta os passos do funil.API de ingestão
Recebe vendas via webhook (90+ gateways) ou via API pública.
Dispatcher
Envia eventos de conversão pra Meta, TikTok, Kwai e Google.
Fluxo de uma venda
1
Anúncio → Landing
Usuário clica no anúncio no TikTok. A URL de destino tem
?ttclid=xxxxxx. Ao carregar a landing, o script V2 lê o ttclid e gera um LeadId:TT-1763007625226-yn4xita3qylwhEsse LeadId é persistido no cookie/localStorage. Todas as navegações posteriores dentro do funil compartilham o mesmo Lead.2
Checkout iniciado
Quando o usuário clica em “Comprar”, o script dispara um evento
initiate_checkout (se o botão tiver data-xtracky-checkout ou se você chamar a API manualmente). A xTracky repassa isso pra rede correspondente como InitiateCheckout (Meta) / Add to Cart (TikTok/Kwai).3
Venda gerada (aguardando)
Gateway retorna o PIX/boleto. Você (ou o webhook do gateway) chama a xTracky com
status=waiting_payment. Evento Add to Cart é disparado.4
Pagamento confirmado
Gateway confirma o pagamento. Novo
POST com status=paid chega à xTracky. Ela:- Deduplica pelo
orderId+utm_source - Identifica a plataforma pelo prefixo
TT- - Dispara
Purchasena API de conversão do TikTok - Atualiza o painel em tempo real
Ingestão: webhook automático vs API
- Webhook automático
- API pública
Se o seu gateway está na lista de plataformas integradas, você não precisa escrever código. Basta apontar o webhook do gateway pra:A xTracky normaliza o payload da plataforma pra um formato canônico (currency, status, amount, UTM, lead) e dispara os eventos de conversão automaticamente.
Componentes que você não precisa saber (mas que rodam por baixo)
- Ingestion — recebe webhooks e valida
- Normalizer — aplica transformer DB-driven por gateway
- Enricher — enriquece com tenant/produto/pixels ativos
- Router — 1 evento → N mensagens (uma por pixel configurado)
- Dispatcher — plugin por rede: Facebook v19, TikTok v1.3, Kwai adsnebula, Google Ads
Produto → Integrações) e a xTracky faz o fan-out.