xTracky Docs — Rastreamento de conversões e tracking multi-plataforma

A xTracky mantém uma família de scripts, cada um pra um cenário. Todos são idempotentes (podem ser incluídos duas vezes sem quebrar), assíncronos e leves (< 8 KB gzip).

Comparativo rápido

Script	Uso principal	Sistema de Leads	SPA	Multi-step
`experimental.js` (V2)	Padrão recomendado	✅	✅	✅
`utm-handler.js` (V1)	Legado / integrações antigas	❌	❌	❌
`utm-handler-shopify.js`	Lojas Shopify	❌	⚠️	❌
`whatsapp.js`	Tracking de clique pra WhatsApp	✅	✅	—

URLs oficiais

Todos os scripts são servidos pelo CDN oficial da xTracky:

https://cdn.xtracky.com/scripts/{nome-do-script}.js

Se o CDN principal estiver sendo bloqueado por ferramentas de URL scan, existe uma rota alternativa via jsDelivr.

Regra de ouro: um único script por página

Nunca inclua dois scripts da xTracky ao mesmo tempo na mesma página. Se você precisa de comportamento de dois scripts (ex: Lead System + WhatsApp), use apenas o V2 — ele já cobre o WhatsApp via atributos.

Quando usar V1 vs V2

Use V2 se
Use V1 se

Está começando agora
Quer atribuição correta cross-plataforma (Kwai + TikTok + Meta + Google)
Roda um SPA (React, Vue, Svelte, Next, Nuxt)
Precisa rastrear múltiplos steps do funil

Já tem uma integração legada dependente do formato clássico utm_source
Não precisa atribuição por plataforma (só quer capturar UTMs pra reportar internamente)
Sua stack não é SPA e o funil tem só 1-2 páginas

Próximo: script V2 completo

Todos os atributos, casos de uso e exemplos