Meta CAPI: configuração avançada e deduplicação de eventos

A Conversions API (CAPI) do Meta é hoje componente essencial de qualquer stack de rastreamento robusto. Mas configurar incorretamente a deduplicação pode resultar em dados duplicados e otimização prejudicada.

Por que a CAPI é indispensável

O Meta Pixel sozinho perde entre 20% e 50% dos eventos dependendo do navegador e dispositivo. A CAPI complementa o pixel enviando eventos diretamente do servidor, sem depender do browser.

Entendendo a deduplicação

Quando pixel e CAPI enviam o mesmo evento, o Meta precisa deduplica-los. Para isso, cada evento deve carregar o mesmo event_id nos dois lados.

No pixel (browser)

fbq('track', 'Purchase', {
  value: 299.90,
  currency: 'BRL'
}, {
  eventID: 'purchase_abc123' // mesmo ID que vai na CAPI
})

Na CAPI (servidor)

{
  "event_name": "Purchase",
  "event_time": 1700000000,
  "event_id": "purchase_abc123",
  "user_data": { ... },
  "custom_data": {
    "value": 299.90,
    "currency": "BRL"
  }
}

Parâmetros de user_data para alto match rate

O Event Match Quality Score depende diretamente da quantidade de parâmetros de usuário enviados. Priorize:

• 'em' (email com hash SHA-256)
• 'ph' (telefone com hash SHA-256)
• 'client_ip_address'
• 'client_user_agent'
• 'fbc' (cookie _fbc do browser)
• 'fbp' (cookie _fbp do browser)

Com email + telefone + fbp/fbc, é possível atingir EMQ Score acima de 8.

Validando a implementação

Use o Events Manager do Meta para verificar:

1. Se a deduplicação está funcionando (eventos duplicados aparecem como "Matched")
2. O EMQ Score de cada evento
3. A taxa de match por parâmetro

Erros comuns

• Não normalizar o email antes do hash (deve ser lowercase, sem espaços)
• Usar event_id diferente no pixel e na CAPI
• Não enviar fbp/fbc do cookie do browser para o servidor

Uma CAPI bem configurada pode aumentar o volume de conversões atribuídas em 30% a 50%.