> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/tracking/set-up-tracking/configure-customer-status-mapping.md).
# Configurar o Mapeamento de Status do Cliente
do impact.com *Mapeamento de Status do Cliente* recurso permite que você diferencie entre seus clientes existentes, clientes que nunca compraram com você antes, clientes frequentes etc. Essas informações são úteis em relatórios ao visualizar a taxa de aquisição de novos clientes do seu programa ou o número de compradores frequentes. As informações também podem ser usadas ao criar modificações de pagamento para parceiros, para incentivar os parceiros a gerarem conversões para uma categoria específica de status de cliente.
{% hint style="warning" %}
**Aviso:** Ativar o *mapeamento de status do cliente* configuração alterará seu código de rastreamento e pode causar interrupções no seu programa. Trabalhe com seu CSM durante o processo a seguir para evitar problemas.
{% endhint %}
#### Configurar o Mapeamento de Status do Cliente
{% stepper %}
{% step %}
**Etapa 1: Crie lógica de identificação em seus sites**
Por padrão, o impact.com não tem nenhuma maneira de identificar quais visitantes do seu site são novos clientes, clientes existentes, compradores frequentes etc. Os únicos dados que o impact.com recebe são dados de conversão depois que uma compra acontece. Portanto, sua equipe deve criar a lógica de infraestrutura para identificar dinamicamente os clientes que visitam sua loja virtual e atribuir a eles uma etiqueta apropriada `CustomerStatus`. Essa etiqueta de status será então enviada ao impact.com junto com os dados de conversão, como um valor em `customerStatus={-o valor dinâmico-}` parâmetro.
Depois de implementar essa lógica do seu lado, você pode configurar os valores correspondentes de mapeamento de status do cliente no impact.com.
{% endstep %}
{% step %}
**Etapa 2: Configure os valores de mapeamento no impact.com**
O *mapeamento de status do cliente* o botão de ativação é habilitado no nível do tipo de evento, então você pode habilitar a configuração para tipos de evento selecionados no seu programa. Observe que os mapeamentos de status do cliente *Novo* e *Existente* (não diferenciam maiúsculas de minúsculas) devem funcionar por padrão ao enviar conversões ou modificações de pagamento, mesmo que você não ative a configuração.
1. Na barra de navegação superior, selecione  **\[Perfil do usuário] → Configurações**.
2. À direita, em *Rastreamento*, selecione **Tipos de evento**.
3. Ao lado do tipo de evento ao qual você deseja adicionar valores de mapeamento de status do cliente, selecione  **\[Mais]** → **Visualizar/Editar**.
4. Na parte inferior, selecione **Mostrar configurações avançadas**.
5. Ao lado de *Mapeamento de Status do Cliente*, selecione  **\[Editar]**.
* Não vê a *Mapeamento de Status do Cliente* configuração? Entre em contato com seu CSM ou [abra um chamado de suporte](https://app.impact.com/support/portal.ihtml) para adicioná-la à sua conta do impact.com.
6. Selecione  **\[Ativar] Adicionar mapeamento de valores para habilitar pagamento diferente para novos clientes**.
7. Ao lado dos status de cliente que você deseja usar, insira os valores que correspondem aos usados pela sua lógica de identificação.
8. Selecione **Salvar**.
{% endstep %}
{% step %}
**Etapa 3: Garanta que o parâmetro seja enviado ao impact.com**
Como precaução, você precisa testar se o parâmetro está sendo enviado ao impact.com com os seus dados de conversão. Há 3 relatórios em que você pode visualizar os dados de status do cliente como uma forma de garantir que você está enviando o `customerStatus` parâmetro:
* Relatório de Cliente Novo vs. Cliente Recorrente
O [Relatório de Cliente Novo vs. Cliente Recorrente](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/multi-program-reports/performance-reports-for-brands/new-vs-return-customer-report.md) mostrará dados sobre ações criadas por *Novo*, *Existente*, e *Reengajados* clientes durante o intervalo de datas escolhido. As ações, o custo da ação e a receita gerada por cada tipo de cliente são agregados pelo parceiro que gerou a ação.
* Relatório de Desempenho por Dia por Status do Cliente
O [Relatório de Desempenho por Dia por Status do Cliente](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/multi-program-reports/performance-reports-for-brands/performance-by-day-by-customer-status-report.md) combina os dados apresentados nos [Novo vs. Cliente Recorrente](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/multi-program-reports/performance-reports-for-brands/new-vs-return-customer-report.md) e [Desempenho por Dia](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/multi-program-reports/performance-reports-for-brands/performance-by-day-report.md) relatórios. Os dados de ação, custo da ação e receita são primeiro agregados por dia e, em seguida, detalhados por status do cliente.
* Listagem Avançada de Ações
O [Listagem Avançada de Ações](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/multi-program-reports/performance-reports-for-brands/advanced-action-listing-report.md) fornecerá diversos pontos de dados sobre cada ação gerada dentro do intervalo de datas escolhido. Para ver qual status de cliente (se houver) está associado às ações apresentadas neste relatório, selecione o **Exibir** filtro, marque a  **\[Caixa desmarcada]** **Status do cliente** caixa e, em seguida, selecione  **\[Pesquisar]**.
{% endstep %}
{% step %}
**Etapa 4: Atualize seus pagamentos**
ajustes de pagamento para parceiros *Ajustes de Pagamento* ou *Grupos de Pagamento*. Essas configurações permitem ajustar ou acrescentar ao que os parceiros recebem, com base na categoria de status do cliente para a qual eles geram conversão (por exemplo, pagamentos maiores para `Novo` clientes).
**Criar um ajuste de pagamento**
No impact.com, você pode criar regras que ajustam o pagamento de uma ação com base em condições muito específicas, incluindo *Status do cliente*. *Ajustes de Pagamento* **ajustar** a comissão devida a um parceiro a partir de *Pagamento Padrão* (ou o *Grupo de Pagamento*, quando aplicável) por um valor ou porcentagem.
{% hint style="info" %}
**Observação:** Para marcas que pagam aos seus parceiros uma *Porcentagem da venda online* como comissão em vez de uma *Taxa de posicionamento*, o impact.com recomenda usar *Grupos de Pagamento* para definir a porcentagem final de pagamento em vez de tentar ajustar a porcentagem de pagamento usando *Ajustes de Pagamento*.
{% endhint %}
1. Na barra de navegação à esquerda, selecione  **\[Engage]** → **Contratos → Termos de Modelo**.
2. Ao lado dos termos de modelo que você deseja alterar, no *Ações* coluna, selecione  **\[Mais]** → **Modificar termos**.
3. Ao lado de *Ajustes de Pagamento*, selecione  **\[Ativar]** **Ajustar pagamentos com base em condições específicas**.
4. Configure um ajuste de pagamento com base em *Status do cliente*.
* Veja a imagem abaixo para um exemplo de configuração em que gerar `Novo` clientes rende um aumento de 10% no pagamento, mas gerar `Existente` clientes reduz o pagamento em 50%.
5. Na parte inferior da tela, selecione **Avançar**.
6. Escolha quando as modificações começarão para contratos ativos nesse termo de modelo.
7. Selecione **Avançar**.
8. Opcionalmente, adicione um comentário para os parceiros explicando as alterações feitas.
9. Selecione **Salvar**.
**Criar um grupo de pagamento**
No impact.com, você pode criar grupos para organizar parceiros em categorias de pagamento com base em regras muito específicas, incluindo *Grupos de Pagamento* **alterar completamente** a comissão devida a um parceiro. Os grupos de pagamento geralmente são criados quando você cria um novo termo de modelo, mas também é possível adicioná-los a termos existentes e trocar os contratos depois.
1. Na barra de navegação à esquerda, selecione  **\[Engage]** → **Contratos → Termos de Modelo**.
2. Ao lado dos termos de modelo que você deseja alterar, selecione  **\[Mais] → Modificar termos**.
3. Ao lado de *Tipo de evento*, selecione o tipo de evento ao qual este termo de modelo se aplicará.
4. Ao lado de *Grupos de Pagamento*, selecione  **\[Ativar]** **Configure grupos de pagamento personalizados**.
5. Para adicionar grupos de pagamento um por vez, selecione **Adicionar novo**.
* No primeiro  **\[Menu suspenso]**, selecione grupo de pagamento *Regras* .
* No segundo  **\[Menu suspenso]**, selecione como a regra deve se aplicar ao seu grupo de pagamento.
* Em seguida, selecione o valor aplicável à regra de pagamento que você selecionou (por exemplo, se você selecionou *Moeda* como regra, você terá que selecionar o tipo de moeda em que deseja pagar os parceiros)
* No *Pagamento* seção, selecione a métrica de pagamento (ou seja, porcentagem ou valor fixo) e o valor numérico apropriado.
* Selecione **Adicionar**.
6. Para criar outro grupo, selecione **Adicionar novo** novamente.
* Se você adicionar mais de uma regra por grupo de pagamento, todas as regras precisarão corresponder para que esse grupo de pagamento seja aplicado.
* Você deve criar um novo grupo de pagamento para cada *Status do cliente* que exija um pagamento personalizado.
7. Selecione **Avançar**.
8. Revise as alterações nos seus termos de modelo e, em seguida, selecione **Avançar**.
9. Escolha quando as modificações devem começar para contratos ativos nesse termo de modelo.
10. Selecione se os parceiros podem optar por iniciar os novos termos antes do *Data de início da modificação*.
11. Opcionalmente, adicione um comentário para os parceiros explicando as alterações feitas.
12. Selecione **Salvar**.
{% hint style="info" %}
**Observação:** Se o impact.com não encontrar um grupo de pagamento aplicável a uma ação gerada por um parceiro, o *Pagamento Padrão* será aplicado.
{% endhint %}
{% hint style="info" %}
**Exemplo:** Barb Dwyer gera uma venda de bigorna ($100) para a sua marca, o que resulta em uma **NOVO** cliente. O pagamento padrão do contrato é 10% da venda, o que resultaria em uma comissão de $10 para Barb Dwyer. No entanto, você quer recompensar seus parceiros por trazerem clientes NOVOS para a sua marca e decide aumentar em 5% os pagamentos que seus parceiros recebem por trazer novos clientes e experimentar com *Grupos de Pagamento* e *Ajustes de Pagamento*.
Primeiro, você decide configurar um **Grupo de Pagamento** no seu contrato com um **15% do valor da venda do item** pagamento (5% a mais que o pagamento padrão).
Barb Dwyer agora receberá 15% de $100, o que resulta em uma comissão de $15.
Em seguida, você desativa o grupo de pagamento e tenta configurar um **Ajuste de pagamento** para aumentar em 5% os pagamentos para novos clientes.
Barb Dwyer agora receberá sua *Pagamento Padrão* de 10% ($10), mais 5% adicionais sobre a comissão recebida. $10 + 5% = comissão recebida de $10,50.
{% endhint %}
{% endstep %}
{% endstepper %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/tracking/set-up-tracking/configure-customer-status-mapping.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.