> ## 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.

# Introdução

> Entenda como a xTracky rastreia conversões, atribui vendas por plataforma e otimiza suas campanhas de anúncios em tempo real.

## O que é a xTracky

A **xTracky** é uma plataforma de rastreamento de conversões que atribui suas vendas às campanhas de anúncios que geraram o clique — mesmo quando o pagamento acontece dias depois, em outro dispositivo ou vindo de uma plataforma de checkout diferente.

Ao instalar um único script no seu funil e integrar o gateway de pagamento (via webhook automático ou API), você passa a:

* Ver **qual campanha vendeu** em Kwai, TikTok, Meta e Google Ads
* Enviar eventos de conversão de volta pra cada rede (Purchase, Initiate Checkout, Add to Cart)
* Otimizar campanhas com base em **ROAS real**, não estimativa da plataforma

## Como funciona em 3 passos

<Steps>
  <Step title="Instale o script">
    Um script único no `<head>` do seu funil detecta automaticamente a plataforma de anúncio (Kwai, TikTok, Meta, Google) pelo parâmetro de click na URL e gera um `LeadId` persistente.
  </Step>

  <Step title="Configure o pagamento">
    Aponte o webhook do seu gateway pra xTracky (90+ integrações prontas) ou envie a venda via **API pública** quando o cliente pagar.
  </Step>

  <Step title="Acompanhe no painel">
    Cada venda aparece atribuída à campanha correta em tempo real. Os eventos são disparados de volta pras APIs de conversão de Meta, TikTok, Kwai e Google.
  </Step>
</Steps>

## URL base da API

Toda integração via API usa esta URL base:

```bash theme={null}
https://api.xtracky.com/api/integrations/
```

Endpoints principais:

* `POST /api/integrations/api` — envio manual de conversão
* `POST /api/integrations/{plataforma}` — webhook automático (Vega, Cakto, Tribopay, etc.)

## Pré-requisitos

Pra começar você vai precisar de:

1. **Conta xTracky** ativa — [cadastre-se em app.xtracky.com](https://app.xtracky.com/auth/register)
2. **Product ID** (UUID) — criado no painel em `Produtos → Novo Produto`
3. **Acesso ao seu funil** pra colar o script no `<head>`
4. **Acesso ao seu gateway** pra configurar o webhook (opcional se usar a API)

## Próximos Passos

<CardGroup cols={2}>
  <Card title="Instalar o script em 5 minutos" icon="bolt" href="/comece-aqui/instalacao">
    Cole o script no `<head>` e comece a rastrear leads na hora
  </Card>

  <Card title="Enviar sua primeira conversão" icon="rocket" href="/comece-aqui/primeira-conversao">
    Guia rápido: do lead ao evento `Purchase` na Meta
  </Card>

  <Card title="Sistema de Leads (V2)" icon="fingerprint" href="/conceitos/leads-e-plataformas">
    Como o `LeadId` cola clique → sessão → venda entre plataformas
  </Card>

  <Card title="Status de Pagamento" icon="credit-card" href="/conceitos/status-pagamento">
    O que cada status dispara em cada plataforma de anúncio
  </Card>

  <Card title="Plataformas Integradas" icon="plug" href="/plataformas/lista">
    Lista completa dos 90+ gateways com webhook pronto
  </Card>

  <Card title="Referência da API" icon="code" href="/api-reference/introducao">
    Todos os endpoints, parâmetros e exemplos por linguagem
  </Card>
</CardGroup>

<Card title="Suporte" icon="life-ring" href="mailto:suporte@xtracky.com">
  Dúvidas de integração? Chama a gente em [suporte@xtracky.com](mailto:suporte@xtracky.com)
</Card>
