API de Conversões da Meta: como devolver as vendas do CRM para a campanha

Uma campanha de captação de leads roda bem no Meta Ads: o custo por lead cai, o volume de formulários preenchidos sobe, e o painel parece saudável. Três semanas depois, o time comercial fecha um contrato importante e ninguém consegue dizer ao algoritmo que aquele lead específico virou venda. Para a Meta, aquele evento nunca aconteceu, e a campanha continua otimizando para o que ela consegue enxergar: o formulário, não o resultado. É exatamente esse buraco que a api de conversões da Meta foi criada para fechar.

O que é a API de Conversões da Meta

A API de Conversões da Meta é o canal que permite enviar, direto do servidor, eventos que aconteceram fora do navegador, como uma venda fechada no CRM, para a mesma conta de anúncios que gerou aquele lead. Ela funciona em paralelo ao Pixel: enquanto o Pixel captura o que acontece no site pelo navegador da pessoa, a API de Conversões recebe eventos enviados pelo seu sistema, sem depender de cookie, de JavaScript carregando ou de o visitante ter aceitado rastreamento.

Na prática, isso muda o que a campanha aprende. Em vez de otimizar só para “formulário preenchido”, ela passa a receber também “virou oportunidade”, “fechou contrato” ou “cancelou”, desde que alguém envie esses eventos de volta. É essa devolução, do CRM para a campanha, que fecha o ciclo entre mídia paga e receita.

Por que o Pixel sozinho não é mais suficiente

O Pixel depende do navegador para funcionar, e uma parte crescente do tráfego bloqueia esse caminho antes mesmo de o evento sair. Bloqueadores de anúncio, navegadores com rastreamento restrito por padrão e políticas de privacidade mais rígidas cortam parte dos eventos do lado do cliente, mesmo quando a conversão realmente aconteceu.

Existe ainda uma limitação estrutural: o Pixel só sabe o que acontece na página. Ele não tem acesso ao que ocorre depois, quando o lead sai do site e entra na esteira comercial. Reunião marcada, proposta enviada e contrato assinado são eventos que moram no CRM, não no navegador, e só chegam à Meta se alguém os enviar de volta pelo servidor.

Como o evento sai do CRM e chega até a campanha

O fluxo começa no momento do lead, não no momento da venda. Quando alguém preenche um formulário vindo de um anúncio, a Meta anexa um identificador de clique à sessão, o parâmetro fbc. Esse valor precisa ser capturado por um campo oculto no formulário e gravado junto com o lead, no mesmo espírito de outros parâmetros de clique que só existem naquele instante e depois desaparecem, como o identificador de clique do Google Ads.

A partir daí, o caminho é este:

• O lead entra no CRM já com fbc , e-mail e telefone salvos.
• Quando o negócio muda de etapa (por exemplo, vira oportunidade ou fecha venda), um evento é montado com esses dados.
• Esse evento é enviado por servidor à Conversions API, com o valor da venda quando existir.
• A Meta soma esse evento ao histórico daquela campanha e passa a otimizar considerando o que realmente virou negócio.

Sem esse encadeamento, o funil unificado de marketing e vendas para de existir do lado da plataforma de anúncios: o CRM sabe da venda, a Meta não. Vale enviar mais do que só a venda fechada: operações com ciclo de venda mais longo costumam perder a janela útil se esperarem o contrato assinado, então faz sentido devolver também marcos intermediários, como qualificação ou proposta enviada, para a campanha ter sinal antes do fim do funil.

Material de apoioGuia de Prompts para Marketing e Vendas70 prompts com perguntas sobre marketing, vendas e comportamento para fazer aos seus dados.Baixar o guia

Event_id e a deduplicação com o Pixel

Quando o mesmo evento é capturado pelo Pixel e também enviado pela Conversions API, o event_id é o que impede a Meta de contar esse evento duas vezes. Cada evento leva um identificador único, gerado no seu lado, repetido nas duas fontes: o mesmo valor no eventID do Pixel e no event_id do evento de servidor.

A comparação funciona assim: a Meta cruza event_id e nome do evento entre as duas fontes e, havendo correspondência, mantém apenas uma ocorrência. Segundo a documentação oficial de deduplicação da Meta, essa comparação só é válida dentro de uma janela de 48 horas a partir do primeiro evento recebido com aquele identificador.

Quem envia pelo servidor sem repetir o event_id do Pixel corre o risco oposto ao que motivou o projeto: em vez de faltar dado, o mesmo evento aparece duplicado no relatório, inflando o número de conversões e distorcendo o custo por resultado.

Qualidade de correspondência: os dados que fazem o evento ser reconhecido

A qualidade de correspondência mede quantos dos parâmetros enviados a Meta conseguiu associar a um perfil real dentro da própria base. Quanto mais parâmetros batem, maior a chance de o evento de venda ser corretamente ligado ao clique e à campanha que originaram aquele lead.

Os parâmetros que mais pesam nessa correspondência são:

• E-mail e telefone , sempre enviados com hash (nunca em texto puro).
• fbc , o identificador de clique capturado no momento do lead.
• fbp , o identificador de navegador gerado pelo próprio Pixel.
• external_id , um identificador interno estável do seu CRM para aquele contato.

Faltando esses campos, a Meta ainda tenta associar o evento por outros sinais, mas com uma taxa de acerto bem menor. Um CRM que grava e-mail e telefone com formatação inconsistente, ou que nunca capturou o fbc no formulário de origem, está pagando esse preço sem enxergá-lo em nenhum relatório.

Passo a passo para conectar o CRM à Conversions API

Conectar o CRM à Conversions API é uma sequência curta de decisões técnicas, não um projeto de meses. Na prática, o trabalho segue esta ordem:

1. Capturar o fbc (e, quando existir, o fbp ) no formulário de origem do lead, junto com e-mail e telefone.
2. Definir os marcos do funil comercial que valem como evento (oportunidade criada, venda fechada, venda perdida).
3. Montar o evento de servidor no formato exigido pela API, com os parâmetros hasheados, o action_source correto e o valor da venda quando aplicável.
4. Reaproveitar o mesmo event_id quando o mesmo acontecimento também for capturado pelo Pixel, para evitar contagem em dobro.
5. Enviar o evento no momento em que o CRM registra a mudança de etapa, não em lote no fim do mês.
6. Acompanhar a qualidade de correspondência no Gerenciador de Eventos e corrigir os campos que estiverem chegando vazios ou mal formatados.

Erros que custam dado sem gerar nenhum alerta no painel

Nenhum dos erros mais comuns aparece como falha no relatório da campanha, porque a Meta simplesmente não recebe o dado que faltou. Os mais frequentes:

• Não capturar o fbc no formulário, o que elimina a ligação direta com o clique original.
• Enviar e-mail e telefone sem hash, ou com formatação diferente da exigida (o hash de um número com e sem o nono dígito, por exemplo, gera valores diferentes).
• Esperar o fim do mês para enviar os eventos em lote, quando parte deles já passou da janela útil de correspondência.
• Duplicar o envio entre Pixel e servidor sem repetir o mesmo event_id nas duas pontas.

Cada um desses pontos é silencioso: o painel de mídia paga continua de pé, o dashboard de mídia paga continua mostrando números, e só quando alguém compara a receita real do CRM com o que a campanha diz ter gerado é que a diferença aparece.

Onde a Laiki entra

O case da Incorporadora Valor Real mostra esse fechamento de ciclo na prática. A Laiki guarda o fbc junto do lead desde a entrada, na mesma ficha em que ficam a origem, os eventos e a etapa do funil. Quando esse lead chega a uma etapa que interessa ao negócio, a plataforma monta e envia o evento correspondente à Conversions API automaticamente, com o event_id reaproveitado do que já foi capturado no navegador.

Isso tira do time a tarefa manual de montar payload, hashear campo por campo e lembrar de enviar dentro do prazo. A campanha passa a otimizar pelo que virou negócio no CRM, e não apenas pelo que virou formulário, com a api de conversões da Meta recebendo esse dado no momento certo em vez de num lote atrasado.

Perguntas frequentes

A API de Conversões da Meta substitui o Pixel? Não. As duas trabalham juntas: o Pixel cobre o que acontece no navegador, a API de Conversões cobre o que acontece fora dele, como eventos do CRM. Usar as duas ao mesmo tempo, com o event_id compartilhado, é o cenário recomendado.

Preciso de um time técnico dedicado para configurar isso? É preciso alguém que monte a integração entre o CRM e a API, mas depois de configurado o envio passa a ser automático. O trabalho concentra-se na etapa inicial de mapear os marcos do funil e os campos de correspondência.

Em quanto tempo a venda enviada pelo CRM aparece refletida na campanha? O evento é processado pela Meta em minutos, mas o efeito sobre a otimização da campanha se acumula ao longo de dias, conforme o algoritmo recebe volume suficiente de eventos de venda para ajustar a entrega.