Docs · CAPI

CAPI server-side

Conversions API da Meta: envio server-to-server com qualidade de match (EMQ) maximizada, sem depender do navegador do usuário.

server-sideEMQGraph API v23.0

01 Por que server-side

Pixel do navegador é facilmente bloqueado: ad blockers, ITP do Safari, Chrome sem cookies de terceiros, extensões de privacidade. A Conversions API (CAPI) é o canal server-to-server da Meta: o Trakd recebe o evento do seu servidor (ou de um webhook do gateway de pagamento) e envia direto pra Meta, sem passar pelo browser do usuário.

Na prática: o server-side recupera os ~50% de sinal que o navegador deixou de entregar desde o iOS 14.5, e é isso que faz o ROAS do painel voltar a bater com o caixa.

02 Fluxo Trakd

Pixel JS dispara o evento no browser (ex: Purchase).

Em paralelo, o gateway (Hotmart, Stripe…) bate webhook na Trakd com o mesmo order_id.

Trakd gera um event_id determinístico pra esse evento.

Pixel client-side e worker CAPI enviam o mesmo event_id server-side.

Meta deduplica automaticamente: conta como 1 evento, mas com muito mais sinais de match.

03 Hashing de PII

Todo dado de identificação pessoal (PII) é hasheado com SHA-256 antes de sair do nosso servidor:

user_data.json
{
  "em": "<sha256(email lowercase trimmed)>",
  "ph": "<sha256(phone E.164 sem '+')>",
  "fn": "<sha256(first_name lowercase)>",
  "ln": "<sha256(last_name lowercase)>",
  "ct": "<sha256(city lowercase)>",
  "external_id": "<sha256(customer_id ou CPF)>"
}

A Meta usa esses hashes pra fazer match contra o gráfico social interno: quanto mais campos preenchidos, maior o EMQ, que se traduz em mais conversões atribuídas à campanha certa.

04 Event Match Quality (EMQ)

A Meta dá um score de 0 a 10 baseado em quantos sinais de identidade você manda. O Trakd otimiza pra EMQ ≥ 8 enviando:

fbp + fbc (cookies first-party que o pixel JS já gera)
client_ip_address + client_user_agent capturados no webhook
Email + phone + nome (hasheados) do gateway de pagamento
Para o Brasil: CPF hasheado em external_id (cobertura adicional)

05 Eventos suportados → Meta

Status do gateway	Evento Meta
approved / paid / completed	`Purchase`
refunded	`Refund` (custom)
chargeback / dispute.created	`Chargeback` (custom)
subscription.created	`Subscribe`
checkout.abandoned	`AbandonedCart` (custom)

06 API version e LTS

Trakd opera em Graph API v23.0 (LTS conservadora). Migramos automaticamente conforme a Meta deprecia versões: você nunca precisa atualizar nada do seu lado.

Pronto pra mandar conversão certa?

Comece em 3 passos: conecte a Meta, instale o tracker e veja o ROAS real no painel.

Testar por 7 dias