Docs · API

API /v1/track

Endpoint pra enviar eventos direto do seu back-end, quando a conversão não passa pelo navegador ou quando você quer integrar além dos gateways nativos.

server-to-server

01 Quando usar

Na maioria dos casos você não precisa de código: as 15 integrações nativas já cobrem checkout, reembolso, assinatura e carrinho abandonado. A API direta existe pra cenários específicos:

  • Eventos que acontecem só no seu back-end e nunca passam pelo navegador.
  • Um gateway ou ERP próprio que não está na lista de integrações nativas.
  • Fluxos custom em que você quer controlar exatamente quando o evento é disparado.

02 Como funciona

Você envia o evento pro endpoint /v1/track da API do Trakd, vinculado ao seu pixel. A partir daí, o evento entra no mesmo pipeline das integrações nativas:

1

O Trakd valida e registra o evento.

2

Aplica a deduplicação por event_id (não conta a venda em dobro).

3

Relaya pra Meta via CAPI de forma assíncrona, com a qualidade de match (EMQ) otimizada.

03 Privacidade e PII

Dados de identificação pessoal (email, telefone, nome) são hasheados com SHA-256 antes de sair do nosso servidor rumo à Meta. Trate a chamada como parte da sua stack server-side e envie só o necessário. Veja os detalhes em CAPI server-side.

04 Especificação completa

A referência detalhada da API (campos, exemplos e limites) fica disponível de forma autenticada no painel, junto das credenciais do seu pixel. Se você quer integrar via API direta, fale com a gente pelo chat ou em contato que liberamos o acesso e ajudamos no setup.

Prefere sem código?

Conecte um dos 15 gateways nativos e comece a mandar conversão certa hoje.

Testar por 7 dias