> 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
da impact.com *Mapeamento de status do cliente* recurso permite distinguir 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 de parceiros, para incentivar os parceiros a gerar conversões para uma determinada categoria de status do cliente.
{% hint style="warning" %}
**Aviso:** Ao habilitar a *mapeamento do status do cliente* configuração, você alterará seu código de rastreamento e isso pode causar interrupções no seu programa. Trabalhe com seu CSM durante o processo a seguir para evitar quaisquer problemas.
{% endhint %}
#### Configure o mapeamento de status do cliente
{% stepper %}
{% step %}
**Etapa 1: Crie a lógica de identificação em seus sites**
Por padrão, a impact.com não tem nenhuma forma de identificar quais visitantes do seu site são novos clientes, clientes existentes, compradores frequentes etc. Os únicos dados que a impact.com recebe são os dados de conversão após uma compra acontecer. Portanto, sua equipe deve criar a lógica de infraestrutura para identificar dinamicamente os clientes que visitam sua loja virtual e marcá-los com uma tag apropriada `CustomerStatus`. Essa tag de status será então enviada para a 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 valores correspondentes de mapeamento de status do cliente na impact.com.
{% endstep %}
{% step %}
**Etapa 2: Configure os valores de mapeamento na impact.com**
O *mapeamento do status do cliente* o botão de alternância é habilitado no nível do tipo de evento, então você pode ativar a configuração para tipos de evento selecionados em seu programa. Observe que os mapeamentos de status do cliente *Novo* e *Existente* (não diferencia 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 ticket de suporte](https://app.impact.com/support/portal.ihtml) para que ela seja adicionada à sua conta da impact.com.
6. Selecione  **\[Ative] 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 para a impact.com**
Por precaução, você precisa testar se o parâmetro está sendo enviado para a impact.com com seus dados de conversão. Há 3 relatórios nos quais 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 Clientes Novos vs. Recorrentes
O [Relatório de Clientes Novos vs. Recorrentes](/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 impulsionou 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 de Ações Avançadas
O [Listagem de Ações Avançadas](/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á muitos pontos de dados diferentes sobre cada ação gerada no intervalo de datas escolhido. Para ver qual status de cliente (se houver) está associado às ações apresentadas neste relatório, selecione o **Mostrar** filtro, marque a  **\[Caixa desmarcada]** **Status do cliente** caixa de seleção e depois selecione  **\[Pesquisar]**.
{% endstep %}
{% step %}
**Etapa 4: Atualize seus pagamentos**
Depois de implementar com sucesso o mapeamento de status do cliente em seu código de rastreamento, você pode criar *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**
Na 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 do *Pagamento Padrão* (ou o *Grupo de Pagamento*, quando relevante) em um valor ou porcentagem.
{% hint style="info" %}
**Observação:** Para marcas que pagam a seus parceiros um *Percentual da venda online* como comissão em vez de uma *Taxa de posicionamento*, a 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 do modelo que você deseja alterar, na *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 gera um aumento de 10% no pagamento, mas gerar `Existente` clientes reduz o pagamento em 50%.
5. Na parte inferior da tela, selecione **Próximo**.
6. Escolha quando as modificações começarão para contratos ativos nesse termo do modelo.
7. Selecione **Próximo**.
8. Opcionalmente, adicione um comentário para os parceiros explicando as alterações feitas.
9. Selecione **Salvar**.
**Criar um grupo de pagamento**
Na impact.com, você pode criar grupos para classificar 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 do modelo, mas também pode 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 do modelo que você deseja alterar, selecione  **\[Mais] → Modificar termos**.
3. Ao lado de *Tipo de evento*, selecione o tipo de evento ao qual esse termo do modelo será aplicado.
4. Ao lado de *Grupos de Pagamento*, selecione  **\[Ativar]** **Configurar grupos de pagamento personalizados**.
5. Para adicionar grupos de pagamento um de cada vez, selecione **Adicionar novo**.
* No primeiro  **\[Menu suspenso]**, selecione o grupo de pagamento *Regras* .
* No segundo  **\[Menu suspenso]**, selecione como a regra deve ser aplicada 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ê precisará selecionar o tipo de moeda na qual 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 exige um pagamento personalizado.
7. Selecione **Próximo**.
8. Revise as alterações nos termos do modelo e depois selecione **Próximo**.
9. Escolha quando as modificações devem começar para contratos ativos nesse termo do 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 a 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 sua marca, o que resulta em um **NOVO** cliente. O pagamento padrão do contrato é 10% da venda, o que resultaria em uma comissão de US$ 10 para Barb Dwyer. No entanto, você quer recompensar seus parceiros por trazerem clientes NOVOS para 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** em seu contrato com um **15% do valor da venda do item** pagamento (5% a mais do que o pagamento padrão).
Barb Dwyer agora receberá 15% de US$ 100, o que resulta em uma comissão de US$ 15.
Em seguida, você desativa o grupo de pagamento e tenta configurar um **Ajuste de pagamento** para aumentar os pagamentos para novos clientes em 5%.
Barb Dwyer agora receberá o seu *Pagamento Padrão* de 10% (US$ 10) mais 5% adicionais sobre a comissão recebida. US$ 10 + 5% = comissão recebida de US$ 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.