Instalação
Cole no<head> de todas as páginas do seu funil, o mais cedo possível:
O
async garante que o script não bloqueie renderização. Ele começa a rastrear assim que estiver pronto.Atributos
string
required
Product ID (UUID) do seu produto na xTracky.
string
Identificador da etapa do funil. Usado pra tracking multi-step no painel.
Exemplos:
Exemplos:
landing, pre-checkout, checkout, obrigado.boolean
default:"true"
Se
Ver Botão de checkout.
true, botões com data-xtracky-checkout disparam initiate_checkout automaticamente.Ver Botão de checkout.
O que ele faz automaticamente
Detecta a plataforma
Lê
ttclid, fbclid, gclid, click_id na URL e escolhe o prefixo do LeadId.Persiste o Lead
Cookie + localStorage + sessionStorage — sobrevive navegação, aba fechada, dias depois.
Intercepta SPAs
Navigation API + History API — sabe quando o roteador SPA troca de “página”.
Deduplica
LeadId + orderId → evita disparo duplo de
Purchase.Eventos que ele dispara
O V2 pode disparar eventos direto do navegador quando você não quer envolver o backend:Acessando o LeadId no cliente
Se você precisa incluir oLeadId num formulário ou passar pro seu backend:
getLeadId() é seguro pra chamar antes do script terminar de carregar — retorna null até estar pronto. Se precisar aguardar:
Debug
Adicione?xtracky_debug=1 à URL pra ativar logs verbose no console do navegador. Você verá:
- Qual
LeadIdfoi gerado (e por qual regra) - Cada evento disparado e seu payload
- Tentativas de rede e respostas da API