Meta Ads 2027 · Capítulo 9 de 36 · 13 min
Enviar eventos pelo servidor com a API de Conversões sem duplicar
Compra contada uma vez pelo navegador e pelo servidor, com cobertura, correspondência e deduplicação lidas no Gerenciador de Eventos antes de confiar no ROAS.
Este capítulo faz parte do curso gratuito Meta Ads 2027. Para marcar como concluído e salvar o progresso, abra este capítulo na página do curso.
Com o plano de eventos escrito e a compra dobrada documentada, falta o servidor confirmar o que o navegador perdeu e parar de contar duas vezes o que já chegou. A API de Conversões faz as duas coisas, desde que o mesmo pedido chegue pelos dois caminhos com a mesma identidade.
Medir só pelo navegador custa sinal. Bloqueador de anúncios, navegador interno dos aplicativos e página de confirmação que não termina de carregar derrubam eventos que existiram. Ligar o servidor sem deduplicar custa o contrário: o sistema recebe compra dobrada e passa a lançar como se a campanha rendesse o dobro.

Se a figura ultrapassar a área visível, deslize para os lados. Pelo teclado, foque a figura e use as setas.
O que muda depois deste passo: você escolhe o método de envio que cabe na sua operação, lê os quatro diagnósticos que a Meta usa para medir a qualidade do sinal e confere a deduplicação com números de antes e de depois.
API de Conversões: a ligação direta entre o servidor da empresa e a Meta. Em vez de depender do código que roda no navegador do visitante, o evento sai do sistema que registrou a venda, seja a loja, o CRM ou o servidor do site. Os dois caminhos convivem: o Pixel capta o comportamento na página e o servidor confirma o que aconteceu.
Se a figura ultrapassar a área visível, deslize para os lados. Pelo teclado, foque a figura e use as setas.
No negócio, a diferença aparece no custo. Anunciantes com a API de Conversões para eventos web tiveram, em média, custo por resultado 17,8 por cento menor do que os sem, segundo dado interno da Meta divulgado em abril de 2026. É média de muitos anunciantes e dado do vendedor. Na sua conta, o ganho depende de quanto o navegador perdia.
Quatro famílias de método levam o evento ao servidor da Meta. A Meta-enabled Conversions API, conexão ativada em um clique no Gerenciador de Eventos, foi anunciada em 15 de abril de 2026 e ficou ativa em 27 de abril, só para eventos web. A integração nativa de uma plataforma parceira liga o envio pelo painel dela.
Conversions API Gateway: a solução hospedada que envia eventos web à Meta. Signals Gateway: um pipeline de dados próprios que manda o mesmo evento a vários destinos, inclusive fora da Meta. Por último vem o desenvolvimento próprio, que chama a API direto do seu sistema. Eventos de app, de loja física e de CRM seguem exigindo integração direta ou de parceiro.
Métodos de envio pelo servidor, do mais simples ao mais flexível
| Método | Eventos que envia | Esforço | Quando escolher |
|---|---|---|---|
| Meta-enabled Conversions API | Só web, espelhando o Pixel | Um clique no Gerenciador | Site com Pixel já correto; ativa desde 27/04/2026 |
| Integração nativa ou parceiro | Os que a plataforma decidiu enviar | Poucos cliques | Loja em plataforma com conexão pronta |
| Conversions API Gateway | Web, em solução hospedada | Configuração de servidor | Volume alto e controle sobre o envio |
| Signals Gateway | Dados próprios para vários destinos | Projeto de dados | Empresa que manda o mesmo dado a várias plataformas |
| Desenvolvimento próprio | Qualquer um, inclusive CRM e loja física | Desenvolvimento | Eventos que nascem fora do site |
Fonte: Meta for Developers; ppc.land, abril de 2026
Todo evento enviado pelo servidor carrega três campos de identidade. O event_name diz qual ação aconteceu, com o mesmo nome usado no Pixel. O event_time marca o momento da ação, em segundos. O action_source diz onde ela ocorreu: website para o site, physical_store para loja física, system_generated para o que nasce num sistema, como o CRM.
Correspondência é a capacidade de a Meta ligar o evento a uma pessoa com conta. Ela depende de identificadores como e-mail, telefone, nome, cidade e CEP. Antes do envio, cada um é normalizado em minúsculas, sem espaço, com o telefone no formato internacional. Depois passa por hash SHA-256, a transformação que embaralha o dado sem volta.
Se a figura ultrapassar a área visível, deslize para os lados. Pelo teclado, foque a figura e use as setas.
Event Match Quality: a nota de 0 a 10 da correspondência. Ela sobe com mais identificadores e com identificadores bem formatados. Uma nota baixa em Purchase significa compras que a Meta recebe e não consegue ligar a ninguém. São compras que existem no relatório de eventos e pouco ensinam ao sistema sobre quem compra.
Três identificadores técnicos completam o quadro
1 de 4fbp
O cookie do Pixel que identifica o navegador.
fbc
Guarda o identificador do clique no anúncio, quando a pessoa chega por ele.
external_id
O código do cliente no seu sistema, também com hash.
Enviados pelo servidor
Os três ligam o evento ao navegador que o Pixel viu e ao clique que o anúncio gerou.
Deduplicação: a regra que conta uma vez o evento que chega duas vezes. A Meta junta os disparos do navegador e do servidor quando os dois trazem o mesmo event_name e o mesmo event_id, o código único do evento. Na loja, o event_id mais seguro é o número do pedido, porque ele existe nos dois lados. Sem event_id igual, os dois disparos viram duas compras.
- Etapa 1 de 5: Pedido 48213 confirmado
A loja gera o número que vira event_id
- Etapa 2 de 5: Pixel dispara Purchase
event_id 48213, com fbp e fbc do navegador
- Etapa 3 de 5: Servidor envia Purchase
event_id 48213, e-mail e telefone com hash, external_id
- Etapa 4 de 5: Meta compara nome e event_id
Mesmo Purchase, mesmo código: um evento só
- Etapa 5 de 5: Uma compra no relatório
O servidor completa o que o navegador perdeu
Quatro diagnósticos medem o sinal no Gerenciador de Eventos, e o curso de Blueprint da Meta sobre a API de Conversões trata exatamente deles. A cobertura é a média de 7 dias do percentual de eventos do Pixel também enviados pelo servidor com chave de deduplicação. A correspondência é a Event Match Quality. A deduplicação mostra se os pares se juntam. A atualização mede o atraso entre a ação e o envio.
Leia os quatro juntos, porque um esconde o outro. Cobertura alta com deduplicação ruim infla o relatório. Nota alta com cobertura baixa melhora poucos eventos. Envio atrasado entrega ao lance uma informação velha. Quem cuida de várias contas pode ler os mesmos indicadores pela Dataset Quality API, a interface que a Meta publica para esse monitoramento.
Consentimento e minimização valem também no servidor. Se o visitante recusou o rastreamento, o evento dele fica fora do envio. Mande só o que a correspondência pede, faça hash antes de enviar e deixe de fora CPF, dado de saúde e texto livre de formulário. Anunciantes de saúde e bem-estar sob o core setup, a configuração restrita que a Meta aplica desde janeiro de 2025, ficam sem parâmetros personalizados e sem URL além do domínio também pela API de Conversões.
Manutenção fecha o ciclo
Programe uma conferência mensal dos quatro diagnósticos e da razão entre compras e pedidos.
- Tema novo e troca de plataforma quebram eventos sem aviso.
- Meio de pagamento novo e mudança de checkout também.
- Queda de cobertura ou de nota vira incidente, com responsável e prazo.
- Trate essa queda como qualquer falha de caixa.
alexandrecaramaschi.com/educacao/frontends-com-vibecoding
Armadilha comum: ligar a API de Conversões por cima de um Pixel que já duplicava. O servidor acrescenta um terceiro disparo do mesmo pedido, a deduplicação junta só o par com event_id igual e a conta fica com mais compras do que antes do conserto. A ordem certa é um disparo por evento no navegador e só então o servidor.
Se a figura ultrapassar a área visível, deslize para os lados. Pelo teclado, foque a figura e use as setas.
A Torra Serrana fez o conserto nessa ordem. Marina tirou do tema o código antigo que disparava Purchase a cada recarga e conferiu com o Meta Pixel Helper que a confirmação ficou com um disparo só. Então ativou a Meta-enabled Conversions API, porque todos os eventos da loja nascem no site. O B2B, que nasce no Pipedrive, ficou para depois.
Se a figura ultrapassar a área visível, deslize para os lados. Pelo teclado, foque a figura e use as setas.
Antes, o Gerenciador recebia 2.212 Purchase para 1.431 pedidos pagos em agosto, sem nenhuma cobertura de servidor e com Event Match Quality de 5,1 em Purchase. Três semanas depois, o mesmo recorte de 30 dias mostrou 1.489 Purchase para 1.512 pedidos criados, cobertura de 93 por cento e nota 7,8, com e-mail e telefone do checkout chegando com hash.
Junto veio o relatório de mídia. Com a mesma verba de R$ 18.000 na loja, as compras atribuídas caíram de 520 para 372 e o ROAS reportado de 4,3 para 3,1, com CPA de R$ 48. Marina levou os dois números à reunião dos sócios com uma frase: a campanha continuou igual, o termômetro é que parou de somar febre duas vezes.
Torra Serrana: a compra da loja antes e depois do servidor
2.212 para 1.489
Purchase recebidos em 30 dias
Contra 1.431 pagos e 1.512 criados; código antigo removido
0% para 93%
cobertura do servidor
Média de 7 dias, lida no Gerenciador de Eventos
5,1 para 7,8
Event Match Quality de Purchase
Escala de 0 a 10; e-mail e telefone com hash
4,3 para 3,1
ROAS reportado da loja
Mesma verba de R$ 18.000; o 4,3 contava compra duplicada
Fonte: Torra Serrana, cenário composto deste curso
Medir a compra da loja com dois códigos ou com navegador e servidor
Dois códigos no navegador, sem servidor
Agosto
- Purchase disparado pela integração e pelo tema
- Recarga da página contada como compra nova
- Evento perdido por bloqueador sem reposição
- Nenhum identificador enviado com hash
Um disparo no navegador e o servidor ao lado
Setembro
- Purchase só pela integração, com o número do pedido como event_id
- Servidor repete o evento com o mesmo event_id
- Deduplicação e cobertura conferidas toda semana
- E-mail e telefone normalizados e com hash SHA-256
Para a Torra Serrana, o ROAS menor foi a primeira notícia boa do trimestre, porque virou um número que o caixa confirma. Sobra uma distância que o servidor da loja não fecha: pedidos criados viram Purchase mesmo quando o Pix expira, e o B2B segue sem contar à Meta quais leads assinaram contrato.

Texto do infográfico
Dados guiam vendas na Torra Serrana. Contexto: a arquitetura de mensuração conecta cada decisão de mídia a um dado confiável. Plano de mensuração: definir objetivos e eventos padrão. O mapa liga decisões de mídia aos dados da Torra Serrana. Captura front-end: instalar Pixel no navegador web. O instrumento inicial mede ações durante a navegação. Conexão servidor: ativar API de Conversões direta. O servidor confirma o que o navegador perdeu. Identidade única: unificar registros via event_id único. A deduplicação evita contagem dobrada da mesma compra. Retorno de dados: enviar venda confirmada pelo CRM. O sistema informa quais leads geraram contratos reais. Análise final: ler atribuição e resultado incremental. A conferência mensal valida o retorno sobre investimento.
Se a figura ultrapassar a área visível, deslize para os lados. Pelo teclado, foque a figura e use as setas.
Guia prático de configuração. Tudo começa na aba Configurações do conjunto de dados, no Gerenciador de Eventos. Ali aparecem os caminhos de envio pelo servidor: Gateway e Signals Gateway na nuvem, integração direta com token de acesso e integração por parceiro, como plataformas de loja e ferramentas de dados.

Imagem: Meta for Developers, Conversions API, Get Started. Reproduzida para fins educacionais, com crédito à fonte.
Se a figura ultrapassar a área visível, deslize para os lados. Pelo teclado, foque a figura e use as setas.
Ligar a API de Conversões, deduplicar e testar em oito passos
Passo 1: Arrumar o Pixel antes do servidor
Um disparo por evento, com o número do pedido como eventID no quarto argumento do fbq('track').
Deu certo quando: O Meta Pixel Helper mostra uma única compra por confirmação de pedido.
Erro comum: Plugin da loja e gerenciador de tags disparando o mesmo evento.
Passo 2: Escolher o método em Configurações
Gateway ou parceiro para quem não tem desenvolvedor; integração direta para quem precisa de controle do dado.
Deu certo quando: O status da integração aparece na visão geral do conjunto de dados.
Erro comum: Ligar a opção de um clique da Meta por cima de um parceiro que já envia, criando duas fontes de servidor.
Passo 3: Gerar o token com a Dataset Quality API
Na integração direta, 'Generate access token' com a opção da Dataset Quality API marcada.
Deu certo quando: O token fica guardado no cofre de segredos do servidor.
Erro comum: Token colado no código do site ou no repositório.
Passo 4: Montar o evento mínimo
event_name, event_time em segundos, event_id igual ao do navegador, action_source igual a website, event_source_url e, em user_data, e-mail e telefone normalizados em SHA-256, external_id, fbp, fbc, IP e user agent.
Deu certo quando: A resposta da API traz events_received.
Erro comum: Hash de e-mail com letra maiúscula ou espaço, ou telefone sem o 55 do Brasil.
Passo 5: Testar com o código de teste
Copie o test_event_code da aba Eventos de teste e envie junto do evento. O teste fica visível por 24 horas.
Deu certo quando: O evento aparece como 'Servidor' e, numa compra de teste, o par navegador e servidor aparece como desduplicado.
Erro comum: Esquecer o código em produção: esses eventos entram no Gerenciador e contaminam a leitura.
Passo 6: Ler a aba de desduplicação
Visão geral, Detalhes do evento, aba 'Desduplicação de eventos': taxa de eventos desduplicados e taxa de uso da chave de desduplicação.
Deu certo quando: Sobreposição alta de event_id entre navegador e servidor, sem alerta.
Erro comum: event_id gerado de novo em cada lado, como dois identificadores aleatórios diferentes.
Passo 7: Conferir a atualização do evento
A aba 'Atualização do evento' mostra o atraso médio, de tempo real a semanal.
Deu certo quando: Compra chegando em até 1 hora, o prazo recomendado para campanhas de vendas.
Erro comum: Envio em lote noturno, que entrega ao lance uma informação velha.
Passo 8: Ler a nota de qualidade depois de 48 horas
A nota de 0 a 10 considera as últimas 48 horas e vale para eventos de site enviados pelo servidor.
Deu certo quando: E-mail e identificação de clique presentes na maior parte das compras.
Erro comum: Julgar a nota no primeiro dia ou pelo PageView, que raramente leva e-mail.
No fim você tem: Compras contadas uma vez, com dado de cliente suficiente para o sistema achar quem se parece com quem compra.
Parâmetros de cliente pela prioridade que a Meta dá na nota de qualidade
| Prioridade | Parâmetros | Formato antes de enviar |
|---|---|---|
| Alta | E-mail (em) e identificação de clique (fbc) | E-mail sem espaços, em minúsculas e em SHA-256; fbc sem hash, no formato fb.subdomínio.data.fbclid |
| Média | Telefone (ph), external_id, identificação do navegador (fbp), país, data de nascimento, Facebook Login ID | Telefone só com dígitos e código do país, em SHA-256; external_id com hash recomendado; fbp sem hash |
| Baixa | Nome, sobrenome, cidade, CEP e lead ID | Normalizados e em SHA-256, exceto o lead ID |
| Sempre em evento web | IP e user agent do navegador | Sem hash; IPv6 é preferível quando o visitante tem IPv6 |
Prioridade da página 'Sobre a qualidade da correspondência de eventos' e formatos da documentação Customer Information Parameters, consultadas em setembro de 2026.
Prazo para enviar o evento pelo servidor, por produto
| Uso do evento | Recomendado | Máximo aceito |
|---|---|---|
| Campanhas de vendas, leads e engajamento | até 1 hora | 7 dias |
| Públicos personalizados | até 24 horas | 7 dias |
| Anúncios de catálogo Advantage+ | até 1 hora | 24 horas |
| Conversion Lift | até 7 dias | 90 dias |
| Eventos offline em públicos | até 24 horas | 62 dias |
Cada requisição aceita até 1.000 eventos, e um evento inválido derruba o lote inteiro.
O um clique não dispensa a conferência
Especialistas divergem sobre o que a API de Conversões ativada pela Meta faz com a deduplicação; a aba de desduplicação mostra a resposta na sua conta.
- BTB Audits (maio de 2026) diz que o um clique instala a conexão, não a deduplicação.
- Alex Paddington (junho de 2026) diz que a Meta deduplica sozinha nesse modo.
- A Stape lembra que visita orgânica, do Google ou de e-mail não traz fbc.
- Na Meta, event_id ausente gera só aviso, e o envio responde 200.
alexandrecaramaschi.com/educacao/frontends-com-vibecoding
Abra o Gerenciador de Eventos, anote a cobertura e a Event Match Quality do seu Purchase e repita a anotação em sete dias. Com a cobertura estável ou em alta e nenhum alerta de duplicado na aba de diagnósticos, o capítulo 'Levar a venda confirmada no CRM de volta à Meta' tem base para ligar o seu CRM.
Seu caderno neste capítulo
Abrir o caderno completoSelecione um trecho do capítulo para destacar ou anotar. Nos vídeos e áudios, use Anotar este momento. No teclado, selecione com Shift e as setas e use Alt+Shift+D para destacar ou Alt+Shift+N para anotar.
Salvo neste navegador. Entre na sua conta para levar o caderno a outros aparelhos.
Entre na sua conta para compartilhar o que aprendeu e convidar alguém para estudar com você.
Conexões deste capítulo
Explore os conceitos e compare abordagens em outros cursos. As conexões indicam assuntos relacionados; a sequência de estudo continua no índice do curso.
Conceitos deste capítulo
O mesmo assunto em outros cursos
- TikTok Ads e Live Commerce 2027Enviar eventos pelo servidor com a Events API sem contar venda em dobroExaminar conexões de Enviar eventos pelo servidor com a Events API sem contar venda em dobro
- Google Analytics 2027Enviar do servidor o evento que o navegador não vê, sem duplicarExaminar conexões de Enviar do servidor o evento que o navegador não vê, sem duplicar
Leve uma ideia para a prática
Escolha uma atividade no painel e volte a este curso quando quiser.
Atividades e evolução ficam reunidas no painel da sua conta.
Capítulos vizinhos em Meta Ads 2027
- 07Preparar perfil, página de destino e atendimento para receber o clique
- 08Desenhar o plano de mensuração e instalar o Meta Pixel com eventos úteis
- 09Enviar eventos pelo servidor com a API de Conversões sem duplicar
- 10Levar a venda confirmada no CRM de volta à Meta
- 11Ler a atribuição da Meta depois das mudanças de 2026