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`	Receita real do negócio, quando ela será enviada
`currency`	Código de moeda da receita (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`	Dados adicionais sobre a empresa
`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 etapas da Jornada

Mapeie o deal_id: é o identificador permanente do negócio no CRM. Ele é obrigatório para cada marco da Jornada de conversão, pois permite reconhecer as etapas do mesmo negócio.

Com a Jornada habilitada e configurada, um evento sem deal_id é pulado: não é enviado como uma conversão simples. Isso evita que uma etapa seja atribuída ao negócio errado.

Para CRMs conectados nativamente (RD Station Marketing, RD Station CRM, Pipedrive e ActiveCampaign), os campos padrão normalmente já incluem o deal_id, sem mapeamento manual. Em webhooks manuais (como RD CRM Free ou CRM próprio), mapeie o campo correto — por exemplo, deal[id] ou negociacao_id.

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

Esse campo é configurado na página de Jornada de conversão, 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 Jornada de conversão.