Meta Conversions API

    Meta CAPI Deduplicação de eventos com event_id

    Os eventos do navegador Pixel e do servidor CAPI devem descrever a mesma conversão com a mesma identidade. A desduplicação correta mantém a resiliência de ambos os caminhos sem contagem dupla.

    19 de maio de 2026 · 12 minutos de leitura

    Meta desduplica eventos de navegador e servidor correspondentes quando eles usam o mesmo nome e ID de evento. Gere o ID uma vez no evento de negócios, passe-o pelos dois caminhos de entrega e nunca crie IDs aleatórios não relacionados em cada tag.

    O que a desduplicação de eventos meta capi com event_id significa na prática

    Para compras, um valor baseado em pedido é estável e auditável. Para eventos de pré-compra, crie um ID antes de ocorrer o envio do navegador ou do servidor.

    O design correto começa com o resultado do negócio e os dados necessários para medi-lo. Os IDs de eventos devem identificar uma ocorrência, não um usuário. A reutilização de um ID para compras separadas pode suprimir conversões legítimas.

    Gere o ID uma vez
    Envie valores event_name idênticos
    Passe o ID pelos dois caminhos
    Verifique a desduplicação no Events Manager

    Como o fluxo de dados deve funcionar

    Os IDs correspondentes não corrigem nomes de eventos, carimbos de data/hora, moedas ou valores inconsistentes. Trate ambas as cargas como representações de um evento canônico.

    Documente a origem, o nome do evento, os identificadores estáveis, o estado de consentimento, as transformações e a resposta do destino. Esse registro torna a implementação testável e evita que uma configuração de plataforma se torne uma lógica de negócios não documentada.

    Uma fonte documentada para cada evento
    Identificadores estáveis ​​de eventos e transações
    Mapeamentos explícitos específicos de destino
    Solicitações de entrada e saída observáveis

    Riscos e erros comuns de implementação

    Use o Meta Events Manager para inspecionar a cobertura do navegador/servidor, duplicar avisos e parâmetros recebidos em vez de confiar apenas na visualização do GTM.

    As falhas mais caras são silenciosas: as tags parecem disparar enquanto as cargas são duplicadas, rejeitadas, despojadas de identificadores ou enviadas sem o estado de consentimento pretendido. Teste a cadeia completa e retenha evidências do sistema de origem e dos diagnósticos de destino.

    Não compare o disparo de tags com aceitação
    Não crie identificadores de forma independente
    Não ignore testes com consentimento negado
    Não otimize uma pontuação diagnóstica isoladamente

    Medição, privacidade e propriedade contínua

    Atribua um proprietário para o contrato de evento, o contêiner da web, o contêiner do servidor e a integração de cada fornecedor. Defina alertas, revisão de alterações e um caminho de reversão antes que a configuração se torne uma dependência de produção.

    Os controles de privacidade pertencem à arquitetura. Minimize cargas úteis, restrinja o acesso, a retenção de documentos e verifique o que cada destino realmente recebe. O processamento do lado do servidor fornece controle somente quando a equipe o configura e audita ativamente.

    Valide o resultado, não apenas a configuração

    As interfaces da plataforma e o comportamento do navegador mudam. Confirme os requisitos atuais na documentação primária vinculada, teste as jornadas reais dos representantes e procure aconselhamento de privacidade qualificado para as jurisdições em que você opera.

    Meta CAPI Deduplicação de eventos com event_id: lista de verificação de implementação

    Use esta sequência para planejar uma nova implementação ou revisar uma existente.

    1. 01

      Definir o evento de negócios canônico

      Anote a entrada, saída, proprietário e critério de aceitação esperados antes de alterar as tags.

    2. 02

      Gere um ID de evento estável

      Configure este estágio com nomenclatura estável e os dados mínimos necessários para sua finalidade documentada.

    3. 03

      Anexe-o ao evento Pixel

      Preserve a identidade do evento, o estado de consentimento e as referências do sistema de origem em todo o caminho de entrega.

    4. 04

      Encaminhe-o para o contêiner do servidor

      Use ferramentas de visualização e inspeção de rede do navegador para comparar a carga observada com o contrato do evento.

    5. 05

      Mapeie-o na tag CAPI

      Verifique a resposta e os diagnósticos do destino; uma tag disparada localmente não é prova de processamento bem-sucedido.

    6. 06

      Novas tentativas de teste e envios duplicados

      Registre os resultados, reconcilie-se com a verdade da fonte e agende um novo teste após alterações significativas na plataforma.

    Construa um sistema de medição que você possa explicar

    Meta CAPI A desduplicação de eventos com event_id funciona melhor quando a propriedade do evento, a identidade, o consentimento e os mapeamentos de destino são explícitos. A implementação deve ser compreensível sem engenharia reversa de uma coleção de tags.

    Comece com uma conversão crítica, valide-a de ponta a ponta e expanda somente depois que a carga útil, o diagnóstico e a reconciliação do sistema de origem concordarem.

    Meta CAPI Deduplicação de eventos com event_id: perguntas comuns

    Posso usar o ID do pedido como event_id?

    Sim para uma compra quando o ID do pedido está disponível para ambos os caminhos e identifica exclusivamente essa transação.

    Por que os eventos ainda são duplicados?

    Verifique se as cargas do navegador e do servidor usam exatamente o mesmo nome de evento e ID de evento e chegam dentro da janela de processamento suportada pela plataforma.

    Como devo testar esta implementação?

    Teste o consentimento aceito e negado, sessões novas e recorrentes, variantes de navegador e back-end, envios duplicados e a resposta final de cada destino.

    O rastreamento do lado do servidor garante mais conversões?

    Não. Pode melhorar o controle e a entrega do sinal, mas os resultados dependem da qualidade da fonte, do consentimento, dos identificadores, das regras da plataforma e da implementação correta.

    Fontes primárias e leituras adicionais

    Artigos relacionados

    Execute server-side GTM em infraestrutura gerenciada da UE

    Implante um endpoint de etiquetagem próprio com preços, monitoramento e infraestrutura previsíveis mantidos pelo Tracking Hippo.

    Explore os benefícios