Documentação de Integração

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.xtracky.com/scripts/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 no 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": "..."
}

📊 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 o XTracky e você poderá acompanhar todas as conversões em tempo real.