Meta Ads 2027 · Capítulo 9 de 36 · 13 min
Confirmar cada venda direto do seu sistema, sem contar duas vezes
A API de Conversões manda a venda pelo servidor, recupera o que o navegador perdeu e, com a deduplicação, conta cada pedido uma vez.
Este capítulo faz parte do curso gratuito Meta Ads 2027.
No balcão de uma loja, o vendedor anota o pedido e o caixa confirma o que foi pago; quando os dois registros batem, ninguém conta a mesma venda duas vezes. Na Meta, o Pixel faz o papel do vendedor, anotando no navegador, e a API de Conversões, o canal que leva o evento do servidor da empresa à Meta, faz o papel do caixa. A decisão do capítulo é como ligar esse segundo registro sem dobrar a compra no relatório.
- API de Conversões
A ligação direta entre o servidor da empresa e a Meta.
- Método de envio
Quatro famílias de método levam o evento ao servidor da Meta.
- Correspondência
Os dados de identidade deixam a Meta ligar o evento a uma pessoa.
- Deduplicação
O mesmo event_id faz a compra dupla contar uma vez.
- Quatro diagnósticos
Cobertura, correspondência, deduplicação e atualização no Gerenciador de Eventos.
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.

Ver como texto
Dois caminhos, um vindo do celular e outro de um servidor, levam envelopes com o mesmo selo e se juntam num funil que entrega um único pacote de café.
Na prática, a 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 servidor do site ou o CRM, o sistema de clientes e negociações. Os dois caminhos convivem: o Pixel capta o comportamento na página e o servidor confirma o que aconteceu.
Ver como texto
Página da API de Conversões da Meta com o título Maximize o desempenho e a mensuração da campanha e o botão Escolher sua configuração
Ver como texto
Pixel e API de Conversões enviando o mesmo evento, deduplicado pela Meta
No negócio, a diferença aparece no custo. A Meta divulgou em abril de 2026 que anunciantes com a API de Conversões para eventos web tiveram custo por resultado menor, em média, do que os sem; o número está no quadro abaixo. É média de muitos anunciantes, publicada pelo vendedor. Na sua conta, o ganho depende de quanto o navegador perdia.
O que a Meta publicou sobre o envio pelo servidor
17,8%
menor custo por resultado, em média
Anunciantes com API de Conversões para eventos web, divulgado em abril de 2026
27/04/2026
conexão de um clique ativa
Meta-enabled Conversions API, só para eventos web
até 1 hora
prazo recomendado de envio
Para campanhas de vendas, leads e engajamento
0 a 10
escala da nota de correspondência
Event Match Quality, calculada sobre as últimas 48 horas
Fonte: Meta: dado interno de abril de 2026, sem método publicado, e documentação para desenvolvedores
Os métodos de envio vão do mais simples ao mais flexível. A conexão de um clique no Gerenciador de Eventos, a área onde chegam os dados de conversão, espelha o Pixel em eventos web e está ativa desde 27 de abril de 2026. A integração de plataforma parceira liga o envio pelo painel dela. Os gateways hospedados e o desenvolvimento próprio servem a quem precisa de controle ou envia eventos que nascem fora do site, como CRM e loja física.
| 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
Para a Meta, cada evento enviado pelo servidor chega com nome, hora e origem: qual ação aconteceu, quando e onde, no site, na loja física ou num sistema como o CRM. O nome precisa ser igual ao usado no Pixel, senão a deduplicação não encontra o par.
Três campos identificam cada evento do servidor
Todo evento enviado pela API de Conversões carrega event_name, event_time e action_source.
- event_name: o nome da ação, igual ao do Pixel, como Purchase ou Lead.
- event_time: o momento da ação, em segundos.
- action_source: website, physical_store ou system_generated, conforme a origem.
- system_generated vale para o que nasce num sistema, como o CRM.
alexandrecaramaschi.com/educacao/frontends-com-vibecoding
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.
Ver como texto
Normalização e hash dos identificadores antes do envio
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: existem no relatório de eventos e pouco ensinam ao sistema sobre quem compra. Os três identificadores do quadro a seguir são detalhe de implementação, assunto do desenvolvedor.
Ver como texto
Artigo da Central de Ajuda da Meta sobre a qualidade da correspondência de eventos, com a pontuação de 0 a 10 do evento do servidor
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.
Ver como texto
Documentação de desenvolvedores da Meta sobre como gerenciar eventos duplicados de Pixel e API de Conversões, atualizada em 28 de junho de 2026
- 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
Ver como texto
- Pedido 48213 confirmado: A loja gera o número que vira event_id
- Pixel dispara Purchase: event_id 48213, com fbp e fbc do navegador
- Servidor envia Purchase: event_id 48213, e-mail e telefone com hash, external_id
- Meta compara nome e event_id: Mesmo Purchase, mesmo código: um evento só
- 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.
Ver como texto
Documentação de desenvolvedores da Meta sobre a Dataset Quality API, com aviso sobre níveis de acesso e métricas de qualidade de eventos
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
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.
Saúde e bem-estar têm regra mais dura. Anunciantes desses setores 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.
Exemplo: uma loja que ainda dispara duas compras no navegador ativa a conexão de servidor para resolver a medição. No relatório seguinte aparecem mais compras do que antes. O servidor acrescentou um terceiro envio do mesmo pedido, a deduplicação juntou só o par com event_id igual e o código antigo continuou sobrando. A ordem certa é deixar um disparo por evento no navegador e só então ligar o servidor.
Ver como texto
Animação de três disparos do mesmo pedido chegando à deduplicação
Exemplo: seguindo essa ordem, primeiro sai do tema o código antigo que disparava Purchase a cada recarga. O Meta Ads Data Advisor, nome atual do antigo Meta Pixel Helper, confirma então que a página de confirmação ficou com um disparo só. Depois entra a conexão de um clique, adequada quando todos os eventos da loja nascem no site. O B2B, cujos eventos nascem no CRM, fica para uma etapa seguinte.
Ver como texto
Fluxograma da ordem do conserto antes de ligar o servidor
Exemplo: antes do conserto, o Gerenciador recebe 2.212 Purchase para 1.431 pedidos pagos, sem nenhuma cobertura de servidor e com Event Match Quality de 5,1 em Purchase. Três semanas depois, um recorte de 30 dias mostra 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. Atenção aos denominadores: o primeiro número compara com pedidos pagos e o segundo com pedidos criados. Além disso, o recorte de 30 dias ainda inclui dias anteriores ao conserto. A comparação mostra o sentido da mudança, não uma medida exata.
No mesmo exemplo, com a mesma verba de R$ 18.000 na loja, as compras atribuídas caem de 506 para 360. O ROAS reportado, a receita atribuída dividida pela verba, vai de 4,2 para 3,0. O CPA, o custo de mídia por compra, vai de R$ 36 para R$ 50 (18.000 ÷ 506 e 18.000 ÷ 360). A queda é da contagem, não da campanha: a medição deixou de somar a mesma compra duas vezes, e a campanha seguiu do mesmo tamanho. Essa é a explicação a levar à diretoria antes que alguém corte verba por causa do número menor.
Exemplo: 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,2 para 3,0
ROAS reportado da loja
Mesma verba de R$ 18.000; o 4,2 contava compra duplicada
Medir a compra da loja com dois códigos ou com navegador e servidor
Dois códigos no navegador, sem servidor
Junho
- 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
Julho
- 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
Na loja, o ROAS menor foi a primeira notícia boa de julho, 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.
Aviso editorial de 26/10/2026: este infográfico foi gerado com o cenário hipotético Torra Serrana, usado pelo curso antes desta revisão editorial; não é empresa real nem fonte de resultados. A imagem e a transcrição abaixo foram mantidas como publicadas; as etapas ilustram a ordem da mensuração e não comprovam ganho.

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.
Ver como texto
Fluxo em escada com seis etapas coloridas: plano de mensuração, Pixel no navegador, API de Conversões no servidor, deduplicação por event_id, venda confirmada devolvida pelo CRM e leitura final de atribuição e resultado incremental.
Guia prático de configuração. Tudo começa na aba Configurações do conjunto de dados, o recipiente que junta os eventos da empresa 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.
Ver como texto
Aba Configurações de um conjunto de dados no Gerenciador de Eventos, com as opções da API de Conversões: Conversions API Gateway, Signals Gateway, integração direta com a Dataset Quality API e o botão Generate access token, e integração por parceiro.
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 Ads Data Advisor 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.
| 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.
| 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
Os consultores BTB Audits e Alex Paddington divergem sobre o que a conexão de um clique 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
Na segunda-feira, anote a cobertura e a Event Match Quality do seu Purchase no Gerenciador de Eventos e repita a anotação sete dias depois. A base está pronta quando a cobertura ficar estável ou em alta e a aba de diagnósticos não mostrar alerta de duplicado; aí o capítulo 'Levar a venda confirmada no CRM de volta à Meta' liga 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
Veja o que estudar antes e para onde seguir depois, explore os conceitos e compare abordagens em outros cursos. Sugestões marcadas como “sugerido pelo grafo” vêm dos assuntos em comum, não do índice do curso.
Conceitos deste capítulo
O mesmo assunto em outros cursos
- Motor de crescimento para IAMedir antes de gastar o primeiro realExaminar conexões de Medir antes de gastar o primeiro real
- TikTok Ads e vendas ao vivoDefinir o que medir antes de instalar ferramentasExaminar conexões de Definir o que medir antes de instalar ferramentas
- MCP e Chrome: agentes de IA no navegadorComo conferir o caminho de uma conversãoExaminar conexões de Como conferir o caminho de uma conversão
- Google Analytics 2027Server-side e Measurement Protocol: medir pagamentos fora do siteExaminar conexões de Server-side e Measurement Protocol: medir pagamentos fora do site
Terminou a leitura?
Você está aqui: capítulo 9 de 36
0 de 36 concluídos
- Próximo · Capítulo 10 de 36 · 10 minLevar a venda confirmada no CRM de volta à MetaLer o capítulo 10 sem concluir
Marque como concluído para o capítulo contar no seu painel e no certificado.
- Anterior · Capítulo 8 de 36 · 12 minDecidir o que medir no site e instalar o Pixel da MetaVoltar para o capítulo 8
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 e atendimento para não perder o clique
- 08Decidir o que medir no site e instalar o Pixel da Meta
- 09Confirmar cada venda direto do seu sistema, sem contar duas vezes
- 10Levar a venda confirmada no CRM de volta à Meta
- 11Explicar por que Meta, Google Analytics e loja contam vendas diferentes



