Conversões Offline na Meta Ads: Etapas do CRM via API
Conversão offline na Meta é uma etapa do CRM (lead qualificado, reunião, proposta, venda) enviada do servidor para o dataset da Meta pela API de Conversões, para que o Gerenciador de Anúncios veja o que acontece depois do formulário. A mecânica lembra a do Google Ads, mas as regras são outras: a janela para enviar é de 7 dias a partir do evento, a normalização dos dados de contato é diferente e não existe primária e secundária. Este guia cobre o envio de etapas do CRM para campanhas de geração de leads. O True Conversions faz esse envio para a Meta e para o Google Ads a partir do mesmo CRM; a configuração da Meta está na documentação do conector.
Como a Meta Recebe Eventos do CRM
O Pixel mede o que acontece no navegador. A API de Conversões recebe eventos enviados de um servidor, e é por ela que o CRM fala com a Meta. A diferença entre os dois e por que o envio do servidor resiste a bloqueadores e restrições do iOS estão em API de Conversões vs Pixel; aqui o foco é o evento que nasce no CRM.
Um evento de etapa do CRM tem quatro partes:
- Destino: o dataset (o mesmo ID do Pixel, no Gerenciador de Eventos) que recebe o evento.
- Identificação do evento:
event_name(qual etapa),event_time(quando aconteceu, em segundos Unix) eevent_id(chave de deduplicação). - Origem:
action_source: system_generatedpara eventos vindos do CRM. Emcustom_data,event_source: crmelead_event_sourcecom o nome do CRM. - Pessoa:
user_data, com os dados de contato com hash e os identificadores de clique e de cookie que existirem.
O que não entra: a etapa do CRM não precisa de valor monetário. Etapas de qualificação vão sem valor; só a venda faz sentido com receita real.
Quais Eventos Enviar Por Etapa
A Meta tem eventos padrão. Para um funil de lead gen, a escolha costuma ser entre poucos deles, um por etapa, sem repetir o mesmo nome em duas etapas.
| Etapa no CRM | Evento padrão possível | Observação |
|---|---|---|
| Lead entrou no CRM | Lead | Cuidado se o Pixel já dispara Lead no formulário (ver deduplicação) |
| Reunião agendada | Schedule | Etapa intermediária com volume razoável |
| Proposta ou aplicação | SubmitApplication | Útil em funis com análise de cadastro |
| Primeiro contato do comercial | Contact | Raso para otimizar; bom para medir |
| Cadastro concluído | CompleteRegistration | Para funis de onboarding |
| Venda | Purchase | Exige valor e moeda reais; sem receita, não envie como Purchase |
Purchase merece cuidado. A Meta trata esse evento como receita, e um Purchase sem valor polui o relatório de valor da conta. Se o CRM não informa o valor real do negócio, use um evento de qualificação.
Leads de anúncios de clique para WhatsApp seguem outro caminho: action_source: business_messaging, messaging_channel: whatsapp, o ctwa_clid da primeira mensagem e o ID da conta do WhatsApp Business (WABA). Os nomes de evento aceitos nesse caminho são validados separadamente, como LeadSubmitted e QualifiedLead. Onde o ctwa_clid aparece e como guardá-lo está em ctwa_clid: o que é e como usar no Meta CAPI; o fluxo completo, Google e Meta, está em como rastrear conversões de anúncios que vão para o WhatsApp.
Chaves de Correspondência
A Meta casa o evento com uma pessoa pelos campos de user_data. Quanto mais chaves corretas, maior a chance de correspondência.
| Campo | O que é | Tratamento |
|---|---|---|
em | Hash SHA-256 após minúsculas e sem espaços | |
ph | Telefone | Hash SHA-256 do número internacional só com dígitos, sem + |
fn, ln | Nome e sobrenome | Hash SHA-256 em minúsculas |
fbc | Identificador do clique (derivado do fbclid) | Sem hash; de preferência o valor capturado no navegador, sem reconstruir |
fbp | Cookie do Pixel | Sem hash, enviado como foi capturado |
lead_id | ID do lead de formulário instantâneo | Sem hash; existe só em leads de Lead Ads |
ctwa_clid | Clique de anúncio para WhatsApp | Só no caminho business_messaging |
O detalhe que mais derruba correspondência em quem já envia para o Google: a normalização é diferente. O Google remove os pontos de e-mails @gmail.com antes do hash; a Meta não remove. O Google quer o telefone em E.164 com +; a Meta quer só os dígitos. O mesmo dado gera hashes diferentes por plataforma, e um hash no formato do Google enviado à Meta simplesmente não casa, sem erro: a API responde 200 e o evento conta como não correspondido. As demais causas de correspondência baixa estão em taxa de match de conversões offline.
O fbc só existe se alguém capturou o fbclid na landing page e levou até o CRM, no mesmo campo oculto usado para o gclid (veja como capturar o GCLID em formulários e salvar no CRM). Montar o fbc a partir do fbclid na hora do envio funciona como último recurso, mas usa a data do envio no lugar da data do clique.
event_time: a Janela de 7 Dias
A regra de tempo da Meta é curta. O event_time pode estar até 7 dias no passado em relação ao envio; se qualquer evento da requisição passar disso, a Meta rejeita a requisição inteira e não processa nenhum evento.
Na prática:
- O que conta é a data da etapa, não a do clique. Uma venda que fecha 40 dias depois do clique pode ser enviada, desde que saia até 7 dias depois do fechamento.
- Envio em lote semanal é arriscado. Uma exportação manual que junta eventos de mais de uma semana perde os mais antigos, e pode derrubar o lote todo.
- Fuso e formato importam. Uma data sem fuso, com ano digitado errado ou impossível de interpretar vira
event_timeerrado. A Meta não documenta rejeição de datas futuras, mas uma conversão datada no futuro é erro de dado e não deve ser enviada.
Há uma segunda janela, separada: a janela de atribuição do conjunto de anúncios. Ela define se o evento conta como resultado da campanha. Uma etapa recebida dentro dos 7 dias pode ficar fora da janela de atribuição se aconteceu muito depois do clique. Recebimento e atribuição são perguntas diferentes.
Otimização Para Leads de Conversão
Em campanhas de cadastro com formulários instantâneos (Lead Ads), a Meta oferece a meta de desempenho Leads de conversão (Conversion Leads). Em vez de buscar mais formulários, a campanha usa as etapas do CRM enviadas de volta para buscar leads com mais chance de avançar.
O que sustenta essa otimização é o vínculo entre o formulário e o CRM: o lead_id gerado pelo formulário instantâneo precisa chegar ao CRM e voltar à Meta junto com os eventos de etapa, marcados como vindos do CRM (action_source: system_generated, event_source: crm, lead_event_source). A Meta avalia no Gerenciador de Eventos se a integração do CRM atende aos requisitos dela para essa meta; os critérios de elegibilidade são definidos e mudados pela Meta, e vale conferi-los ali antes de planejar a campanha.
Se o lead vem de formulário no site, não há lead_id. Nesse caso, as etapas do CRM chegam à Meta casadas por e-mail, telefone, fbc e fbp, e servem para medição e para eventos de conversão escolhidos no conjunto de anúncios, conforme o que a Meta permitir para o objetivo da campanha.
Deduplicação: event_id e o Pixel
A Meta deduplica um evento do Pixel e um da API quando event_name e event_id coincidem. Para eventos de CRM, isso tem duas implicações:
- O
event_idprecisa ser estável por etapa e negócio. Se cada nova tentativa de envio gera um ID novo, um reenvio após timeout vira dois eventos. - Evite colidir com o Pixel. O evento do CRM tem um
event_idque o navegador nunca viu. Se o Pixel já disparaLeadno envio do formulário e a etapa “lead qualificado” do CRM também é enviada comoLead, os dois somam em vez de deduplicar. Use para a etapa do CRM um nome que o Pixel não dispara.
Diferenças Para o Google Ads
Quem já envia etapas do CRM ao Google Ads reaproveita a origem dos dados, mas não as regras.
| Aspecto | Google Ads | Meta (API de Conversões) |
|---|---|---|
| Prazo para enviar | Dentro da janela de conversão da ação, até 90 dias após o clique | event_time até 7 dias antes do envio |
| Estrutura de otimização | Ação primária ou secundária, metas por campanha | Evento de otimização escolhido no conjunto de anúncios |
| Chave de clique | gclid, gbraid, wbraid | fbc, lead_id, ctwa_clid |
| Normalização de e-mail | Remove pontos em @gmail.com | Só minúsculas e sem espaços |
| Normalização de telefone | E.164 com + | Dígitos, sem + |
| Deduplicação | ID de transação ou de pedido | event_id com event_name |
| Confirmação do envio | Diagnóstico de conversões otimizadas | Resposta com events_received; correspondência no Gerenciador de Eventos |
| Pré-requisito de conta | Conversões otimizadas para leads e termos de dados | Dataset e acesso ao negócio e à conta de anúncios |
A ausência de primária e secundária muda a forma de pensar a configuração. No Google, enviar várias etapas e escolher uma para o lance é a estrutura descrita em conversão primária ou secundária no Google Ads. Na Meta, todas as etapas enviadas ficam disponíveis no dataset, e a decisão de otimização acontece no conjunto de anúncios. O mecanismo do lado do Google está no guia de conversões offline no Google Ads.
A camada de LGPD é a mesma nas duas plataformas: hash não é anonimização, e quem anuncia precisa de base legal para usar o dado do lead. Veja LGPD e conversões offline.
Como Verificar
A resposta da API com events_received confirma que a Meta recebeu o evento. Não confirma que ele casou com uma pessoa nem que foi atribuído a uma campanha. Para avançar na verificação:
- Gerenciador de Eventos: confirme que o evento aparece no dataset com a origem servidor e acompanhe a qualidade de correspondência por evento.
- Teste com um negócio real: mova um negócio de teste no CRM por uma etapa configurada e confira o evento no dataset.
- Erros de requisição: um
event_timefora da janela derruba a requisição inteira; leia a resposta, não só o status.
Onde o True Conversions Entra
O True Conversions envia à Meta, pela API de Conversões, as etapas do CRM que você configurar, a partir dos mesmos conectores usados para o Google Ads (RD Station CRM, RD Station Marketing, Pipedrive, ActiveCampaign ou webhook genérico). O que ele faz no lado da Meta:
- envia cada etapa com
action_source: system_generated,event_source: crme o nome do CRM emlead_event_source, ou pelo caminhobusiness_messagingcomctwa_clide WABA quando o lead veio de anúncio para WhatsApp; - aplica a normalização da Meta (separada da do Google) antes do hash e envia
fbc,fbpelead_idquando o CRM os fornece; - usa um
event_iddeterminístico por negócio, etapa e destino, para reenvio não duplicar; - recusa localmente eventos com
event_timealém de 7 dias, futuro ou inválido, em vez de deixar a Meta rejeitar a requisição; - não oferece
Purchasecomo evento de etapa e recusa umPurchasesem valor e moeda.
Ele não cria nem edita campanhas, não usa permissão de gerenciamento de anúncios e não escolhe a meta de otimização do conjunto de anúncios. A resposta de recebimento aparece no painel; correspondência e resultado de campanha são lidos na Meta.
Próximo Passo
O True Conversions envia as etapas do seu CRM à Meta e ao Google Ads, com a normalização certa para cada plataforma e deduplicação por etapa e negócio. A configuração da Meta está na documentação do conector. São 60 dias grátis, sem cartão, a partir de R$49/mês.
Perguntas Frequentes
Como enviar conversões offline do CRM para a Meta?
Pela API de Conversões (CAPI): cada etapa do CRM vira um evento enviado do servidor para o dataset da Meta, com action_source system_generated, os dados de contato com hash e, quando existirem, identificadores como fbc, fbp ou lead_id. O evento precisa chegar até 7 dias depois do event_time, ou a Meta rejeita a requisição inteira.
Qual a diferença entre conversões offline na Meta e no Google Ads?
As principais são a janela e a estrutura de otimização. A Meta aceita eventos com event_time de até 7 dias no passado; no Google, a referência é a janela de conversão da ação, de até 90 dias após o clique. A Meta não tem primária e secundária: a otimização é escolhida no conjunto de anúncios. A normalização antes do hash também difere em e-mail e telefone.
O que é otimização para Leads de conversão na Meta?
É uma meta de desempenho para campanhas de cadastro com formulários instantâneos que usa os eventos de etapa do CRM, enviados pela API de Conversões com o lead_id do formulário, para buscar leads com mais chance de avançar no funil. A elegibilidade e a configuração ficam no Gerenciador de Eventos e no Gerenciador de Anúncios da Meta.
Por que a Meta aceita o evento e ele não aparece como resultado da campanha?
Porque recebimento não é correspondência nem atribuição. A resposta da API confirma que o evento chegou. Para virar resultado, a Meta precisa casar o evento com uma pessoa e esse evento precisa estar dentro da janela de atribuição do conjunto de anúncios.
Posso usar o mesmo nome de evento do Pixel para uma etapa do CRM?
Pode, mas é arriscado. A Meta deduplica eventos do Pixel e da API quando o event_name e o event_id coincidem. Um evento de CRM com event_id próprio e o mesmo nome que o Pixel já dispara no formulário soma em vez de deduplicar. Para etapas do CRM, prefira um nome que o Pixel não usa.