> 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 distinguir entre seus clientes atuais, 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, a fim de incentivar os parceiros a gerar conversões para uma categoria específica de status do 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 %}
{% stepper %}
{% step %}
## Crie lógica de identidade em seus sites
Por padrão, o impact.com não tem nenhuma forma de identificar quais visitantes do seu site são novos clientes, clientes atuais, compradores frequentes etc. Os únicos dados que o impact.com recebe são os dados de conversão após uma compra acontecer. Portanto, sua equipe precisa criar a lógica de infraestrutura para identificar dinamicamente os clientes que visitam sua loja virtual e marcá-los com uma `CustomerStatus`. Essa tag 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 %}
## Configure os valores de mapeamento no impact.com
O *mapeamento de status do cliente* alternância é habilitada no nível do tipo de evento, então você pode ativar a configuração para tipos de evento selecionados no seu programa. Observe que os mapeamentos de status do cliente *Novo* e *Existente* (sem diferenciação entre maiúsculas e 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]** → **Ver/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 [abrir um chamado de suporte](https://app.impact.com/support/portal.ihtml) para adicioná-la à sua conta impact.com.
6. Selecione  **\[Ativar] Adicionar mapeamento de valores para habilitar pagamento diferente para novos clientes**.
7. Ao lado dos status do cliente que você quer usar, insira os valores que correspondem aos usados pela sua lógica de identidade.
8. Selecione **Salvar**.
{% endstep %}
{% step %}
## 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 nos quais você pode visualizar dados de status do cliente como 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 ao longo do 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 relatórios [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) 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á muitos pontos de dados diferentes sobre cada ação gerada no intervalo de datas escolhido. Para ver qual status do 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 %}
## Atualize seus pagamentos
Depois de implementar com sucesso o mapeamento de status do cliente no seu código de rastreamento, você pode criar *Ajustes de pagamento* ou *Grupos de pagamento*. Essas configurações permitem ajustar ou adicionar ao que os parceiros recebem, com base na categoria de status do cliente pela qual eles geram conversão (por exemplo, pagamentos maiores para `Novo` clientes).
### Crie 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 do *Pagamento padrão* (ou o *Grupo de pagamento*, quando relevante) por um valor ou porcentagem.
{% hint style="success" %}
**Observação:** Para marcas que pagam seus parceiros com 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 do pagamento em vez de tentar ajustar a porcentagem do pagamento usando *Ajustes de pagamento*.
{% endhint %}
1. Na barra de navegação à esquerda, selecione  **\[Engage]** → **Contratos →** [**Termos de Modelo**](https://app.impact.com/secure/advertiser/engage/contracts/library/view-manage-ios-flow.ihtml).
2. Ao lado dos termos do modelo que você quer alterar, na *Ações* coluna, selecione  **\[Mais]** → **Modificar termos**.
3. Ao lado de *Ajustes de pagamento*, selecione  **\[Ativar]** **Ajuste pagamentos com base em condições específicas**.
4. Configure um ajuste de pagamento [*regras*](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/template-terms/payout-adjustments/how-payout-rules-work.md) com base em *Status do Cliente*.
* Veja a configuração de exemplo abaixo 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**.
### Crie um grupo de pagamento
No impact.com, você pode criar grupos para classificar parceiros em categorias de pagamento com base em regras muito específicas, incluindo [*Grupos de pagamento*](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/template-terms/payout-adjustments/set-payout-rules-using-payout-groups.md) para **alterar completamente** a comissão devida a um parceiro. Normalmente, você criaria grupos de pagamento ao criar um novo termo de modelo, mas também pode adicioná-los a termos existentes e [trocar contratos depois](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/contracts/replace-a-partners-contract.md).
1. Na barra de navegação à esquerda, selecione  **\[Engage]** → **Contratos →** [**Termos de Modelo**](https://app.impact.com/secure/advertiser/engage/contracts/library/view-manage-ios-flow.ihtml).
2. Ao lado dos termos do modelo que você quer alterar, selecione  **\[Mais] → Modificar termos**.
3. Ao lado de *Tipo de Evento*, selecione o tipo de evento ao qual este 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 por vez, selecione **Adicionar novo**.
* Em primeiro lugar,  **\[menu suspenso]**, selecione o grupo de pagamento [*regras*](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/template-terms/payout-adjustments/how-payout-rules-work.md).
* Em segundo lugar,  **\[menu suspenso]**, selecione como a regra deve ser aplicada ao seu grupo de pagamento.
* Em seguida, selecione o valor aplicável à regra de pagamento selecionada (por exemplo, se você selecionou *Moeda* como regra, você terá de selecionar o tipo de moeda na qual deseja pagar os parceiros)
* No *Pagamento* na seção, selecione a métrica de pagamento (ou seja, percentual ou 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 se aplique.
* 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 dos termos do seu modelo e, em seguida, 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 começar 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**.
{% endstep %}
{% endstepper %}
{% hint style="success" %}
**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 %}
## Exemplo na prática
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 $10 para Barb Dwyer. No entanto, você quer recompensar seus parceiros por gerar clientes NOVOS para sua marca e decide aumentar os pagamentos que seus parceiros recebem por trazer novos clientes em 5% e testar *Grupos de pagamento* e *Ajustes de pagamento*.
Primeiro, você decide configurar um **Grupo de pagamento** em seu contrato com um **pagamento de 15% do valor da venda do item** (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 os pagamentos para novos clientes em 5%.
Barb Dwyer agora receberá seu *Pagamento padrão* de 10% ($10) mais 5% adicionais sobre a comissão recebida. Comissão recebida: $10 + 5% = $10,50.
---
# 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 by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
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 what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
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.
