> 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 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, a fim de incentivar os parceiros a gerar conversões para uma determinada categoria de status de cliente.
{% hint style="warning" %}
**Aviso:** Ativar o *mapeamento de status do cliente* configuração vai alterar seu código de rastreamento e pode causar interrupções em seu programa. Trabalhe com seu CSM ao longo do processo a seguir para evitar quaisquer problemas.
{% endhint %}
{% stepper %}
{% step %}
## Crie 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 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 marcá-los com um `CustomerStatus`. Essa tag de status será então enviada para a impact.com junto com os dados de conversão, como um valor no `customerStatus={-the dynamic value-}` parâmetro.
Depois de implementar essa lógica do seu lado, você pode configurar os valores correspondentes de mapeamento de status do cliente na impact.com.
{% endstep %}
{% step %}
## Configurar valores de mapeamento na impact.com
A *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 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]** → **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 [abra um chamado de suporte](https://app.impact.com/support/portal.ihtml) para adicioná-la à sua conta da impact.com.
6. Selecione  **\[Ativar] Adicionar mapeamento de valores para permitir 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 %}
## Certifique-se de que o parâmetro seja passado para a impact.com
Como precaução, você precisa testar se o parâmetro está sendo passado para a impact.com com os seus dados de conversão. Existem 3 relatórios em que você pode visualizar os dados de status do cliente como uma forma de garantir que você esteja passando o `customerStatus` parâmetro:
* Relatório de novos clientes vs. clientes recorrentes
A [Relatório de novos clientes vs. clientes 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
A [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 [Novos vs. Clientes 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) 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, depois, detalhados por status do cliente.
* Listagem avançada de ações
A [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á a você muitos pontos de dados diferentes 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 **Mostrar** 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 em seu código de rastreamento, você pode criar *Ajustes de pagamento* ou *Grupos de repasse*. Essas configurações permitem ajustar ou acrescentar o que os parceiros recebem, com base na categoria de status do cliente pela qual eles geram conversão (por exemplo, pagamentos mais altos 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 a partir do *Pagamento padrão* (ou o *Grupo de pagamento*, quando relevante) em um valor ou percentual.
{% hint style="success" %}
**Observação:** Para marcas que pagam a seus parceiros um *Percentual da venda online* como comissão em vez de uma *Taxa de veiculação*, a impact.com recomenda usar *Grupos de repasse* para definir o percentual final de pagamento em vez de tentar ajustar o percentual de pagamento usando *Ajustes de pagamento*.
{% endhint %}
1. Na barra de navegação à esquerda, selecione  **\[Engajar]** → **Contratos →** [**Termos de modelo**](https://app.impact.com/secure/advertiser/engage/contracts/library/view-manage-ios-flow.ihtml).
2. Ao lado dos termos de 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. Configurar 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/como-as-regras-de-pagamento-funcionam.md) com base em *Status do cliente*.
* Veja o exemplo de configuração abaixo 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
Na impact.com, você pode criar grupos para organizar parceiros em categorias de pagamento com base em regras muito específicas, incluindo [*Grupos de repasse*](/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  **\[Engajar]** → **Contratos →** [**Termos de modelo**](https://app.impact.com/secure/advertiser/engage/contracts/library/view-manage-ios-flow.ihtml).
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 esse termo de modelo se aplicará.
4. Ao lado de *Grupos de repasse*, selecione  **\[ativar]** **Configurar grupos de repasse personalizados**.
5. Para adicionar grupos de pagamento um de cada vez, selecione **Adicionar novo**.
* No primeiro  **\[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/como-as-regras-de-pagamento-funcionam.md).
* 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)
* Na *valor do repasse* 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 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 termos do 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 da *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 a impact.com não encontrar um grupo de pagamento aplicável a uma ação gerada por um parceiro, a *Pagamento padrão* será aplicada.
{% endhint %}
## Exemplo na prática
Barb Dwyer gera uma venda de bigorna ($100) para 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 US$ 10 para Barb Dwyer. No entanto, você quer recompensar seus parceiros por gerar clientes NOVOS para sua marca e decide aumentar em 5% os pagamentos que seus parceiros recebem por trazer novos clientes e testar com *Grupos de repasse* e *Ajustes de pagamento*.
Primeiro, você decide configurar um **Grupo de pagamento** em seu contrato com um **15% do valor de venda do item** pagamento (5% a mais 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á seu *Pagamento padrão* pagamento de 10% (US$ 10) mais 5% adicionais sobre a comissão recebida. US$ 10 + 5% = comissão recebida de US$ 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 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.
