API de Conversões da Meta: como saber se o seu Pixel está funcionando

O Gerenciador de Anúncios mostra 12 leads no mês. O comercial conta 31 pedidos de orçamento que vieram do Instagram. Alguém diz que “o Pixel está instalado”, porque um dia uma agência colocou um código no site, mas ninguém sabe dizer se ele registra todos os formulários, se conta duas vezes ou se parou de funcionar depois da última atualização do site.

Esse cenário é mais comum do que parece. E ele tem um custo direto: a Meta decide para quem mostrar os seus anúncios com base nos eventos que recebe. Se ela recebe metade das conversões, aprende com metade da informação.

Este artigo explica o que é a API de Conversões, por que o Pixel sozinho costuma perder eventos, como você mesmo pode testar o rastreamento hoje e quais são as formas de instalar, da mais simples à mais completa.

Por que o Pixel sozinho perde conversões

O Pixel da Meta é um código que roda no navegador do visitante. Quando a pessoa envia um formulário ou finaliza uma compra, o navegador dispara um aviso para a Meta. O problema é que esse aviso depende de tudo dar certo no aparelho de quem está navegando.

A documentação de boas práticas da Meta cita esse limite diretamente: o Pixel pode perder eventos por problemas de conexão ou erros no carregamento da página. Na prática, os casos que mais encontramos em auditorias são:

• A página de obrigado carrega devagar e a pessoa fecha antes de o código rodar.
• O site foi refeito ou trocou de tema, e o código do Pixel ficou só em parte das páginas.
• O formulário mudou (de uma página de obrigado para uma mensagem na mesma tela), e o evento de lead deixou de disparar.
• Bloqueadores de anúncio e restrições do navegador impedem o script de carregar.
• O lead vira venda fora do site, no WhatsApp ou na loja, e o Pixel nunca fica sabendo.

Nenhum desses problemas aparece como erro no Gerenciador de Anúncios. A campanha simplesmente mostra menos resultados do que existiram.

O que é a API de Conversões, em português claro

A API de Conversões (em inglês, Conversions API, ou CAPI) é um canal oficial da Meta para enviar os mesmos eventos a partir do servidor, e não do navegador. Quando um lead chega no seu sistema, o próprio servidor do site, o CRM ou a ferramenta de automação avisa a Meta.

Segundo a documentação da Meta, os eventos enviados pelo servidor ficam ligados ao mesmo conjunto de dados do Pixel e são processados da mesma forma. A API também aceita eventos de app, de conversas e conversões offline, como uma venda fechada na loja física a partir de um lead do anúncio.

O ponto mais importante: a API de Conversões não substitui o Pixel. A recomendação da Meta é a chamada configuração redundante: enviar os mesmos eventos pelos dois canais. O que o navegador perder, o servidor cobre.

Pixel x API de Conversões: o que muda

	Pixel da Meta	API de Conversões
Onde roda	No navegador do visitante	No servidor, CRM ou automação
Depende do carregamento da página	Sim	Não
Registra vendas fora do site	Não	Sim, como evento offline
Instalação	Código no site ou plugin	Integração nativa, Gateway ou desenvolvimento
Dados do cliente	Coletados no navegador	Enviados pelo servidor, com e-mail e telefone criptografados
Papel recomendado	Usar junto com a API	Usar junto com o Pixel

Como saber hoje se o seu Pixel está funcionando

Você não precisa ser técnico para fazer um primeiro diagnóstico. Separe 20 minutos e siga estes passos.

1. Veja o que o navegador está enviando

Instale a extensão gratuita da Meta para Chrome ou Edge. Ela se chamava Meta Pixel Helper e hoje se chama Meta Ads Data Advisor; quem já tinha a antiga recebe a atualização automaticamente. Desative o bloqueador de anúncios, abra o seu site e preencha um formulário de teste.

A extensão mostra quais Pixels foram encontrados na página, se carregaram e quais eventos dispararam. Fique atento a três sinais:

• Nenhum evento de Lead ou Purchase depois do envio: o evento principal não está configurado.
• Dois Pixels diferentes na mesma página: comum quando uma agência antiga deixou o código dela.
• Avisos de parâmetros faltando, como valor e moeda em uma compra.

2. Confira os eventos no Gerenciador de Eventos

No Gerenciador de Eventos (Events Manager), abra o seu Pixel e vá em Visão geral. Ali aparecem os eventos recebidos, o canal de conexão de cada um (navegador ou servidor) e quantos foram descartados por duplicidade ou por regras de consentimento. A Meta informa que os eventos devem aparecer em até 20 minutos depois de enviados.

Se a coluna de conexão mostra só “navegador”, você ainda não usa a API de Conversões.

3. Compare com o seu número real

Pegue um período fechado, por exemplo os últimos 30 dias, e compare os leads que o Gerenciador de Anúncios mostra com os leads que chegaram de fato pelo site (no CRM, na planilha ou no e-mail). Os números nunca batem 100%, porque a Meta atribui conversões por janelas de tempo e nem todo lead vem do anúncio. Mas uma diferença grande, como no exemplo da abertura, é sinal de evento perdido.

4. Olhe a qualidade da correspondência

Cada evento tem uma nota de qualidade da correspondência de eventos (Event Match Quality), de 1 a 10. Ela mede quanto os dados de cliente que você envia permitem à Meta ligar o evento a uma conta real. A documentação recomenda buscar nota 6 ou mais quando possível. Clicando na nota, o próprio Gerenciador mostra o que está faltando.

Duplicidade: o erro que faz o resultado parecer melhor do que é

Quando você envia o mesmo lead pelo Pixel e pela API, a Meta precisa saber que é o mesmo lead. Sem isso, ela conta dois. O relatório fica bonito, mas o custo por lead aparece pela metade e as decisões de verba passam a se apoiar num número falso.

A forma recomendada pela Meta é a deduplicação por ID do evento:

• o eventID enviado pelo Pixel precisa ser igual ao event_id enviado pela API;
• o nome do evento (por exemplo, Lead) precisa ser o mesmo nos dois canais;
• a Meta só junta eventos que chegam em até 48 horas a partir do primeiro com aquele ID.

Quando os dois batem, a Meta descarta a cópia. No Gerenciador de Eventos, a aba Desduplicação de eventos mostra se isso está acontecendo. Se a taxa de eventos desduplicados está perto de zero e você envia pelos dois canais, provavelmente está contando em dobro.

As formas de instalar a API de Conversões

Não existe um único jeito certo. A escolha depende da plataforma do site e de quanto controle você precisa.

Caminho	Para quem serve	O que considerar
Integração nativa da plataforma (Shopify, plugins de WooCommerce e similares)	Lojas e sites em plataformas prontas	Mais simples. Cobre os eventos padrão; checkouts muito customizados podem ficar de fora
Configuração pelo Gerenciador de Eventos	Quem já tem Pixel e quer começar rápido	A Meta oferece configuração sem código a partir do Pixel existente
Conversions API Gateway	Sites próprios sem plataforma pronta	Roda em uma conta de nuvem (AWS) sua ou de um parceiro; a instalação leva cerca de 30 a 40 minutos, mais o custo mensal da nuvem
Integração direta (servidor, CRM ou n8n)	Quem quer enviar vendas do CRM ou eventos fora do site	Mais trabalho no início, mas permite mandar o lead que virou cliente, não só o formulário

O último caminho é o que mais muda a qualidade da informação para quem vende fora do site. Uma imobiliária, por exemplo, pode enviar à Meta não só o formulário, mas também o lead que agendou visita, marcado no CRM. Fluxos desse tipo podem ser montados com ferramentas de automação como as que explicamos no guia de automação de atendimento com n8n e Make.

Um exemplo do que o servidor envia

Para quem vai implementar, este é o formato mínimo de um evento de lead. Os dados são fictícios; e-mail e telefone vão criptografados em SHA-256 depois de normalizados.

{
  "data": [
    {
      "event_name": "Lead",
      "event_time": 1793260800,
      "event_id": "lead-000123",
      "action_source": "website",
      "event_source_url": "https://exemplo.com.br/orcamento",
      "user_data": {
        "em": ["<sha256 de contato@exemplo.com.br>"],
        "ph": ["<sha256 de 5511000000000>"],
        "client_ip_address": "203.0.113.10",
        "client_user_agent": "Mozilla/5.0 ...",
        "fbp": "fb.1.1793260000000.1234567890"
      }
    }
  ]
}

Detalhes que costumam dar errado:

• E-mail precisa estar sem espaços e em minúsculas antes da criptografia.
• Telefone precisa incluir o código do país (55 no Brasil), sem símbolos nem zeros à esquerda.
• IP, navegador e os cookies fbp e fbc não são criptografados. A documentação é explícita sobre o IP: ele nunca deve ser criptografado.
• event_time aceita até 7 dias para trás. Um único evento mais antigo faz a Meta recusar a requisição inteira.
• event_source_url é obrigatório para eventos de site e deve corresponder ao domínio verificado.

Como testar antes de ligar de verdade

A Meta tem uma ferramenta própria para isso. No Gerenciador de Eventos, em Testar eventos, ela gera um código de teste. Esse código vai no campo test_event_code da requisição, e os eventos passam a aparecer na tela de teste assim que são enviados, sem misturar com os dados reais.

A documentação recomenda fazer o teste com os seus próprios dados (o seu e-mail e o seu telefone), para que a correspondência funcione como funcionaria com um cliente real. Depois, o campo test_event_code precisa ser removido; esquecê-lo é um dos erros que vemos em implementações feitas às pressas.

Um roteiro de teste que funciona bem:

1. Envie um formulário real pelo site, do celular e do computador.
2. Confira se o evento apareceu duas vezes na tela de teste: uma pelo navegador, outra pelo servidor.
3. Confira se os dois têm o mesmo ID de evento.
4. Depois de alguns dias em produção, veja a taxa de desduplicação e a nota de qualidade da correspondência.

O que a API de Conversões não resolve

Vale ser honesto sobre o limite da ferramenta. A API de Conversões melhora a informação que chega à Meta. Ela não melhora o anúncio, a oferta, o preço nem o atendimento.

Ela também não corrige um site lento ou um formulário confuso. Se a página demora para carregar no celular, as pessoas desistem antes de enviar o formulário, e não há evento para enviar por canal nenhum. Se esse for o caso, comece pelo básico de Core Web Vitals e velocidade do site.

E não dispensa cuidado com privacidade. Enviar pelo servidor muda o caminho do dado, mas a sua política de privacidade e as regras de consentimento do site continuam valendo. O próprio Gerenciador de Eventos mostra quantos eventos foram descartados por controles de consentimento.

O que você ganha é uma base mais confiável: o número de leads do relatório fica mais perto do número real, a Meta aprende com mais conversões e você consegue comparar custo por lead entre campanhas sabendo que está medindo a mesma coisa.

Próximo passo

Faça hoje o teste com a extensão e compare os leads do último mês com o que a Meta registrou. Se a diferença for grande, se aparecer Pixel duplicado ou se a conexão mostrar só “navegador”, vale revisar o rastreamento antes de aumentar a verba. A MR instala e audita Pixel e API de Conversões como parte do serviço de tráfego pago com rastreamento. Se quiser uma segunda opinião sobre o que está configurado hoje, peça o diagnóstico gratuito.