API de Conversões do Meta: como implementar sem duplicar eventos
Pixel e API precisam contar a mesma conversão uma única vez. Entenda event_id, deduplicação, correspondência avançada e como validar a implementação.
- Guilherme Fonseca
- 10 min de leitura
- 6 partes
Em 30 segundos
- 1Pixel e API de Conversões trabalham juntos; o Meta mantém um registro só por evento.
- 2A deduplicação depende do mesmo event_name e event_id nos dois envios.
- 3Dados de usuário com hash, mais fbc e fbp, decidem se a conversão encontra a campanha certa.
Bloqueadores de anúncio, limites de cookies de terceiros e restrições de navegador reduzem a cobertura do pixel no navegador. A API de Conversões envia os mesmos eventos pelo servidor, recuperando conversões que se perderiam. O risco é contar duas vezes — e é isso que a deduplicação resolve.
Parte 01Pixel e API não são alternativas
A recomendação é redundância: o mesmo evento sai do navegador e do servidor. O Meta compara os dois envios e mantém apenas um registro, desde que você mande as chaves corretas. Desligar o pixel para 'evitar duplicidade' é o pior dos caminhos, porque você perde sinais de navegador que a API não tem.
Parte 02A chave da deduplicação: event_id + event_name
O Meta deduplica quando o par event_name e event_id é idêntico nos dois envios, dentro da janela de comparação. O event_id precisa ser gerado uma única vez por ocorrência de evento e compartilhado entre o disparo do navegador e o do servidor.
- Gere um identificador único por evento (por exemplo um UUID) no momento da ação
- Envie esse valor como eventID no fbq do navegador
- Envie o mesmo valor como event_id no payload da API
- Nunca reutilize o mesmo event_id para eventos diferentes
Parte 03Correspondência avançada: quanto melhor o dado, melhor a atribuição
Além do event_id, envie os parâmetros de usuário disponíveis com hash SHA-256: e-mail, telefone, nome, cidade e estado. Some a isso os identificadores de clique e navegador (fbc e fbp), que vêm dos cookies e do parâmetro fbclid na URL. A qualidade da correspondência é o que decide se a conversão será atribuída à campanha certa.
Evento sem parâmetros de correspondência chega na plataforma, mas muitas vezes não encontra dono — e a campanha não recebe o crédito.
Parte 04Cuidados na implementação
- Normalize os dados antes do hash: minúsculas, sem espaços, telefone com código do país
- Nunca envie dados pessoais sem hash no payload
- Respeite o consentimento do usuário; sem base legal, não envie
- Use action_source correto (website, chat, phone_call) para cada origem
- Envie event_time em unix timestamp e evite atrasos maiores que a janela suportada
Parte 05Como validar
No Gerenciador de Eventos, use a Ferramenta de Teste com o test_event_code para ver os envios em tempo real e confirmar que navegador e servidor aparecem como um evento deduplicado. Depois acompanhe, ao longo de alguns dias, o percentual de eventos deduplicados e a nota de qualidade da correspondência de cada evento.
- Eventos deduplicados aparecendo como processados corretamente
- Qualidade da correspondência de evento estável ou em alta
- Volume de conversões próximo do que o CRM registra
- Nenhum alerta de parâmetro obrigatório ausente
Parte 06O mesmo vale para outras plataformas
Google Ads (Enhanced Conversions) e TikTok (Events API) seguem lógica parecida: envio pelo servidor, identificador de deduplicação e dados de usuário com hash. Vale montar um plano de medição único e replicar a estrutura, em vez de tratar cada plataforma como um projeto separado.
Se você desconfia dos números do seu gerenciador, uma auditoria de eventos costuma revelar o problema em poucos dias. Fale com a gente pelo WhatsApp.
Perguntas frequentes
01O que é a API de Conversões da Meta?
É o envio de eventos de conversão (compra, lead, checkout) direto do seu servidor para a Meta, em vez de depender só do pixel no navegador. Como não é bloqueada por bloqueadores de anúncio nem pela perda de cookies, ela recupera conversões que o pixel sozinho deixa de registrar.
02Preciso da API de Conversões se já tenho o pixel instalado?
Sim, os dois trabalham juntos. O pixel captura o comportamento no navegador e a API garante o registro do lado do servidor; com a deduplicação configurada, a Meta junta os dois sinais do mesmo evento sem contar em dobro. Hoje, só o pixel costuma subestimar o resultado real das campanhas.
03O que é deduplicação de eventos e por que ela importa?
Deduplicação é o mecanismo que faz a Meta entender que um evento vindo pelo pixel e pelo servidor é o mesmo, usando um identificador comum (o event_id). Sem ela, a mesma compra é contada duas vezes, os números incham e o algoritmo otimiza por dados errados.
Compartilhe este artigo
