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.jsdelivr.net/gh/xTracky/static@91f40bf1b4096a3e607d5a56ddf66ee615e4236b/proxy.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.

✅ Pronto!

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