API de Conversões da Meta (CAPI): o que é, por que usar e como configurar

Se você anuncia no Facebook e no Instagram, já deve ter ouvido falar da API de Conversões (em inglês, Conversions API, ou CAPI). Ela se tornou peça essencial para quem quer que os anúncios otimizem bem: é a forma de enviar os eventos de venda diretamente do servidor para a Meta, sem depender apenas do navegador do cliente.

Veja o que é, por que importa e como configurar sem dor de cabeça.

O problema: o pixel sozinho perde eventos

O pixel tradicional roda no navegador do visitante. Isso tem limites:

• bloqueadores de anúncios e de rastreamento impedem o pixel de carregar;
• navegadores e sistemas restringem cookies e rastreamento;
• conexões lentas e páginas fechadas antes do tempo fazem eventos se perderem;
• checkouts em outros domínios quebram a jornada.

Quando eventos de compra se perdem, a Meta recebe menos informação sobre quem compra — e o algoritmo otimiza pior, mostrando os anúncios para as pessoas erradas.

A solução: eventos enviados pelo servidor

Com a API de Conversões, o evento de compra é enviado do servidor, a partir da venda confirmada, direto para a Meta. Não depende do navegador, de cookies ou de bloqueadores.

O ideal é usar os dois juntos, com deduplicação: o pixel e a API enviam o mesmo evento com um identificador comum, e a Meta conta uma vez só.

Benefícios da API de Conversões

1. Mais eventos registrados, com menos perdas.
2. Melhor otimização: o algoritmo aprende com mais compras reais.
3. Públicos mais precisos para remarketing e semelhantes.
4. Relatórios mais confiáveis dentro do gerenciador.
5. Eventos de compra confirmados a partir da venda aprovada no gateway.

Qualidade da correspondência de eventos

A Meta avalia quão bem consegue associar os eventos a pessoas (a chamada qualidade da correspondência). Quanto mais parâmetros confiáveis forem enviados — como identificadores de clique e navegador capturados pelo pixel, e dados do cliente em formato protegido por hash —, melhor. Sempre respeite a legislação de proteção de dados e a sua política de privacidade.

Importante

Envie apenas dados necessários, em formato protegido (hash), e informe o uso na política de privacidade do seu site.

Como configurar

Caminho 1: desenvolvimento próprio

Um programador integra o servidor da loja ou do checkout à API da Meta, cuida da deduplicação, dos parâmetros e da manutenção. Funciona, mas exige tempo técnico e manutenção contínua.

Caminho 2: ferramenta pronta

Uma ferramenta de rastreamento que já recebe as vendas do gateway envia os eventos de compra para a Meta automaticamente. Você só informa o ID do pixel e o token de acesso gerado no Gerenciador de Eventos.

No UTM Labs, a camada de API de Conversões funciona assim:

1. O pixel do UTM Labs no site captura a origem da visita e os identificadores de clique e navegador.
2. O gateway envia a venda aprovada por webhook.
3. O UTM Labs liga a venda à visita original.
4. O evento de compra é enviado para a Meta pelo servidor, com os parâmetros de correspondência.
5. No painel, você vê a venda atribuída ao anúncio certo — e a Meta recebe o evento para otimizar.

Tudo sem programar, com 7 dias de teste grátis.

Checklist de configuração

• Pixel da Meta instalado no site.
• Token da API de Conversões gerado no Gerenciador de Eventos.
• Gateway enviando vendas por webhook para a ferramenta.
• Deduplicação configurada entre pixel e servidor.
• Eventos de teste conferidos no Gerenciador de Eventos.
• Política de privacidade atualizada.

Exemplo prático: loja virtual com checkout externo

Uma loja virtual usava um checkout em outro domínio. O pixel da Meta perdia boa parte das compras, porque a jornada era quebrada entre os domínios e muitos navegadores bloqueavam o rastreamento. Com a API de Conversões enviando as compras aprovadas pelo servidor:

• As compras passaram a aparecer com mais consistência no Gerenciador de Eventos.
• As campanhas de conversão passaram a ter mais dados para otimizar.
• Os públicos de compradores ficaram mais completos para remarketing e semelhantes.

Como verificar se está funcionando

1. Abra o Gerenciador de Eventos da Meta.
2. Veja se os eventos de compra aparecem com a origem "servidor".
3. Confira se há deduplicação entre navegador e servidor.
4. Observe a qualidade da correspondência de eventos.
5. Compare o número de compras recebidas com as vendas aprovadas no gateway.

Checklist de manutenção

• Token de acesso válido e guardado com segurança.
• Deduplicação funcionando.
• Eventos de teste conferidos após qualquer mudança no site ou no checkout.
• Política de privacidade atualizada.
• Revisão mensal da qualidade dos eventos.

Perguntas frequentes

A API de Conversões substitui o pixel?

Não. O recomendado é usar os dois juntos, com deduplicação.

Preciso de programador?

Não, se usar uma ferramenta pronta que já faz a integração com o gateway e com a Meta.

A API de Conversões precisa de análise da Meta?

Para enviar eventos do seu próprio pixel, basta gerar o token de acesso no Gerenciador de Eventos da sua conta.

Ela melhora o ROAS?

Ela melhora a qualidade dos dados que a Meta usa para otimizar. Com dados melhores, os anúncios tendem a encontrar compradores com mais eficiência, mas o resultado depende também de oferta, criativo e público.

Funciona com qualquer gateway?

Funciona com gateways que enviam as vendas por webhook para a ferramenta de rastreamento. Veja também como saber qual anúncio gerou a venda.