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.
| Plataforma | Mecanismo relevante |
|---|---|
| Meta Pixel + CAPI | event_name e event_id |
| GA4 — compras | transaction_id, nas condições suportadas |
| Google Ads — importações | Identificadores 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
- Identifique todos os pontos que enviam eventos de conversão.
- Defina um identificador único para cada ocorrência.
- Compartilhe esse identificador entre os canais que exigem deduplicação.
- Configure os eventos e os parâmetros conforme a plataforma.
- Implemente controle de reprocessamento nas integrações.
- 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.
