Se você ligou o pixel e a API de Conversões ao mesmo tempo e as conversões quase dobraram de um dia para o outro, a medição não melhorou. A mesma venda está sendo contada duas vezes.

A deduplicação resolve isso, e é nela que a maioria das implementações quebra: um ID gerado duas vezes, um nome de campo errado no navegador, um webhook que reenvia a compra. Abaixo está a regra da Meta, os pontos onde o ID se perde e o caso dos checkouts externos, como Hotmart e Kiwify.

Por que a CAPI existe

O pixel do Facebook roda no navegador do visitante. Ele carrega junto com a página, monta o evento ali e manda direto do dispositivo da pessoa para a Meta.

Esse caminho tem buracos conhecidos. Bloqueadores de anúncio e extensões de privacidade derrubam a requisição antes dela sair. O Safari limita a duração dos cookies criados por JavaScript, então quem volta depois de uma semana pode chegar como visitante novo.

A API de Conversões muda quem fala com a Meta no último trecho: em vez do navegador, é o seu servidor que envia o evento. Esse trecho servidor-Meta não passa por bloqueador. O que chega ao seu servidor, porém, ainda depende do navegador, a menos que venha de um webhook do gateway. O consentimento do visitante é uma frente à parte, que afeta tanto o pixel quanto o que o servidor pode enviar; o guia sobre banner de cookies integrado ao GA4 e à Meta cobre essa parte.

Diagrama: o evento do pixel e o evento da CAPI usam o mesmo event_id, então a Meta casa os dois e conta uma única conversão.
O event_id compartilhado é o que permite à Meta casar os dois envios. Sem ele, não conte com o método alternativo para evitar a compra em dobro.

A CAPI não substitui o pixel

Muita gente instala a CAPI achando que ela substitui o pixel. A própria Meta recomenda os dois juntos.

Cada lado enxerga uma coisa. O navegador tem o fbp, tem o fbc quando a pessoa chegou por anúncio, tem o comportamento na página e o user agent. O servidor tem a transação confirmada, o e-mail real do comprador e o valor que o gateway aprovou.

Rodar só um dos dois é abrir mão de parte da informação. Rodar os dois sem deduplicação é pior, porque aí você não perde dado: você inventa dado.

Como a Meta deduplica

A documentação de deduplicação da Meta (verificada em 17/10/2026) usa dois campos: o nome do evento e o ID do evento. O eventID do pixel precisa ser igual ao event_id da API, e o evento do pixel precisa ter o mesmo nome do event_name do servidor.

Três detalhes da mesma página mudam como você testa:

  • A janela é de 48 horas contadas a partir do primeiro evento recebido. Ela é um prazo de chegada para a segunda cópia, não um tempo de processamento.
  • Quando as duas cópias chegam, a Meta em geral fica com a primeira recebida. Por isso os parâmetros de cliente devem ser equivalentes nos dois lados; se só o servidor manda e-mail com hash e o navegador chega antes, você pode perder esse dado na cópia que ficou.
  • A deduplicação descrita é entre navegador e servidor. A página não promete descartar duas cópias enviadas pelo servidor, e na seção do método alternativo (por fbp ou external_id) diz com todas as letras que dois eventos consecutivos do servidor com a mesma informação não são descartados.

O último ponto é o que mais pega em fluxo de webhook. Se o gateway reenvia a notificação e o seu servidor dispara outro Purchase com o mesmo event_id, não conte com a Meta para jogar a cópia fora. Em outubro de 2026, ao dimensionar a janela de reenvio do nosso próprio pipeline de eventos, adotamos essa leitura como regra: o servidor envia cada compra uma vez, e quem garante isso é um registro de idempotência do nosso lado, antes da chamada à CAPI.

O event_name quase nunca é o problema, porque os dois lados mandam Purchase. O problema costuma ser o event_id.

O event_id precisa nascer uma vez

O event_id precisa ser o mesmo valor exato dos dois lados. O padrão errado mais comum é gerar o ID em cada lado de forma independente:

// no navegador
event_id: crypto.randomUUID()

// no servidor
event_id: crypto.randomUUID()   // valor diferente, dedup não acontece

Dois UUIDs válidos, dois eventos válidos, zero deduplicação.

A regra que uso tem duas partes. Se a página de obrigado e o webhook conhecem o mesmo código do pedido, use esse código como event_id nos dois lados; ele já é único por transação e não precisa ser guardado em lugar nenhum. Se o navegador não conhece o código do pedido, crie um ID de checkout cedo, grave junto do pedido e mapeie para a transação antes de o webhook disparar a CAPI.

Um par de envios fica assim (valores de exemplo):

// navegador, na página de obrigado
fbq('track', 'Purchase', { value: 297.00, currency: 'BRL' }, { eventID: 'HP1234567890' });
{
  "data": [{
    "event_name": "Purchase",
    "event_time": 1760700000,
    "event_id": "HP1234567890",
    "action_source": "website",
    "event_source_url": "https://seudominio.com.br/obrigado",
    "user_data": {
      "em": ["<sha256 do e-mail normalizado>"],
      "client_user_agent": "<user agent do comprador>",
      "client_ip_address": "<IP do comprador>",
      "fbp": "fb.1.1760699000000.123456789",
      "fbc": "fb.1.1760698000000.AbCdEf"
    },
    "custom_data": { "value": 297.00, "currency": "BRL" }
  }]
}

Repare no detalhe que consome tarde da noite: no pixel o campo se chama eventID, com I e D maiúsculos. Na API de Conversões ele se chama event_id, minúsculo com underscore. Escrever event_id no lado do navegador não gera erro nem aviso; simplesmente não deduplica.

Onde o ID costuma se perder

Entre a página de checkout e o webhook do gateway. A pessoa compra, o gateway confirma minutos depois por webhook, e nesse momento ninguém lembra qual ID foi usado no navegador. Se o ID não foi gravado junto do pedido, ele não existe mais. É o caso da segunda parte da regra acima.

Em checkout fora do seu domínio. Hotmart, Kiwify e Eduzz processam o pagamento em outro domínio, e o que estava na memória da página anterior morre ali. A decisão nesses casos começa por listar quem envia cada Purchase hoje:

  1. O pixel nativo da plataforma. Na Hotmart ele pode enviar pelo navegador e também pela API, a partir do servidor da Hotmart (opções avançadas do pixel, verificado em 17/10/2026).
  2. Uma tag sua no GTM ou código na página de obrigado.
  3. O seu webhook, transformado em CAPI no servidor.

Mantenha um único dono para o envio do navegador. Se a sua CAPI sai do webhook e o pixel nativo também envia pela API, há dois remetentes no servidor para a mesma venda e nenhum conhece o event_id do outro. Use o código da transação da plataforma (purchase.transaction na Hotmart) dos dois lados quando ele estiver disponível, e trave o webhook com idempotência. O guia de rastreamento Hotmart por webhook mostra o registro de idempotência; o do indexador entre a LP e o checkout mostra como levar o contexto do clique até o webhook.

Em disparo duplicado do próprio pixel. Página de obrigado que recarrega, ou tag configurada em dois gatilhos, gera dois eventos de navegador, muitas vezes com IDs diferentes. Aí nem a deduplicação com o servidor salva, porque o problema está antes.

Como conferir que está funcionando

O modo de visualização prova que a tag disparou, não que o evento chegou íntegro do outro lado. O teste que vale é uma compra real e depois:

  1. Abra o Gerenciador de Eventos da Meta e vá no evento Purchase.
  2. Em teste ao vivo é normal ver as duas chegadas. Confira que as duas dizem Purchase e trazem o mesmo ID, deixe processar e só então leia o total consolidado.
  3. Procure a indicação de eventos deduplicados na visão do evento.
  4. Compare o total de Purchase do dia com as vendas aprovadas no gateway. Se estiver perto do dobro, a deduplicação não está acontecendo.

O passo 4 é o que mais gente pula. Para ler a contagem fora da interface, o endpoint /stats do conjunto de dados na Graph API devolve contagens por hora, por nome de evento e por origem (navegador ou servidor). Em outubro de 2026, num site próprio, foi esse endpoint que confirmou a entrega pela CAPI quando o nosso log amostrado perdeu uma linha de ad_view em dois de três testes. Naqueles testes, os blocos de contagem apareceram cerca de uma hora depois; a Meta não publica um prazo, então espere antes de concluir que algo faltou.

Ilustração da tela de origem do evento, mostrando a mesma compra recebida do navegador e do servidor, e uma terceira linha sem event_id.
Ilustração, não captura. A terceira linha representa um envio sem event_id: fora do casamento por ID, ele pode virar uma compra a mais que nunca existiu.

O outro número: EMQ

Deduplicação resolve contagem. Ela não resolve correspondência.

A Qualidade da Correspondência de Eventos, o EMQ, é uma nota de 0 a 10 para eventos de site enviados pela API de Conversões. Ela resume quão úteis são as informações do cliente que vieram junto do evento para associá-lo a uma conta da Meta. Nota baixa não quer dizer que o evento foi perdido; quer dizer menos material para ligar a conversão a uma pessoa.

Os parâmetros que a Meta lista incluem e-mail e telefone com hash, external_id, fbp, fbc, IP do visitante e dados de endereço quando você os tem. O user agent é obrigatório para eventos de site enviados pela CAPI, segundo a página de parâmetros de cliente (verificada em 17/10/2026). Num servidor intermediário, o IP e o user agent precisam ser os do visitante, não os da máquina que repassa o evento. A Meta não publica uma ordem de impacto entre esses campos.

Para fazer essa leitura sem tratar a nota como um boletim geral da conta, veja o guia do Gerenciador de Eventos e qualidade da correspondência, com um antes e depois real do mesmo conjunto de dados.

A ordem de trabalho

  1. Confirme que existe problema. Compare Purchase no Gerenciador de Eventos com as vendas aprovadas no gateway, no mesmo período.
  2. Identifique quem envia cada Purchase hoje: pixel nativo, GTM, código manual, webhook. Uma CAPI pode sair de um container server-side ou direto do seu backend; se você precisa hospedar um container, o guia da Stape cobre hospedagem e custos.
  3. Defina o event_id: código do pedido quando os dois lados o conhecem, ID de checkout mapeado quando não.
  4. Ligue ou ajuste a CAPI e confira eventID no navegador contra event_id no servidor.
  5. Trave o webhook para que cada transação gere um único envio do servidor.
  6. Valide com transação real e compare os totais de novo. Depois de contar certo, trabalhe o EMQ.

Em checkout com ofertas adicionais, a contagem exige outro corte: veja como separar compra duplicada, order bump e upsell no Meta sem deduplicar transações legítimas.