--- id: agencias/conversoes-offline-crm industria: Agências de marketing uso: comum esforco: médio grao: Uma linha por evento de conversão e por destino, só da janela corrente --- # Conversões do CRM de volta para Meta e Google Lead qualificado, reunião e venda do CRM de cada cliente enviados para Meta e Google uma vez só, dentro da janela que cada plataforma aceita. ## Resumo executivo **Para quem:** Agências que gerem mídia de clientes cuja venda acontece no CRM, no WhatsApp ou na loja. **O que resolve** - As plataformas passam a otimizar por lead qualificado, reunião ou venda, e não por formulário preenchido. - Cada evento chega uma vez, dentro do prazo que a plataforma aceita. - Leads desqualificados e clientes atuais saem da prospecção por público de exclusão. **Por que importa:** Meta e Google otimizam pelo que recebem. Se só veem o formulário, entregam mais formulário, inclusive de quem nunca compra. Devolver o resultado do CRM muda para quem o anúncio é mostrado, mas um envio duplicado, fora da janela ou sem identificador estraga o aprendizado sem nenhuma tela acusar. **Perguntas de negócio que responde** - Quais eventos foram enviados ontem para a Meta, por cliente? - Quantas vendas do CRM foram devolvidas ao Google no mês? - A qualidade de correspondência caiu? Quais campos estão faltando? - Algum cliente tem a tabela pronta e o envio desligado? - Quantos leads desqualificados estão no público de exclusão? **O que você precisa** - O CRM de cada cliente conectado na Nekt, com a data de cada etapa - As etapas que viram evento e o valor de cada uma, combinados com o cliente - Os destinos Meta Conversions e Google Ads configurados por conta, com a ação de conversão criada na plataforma **O que você recebe** - Uma tabela por destino e por cliente com os eventos da janela corrente - Identificadores normalizados: e-mail, telefone, fbc e id externo - Públicos de clientes e de desqualificados atualizados - Um monitor que compara a tabela produzida com o envio feito ## Detalhado ### O problema A mesma venda precisa chegar à Meta e ao Google em formatos e prazos diferentes. A Meta recusa evento com mais de 7 dias ou com data no futuro; o Google aceita até 90 dias do clique, mas recusa identificador vazio. O destino reenvia a tabela inteira a cada execução, então quem não controla a janela manda o mesmo evento várias vezes. E uma execução com sucesso na Nekt não prova que a plataforma casou a venda com um clique. ### Regras de negócio 1. **Uma tabela por destino.** Meta e Google exigem colunas, janelas e identificadores diferentes para a mesma venda. Monte uma transformação por cliente e por destino, já no formato do destino. Nunca uma tabela única servindo os dois. (Evite: Uma tabela de conversões para todos os destinos.) 2. **Janela dentro do limite, com margem.** A Meta Conversions API rejeita event_time com mais de 7 dias: use janela de 6 dias ou de 132 horas, nunca 7 exatos. O Google Ads Click Conversions aceita até 90 dias depois do clique (63 dias nas conversões otimizadas para leads): janelas reais usam 55 dias para sobrar margem. Evento com data no futuro derruba o lote da Meta: limite event_time ao momento da execução. (Evite: Janela de 7 dias exatos ou backfill de meses para a Meta.) 3. **A tabela só tem a janela corrente.** O destino reenvia a tabela inteira a cada execução. Por isso a tabela traz só os eventos da janela atual, amarrada ao horário da execução, com janelas disjuntas quando roda várias vezes por dia. Cada atualização sai uma vez e a contagem diária fica igual no Events Manager. (Evite: Tabela acumulada com todo o histórico.) 4. **event_id determinístico.** Monte o event_id com o id do lead ou do negócio e o nome do evento (-). Se o mesmo negócio voltar numa janela seguinte, ele sai com o mesmo event_id e a deduplicação da Meta absorve. No Google, use order_id com o mesmo princípio. (Evite: event_id aleatório ou com a data da execução.) 5. **Identificadores normalizados.** E-mail em minúsculas, sem espaços e com @. Telefone só com dígitos, com 55 na frente quando tiver 10 ou 11 dígitos, válido com 12 ou 13. Primeiro nome só com letras. fbc no formato fb.1.. quando a URL de entrada tiver fbclid; fbp, IP e user agent da página quando existirem. Linha sem e-mail e sem telefone não sai. (Evite: Mandar o telefone como foi digitado.) 6. **Etapa vira evento com nome e valor combinados.** Cada cliente define quais etapas viram evento (lead qualificado, reunião marcada, proposta, venda) e o valor de cada uma. Venda leva o valor do negócio ganho; etapa intermediária pode levar valor fixo combinado. Evento vindo só do CRM vai como system_generated (offline); evento com dados da página vai como website, o único que recebe nota de qualidade de correspondência. (Evite: Mandar todo negócio criado como Purchase.) 7. **Um dono por evento.** Se o pixel, uma automação ou outra ferramenta já envia um evento (agendamento pelo calendário, lead do formulário), a esteira do CRM não manda o mesmo fato com outro nome. Use um marcador no lead para não disparar de novo e mantenha nomes de evento distintos entre as esteiras. (Evite: Dois envios do mesmo agendamento com nomes diferentes.) 8. **Só o que pode ter vindo da plataforma.** Envie as conversões que podem ter clique no destino: quando o cliente pedir, só negócios com origem Meta vão para a Conversions API. Nunca envie base importada, contatos de teste nem e-mails da equipe do cliente ou da agência. (Evite: Mandar a base inteira do CRM.) 9. **Envio feito não é conversão contada.** Confira os dois lados: a transformação rodou, o destino está ativo e rodou depois dela. Transformação recente com destino inativo é sinal nunca entregue. E mesmo com envio aceito, sem clique correspondente na janela a venda não vira conversão: o sinal de que funciona é a ação de conversão offline aparecer com conversões na conta de anúncio. (Evite: Concluir que a plataforma recebeu porque a tabela existe.) 10. **Público usa a mesma limpeza.** Públicos de clientes (Customer Match, Custom Audiences) e de exclusão (desqualificados, clientes atuais, base de outra linha de negócio) usam a mesma normalização de e-mail e telefone, sem contatos de teste nem da equipe, deduplicados por telefone. Desqualificado é a etapa de desqualificação ou a perda por perfil, combinada com o cliente. (Evite: Exportar a lista do CRM sem limpar.) ### Limites de cada destino O que cada plataforma aceita e o que a esteira faz para caber. - **Meta Conversions API** → event_time até 7 dias (`janela de 6 dias ou 132 horas`) - **Meta · evento no futuro** → Lote recusado (`event_time limitado ao momento da execução`) - **Meta · deduplicação** → Mesmo event_id em 48 horas (`-`) - **Meta · action_source website** → Recebe nota de qualidade de correspondência (`em, ph, fbc, fbp, IP, user agent`) - **Meta · action_source system_generated** → Offline, sem nota de qualidade (`venda do CRM`) - **Google Ads Click Conversions** → Até 90 dias do clique (`janela de 55 dias`) - **Google · identificador vazio** → Linha recusada (`só linhas com e-mail válido`) - **Customer Match e Custom Audiences** → Públicos de clientes e de exclusão (`mesma normalização`) ### Definições | Métrica | Definição | |---|---| | Evento de conversão | uma linha por registro do CRM e etapa, com event_name, event_time, event_id e identificadores, dentro da janela do destino | | Janela corrente | intervalo de atualização dos registros que esta execução envia; não se sobrepõe à janela da execução anterior | | event_id | id do lead ou do negócio mais o nome do evento | | Taxa de identificação | eventos com e-mail ou telefone válidos / eventos elegíveis na janela | | Eventos entregues | eventos da tabela cobertos por uma execução concluída do destino, posterior à transformação | | Conversões contabilizadas | conversões da ação offline na conta de anúncio no período (no Google, ação do tipo UPLOAD_CLICKS) | | Público de exclusão | contatos normalizados e deduplicados por telefone em etapa de desqualificação ou de cliente, sem testes | ### Armadilhas - **Esteira pela metade.** A transformação rodava todo dia e a tabela estava certa, mas o destino estava inativo havia semanas. O Google seguia otimizando por lead. Como evitar: Monitor que compara tabela produzida com envio feito. - **Lote recusado pela data.** Um evento com data alguns minutos no futuro fez a Meta recusar o lote inteiro. Como evitar: Limite event_time ao momento da execução. - **Contagem em dobro no Events Manager.** A tabela acumulada era reenviada a cada execução e o mesmo lead aparecia várias vezes no dia. Como evitar: Janela disjunta amarrada ao horário da execução. - **Deduplicação que não deduplicava.** Respostas completas e parciais do formulário tinham ids de espaços diferentes; deduplicar pelo id da resposta não removia nada e o lead saía duas vezes. Como evitar: Deduplique por telefone normalizado numa janela de 7 dias. - **Venda que é eco.** A conversão de venda na conta de anúncio era dado enviado pela própria agência e foi apresentada ao cliente como medição da plataforma. Como evitar: Rotule a conversão offline como enviada pela agência. - **Enviado e nunca contabilizado.** Meses de envios com sucesso e nenhuma conversão offline atribuída, porque os e-mails não casavam com cliques na janela. Como evitar: Acompanhe a ação offline na conta, e não o status do envio. ### Teste de aceitação - [ ] Nenhum event_time da tabela da Meta tem mais de 7 dias nem está no futuro no momento do envio. - [ ] Em 7 execuções seguidas, cada event_id aparece em uma única janela, e a contagem diária no Events Manager é igual à da tabela. - [ ] Toda linha tem e-mail ou telefone normalizado, e todo telefone tem 12 ou 13 dígitos começando com 55. - [ ] Para cada tabela de conversão ativa existe um destino ativo que rodou depois dela nas últimas 24 horas. - [ ] Num mês fechado, as vendas enviadas ao Google aparecem na ação offline da conta, ou a diferença está explicada. ### Context document ```text Conversões do CRM para as plataformas - Cada cliente tem uma tabela por destino. Tabelas de conversão são saídas para Meta e Google, não fonte de análise de resultado. - Meta Conversions API: event_time de até 7 dias (janela de 6 dias ou 132 horas) e nunca no futuro. Deduplicação pelo event_id em 48 horas. - Google Ads Click Conversions: até 90 dias do clique (63 nas conversões otimizadas para leads); linha sem identificador é recusada. - event_id = id do registro + nome do evento. A tabela contém só a janela corrente. - Eventos só do CRM vão como system_generated (offline, sem nota de qualidade). Eventos com dados da página vão como website. - Tabela produzida não é envio feito: confirme destino ativo e execução depois da transformação. Envio aceito não é conversão contabilizada: confira a ação offline na conta. - Conversão de venda que aparece na plataforma foi enviada pela agência. Não apresente como medição independente. Exceções por cliente: - : eventos , e ; LeadQualificado = lead ainda aberto dias depois de criado. - : só negócios com origem Meta vão para a Conversions API. - : valor fixo de para a etapa no Google. ``` ### Variações - **Formulário com respostas parciais:** Parcial e completa saem com o mesmo nome de evento, o event_id do parcial ganha sufixo próprio e a deduplicação é por telefone. - **Uma esteira por cliente final:** Agências com dezenas de clínicas ou franquias geram uma tabela e um destino por formulário, a partir de um modelo. - **Venda do checkout:** Venda aprovada em plataforma de infoproduto enviada por transação, com e-mail validado.