> ## 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.
# Lead System (V2)
> O script V2 (experimental.js) é a integração recomendada da xTracky — sistema de leads, detecção automática de plataforma, SPA e multi-step.
## Instalação
Cole no `` de **todas** as páginas do seu funil, o mais cedo possível:
```html theme={null}
```
O `async` garante que o script não bloqueie renderização. Ele começa a rastrear assim que estiver pronto.
## Atributos
Product ID (UUID) do seu produto na xTracky.
Identificador da etapa do funil. Usado pra tracking multi-step no painel.\
Exemplos: `landing`, `pre-checkout`, `checkout`, `obrigado`.
Se `true`, botões com `data-xtracky-checkout` disparam `initiate_checkout` automaticamente.\
Ver [Botão de checkout](/scripts/botao-checkout).
## O que ele faz automaticamente
Lê `ttclid`, `fbclid`, `gclid`, `click_id` na URL e escolhe o prefixo do `LeadId`.
Cookie + localStorage + sessionStorage — sobrevive navegação, aba fechada, dias depois.
Navigation API + History API — sabe quando o roteador SPA troca de "página".
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:
```javascript theme={null}
// Dispara initiate_checkout manual
window.xtracky?.track('initiate_checkout', {
orderId: 'ORDER_123',
amount: 9990,
});
// Dispara add_to_cart manual
window.xtracky?.track('add_to_cart', {
orderId: 'ORDER_123',
amount: 9990,
});
```
**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:
```javascript theme={null}
const leadId = window.xtracky?.getLeadId();
// Ex: "TT-1763007625226-yn4xita3qylwh"
// Anexar num campo hidden
document.querySelector('input[name="utm_source"]').value = leadId;
```
O `getLeadId()` é seguro pra chamar antes do script terminar de carregar — retorna `null` até estar pronto. Se precisar aguardar:
```javascript theme={null}
window.addEventListener('xtracky:ready', () => {
const leadId = window.xtracky.getLeadId();
console.log('Lead:', leadId);
});
```
## 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