API de Conversões da Meta: o que é e como configurar

Nêmora Schuh · 28/07/2026

Se você já ouviu um cliente dizer “meu Facebook Ads não traz mais resultado” sem nenhuma outra mudança na campanha, o problema raramente é o anúncio. Na maioria das vezes é dado: a Meta simplesmente parou de enxergar boa parte das conversões que já estão acontecendo. E o motivo tem nome: API de Conversões, ou CAPI.

Trabalho com tráfego pago há anos e vejo essa confusão se repetir em praticamente toda conta que assumo: o Pixel está instalado, “tudo certo” segundo quem configurou, mas a Meta está otimizando com uma fração dos dados reais de quem compra ou vira lead. Neste guia, explico o que é a API de Conversões, por que o Pixel sozinho não é mais suficiente e como configurar a CAPI passo a passo, sem precisar de time de desenvolvimento dedicado.

O Que É a API de Conversões (CAPI) e Em Que Ela Difere do Pixel?

A API de Conversões cria uma conexão direta entre o servidor do anunciante, site, CRM ou plataforma de e-commerce, enquanto os sistemas da Meta otimizam a entrega de anúncios, segundo a própria documentação oficial (Meta for Developers, “Conversions API”, 2026). Na prática, é um segundo canal de dados que roda por trás dos bastidores, sem depender do navegador do usuário.

O Pixel do Meta, que a maioria das contas já conhece, funciona do lado do cliente: um script instalado no site que dispara eventos (visualização de página, adição ao carrinho, compra) direto do navegador de quem está navegando. É rápido de instalar e continua sendo a base de qualquer conta. O problema é que ele depende inteiramente de o navegador conseguir, e deixar, que esse disparo aconteça.

◆ Insight exclusivo

É aqui que mora a confusão que quase ninguém explica direito: pixel e API de conversão não são duas opções concorrentes, são duas metades do mesmo sistema. O Pixel capta o que acontece no navegador; a CAPI capta o mesmo evento a partir do servidor, sem depender de cookie, bloqueador de anúncio ou configuração de privacidade do aparelho. Quando os dois rodam juntos e bem configurados, um cobre exatamente o ponto cego do outro.

Pense assim: se o Pixel é uma câmera apontada pra vitrine da loja, a API de Conversões é o caixa registrando cada venda direto no sistema, mesmo que alguém tenha tampado a câmera no caminho até o caixa. Nenhuma das duas sozinha conta a história completa; juntas, sim.

Rodando junto do Pixel, a Meta usa o parâmetro event_id pra reconhecer que os dois canais descreveram o mesmo evento e evitar contar a mesma conversão duas vezes  mais detalhes sobre esse processo de deduplicação na seção 3.

Por Que Só o Pixel Não É Mais Suficiente?

A adesão global ao rastreamento por app caiu para 13,85% no segundo trimestre de 2024, segundo dados da Singular reproduzidos pela Purchasely, ou seja, quase 9 em cada 10 usuários de iOS hoje bloqueiam o rastreamento entre apps quando o alerta da Apple aparece (Purchasely, “ATT Opt-In Rates in 2025 and How to Increase Them”, 2024). Isso é o piso novo da indústria desde que a Apple lançou o App Tracking Transparency, em 2021.

Na prática, isso significa que o Pixel, sozinho, no Safari e em boa parte do tráfego mobile no iOS, está literalmente sem visão de boa parte das conversões que estão acontecendo de verdade. A pessoa compra, mas o navegador nunca deixa esse dado voltar pra Meta. O algoritmo, então, otimiza com base no que consegue ver e o que ele consegue ver, cada vez mais, é só uma fatia do funil.

Some a isso o comportamento dos navegadores fora do universo Apple: Safari e Firefox já bloqueiam cookies de terceiros por padrão, e uma fatia relevante do tráfego roda com bloqueador de anúncio ativo, cortando o disparo do Pixel antes mesmo de ele acontecer. O resultado prático de tudo isso junto é que uma campanha pode estar performando bem de verdade, gerando vendas, gerando leads e ainda assim aparecer “fraca” no Gerenciador de Anúncios, simplesmente porque o sistema de mensuração não está enxergando o que já está acontecendo.

Já perdi as contas de quantas vezes um cliente me procurou dizendo “meu Facebook Ads não traz mais cliente” e, ao abrir a conta, o Pixel estava instalado, tecnicamente funcionando, só que sozinho, sem nenhuma camada de servidor por trás. Assim que a CAPI entrava no ar, muitas vezes o volume de conversões relatado subia de forma significativa em poucos dias. Não porque a campanha tivesse mudado, mas porque a Meta finalmente estava recebendo os dados que já existiam.

Você já parou pra calcular quantas vendas reais a sua conta simplesmente não está “vendo”? É exatamente esse o gancho que faz o algoritmo tomar decisões erradas: ele não otimiza pra quem realmente compra, otimiza pra quem o Pixel conseguiu enxergar comprando e isso é um grupo cada vez menor. Essa mudança de comportamento também empurrou a própria Meta a redesenhar como o algoritmo decide entrega e lance, tema que já detalhamos no artigo sobre o Meta Andromeda.

Como Configurar a API de Conversões da Meta (Passo a Passo)

Configurar a API de Conversões da Meta passa por três etapas fixas no Gerenciador de Eventos: gerar o token de acesso, escolher o método de envio e validar que o evento chegou com o event_id correto pra deduplicação (Meta for Developers, “Conversions API”, 2026). Nenhuma das três exige, sozinha, um time de desenvolvimento dedicado, mas exige atenção, porque é onde a maioria dos erros acontece.

Passo 1: Gere o token de acesso

No Gerenciador de Eventos, dentro do conjunto de dados (dataset) do seu Pixel, existe a aba “Configurações” com a opção de gerar um token de acesso da API de Conversões diretamente pela interface, sem precisar criar um app de desenvolvedor. Esse token é o que autentica cada chamada da CAPI como pertencente à sua conta.

Passo 2: Escolha como os eventos vão ser enviados

Existem, no fundo, três caminhos para colocar a CAPI no ar:

• Integração direta via servidor: seu próprio backend (loja, CRM, sistema de automação) chama a API da Meta enviando o evento com o token gerado no passo 1
• Parceiro de integração no Gerenciador de Eventos: a Meta lista parceiros de e-commerce e CRM que já têm integração pronta com poucos cliques, sem escrever código
• Servidor de tags (server-side tagging): uma camada intermediária recebe o evento uma vez e distribui pros destinos configurados, incluindo a CAPI

Se seu site já roda em uma plataforma de e-commerce com integração nativa, esse costuma ser o caminho mais rápido. Se você tem um site próprio ou um funil com CRM personalizado, vale considerar o servidor de tags, ele evita reescrever a mesma lógica de envio toda vez que você adiciona um novo destino de dados.

Passo 3: Configure o `event_id` pra deduplicação

Todo evento que você já dispara pelo Pixel no navegador precisa levar o mesmo event_id quando o evento equivalente for enviado pela CAPI no servidor. A própria documentação da Meta usa este exemplo: se um cliente faz duas compras, com números de pedido 123 e 456, cada chamada da API de Conversões deve carregar o número do respectivo pedido como event_id, assim a Meta reconhece que são duas transações diferentes, e não quatro eventos separados (Meta for Developers, “Original Event Data Parameters”, 2026).

Quando não existe um número de pedido natural  (um lead de formulário, por exemplo) a própria documentação permite usar um número aleatório, desde que o mesmo número seja enviado tanto no evento do navegador quanto no evento do servidor. O requisito real não é o formato do identificador; é que ele seja idêntico dos dois lados.

Enviando Eventos Além do Clique: Como a Meta Aprende Quem É Lead Qualificado?

O Event Match Quality (EMQ) é a nota de 0 a 10 que a Meta calcula em tempo real pra medir a qualidade das informações de cliente enviadas pela CAPI e o quanto delas conseguem ser casadas com uma conta real (Meta for Developers, “Dataset Quality API”, 2026). Quanto mais parâmetros de identificação bem formatados chegam junto do evento, maior a chance de a Meta reconhecer exatamente quem praticou aquela ação.

A documentação oficial lista os principais parâmetros usados nesse casamento: e-mail e telefone (hasheados após normalização), external_id (qualquer identificador único do seu sistema, como ID de cliente ou de assinante), além de fbc e fbp, os identificadores de clique e de navegador que a própria Meta já grava em cookie e que não devem ser hasheados (Meta for Developers, “Customer Information Parameters”, 2026). Enviar só o clique do anúncio é o mínimo; enviar e-mail, telefone e external_id junto é o que realmente eleva a nota.

É aqui que mora a diferença entre uma campanha que “não converte” e uma que converte, mas a Meta não sabe reconhecer quem tem valor. O exemplo mais comum: um formulário de captação de lead que dispara só o evento de clique no botão, sem enviar e-mail, telefone ou qualquer outro dado do lead junto pela CAPI. A Meta otimiza pra quem clica, não necessariamente pra quem vira lead de verdade, muito menos pra quem fecha negócio depois.

Quando esse mesmo formulário passa a enviar, via CAPI, os dados de contato do lead junto com o evento de conversão e, idealmente, um evento posterior indicando se aquele lead avançou ou não no funil dentro do seu CRM, a Meta ganha um sinal muito mais rico pra reconhecer o padrão de quem realmente qualifica. Isso vale tanto pra e-commerce quanto pra captação de lead em Saas e serviços, os dois cenários que mais vejo em consultoria: enviar eventos personalizados de qualificação (não só o de conversão bruta) é o que ensina o algoritmo a parar de trazer volume barato e passar a trazer o perfil certo.

Você consegue apontar, hoje, qual evento da sua conta carrega e-mail e telefone do lead, e qual carrega só o clique? Essa pergunta sozinha já resolve boa parte das reclamações de “lead ruim” que chegam até consultorias como a minha. Não é sempre um problema de criativo ou de segmentação,  os fundamentos de segmentação de público continuam valendo, mas de dado que nunca chegou até o algoritmo com a riqueza necessária para ele aprender.

Erros Comuns na Configuração

A maioria dos problemas de CAPI que encontro em auditoria de conta está em detalhe técnico de configuração que passa despercebido por semanas. Veja os quatro mais comuns:

• Token errado ou expirado: o token de acesso gerado no Gerenciador de Eventos não tem validade eterna em todos os fluxos de integração; se ninguém monitora, o envio da CAPI simplesmente para de funcionar em silêncio, sem erro visível na interface
• Evento duplicado entre Pixel e CAPI: acontece quando o event_id enviado pelo navegador não é exatamente igual ao enviado pelo servidor. Mesmo uma diferença de maiúscula/minúscula ou espaço já quebra a deduplicação, e a Meta passa a contar a mesma conversão duas vezes
• E-mail e telefone sem normalização antes do hash: a documentação da Meta exige remover espaços e converter pra minúsculas antes de hashear o e-mail, e remover símbolos, letras e zeros à esquerda do telefone (Meta for Developers, “Customer Information Parameters”, 2026). Pular essa normalização faz o hash não bater com o cadastro da Meta, mesmo com o dado certo
• Só o evento de clique, sem eventos de qualificação: como descrito na seção anterior, enviar apenas o disparo inicial impede a Meta de aprender o que diferencia um lead que fecha negócio de um que não fecha

Antes de assumir que a campanha “parou de funcionar”, vale conferir esses quatro pontos no Gerenciador de Eventos, a maioria some da lista de suspeitos assim que o EMQ volta a subir.

Conclusão

A API de Conversões não é um recurso opcional pra quem investe em Meta Ads de verdade, é o que garante que o algoritmo continue enxergando suas conversões reais num cenário onde o Pixel sozinho enxerga cada vez menos. Pixel e CAPI rodando juntos, com event_id correto e dados de cliente bem formatados, é hoje o mínimo pra qualquer conta que dependa de otimização de conversão para crescer.

Se você não sabe se a sua conta está com a CAPI configurada corretamente ou desconfia que o Gerenciador de Anúncios está reportando muito menos conversão do que a sua operação realmente gera, a Agência Mest audita essa configuração antes de qualquer real a mais entrar em campanha. Fale com a equipe da Agência Mest sobre tráfego pago e pare de deixar o algoritmo decidir com menos da metade dos seus dados reais.

Perguntas Frequentes

O que é a API de Conversões da Meta?

É um método de envio de eventos de conversão direto do servidor do anunciante pra Meta, complementando os dados que o Pixel captura no navegador. Ela funciona mesmo quando o navegador bloqueia cookie, script de rastreamento ou está sujeito a restrições de privacidade como o App Tracking Transparency da Apple.

Qual a diferença entre Pixel e API de Conversões?

O Pixel dispara eventos do lado do navegador do usuário; a API de Conversões (CAPI) envia o mesmo tipo de evento a partir do servidor do anunciante. Usados juntos e deduplicados pelo event_id, eles cobrem os pontos cegos um do outro, o que a documentação da Meta recomenda como configuração padrão.

Como gerar o token da API de Conversões?

No Gerenciador de Eventos, acesse o dataset do seu Pixel e abra a aba de configurações: existe a opção de gerar o token de acesso diretamente pela interface, sem precisar criar um aplicativo de desenvolvedor separado.

Por que minha campanha de Meta Ads não converte mesmo com o Pixel instalado?

Na maioria dos casos, o Pixel sozinho está perdendo conversões que acontecem em navegadores ou dispositivos que bloqueiam rastreamento, especialmente no iOS. Configurar a CAPI corretamente, com event_id para deduplicação e dados de cliente formatados, costuma recuperar parte relevante dessas conversões que já estavam acontecendo.

O que é Event Match Quality (EMQ)?

É a nota de 0 a 10 que a Meta calcula em tempo real para medir a qualidade das informações de cliente enviadas pela API de Conversões e a taxa de eventos casados com contas reais, segundo a documentação oficial da Meta for Developers.