A duplicidade de eventos ocorre quando uma mesma ação é registrada mais de uma vez.

Isso pode acontecer por acionadores incorretos, múltiplas implementações, reenvio de requisições ou integrações que não compartilham identificadores consistentes.

O impacto depende da plataforma, do evento e do mecanismo de deduplicação disponível.

Como funciona

Cada plataforma possui regras próprias para identificar eventos duplicados.

Não existe um identificador universal que resolva todos os cenários.

PlataformaMecanismo relevante
Meta Pixel + CAPIevent_name e event_id
GA4 — comprastransaction_id, nas condições suportadas
Google Ads — importaçõesIdentificadores da conversão, horário e campos de deduplicação conforme o método

O transaction_id do GA4 não substitui o event_id da Meta.

Exemplo prático

Considere uma compra com identificador pedido_12345.

No GA4, o evento pode utilizar:

gtag("event", "purchase", {
  transaction_id: "pedido_12345",
  value: 299.90,
  currency: "BRL"
});

Na Meta, a mesma compra pode ser enviada pelo Pixel e pela CAPI utilizando um event_id compartilhado.

O identificador deve representar a mesma ocorrência em ambos os envios.

Como implementar

  1. Identifique todos os pontos que enviam eventos de conversão.
  2. Defina um identificador único para cada ocorrência.
  3. Compartilhe esse identificador entre os canais que exigem deduplicação.
  4. Configure os eventos e os parâmetros conforme a plataforma.
  5. Implemente controle de reprocessamento nas integrações.
  6. Valide o comportamento em cenários de repetição e falha.

Como validar

Realize testes com uma única conversão e compare:

  • Quantidade de disparos no navegador.
  • Quantidade de requisições enviadas pelo servidor.
  • Identificadores presentes em cada envio.
  • Eventos recebidos pela plataforma.
  • Diagnósticos de deduplicação disponíveis.

Também é importante testar atualizações de página, reenvios automáticos e repetição de webhooks.

Pontos de atenção

  • Deduplicação não substitui a correção de acionadores incorretos.
  • Um evento pode estar duplicado antes de chegar à plataforma.
  • IDs gerados aleatoriamente em cada envio podem impedir a correspondência.
  • Eventos diferentes não devem compartilhar o mesmo identificador apenas por pertencerem ao mesmo usuário.
  • Reprocessamento de webhooks exige controle de idempotência.
  • Nem todas as plataformas utilizam os mesmos critérios ou janelas de deduplicação.

Uma implementação confiável deve controlar duplicidades na origem e utilizar corretamente os mecanismos disponibilizados por cada destino.

Observação: os exemplos de código e payloads são ilustrativos. Antes de utilizá-los em produção, é necessário adaptar identificadores, autenticação, parâmetros e regras de envio à implementação específica e à documentação vigente de cada plataforma.

Compartilhe