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

# Sistema de Leads (V2)

> Como o LeadId cola clique, sessão e venda entre plataformas — mesmo em SPAs, cross-device ou pagamento diferido.

O **Sistema de Leads** é a espinha dorsal do tracking V2. Cada visitante que chega no seu funil ganha um identificador único (`LeadId`) que carrega a plataforma de origem, o timestamp e um sufixo aleatório.

Esse `LeadId` é **persistido no cookie e localStorage** do visitante e é o que amarra:

* O clique no anúncio
* A navegação entre páginas do funil
* O checkout iniciado
* A venda confirmada (mesmo dias depois)

## Anatomia de um LeadId

```
TT-1763007625226-yn4xita3qylwh
│  │              │
│  │              └── sufixo aleatório (colisão zero)
│  └────────────────── timestamp Unix ms de geração
└───────────────────── prefixo da plataforma de origem
```

## Prefixos por plataforma

O prefixo é definido pelo primeiro parâmetro de click presente na URL de chegada:

| Prefixo | Plataforma                                     | Parâmetro na URL |
| ------- | ---------------------------------------------- | ---------------- |
| `KW-`   | Kwai                                           | `click_id`       |
| `TT-`   | TikTok                                         | `ttclid`         |
| `FB-`   | Facebook / Meta                                | `fbclid`         |
| `GG-`   | Google Ads                                     | `gclid`          |
| `XT-`   | Orgânico / direto (nenhum parâmetro detectado) | —                |

<Tip>
  Configure sempre suas campanhas pra preservar o parâmetro de click na URL de destino. Se você usa encurtadores ou redirecionadores customizados, garanta que passem os parâmetros adiante — do contrário, o Lead cai como orgânico (`XT-`) e a venda não é atribuída à campanha.
</Tip>

## Persistência

O `LeadId` é gravado em três lugares pra maximizar sobrevivência:

* **`localStorage`** — sobrevive a fechamento do navegador
* **Cookie de primeira parte** — sobrevive a mudança de subdomínio dentro do mesmo domínio raiz
* **`sessionStorage`** — usado como cache imediato pra evitar re-gerar em navegações internas

Enquanto o navegador do visitante não limpar todos os três, o `LeadId` é o mesmo — mesmo se ele voltar dias depois pra fechar o checkout.

## Multi-step tracking

Cada página do funil pode ter seu próprio `data-step-id`:

```html theme={null}
<!-- landing -->
<script src="https://cdn.xtracky.com/scripts/experimental.js"
  data-token="SEU_PRODUCT_ID"
  data-step-id="landing" async></script>

<!-- checkout -->
<script src="https://cdn.xtracky.com/scripts/experimental.js"
  data-token="SEU_PRODUCT_ID"
  data-step-id="checkout" async></script>

<!-- página de obrigado -->
<script src="https://cdn.xtracky.com/scripts/experimental.js"
  data-token="SEU_PRODUCT_ID"
  data-step-id="obrigado" async></script>
```

Assim você consegue medir taxa de conversão etapa por etapa dentro do painel.

## E se o visitante nunca teve `?ttclid` na URL?

O script gera um `LeadId` com prefixo `XT-` (orgânico). Vendas atribuídas a `XT-` **não são reportadas** de volta pra nenhuma rede de anúncios — elas aparecem no painel como venda orgânica.