🚀 Integração XTracky

Primeiros passos para integrar seu funil

1

Instalação do Script

Insira o código abaixo em TODAS as páginas do seu funil logo após a tag <head>. 

<script
    src="https://cdn.jsdelivr.net/gh/xTracky/static/utm-handler.js"
    data-token="12345678-abcd-efgh-ijkl-123456789012"
    data-click-id-param="click_id">
</script>
Importante: Este script deve ser instalado em todas as páginas do seu funil para garantir o rastreamento adequado dos visitantes.

⚙️ Configuração do Script:

  • data-token: Substitua pelo ID do seu produto na xTracky
  • data-click-id-param: Parâmetro para capturar o click_id (geralmente mantém "click_id")
2

Envio de Conversões

Faça uma requisição POST para o endpoint abaixo sempre que uma venda for realizada:

POST https://api.xtracky.com/api/integrations/api

Corpo da Requisição (JSON):

{
    "orderId": "AB123",
    "amount": 100,
    "status": "waiting_payment",
    "utm_source": "..."
}

📝 Exemplos de Implementação:

JavaScript (Fetch API):
cURL:
PHP:

📊 Status de Pagamento Aceitos:

waiting_payment - Venda aguardando pagamento
paid - Venda aprovada

📝 Parâmetros Explicados:

  • orderId: Identificador único da venda
  • amount: Valor da venda em centavos (ex: R$ 1,00 = 100)
  • status: Status atual do pagamento
  • utm_source: Envie o valor da utm_source que estiver na URL
UTM Source: Certifique-se de capturar e enviar o valor do parâmetro utm_source presente na URL do visitante para rastrear corretamente a origem do tráfego.
📊 Integração Kwai: Para cada requisição enviada para este endpoint, um novo evento é automaticamente gerado no Kwai, permitindo o rastreamento completo das conversões na plataforma.
🔒 Proteção contra Duplicatas: Requisições duplicadas não serão processadas. Cada requisição é processada somente uma vez, evitando a duplicação de eventos e conversões.

✅ Pronto!

Após seguir estes passos, seu funil estará integrado com a XTracky e você poderá acompanhar todas as conversões em tempo real.