Pixel e API de Conversões juntos: como deduplicar sem contar a venda duas vezes

A recomendação do próprio Meta é usar o pixel e a API de Conversões (CAPI) juntos. O pixel roda no navegador e a CAPI roda no seu servidor. Um cobre a falha do outro: quando o navegador bloqueia o pixel, o servidor ainda manda o evento.

O problema aparece quando os dois mandam o mesmo evento e o Meta não sabe que é o mesmo. Resultado: compras em dobro no relatório e um algoritmo aprendendo com dados errados.

Como o Meta deduplica

O Meta considera dois eventos como o mesmo quando eles chegam com:

• o mesmo nome do evento (event_name, por exemplo Purchase);
• o mesmo identificador do evento (eventID no pixel e event_id na CAPI).

Se os dois batem dentro da janela de deduplicação, o Meta fica com um só.

Gerando o identificador

O identificador precisa ser único por evento e igual nos dois lados. Para compra, o mais simples é usar o código do pedido:

// No navegador
fbq('track', 'Purchase', { value: 197, currency: 'BRL' }, { eventID: 'pedido-48213' });

// No servidor (CAPI)
{
  "event_name": "Purchase",
  "event_id": "pedido-48213",
  "action_source": "website",
  "custom_data": { "value": 197, "currency": "BRL" }
}

Para eventos antes do pedido existir, como InitiateCheckout, gere um identificador no navegador, guarde e envie o mesmo valor para o servidor.

Erros que eu mais vejo

• event_id diferente nos dois lados, porque cada um gera o seu. Vira duplicação.
• Nome do evento diferente, como Purchase no pixel e purchase no servidor.
• Servidor sem fbp, fbc e dados do cliente. O evento chega, mas com correspondência fraca.
• Compra pelo servidor disparada na página de obrigado, e não na aprovação do pagamento.

Quem manda a compra: navegador ou servidor?

Em oferta com Pix e boleto, a compra de verdade acontece depois: quando o pagamento é aprovado. Por isso eu prefiro:

1. o pixel manda InitiateCheckout e, se quiser, a compra na página de obrigado, com o eventID do pedido;
2. o servidor manda a compra quando chega o webhook de pagamento aprovado, com o mesmo event_id.

Se o visitante pagou o Pix e nunca voltou para a página de obrigado, o servidor garante a venda. Se os dois mandaram, a deduplicação resolve.

Como conferir o pixel e a API de Conversões

No Gerenciador de Eventos, o evento de compra mostra se recebeu dados do navegador, do servidor ou dos dois, e quantos foram deduplicados. Se aparece só "Servidor" ou só "Navegador", um dos lados não está funcionando.

Pixel sozinho já não basta, e CAPI mal configurada atrapalha. O ponto de equilíbrio é o event_id certo nos dois lados.