A API de Conversões da Meta, explicada.
O que ela envia, por que anda junto com o pixel, como configurar.

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

A API de Conversões da Meta é uma conexão direta entre os seus dados de marketing e os sistemas de anúncios da Meta. Em vez de depender só de código no navegador do visitante, ela envia eventos como compras, cadastros ou adições ao carrinho a partir do seu servidor, da plataforma do site, do app ou do CRM, para que a Meta meça e otimize os seus anúncios.

A Meta a apresenta como uma forma de otimizar a segmentação dos anúncios, reduzir o custo por resultado e medir resultados em todas as suas tecnologias. Uma única API transporta eventos do site, eventos do app, conversões offline e eventos de mensagens. Você vai vê-la abreviada como CAPI, e muitas vezes chamada de API de Conversões do Facebook.

A Meta também informa que a API de Conversões Offline foi descontinuada em maio de 2025: os eventos offline agora passam pela API de Conversões, para conjuntos de dados.

Por que usar a API de Conversões além do pixel?

Porque o pixel sozinho perde eventos. As boas práticas da Meta dizem que a API de Conversões pode captar eventos do site que o pixel deixa escapar por problemas de rede ou erros de carregamento da página. A Meta recomenda uma configuração redundante: envie os mesmos eventos, como compra, início do checkout ou contato, pelo pixel e pela API de Conversões.

A Meta dá até uma meta para essa paridade: buscar uma cobertura de 75% de eventos da API de Conversões em relação aos eventos do Pixel da Meta. Você acompanha essa taxa no Gerenciador de Eventos.

A Meta também pede que você compartilhe os eventos em tempo real, ou o mais perto possível disso, para que o sistema de veiculação consiga avaliar quem tem mais chance de agir depois de ver um anúncio.

Como funciona a desduplicação com event_id?

Quando o pixel e a API de Conversões informam a mesma compra, a Meta precisa saber que é uma compra, não duas. Ela compara dois campos: o eventID do pixel precisa corresponder ao event_id da API de Conversões, e o event do pixel ao event_name. Quando os dois correspondem, a Meta fica com um evento e descarta o duplicado.

A Meta só desduplica eventos recebidos nas 48 horas seguintes ao primeiro e, em geral, fica com o que recebeu primeiro.

A Meta documenta um segundo método, que envia os mesmos valores fbp ou external_id das duas fontes, mas ele só funciona quando o evento do navegador chega antes do evento do servidor. A Meta recomenda o método do ID e do nome de evento.

Os duplicados que escapam inflam as conversões informadas, e o seu ROAS junto. Se os seus números parecem bons demais, ou caem de repente, leia o seu relatório da Meta linha por linha.

O que é a Qualidade da Correspondência de Eventos?

A Qualidade da Correspondência de Eventos (Event Match Quality) é uma pontuação de 0 a 10 que mostra o quanto as informações do cliente enviadas com os seus eventos de servidor os associam a contas da Meta. A Meta calcula essa nota pela qualidade dessas informações e pela parcela de eventos associados, com os dados das últimas 48 horas, por isso os eventos precisam chegar com regularidade.

Ela vale para eventos do site enviados pela API de Conversões com a origem da ação definida como Site. A Meta diz que uma correspondência melhor ajuda a mostrar os anúncios para pessoas com mais chance de converter e a atribuir as conversões aos seus anúncios, e pode aumentar as conversões adicionais informadas.

Para subir a nota, envie mais parâmetros de informações do cliente, com hash, como explica a documentação para desenvolvedores da Meta, e só com as autorizações e os consentimentos legais necessários. A Meta ordena a prioridade deles:

• Alta: e-mail e ID de clique.
• Média: ID do Login do Facebook, data de nascimento, país, número de telefone, ID externo e ID do navegador.
• Baixa: ID do cadastro, nome, sobrenome, cidade e CEP.

Como você configura a API de Conversões?

A Meta lista vários caminhos e diz que muitos não precisam de desenvolvedor. O certo depende de onde o seu site roda e de quem cuida dele: um parceiro de plataforma de e-commerce, a API de Conversões ativada pela Meta com um clique, o Gateway da API de Conversões sem código ou uma integração direta programada sobre a API.

• Integrações de parceiros. Na Shopify, WooCommerce, Wix ou BigCommerce, a Meta diz que a configuração leva poucos cliques, sem custo adicional. Adobe, Google Tag Manager, Tealium e outros parceiros também podem conectá-la.
• API de Conversões ativada pela Meta. Uma opção só para web que cria a conexão do lado do servidor com um clique, de graça, e envia os mesmos eventos e parâmetros do seu pixel, desduplicados automaticamente.
• Gateway da API de Conversões. Uma configuração sem código que você escolhe no Gerenciador de Eventos, hospedada na sua própria conta AWS ou Google Cloud. A Meta diz que ele reduz a configuração de semanas para menos de 30 minutos e desduplica automaticamente; as taxas de nuvem, seu único custo, começam em 30 $ por mês.
• Integração direta. Um desenvolvedor envia os seus eventos para a API. A Meta estima de 2 a 4 semanas para uma nova integração, e é a única opção para eventos de app e de loja física.

A Meta sugere o Gateway se você já usa o pixel, ainda não envia eventos web pela API de Conversões, investe mais de 300 $ por mês em campanhas otimizadas para eventos web e não trabalha com um parceiro de e-commerce. Se um parceiro como a Shopify já gerencia o seu pixel, a Meta recomenda a integração desse parceiro.