API de Conversões da Meta: o guia prático para gestores
Sem sinal bom, nenhuma automação acerta. Veja o que é a API de Conversões, como ela se soma ao pixel e o caminho mais simples para configurar em cada tipo de negócio.
Atualizado em · 4 min de leitura
Resposta curta: a API de Conversões (CAPI) envia os eventos de conversão (compra, cadastro, contato) do servidor do negócio direto para a Meta, em vez de depender só do pixel no navegador. Ela recupera eventos que o pixel perde por bloqueadores, cookies e navegação privada, e melhora a otimização e a medição. O certo é usar pixel e API juntos, com deduplicação para o mesmo evento não contar duas vezes.
Por que só o pixel não basta mais
O pixel roda no navegador do cliente. Bloqueadores de anúncio, restrições de cookies, navegação privada e conexões que caem fazem parte dos eventos não chegar à Meta. Com menos eventos, a Meta aprende menos sobre quem compra, e as campanhas otimizam pior. A API de Conversões manda os eventos pelo servidor, que não sofre essas perdas.
Como pixel e API trabalham juntos
- O pixel captura o comportamento no site (página vista, adicionar ao carrinho).
- A API envia os eventos importantes pelo servidor, com dados do cliente (como e-mail e telefone) criptografados.
- A deduplicação junta os dois: quando o mesmo evento chega pelo pixel e pela API com o mesmo nome de evento e o mesmo ID de evento, a Meta conta uma vez só.
Sem deduplicação, as compras aparecem em dobro e a otimização se perde.
Os 3 caminhos para configurar
| Caminho | Para quem | Esforço |
|---|---|---|
| Integração de parceiro | Lojas em plataformas como Shopify, Nuvemshop, WooCommerce, Hotmart | Baixo: liga na própria plataforma |
| Gateway da API de Conversões | Sites sem plataforma pronta, sem time técnico | Médio: um servidor gerenciado configurado pelo Gerenciador de Eventos |
| Integração direta pelo servidor | Sites próprios, sistemas e CRMs | Alto: desenvolvimento, mas controle total |
Comece sempre pelo caminho de parceiro, se existir. A documentação oficial da API de Conversões tem a referência técnica para os outros dois.
O que é a qualidade de correspondência do evento
No Gerenciador de Eventos, cada evento recebe uma nota de qualidade da correspondência (de 0 a 10), que mostra o quanto a Meta consegue ligar o evento a uma pessoa. Quanto mais dados do cliente forem enviados (e-mail, telefone, nome, cidade, identificadores do clique), maior a nota e melhor a otimização. Os dados pessoais são enviados com hash, nunca em texto aberto.
E para negócios que vendem pelo WhatsApp?
Muitos negócios locais não vendem no site: o anúncio abre uma conversa no WhatsApp e a venda acontece ali. Nesse caso:
- A conversa iniciada já é medida dentro da Meta, sem pixel.
- Para ensinar a Meta quem compra (e não só quem conversa), é possível enviar eventos de venda a partir do CRM ou do WhatsApp Business pela API de Conversões, quando o negócio tem esse registro.
- Sem integração, o mínimo é registrar com o cliente o que virou venda, para o relatório e para as decisões de verba. Veja campanha de WhatsApp na Meta.
Checklist de conferência
- Os eventos principais aparecem no Gerenciador de Eventos, pelo navegador e pelo servidor?
- A deduplicação está ativa (mesmo nome e mesmo ID de evento nos dois)?
- A qualidade da correspondência está razoável nos eventos que importam?
- O valor e a moeda da compra estão chegando certos?
- O evento de otimização da campanha é o que representa a venda?
Faça essa conferência todo mês e sempre que o site ou a loja mudarem. Ela faz parte do checklist do gestor.
Perguntas frequentes
A API de Conversões substitui o pixel?
Não, os dois trabalham juntos. O pixel captura o comportamento no navegador e a API envia os eventos pelo servidor, recuperando o que o pixel perde. A recomendação é usar os dois com deduplicação: o mesmo evento chega pelos dois caminhos com o mesmo nome e o mesmo ID, e a Meta conta uma vez só. Usar só a API funciona, mas você perde parte dos sinais de navegação.
Preciso de programador para configurar a API de Conversões?
Nem sempre. Lojas em plataformas como Shopify, Nuvemshop e WooCommerce, e produtores em plataformas como Hotmart, costumam ter integração pronta que se liga em poucos cliques. Sites sem plataforma podem usar o gateway da API de Conversões, configurado pelo Gerenciador de Eventos. A integração direta pelo servidor, para sistemas próprios, é a que exige desenvolvimento.
Como sei se a API de Conversões está funcionando?
No Gerenciador de Eventos da Meta: os eventos devem aparecer com a origem "servidor", a deduplicação deve estar funcionando (sem contagem dobrada) e a qualidade da correspondência deve estar razoável. Compare também o número de compras na Meta com o número de vendas da loja no mesmo período; uma diferença muito grande indica eventos faltando ou duplicados.
Um gestor sênior olhando as suas contas todo dia
O Trafy lê as contas de Meta Ads dos seus clientes, diz o que mudar e por quê, e só mexe no dinheiro com o seu sim. Relatório na sua marca e conversa pelo WhatsApp.