Se você anuncia no Meta Ads e mede tudo só pelo pixel, está decidindo verba com parte das vendas invisível. Bloqueadores, navegadores mais restritivos e cookies cada vez mais limitados fazem eventos se perderem no caminho, e o algoritmo otimiza com menos sinal do que poderia.
A API de Conversões fecha essa lacuna: ela envia os eventos direto do servidor, da plataforma do site ou do CRM para a Meta, sem depender do navegador. Resposta curta para a dúvida mais comum: ela não substitui o pixel. Os dois trabalham juntos.
Neste guia você vê o que é a API de Conversões, por que ela complementa o pixel com a perda de cookies, como configurar pelo Gerenciador de Eventos ou pelo GTM server-side, como checar a qualidade da correspondência e os 7 erros mais comuns.
Com a Black Friday chegando, vale ajustar isso antes de colocar em prática o nosso cronograma de Black Friday 2026.
O que é a API de Conversões do Meta?
A API de Conversões (Conversions API, ou CAPI) é uma conexão de servidor para servidor entre os seus sistemas e a Meta. Segundo a documentação oficial da Meta, ela liga eventos do site, do app, de mensagens comerciais e conversões offline aos sistemas que otimizam a segmentação, reduzem o custo por resultado e medem os resultados.
Na prática, quando alguém compra, preenche um formulário ou vira oportunidade no CRM, o seu servidor avisa a Meta diretamente. O pixel faz o mesmo pelo navegador. Os dois eventos chegam com uma chave em comum, e a Meta descarta a duplicata para contar a conversão uma vez só.
E ela não é exclusiva de e-commerce. A API de Conversões aceita eventos da web, do app, de mensagens comerciais e offline, e a Meta mantém um guia de integração com CRM para eventos de lead, como indica a página de parâmetros da API.
Por que a API de Conversões complementa o pixel com a perda de cookies?
O pixel roda no navegador do usuário. Se a pessoa usa bloqueador, um navegador que limita rastreamento ou fecha a página antes de o script carregar, o evento não sai. A conversão aconteceu, mas a Meta não ficou sabendo, e a campanha parece pior do que é.
E muita gente construiu a medição sobre cookies de terceiros: segundo a 8ª edição do State of Marketing da Salesforce (tendências para 2023), citada pela Exame, 75% dos profissionais de marketing ainda usavam esse tipo de cookie. A pesquisa ouviu 6.000 gestores e executivos de 35 países, incluindo o Brasil.
A própria Meta divulga o ganho: anunciantes com API de Conversões para eventos web tiveram, em média, custo por resultado 17,8% menor do que os que não usam a ferramenta, segundo dado da Meta reportado pelo PPC Land. É média da plataforma, não promessa de resultado.
Para o contexto completo da perda de cookies, veja nosso guia de marketing sem cookies e as estratégias de first-party data.
| Critério | Pixel do Meta | API de Conversões |
|---|---|---|
| Onde roda | Navegador do usuário | Servidor, plataforma do site ou CRM |
| Depende de script no navegador | Sim | Não |
| Eventos fora do site (CRM, offline) | Não | Sim |
| Esforço de implantação | Baixo | De um clique a projeto técnico |
| Melhor uso | Comportamento na página | Conversões que precisam chegar com dados completos |
Quais são as formas de configurar a API de Conversões?
Existem quatro caminhos principais. A escolha depende de quanto controle você precisa sobre quais eventos sobem e com quais dados do cliente.
| Método | Esforço | Controle | Indicado para |
|---|---|---|---|
| Um clique no Gerenciador de Eventos | Mínimo, sem código | Nenhum: envia o que o pixel envia | Quem quer começar hoje |
| Integração de parceiro (plataforma ou CRM) | Baixo | Limitado ao que o parceiro oferece | E-commerce em plataforma pronta |
| GTM server-side | Médio, exige servidor | Alto: escolhe eventos e parâmetros | Quem já usa GTM e quer controle |
| Integração direta via código | Alto, exige desenvolvedor | Total | Operações com CRM próprio e eventos offline |
A versão de um clique foi anunciada pela Meta em 15/04/2026 como uma configuração gratuita que cria a conexão de servidor junto com o pixel e desduplica os eventos automaticamente, segundo o PPC Land. A limitação é clara: não dá para escolher eventos nem parâmetros, porque a API de Conversões envia exatamente o que o pixel envia.
Como configurar a API de Conversões pelo Gerenciador de Eventos
É o caminho mais rápido. A documentação da Meta confirma que quem já tem o pixel no site pode ativar a integração para eventos web com um clique, sem código, sem configuração e sem taxa de implementação. O roteiro é este:
- Abra o Gerenciador de Eventos e selecione o conjunto de dados (o pixel) do site.
- Nas configurações, localize a seção da API de Conversões e escolha a configuração feita pela Meta.
- Revise os eventos que o pixel já envia, porque são eles que o servidor vai repetir.
- Confira na visão geral se os eventos aparecem recebidos pelo navegador e pelo servidor.
- Acompanhe a qualidade da correspondência de cada evento nos dias seguintes.
Esse modo é ótimo para sair do zero, mas herda os defeitos do pixel: se ele não envia e-mail e telefone, o servidor também não envia. Antes de ativar, revise a marcação, tema do nosso artigo sobre erros no Google Tag Manager.
Como configurar a API de Conversões pelo GTM server-side
O GTM server-side dá controle total: você decide quais eventos sobem e com quais parâmetros. Segundo o Google, a tag do lado do servidor melhora o desempenho e a segurança do site porque processa os dados num servidor, e não no navegador do usuário.
1. Crie o container de servidor
No Google Tag Manager, crie um container do tipo Servidor. O Google recomenda o provisionamento automático no Google Cloud (Cloud Run), mas também dá para configurar manualmente em outra plataforma. O custo mensal varia com o volume de requisições.
2. Aponte um subdomínio próprio
O servidor nasce com uma URL padrão em run.app. Para melhorar a privacidade e a durabilidade dos cookies, a documentação do Google recomenda apontar um subdomínio do seu site, como dados.suaempresa.com.br, para o servidor de tags.
3. Envie os eventos do container web para o servidor
No container web, configure a tag do Google para mandar os dados ao endereço do servidor, onde o cliente do GA4 recebe as requisições e as transforma em eventos para as tags. Se você já marca conversões no GA4, aproveite nosso guia de conversões GA4 no GTM.
4. Instale a tag da Meta no container de servidor
Na Galeria de Modelos da Comunidade, adicione o modelo de tag da API de Conversões da Meta. Informe o ID do pixel e o token de acesso gerado nas configurações do conjunto de dados, no Gerenciador de Eventos. Depois defina em quais eventos a tag dispara e mapeie os parâmetros do cliente.
5. Use o mesmo event_id no pixel e no servidor
Gere um ID único por evento no container web e envie o mesmo valor para o pixel e para o servidor. É com essa chave, junto com o nome do evento, que a Meta desduplica. Sem ela, cada compra pode ser contada duas vezes.
6. Teste com o Preview e o Testar Eventos
Use o modo de visualização do container de servidor para ver a tag disparando. Ao mesmo tempo, abra a ferramenta Testar Eventos no Gerenciador de Eventos com o código de teste. Só publique quando os eventos aparecerem como recebidos e desduplicados, como a Meta recomenda na documentação da API de Conversões.
Como usar a API de Conversões com o CRM no B2B?
No B2B, otimizar por formulário preenchido costuma encher o funil de contatos que nunca compram. Pelo servidor dá para enviar o que acontece depois: lead qualificado, reunião marcada, proposta e venda fechada. Assim o algoritmo aprende quem vira cliente, e não só quem clica.
Eventos que não são da web exigem apenas o parâmetro action_source, segundo a página de parâmetros da Meta, o que simplifica o envio a partir do CRM. Na Agência Veezy, fazemos essa ponte com n8n ligando o Kommo às plataformas de anúncio, como mostramos nas automações com n8n para marketing.
Veja como aplicamos essa lógica em um de nossos cases de automação B2B com CRM e Google Ads. O pré-requisito é ter o funil organizado: se as etapas do CRM não refletem a realidade, a Meta aprende com dado errado. Comece pela configuração do Kommo CRM.
Como checar a qualidade da correspondência de eventos?
Enviar o evento é metade do trabalho. A outra metade é a Meta conseguir ligá-lo a uma pessoa.
Segundo a documentação da Dataset Quality API, a qualidade da correspondência de eventos (EMQ) avalia se você envia pela API de Conversões as informações certas do cliente, considerando quais parâmetros chegam, a qualidade desses dados e o percentual de eventos associados a uma conta.
A EMQ aparece no Gerenciador de Eventos, por evento, e é calculada em tempo real. Ao lado dela, acompanhe outras métricas da mesma documentação:
- Cobertura de eventos: média de 7 dias do percentual de eventos do pixel que também chegam pela API de Conversões com chaves de desduplicação em comum (fonte: Meta).
- Conversões adicionais reportadas (ACR): estimativa de quantas conversões a mais passam a ser medidas graças à API usada junto com o pixel.
- Desduplicação: confirma se pixel e servidor estão sendo unidos ou contados em dobro.
Os parâmetros que mais elevam a correspondência na API de Conversões são e-mail e telefone com hash, os identificadores fbp e fbc (navegador e clique no anúncio), IP, user agent e um ID externo vindo do CRM. Priorize os eventos que otimizam a campanha: se ela otimiza por lead, a correspondência do evento Lead pesa mais que a do PageView.
Na Agência Veezy, toda auditoria de Meta Ads começa por cobertura e EMQ, porque elas mostram se a API de Conversões está entregando sinal útil. Leve as duas métricas para o seu relatório de tráfego pago.
Os 7 erros mais comuns na API de Conversões
1. event_id diferente entre pixel e servidor
Pixel e servidor enviam a mesma compra com IDs diferentes, ou sem ID. A Meta não consegue unir os dois e a conta reporta mais conversões do que existem.
Como resolver: gere o event_id no momento da ação e use o mesmo valor e o mesmo nome de evento nos dois envios.
2. Parâmetros obrigatórios ausentes
Eventos do site enviados pela API de Conversões exigem client_user_agent, action_source e event_source_url, segundo a documentação de parâmetros. Sem eles, a requisição falha.
Como resolver: valide o envio no Testar Eventos. Em eventos de CRM, que não são da web, só o action_source é obrigatório.
3. Dados sem normalização antes do hash
E-mail com maiúscula ou espaço sobrando e telefone sem código do país geram um hash que não bate com o da Meta.
Como resolver: antes do hash SHA-256, deixe o e-mail em minúsculas e sem espaços, e o telefone só com números, incluindo o 55 do Brasil.
4. event_time antigo demais
Integrações com CRM às vezes sobem eventos em lote, dias depois. A documentação de parâmetros aceita event_time de até 7 dias antes do envio na API de Conversões; acima disso, a requisição é recusada.
Como resolver: envie em tempo real ou em rotina diária, sempre com o horário real da ação, e não o do envio.
5. Ligar a versão de um clique e parar por aí
A versão de um clique repete o que o pixel envia. Se o pixel não captura e-mail e telefone, a correspondência continua baixa.
Como resolver: use o um clique para começar e migre a API de Conversões para o GTM server-side ou integração direta quando precisar escolher eventos e parâmetros.
6. Otimizar por formulário no B2B
A conta aprende a achar quem preenche, não quem compra. O resultado é custo por lead bonito e pipeline vazio.
Como resolver: envie do CRM os estágios de qualificação e venda pela API de Conversões e, com volume suficiente, otimize por eles.
7. Ignorar consentimento e LGPD
Mandar dados pelo servidor não dispensa a LGPD, sancionada em agosto de 2018. Segundo a Exame, cookies não são ilegais, mas dependem do consentimento do usuário.
Como resolver: respeite a escolha do banner de cookies também no servidor, registre a base legal na política de privacidade e lembre que hash não torna o dado anônimo.
Perguntas frequentes sobre API de Conversões
O que é a API de Conversões do Meta?
É uma conexão de servidor que envia eventos do site, do app, do CRM e conversões offline direto para a Meta, sem depender do navegador. Ela complementa o pixel e ajuda o Meta Ads a medir e otimizar campanhas com dados mais completos.
A API de Conversões substitui o pixel do Meta?
Não. O ideal é usar os dois juntos, com o mesmo event_id para a Meta desduplicar. O pixel capta o comportamento no navegador e o servidor garante que a conversão chegue mesmo quando o navegador falha ou bloqueia o script.
Quanto custa usar a API de Conversões?
A Meta não cobra pelo uso, e a versão de um clique no Gerenciador de Eventos não tem taxa de implementação. No GTM server-side existe o custo do servidor na nuvem, que varia com o tráfego. Na integração direta, entra o custo de desenvolvimento.
Como saber se a API de Conversões está funcionando?
Abra o Gerenciador de Eventos e confira se cada evento aparece recebido pelo navegador e pelo servidor, com desduplicação ativa. Depois acompanhe a qualidade da correspondência, a cobertura de eventos e as conversões adicionais reportadas, e cruze os números com o CRM.
Preciso de consentimento para enviar dados pela API de Conversões?
Sim. A LGPD vale para o envio pelo servidor tanto quanto para o pixel. Respeite a escolha do banner de cookies, registre a base legal na política de privacidade e envie e-mail e telefone apenas com hash, lembrando que hash não torna o dado anônimo.
API de Conversões pronta antes da Black Friday
A Agência Veezy, especializada em tráfego pago e marketing digital B2B em São Paulo, configura a API de Conversões, revisa a qualidade da correspondência e liga os eventos do CRM às suas campanhas para que o Meta Ads otimize por venda, e não por clique. Fale com nosso time e peça um diagnóstico da sua conta, ou veja os serviços de performance e mídia paga em agenciaveezy.com.br.
