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

Insira o script em todas as páginas do seu funil (landing, checkout, obrigado), imediatamente após a abertura da tag <head>. O script detecta automaticamente a plataforma de anúncios (Kwai, TikTok, Meta, Google) pelo parâmetro de click na URL e gera um LeadId persistente que cola clique → sessão → venda.

Escolha a versão do script

Recomendado (V2 — Lead System)
Padrão (V1 — UTM Handler)
CDN Alternativo (anti-bloqueio)

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

V2 — Sistema de Leads
Detecção automática de plataforma, tracking multi-step, suporte a SPA e deduplicação inteligente. Gera um LeadId único por visitante (ex: TT-1763007625226-yn4xita3qylwh).

<script
  src="https://cdn.xtracky.com/scripts/utm-handler.js"
  data-token="SEU_PRODUCT_ID"
  data-click-id-param="click_id">
</script>

Use o V1 se você já tem uma integração legada dependendo do formato clássico UTM. Para novas integrações, prefira sempre o V2.

<script
  src="https://cdn.jsdelivr.net/gh/xTracky/static/utm-handler.js"
  data-token="SEU_PRODUCT_ID"
  data-click-id-param="click_id">
</script>

Use esta opção se a URL principal (cdn.xtracky.com) estiver sendo bloqueada por ferramentas de URL scan. Ver Evitar URL Scan.

Atributos do script

string

required

ID do seu produto na xTracky (UUID). Encontrado no painel em Produtos → Detalhes do Produto.

string

Identificador da etapa do funil (ex: checkout, upsell, obrigado). Usado no V2 para tracking multi-step.

string

default:"click_id"

Nome do parâmetro de click ID na URL. Usado no V1. Padrão: click_id.

Detecção automática de plataforma (V2)

O script V2 identifica a plataforma de origem lendo o parâmetro de click na URL e escolhe o prefixo do LeadId:

Parâmetro na URL	Plataforma	Prefixo do Lead
`click_id`	Kwai	`KW-`
`ttclid`	TikTok	`TT-`
`fbclid`	Facebook / Meta	`FB-`
`gclid`	Google Ads	`GG-`

Configure suas campanhas para preservar esses parâmetros na URL de destino. A xTracky captura automaticamente e mantém o LeadId no cookie/localStorage do visitante — mesmo se ele navegar entre páginas ou abandonar e voltar depois.

Próximo passo

Enviar sua primeira conversão

Do lead capturado à venda registrada na xTracky

Introdução

Comece Aqui

Conceitos

Scripts

Plataformas

Instalação do Script

Escolha a versão do script

Atributos do script

Detecção automática de plataforma (V2)

Próximo passo

Enviar sua primeira conversão

​Escolha a versão do script

​Atributos do script

​Detecção automática de plataforma (V2)

​Próximo passo

Enviar sua primeira conversão

Escolha a versão do script

Atributos do script

Detecção automática de plataforma (V2)

Próximo passo