Skip to main content

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: landing, pre-checkout, checkout, obrigado.
boolean
default:"true"
Se 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:
Nunca dispare purchase do navegador. Purchase deve sempre vir do webhook do gateway ou de uma chamada backend, pra evitar fraude e duplicatas.

Acessando o LeadId no cliente

Se você precisa incluir o LeadId num formulário ou passar pro seu backend:
O 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 LeadId foi gerado (e por qual regra)
  • Cada evento disparado e seu payload
  • Tentativas de rede e respostas da API