Nexopath Guias True Conversions

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) e event_id (chave de deduplicação).
  • Origem: action_source: system_generated para eventos vindos do CRM. Em custom_data, event_source: crm e lead_event_source com 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 CRMEvento padrão possívelObservação
Lead entrou no CRMLeadCuidado se o Pixel já dispara Lead no formulário (ver deduplicação)
Reunião agendadaScheduleEtapa intermediária com volume razoável
Proposta ou aplicaçãoSubmitApplicationÚtil em funis com análise de cadastro
Primeiro contato do comercialContactRaso para otimizar; bom para medir
Cadastro concluídoCompleteRegistrationPara funis de onboarding
VendaPurchaseExige 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.

CampoO que éTratamento
emE-mailHash SHA-256 após minúsculas e sem espaços
phTelefoneHash SHA-256 do número internacional só com dígitos, sem +
fn, lnNome e sobrenomeHash SHA-256 em minúsculas
fbcIdentificador do clique (derivado do fbclid)Sem hash; de preferência o valor capturado no navegador, sem reconstruir
fbpCookie do PixelSem hash, enviado como foi capturado
lead_idID do lead de formulário instantâneoSem hash; existe só em leads de Lead Ads
ctwa_clidClique de anúncio para WhatsAppSó 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_time errado. 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:

  1. O event_id precisa 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.
  2. Evite colidir com o Pixel. O evento do CRM tem um event_id que o navegador nunca viu. Se o Pixel já dispara Lead no envio do formulário e a etapa “lead qualificado” do CRM também é enviada como Lead, 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.

AspectoGoogle AdsMeta (API de Conversões)
Prazo para enviarDentro da janela de conversão da ação, até 90 dias após o cliqueevent_time até 7 dias antes do envio
Estrutura de otimizaçãoAção primária ou secundária, metas por campanhaEvento de otimização escolhido no conjunto de anúncios
Chave de cliquegclid, gbraid, wbraidfbc, lead_id, ctwa_clid
Normalização de e-mailRemove pontos em @gmail.comSó minúsculas e sem espaços
Normalização de telefoneE.164 com +Dígitos, sem +
DeduplicaçãoID de transação ou de pedidoevent_id com event_name
Confirmação do envioDiagnóstico de conversões otimizadasResposta com events_received; correspondência no Gerenciador de Eventos
Pré-requisito de contaConversões otimizadas para leads e termos de dadosDataset 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_time fora 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: crm e o nome do CRM em lead_event_source, ou pelo caminho business_messaging com ctwa_clid e 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, fbp e lead_id quando o CRM os fornece;
  • usa um event_id determinístico por negócio, etapa e destino, para reenvio não duplicar;
  • recusa localmente eventos com event_time além de 7 dias, futuro ou inválido, em vez de deixar a Meta rejeitar a requisição;
  • não oferece Purchase como evento de etapa e recusa um Purchase sem 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.