> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xtracky.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Visão geral

> Qual script escolher — do V2 com sistema de leads às versões especializadas pra Shopify e WhatsApp.

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)](/scripts/lead-system) | Padrão recomendado              |         ✅        |  ✅  |      ✅     |
| [`utm-handler.js` (V1)](/scripts/utm-handler)  | Legado / integrações antigas    |         ❌        |  ❌  |      ❌     |
| [`utm-handler-shopify.js`](/scripts/shopify)   | Lojas Shopify                   |         ❌        |  ⚠️ |      ❌     |
| [`whatsapp.js`](/scripts/whatsapp)             | 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](/scripts/avoid-urlscan).

## 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

<Tabs>
  <Tab title="Use V2 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
  </Tab>

  <Tab title="Use V1 se">
    * 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
  </Tab>
</Tabs>

<Card title="Próximo: script V2 completo" icon="arrow-right" href="/scripts/lead-system">
  Todos os atributos, casos de uso e exemplos
</Card>