Mapeamento de campos

Depois que o primeiro evento de conversão chega (de um CRM conectado ou de um teste no webhook manual), o True Conversions mostra os campos brutos recebidos e permite mapeá-los para os campos normalizados que o motor de processamento entende.

Acesse: abra a conta (cliente) → Mapeamento de campos.

Conta com CRM conectado nativamente (RD Station Marketing, RD Station CRM, Pipedrive, ActiveCampaign)? O checklist da conta já mostra este passo como "Automático — campos do CRM já mapeados" — na maioria dos casos você pode pular esta página. Use-a só se quiser mapear um campo extra (ex.: cnpj, company_name) ou se o mapeamento automático não pegou algo que você esperava.

Como funciona a tela

A tabela mostra cada campo encontrado no último payload recebido (achatado — objetos aninhados viram caminhos como deal[stage_title] ou contact.email), o valor de exemplo, e um seletor para escolher o campo normalizado correspondente.

Mapeamento automático: campos comuns (email, telefone, nome, valor, gclid, etc.) já vêm sugeridos automaticamente, tanto em inglês quanto em português (ex.: telefone, valor, empresa).
Cada campo normalizado só pode ser usado uma vez — se dois campos brutos sugerirem o mesmo destino, apenas o primeiro é mantido.
Clique em Salvar mapeamento para confirmar.

Se nenhum payload foi recebido ainda, a página avisa: envie um evento de teste ao webhook da conta primeiro.

Campos normalizados disponíveis

Campo	Uso
`email`	Identificador principal de correspondência
`phone`	Identificador de correspondência (formato E.164 recomendado)
`first_name` / `last_name`	Melhora a correspondência
`value`	Valor do negócio/conversão
`currency`	Código de moeda (ex.: `BRL`)
`order_id`	ID do pedido/transação (se aplicável)
`event_name`	Nome do evento (fallback quando não há campo de etapa configurado)
`gclid`	Código do clique do Google Ads — melhora muito a correspondência
`wbraid` / `gbraid`	Códigos do clique do Google no iOS (app/web)
`fbclid`	Código do clique do Meta (da URL)
`fbc` / `fbp`	Cookies do pixel do Meta (enviados sem hash)
`lead_id`	ID do lead do Meta Lead Ads (formulários instantâneos)
`utm_source` / `utm_campaign`	Atribuição de campanha
`conversion_time`	Timestamp do evento
`cnpj` / `website` / `company_name`	Ajudam o Enriquecimento de leads a identificar a empresa mais rápido
`deal_id`	O ID permanente do negócio/negociação no CRM

Regras de validação

Email ou telefone é obrigatório. Sem pelo menos um dos dois, o Save é bloqueado — são os identificadores que as plataformas de anúncios usam para correspondência.
Se você mapear gclid, mas nenhum outro campo tiver sido mapeado ainda, um aviso aparece incentivando o mapeamento — ele melhora significativamente a correspondência no Google Ads.

`deal_id` — obrigatório para Otimização de valor

Se a conta usa (ou vai usar) Otimização de valor, mapeie o deal_id: é o identificador permanente do negócio no CRM, o que permite ao True Conversions conectar as etapas de um mesmo negócio ao longo do tempo (enviar o valor inicial, depois reafirmar conforme ele avança, até o Fechado-Ganho).

Sem deal_id mapeado, as regras de valor simplesmente não são aplicadas — os eventos continuam sendo processados e enviados, só que sem os multiplicadores por etapa. Esse é o problema mais comum quando alguém configura a Otimização de valor e "nada parece acontecer".

Para CRMs conectados nativamente (RD Station Marketing, RD Station CRM, Pipedrive, ActiveCampaign), o deal_id já chega em um campo padrão e normalmente nem precisa de mapeamento manual. Para webhooks manuais (RD CRM no plano Free, CRMs customizados), você precisa mapear o campo correto manualmente — geralmente algo como deal[id] ou negociacao_id.

Encontrando o campo de etapa (stage) do negócio

Esse campo é configurado na página de Otimização de valor, não aqui — mas a forma de descobrir o caminho certo usa esta mesma tela de eventos:

Mova um negócio de teste para uma nova etapa no CRM.
Vá até a página da conta → Eventos recentes, encontre o evento mais recente e clique para expandir.
Abra a seção Dados recebidos — ela mostra todos os campos achatados do payload bruto, exatamente como chegaram.
Encontre o campo que contém o nome da etapa (ex.: deal[stage_title]) e copie o caminho exato.
Cole esse caminho no campo Campo de etapa da página de Otimização de valor.