# 7.1 MAPEAMENTO

## Mapeamento de Campos

O **mapeamento de campos** é o processo responsável por traduzir as informações enviadas por sistemas parceiros para o padrão utilizado pelo Dommus.

Sempre que um lead ou oportunidade é recebido no sistema, ele pode conter dados como:

- Origem
- Mídia
- Campanha
- Empreendimento
- Entre outros

Para que essas informações sejam corretamente interpretadas e atribuídas corretamente dentro do sistema, é necessário realizar o mapeamento desses campos.

---

#### Como identificar os dados recebidos

Antes de realizar o mapeamento, é importante validar como as informações estão chegando no Dommus.

Para isso:

1. Acesse o menu lateral
2. Clique em **Mais Funcionalidades**
3. Acesse a tela de **Central de Recepção de Leads**
4. Localize um lead recebido e valide os campos encaminhados pela integração

Essa validação é importante, pois os dados enviados podem variar de acordo com o canal de origem.

---

#### **Ponto de Atenção**

Os dados encaminhados pelo desenvolvedor ou pela plataforma parceira **podem variar conforme a origem do lead**.

Ou seja, a estrutura dos campos recebidos no Dommus nem sempre será a mesma para todos os canais.

**Exemplo 1: Landing Page**

Quando o lead é enviado por uma **Landing Page**, normalmente os campos costumam vir de forma mais direta, como:

- mídia
- origem
- empreendimento

Nesse cenário, a identificação dos dados costuma ser mais simples, pois os campos já chegam com nomenclaturas mais próximas do que será utilizado no sistema.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-04/scaled-1680-/2ENimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-04/2ENimage.png)

---

**Exemplo 2: LAIS**

Na plataforma **LAIS**, os dados são encaminhados com outra estrutura. Nesse caso, os campos devem ser interpretados da seguinte forma:

- **Mídia** = `origin`
- **Origem** = `origin`
- **Campanha** = `portal_listing_id`
- **Empreendimento** = `client_listing_id`

Ou seja, ao analisar um lead vindo da LAIS na Central de Recepção de Leads, os dados de campanha, mídia, origem e empreendimento estarão distribuídos conforme essa estrutura.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-04/scaled-1680-/P5vimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-04/P5vimage.png)

---

**Exemplo 3: RD Station**

No **RD Station**, os campos também podem chegar com nomenclaturas diferentes. A correspondência é a seguinte:

- **Campanha** = `last_conversion -> source`
- **Empreendimento** = `last_conversion -> source`
- **Mídia** = `last_conversion -> conversion_origin -> source`
- **Origem** = `last_conversion -> conversion_origin -> source`

Por isso, antes de criar qualquer regra de mapeamento, é fundamental validar exatamente quais campos e valores estão sendo recebidos pelo Dommus.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-04/scaled-1680-/R8Pimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-04/R8Pimage.png)

---

#### Como funciona o mapeamento

O mapeamento funciona como um **DE/PARA**, ou seja:

- **DE:** valor enviado pelo sistema externo
- **PARA:** valor que será atribuído dentro do Dommus

Na prática, isso significa traduzir o que está sendo encaminhado pela integração para o formato que o sistema deve considerar ao gerar o lead.

Exemplo:

- O parceiro envia um valor específico em um campo
- No Dommus, esse valor deve corresponder a uma mídia, origem, campanha ou empreendimento já configurado

Com isso, o sistema consegue classificar corretamente o lead recebido.

---

#### Quando o mapeamento deve ser realizado

O mapeamento é necessário principalmente quando:

- Está sendo integrada uma **nova landing page**
- Um novo parceiro começa a enviar leads
- Os dados recebidos não estão sendo corretamente identificados no sistema
- Há diferença entre o nome do campo enviado pela integração e o nome utilizado no Dommus

Caso não exista um mapeamento configurado corretamente, o sistema pode não interpretar os dados da forma esperada.

---

#### **Próximo passo**

Após identificar como os campos estão chegando no Dommus, basta seguir o passo a passo de configuração para realizar o **mapeamento dos campos**.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-07/scaled-1680-/FkZimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-07/FkZimage.png)

**Mapeamento de Mídia**

O primeiro passo é realizar o **mapeamento da mídia**.  
Ao clicar em **"Mapeamento de Mídias"**, o sistema exibirá todos os mapeamentos de mídia já cadastrados na base do Dommus. Além disso, será possível **criar um novo mapeamento**, caso necessário.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-07/scaled-1680-/8Vlimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-07/8Vlimage.png)

Ao clicar em **“Cadastrar um Novo Mapeamento”**, o sistema abrirá uma janela com alguns campos a serem preenchidos:

- **Descrição**: corresponde ao valor exato da informação que está sendo enviada para o Dommus.
- **Mídia**: refere-se à mídia previamente cadastrada no sistema Dommus, à qual essa informação será vinculada.
- **Parceiro de Integração**: identifica o sistema, landing page ou site responsável por enviar os dados ao Dommus.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-07/scaled-1680-/gJ4image.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-07/gJ4image.png)

Após preencher todos os campos obrigatórios, clique em **“Salvar”** para que o sistema registre as informações do novo mapeamento.

Se for necessário **alterar um mapeamento existente**, localize-o na listagem, clique no ícone correspondente e selecione a opção **“Editar”**.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-07/scaled-1680-/bp0image.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-07/bp0image.png)

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-07/scaled-1680-/rj0image.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-07/rj0image.png)

A inclusão ou alteração dos mapeamentos de **origens**, **campanhas** e outras categorias segue o mesmo padrão utilizado no mapeamento de mídia. Todos utilizam a mesma estrutura de tela para configuração, o que torna o processo simples e padronizado.

**Mapeamento de Origens**

<span class="heading-anchor-wrapper" role="presentation"><button aria-hidden="true" class="cc-wf6gg8" data-testid="anchor-button" type="button"><span aria-label="Copiar" class="_1e0c1o8l _vchhusvi _1o9zidpf _vwz4kb7n _y4ti1igz _bozg1mb9 _12va18uv _jcxd1r8n" role="img"><svg class="_1reo15vq _18m915vq _syaz1r31 _lcxvglyw _s7n4yfq0 _vc881r31 _1bsbpxbi _4t3ipxbi" fill="none" role="presentation" viewbox="0 0 16 16"><path clip-rule="evenodd" d="M8.22 2.22a3.932 3.932 0 1 1 5.56 5.56l-2.25 2.25-1.06-1.06 2.25-2.25a2.432 2.432 0 0 0-3.44-3.44L7.03 5.53 5.97 4.47zm3.06 3.56-5.5 5.5-1.06-1.06 5.5-5.5zM2.22 8.22l2.25-2.25 1.06 1.06-2.25 2.25a2.432 2.432 0 0 0 3.44 3.44l2.25-2.25 1.06 1.06-2.25 2.25a3.932 3.932 0 1 1-5.56-5.56" fill="currentcolor" fill-rule="evenodd"></path></svg></span></button></span>No caso do **Mapeamento de Origens**, o procedimento é idêntico:  
Acesse a seção correspondente, clique em **“Cadastrar um Novo Mapeamento”**, preencha os campos obrigatórios e clique em **“Salvar”**.<span class="_ca0qidpf _u5f3idpf _n3tdidpf _19bvidpf _19itidpf _1reo15vq _18m915vq _1bsbt94y _4t3it94y _kqswstnw _ogto7mnp _uiztglyw _o5721q9c" data-testid="visually-hidden-heading-anchor"><span class="heading-anchor-wrapper" role="presentation"><button aria-hidden="false" aria-label="Copiar link para cabeçalho" aria-labelledby="Mapeamento-de-Origens" class="cc-wf6gg8" data-testid="anchor-button" tabindex="-1" type="button"><span aria-label="Copiar" class="_1e0c1o8l _vchhusvi _1o9zidpf _vwz4kb7n _y4ti1igz _bozg1mb9 _12va18uv _jcxd1r8n" role="img"><svg class="_1reo15vq _18m915vq _syaz1r31 _lcxvglyw _s7n4yfq0 _vc881r31 _1bsbpxbi _4t3ipxbi" fill="none" role="presentation" viewbox="0 0 16 16"><path clip-rule="evenodd" d="M8.22 2.22a3.932 3.932 0 1 1 5.56 5.56l-2.25 2.25-1.06-1.06 2.25-2.25a2.432 2.432 0 0 0-3.44-3.44L7.03 5.53 5.97 4.47zm3.06 3.56-5.5 5.5-1.06-1.06 5.5-5.5zM2.22 8.22l2.25-2.25 1.06 1.06-2.25 2.25a2.432 2.432 0 0 0 3.44 3.44l2.25-2.25 1.06 1.06-2.25 2.25a3.932 3.932 0 1 1-5.56-5.56" fill="currentcolor" fill-rule="evenodd"></path></svg></span></button></span></span>

Os campos apresentados são:

- **Descrição**: valor exato da origem enviada para o Dommus.
- **Origem**: origem já cadastrada no sistema Dommus que será associada à informação recebida.
- **Parceiro de Integração**: sistema, site ou landing page que está enviando os dados.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-07/scaled-1680-/chaimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-07/chaimage.png)

**Mapeamento de Campanhas**<span class="heading-anchor-wrapper" role="presentation"><button aria-hidden="true" class="cc-wf6gg8" data-testid="anchor-button" type="button"><span aria-label="Copiar" class="_1e0c1o8l _vchhusvi _1o9zidpf _vwz4kb7n _y4ti1igz _bozg1mb9 _12va18uv _jcxd1r8n" role="img"><svg class="_1reo15vq _18m915vq _syaz1r31 _lcxvglyw _s7n4yfq0 _vc881r31 _1bsbpxbi _4t3ipxbi" fill="none" role="presentation" viewbox="0 0 16 16"><path clip-rule="evenodd" d="M8.22 2.22a3.932 3.932 0 1 1 5.56 5.56l-2.25 2.25-1.06-1.06 2.25-2.25a2.432 2.432 0 0 0-3.44-3.44L7.03 5.53 5.97 4.47zm3.06 3.56-5.5 5.5-1.06-1.06 5.5-5.5zM2.22 8.22l2.25-2.25 1.06 1.06-2.25 2.25a2.432 2.432 0 0 0 3.44 3.44l2.25-2.25 1.06 1.06-2.25 2.25a3.932 3.932 0 1 1-5.56-5.56" fill="currentcolor" fill-rule="evenodd"></path></svg></span></button></span><span class="_ca0qidpf _u5f3idpf _n3tdidpf _19bvidpf _19itidpf _1reo15vq _18m915vq _1bsbt94y _4t3it94y _kqswstnw _ogto7mnp _uiztglyw _o5721q9c" data-testid="visually-hidden-heading-anchor"><span class="heading-anchor-wrapper" role="presentation"><button aria-hidden="false" aria-label="Copiar link para cabeçalho" aria-labelledby="Mapeamento-de-Campanhas" class="cc-wf6gg8" data-testid="anchor-button" tabindex="-1" type="button"><span aria-label="Copiar" class="_1e0c1o8l _vchhusvi _1o9zidpf _vwz4kb7n _y4ti1igz _bozg1mb9 _12va18uv _jcxd1r8n" role="img"><svg class="_1reo15vq _18m915vq _syaz1r31 _lcxvglyw _s7n4yfq0 _vc881r31 _1bsbpxbi _4t3ipxbi" fill="none" role="presentation" viewbox="0 0 16 16"><path clip-rule="evenodd" d="M8.22 2.22a3.932 3.932 0 1 1 5.56 5.56l-2.25 2.25-1.06-1.06 2.25-2.25a2.432 2.432 0 0 0-3.44-3.44L7.03 5.53 5.97 4.47zm3.06 3.56-5.5 5.5-1.06-1.06 5.5-5.5zM2.22 8.22l2.25-2.25 1.06 1.06-2.25 2.25a2.432 2.432 0 0 0 3.44 3.44l2.25-2.25 1.06 1.06-2.25 2.25a3.932 3.932 0 1 1-5.56-5.56" fill="currentcolor" fill-rule="evenodd"></path></svg></span></button></span></span>

O processo para configurar o **Mapeamento de Campanhas** também segue o mesmo padrão.

Acesse a seção **“Mapeamento de Campanhas”**, clique em **“Cadastrar um Novo Mapeamento”**, preencha os campos obrigatórios e finalize clicando em **“Salvar”**.

Os campos disponíveis são:

- **Descrição**: valor exato da campanha que está sendo enviada para o Dommus.
- **Campanha**: campanha já cadastrada no sistema Dommus à qual a informação será vinculada.
- **Parceiro de Integração**: sistema, site ou landing page responsável pelo envio dos dados.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-07/scaled-1680-/hgYimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-07/hgYimage.png)

**Mapeamento de Empreendimentos**<span class="heading-anchor-wrapper" role="presentation"><button aria-hidden="true" class="cc-wf6gg8" data-testid="anchor-button" type="button"><span aria-label="Copiar" class="_1e0c1o8l _vchhusvi _1o9zidpf _vwz4kb7n _y4ti1igz _bozg1mb9 _12va18uv _jcxd1r8n" role="img"><svg class="_1reo15vq _18m915vq _syaz1r31 _lcxvglyw _s7n4yfq0 _vc881r31 _1bsbpxbi _4t3ipxbi" fill="none" role="presentation" viewbox="0 0 16 16"><path clip-rule="evenodd" d="M8.22 2.22a3.932 3.932 0 1 1 5.56 5.56l-2.25 2.25-1.06-1.06 2.25-2.25a2.432 2.432 0 0 0-3.44-3.44L7.03 5.53 5.97 4.47zm3.06 3.56-5.5 5.5-1.06-1.06 5.5-5.5zM2.22 8.22l2.25-2.25 1.06 1.06-2.25 2.25a2.432 2.432 0 0 0 3.44 3.44l2.25-2.25 1.06 1.06-2.25 2.25a3.932 3.932 0 1 1-5.56-5.56" fill="currentcolor" fill-rule="evenodd"></path></svg></span></button></span><span class="_ca0qidpf _u5f3idpf _n3tdidpf _19bvidpf _19itidpf _1reo15vq _18m915vq _1bsbt94y _4t3it94y _kqswstnw _ogto7mnp _uiztglyw _o5721q9c" data-testid="visually-hidden-heading-anchor"><span class="heading-anchor-wrapper" role="presentation"><button aria-hidden="false" aria-label="Copiar link para cabeçalho" aria-labelledby="Mapeamento-de-Empreendimentos" class="cc-wf6gg8" data-testid="anchor-button" tabindex="-1" type="button"><span aria-label="Copiar" class="_1e0c1o8l _vchhusvi _1o9zidpf _vwz4kb7n _y4ti1igz _bozg1mb9 _12va18uv _jcxd1r8n" role="img"><svg class="_1reo15vq _18m915vq _syaz1r31 _lcxvglyw _s7n4yfq0 _vc881r31 _1bsbpxbi _4t3ipxbi" fill="none" role="presentation" viewbox="0 0 16 16"><path clip-rule="evenodd" d="M8.22 2.22a3.932 3.932 0 1 1 5.56 5.56l-2.25 2.25-1.06-1.06 2.25-2.25a2.432 2.432 0 0 0-3.44-3.44L7.03 5.53 5.97 4.47zm3.06 3.56-5.5 5.5-1.06-1.06 5.5-5.5zM2.22 8.22l2.25-2.25 1.06 1.06-2.25 2.25a2.432 2.432 0 0 0 3.44 3.44l2.25-2.25 1.06 1.06-2.25 2.25a3.932 3.932 0 1 1-5.56-5.56" fill="currentcolor" fill-rule="evenodd"></path></svg></span></button></span></span>

O **Mapeamento de Empreendimentos** também utiliza a mesma estrutura de configuração.

Para cadastrar um novo mapeamento, acesse a seção **“Mapeamento de Empreendimentos”**, clique em **“Cadastrar um Novo Mapeamento”**, preencha os campos obrigatórios e clique em **“Salvar”**.

Os campos apresentados são:

- **Descrição**: valor exato do nome do empreendimento enviado para o Dommus.
- **Empreendimento**: empreendimento já cadastrado no sistema Dommus com o qual a informação será associada.
- **Parceiro de Integração**: sistema, site ou landing page que está enviando os dados ao Dommus.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-07/scaled-1680-/5i7image.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-07/5i7image.png)

  
O **Mapeamento de Anúncios ImovelWeb** também segue o mesmo processo de cadastro.

Acesse a seção **“Mapeamento de Anúncios ImovelWeb”**, clique em **“Cadastrar um Novo Mapeamento”**, preencha os campos obrigatórios e clique em **“Salvar”**.

Os campos disponíveis são:

- **Descrição**: valor enviado pelo parceiro para identificação do anúncio.
- **Empreendimento**: empreendimento já cadastrado no sistema Dommus que será vinculado ao anúncio.
- **Parceiro de Integração**: sistema ou portal responsável pelo envio das informações.

**Observação:** neste tipo de mapeamento, é obrigatório informar o **código do ImovelWeb** correspondente ao anúncio.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-07/scaled-1680-/YSsimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-07/YSsimage.png)