> 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/it/what-would-you-like-to-learn-about/platform-features/tracking/set-up-tracking/configure-customer-status-mapping.md).
# Configura la mappatura dello stato del cliente
di impact.com *Mappatura dello stato del cliente* la funzione ti consente di distinguere tra i tuoi clienti esistenti, i clienti che non hanno mai acquistato da te prima, i clienti abituali, ecc. Queste informazioni sono utili nei report quando si visualizza il tasso di acquisizione di nuovi clienti del tuo programma o il numero di acquirenti abituali. Le informazioni possono anche essere utilizzate quando si creano modifiche ai pagamenti dei partner, per incentivare i partner a generare conversioni per una specifica categoria di stato del cliente.
{% hint style="warning" %}
**Avviso:** L'attivazione di *mappatura dello stato del cliente* l'impostazione modificherà il tuo codice di tracciamento e può causare interruzioni nel tuo programma. Collabora con il tuo CSM durante il seguente processo per evitare problemi.
{% endhint %}
{% stepper %}
{% step %}
## Crea la logica di identificazione sui tuoi siti
Per impostazione predefinita, impact.com non ha alcun modo per identificare quali visitatori del tuo sito siano nuovi clienti, clienti esistenti, acquirenti abituali, ecc. Gli unici dati che impact.com riceve sono i dati di conversione dopo che avviene un acquisto. Pertanto, il tuo team deve creare la logica infrastrutturale per identificare dinamicamente i clienti che visitano il tuo negozio online e contrassegnarli con un appropriato `CustomerStatus`. Questo tag di stato verrà quindi passato a impact.com insieme ai dati di conversione, come valore in `customerStatus={-il valore dinamico-}` parametro.
Dopo aver implementato questa logica da parte tua, puoi configurare i corrispondenti valori di mappatura dello stato del cliente su impact.com.
{% endstep %}
{% step %}
## Configura i valori di mappatura su impact.com
Il *mappatura dello stato del cliente* l'opzione di attivazione è abilitata a livello di tipo di evento, quindi puoi abilitare l'impostazione per tipi di evento selezionati nel tuo programma. Tieni presente che le mappature dello stato del cliente *Nuovo* e *Esistenti* (non sensibili alle maiuscole/minuscole) dovrebbero funzionare per impostazione predefinita quando invii conversioni o modifiche ai pagamenti, anche se non attivi l'impostazione.
1. Nella barra di navigazione superiore, seleziona  **\[Profilo utente] → Impostazioni**.
2. A destra, sotto *Tracciamento*, seleziona **Tipi di evento**.
3. Accanto al tipo di evento a cui desideri aggiungere i valori di mappatura dello stato del cliente, seleziona  **\[Altro]** → **Visualizza/Modifica**.
4. In fondo, seleziona **Mostra impostazioni avanzate**.
5. Accanto a *Mappatura dello stato del cliente*, seleziona  **\[Modifica]**.
* Non vedi l' *Mappatura dello stato del cliente* impostazione? Contatta il tuo CSM o [crea un ticket di supporto](https://app.impact.com/support/portal.ihtml) per farla aggiungere al tuo account impact.com.
6. Seleziona  **\[Attiva] Aggiungi mappatura dei valori per abilitare un pagamento diverso per i nuovi clienti**.
7. Accanto agli stati dei clienti che desideri utilizzare, inserisci i valori corrispondenti a quelli usati dalla tua logica di identificazione.
8. Seleziona **Salva**.
{% endstep %}
{% step %}
## Assicurati che il parametro venga passato a impact.com
Come precauzione, devi verificare se il parametro viene passato a impact.com con i tuoi dati di conversione. Ci sono 3 report in cui puoi visualizzare i dati sullo stato del cliente per assicurarti di inviare il `customerStatus` parametro:
* Report Nuovi vs. Clienti di ritorno
Il [Report Nuovi vs. Clienti di ritorno](/brand/it/what-would-you-like-to-learn-about/platform-features/multi-program-reports/performance-reports-for-brands/new-vs-return-customer-report.md) ti mostrerà i dati sulle azioni create da *Nuovo*, *Esistenti*, e *Riattivati* clienti nell'intervallo di date scelto. Le azioni, il costo dell'azione e i ricavi generati da ciascun tipo di cliente sono aggregati dal partner che ha generato l'azione.
* Report Prestazioni per giorno per stato cliente
Il [Report Prestazioni per giorno per stato cliente](/brand/it/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 i dati presentati nei report [Nuovo cliente vs. Cliente di ritorno](/brand/it/what-would-you-like-to-learn-about/platform-features/multi-program-reports/performance-reports-for-brands/new-vs-return-customer-report.md) e [Prestazioni per giorno](/brand/it/what-would-you-like-to-learn-about/platform-features/multi-program-reports/performance-reports-for-brands/performance-by-day-report.md) report. I dati di azioni, costo dell'azione e ricavi vengono prima aggregati per giorno e poi ulteriormente analizzati per stato del cliente.
* Elenco azioni avanzato
Il [Elenco azioni avanzato](/brand/it/what-would-you-like-to-learn-about/platform-features/multi-program-reports/performance-reports-for-brands/advanced-action-listing-report.md) ti fornirà molti punti dati diversi su ogni azione generata nell'intervallo di date scelto. Per vedere quale stato del cliente (se presente) è associato alle azioni presentate in questo report, seleziona il **Mostra** filtro, seleziona la casella  **\[casella non selezionata]** **Stato del cliente** , quindi seleziona  **\[Search]**.
{% endstep %}
{% step %}
## Aggiorna i tuoi pagamenti
Dopo aver implementato correttamente la mappatura dello stato del cliente nel tuo codice di tracciamento, puoi creare partner *Adeguamenti del payout* o *Gruppi di payout*. Queste impostazioni ti consentono di modificare o integrare quanto viene pagato ai partner, in base alla categoria di stato del cliente per cui generano conversioni (ad es. pagamenti più elevati per `Nuovo` i clienti).
### Crea una modifica del pagamento
Su impact.com, puoi creare regole che modificano il pagamento per un'azione in base a condizioni molto specifiche, tra cui *Stato del cliente*. *Adeguamenti del payout* **modifica** la commissione dovuta a un partner da *Compenso predefinito* (o il *Gruppo di payout*, se pertinente) di un importo o di una percentuale.
{% hint style="success" %}
**Nota:** Per i brand che pagano ai loro partner una *Percentuale della vendita online* come commissione anziché un *Costo di collocamento*, impact.com consiglia di utilizzare *Gruppi di payout* per impostare la percentuale finale del pagamento invece di cercare di modificare la percentuale del pagamento usando *Adeguamenti del payout*.
{% endhint %}
1. Dalla barra di navigazione a sinistra, seleziona  **\[Engage]** → **Contratti →** [**Termini del template**](https://app.impact.com/secure/advertiser/engage/contracts/library/view-manage-ios-flow.ihtml).
2. Accanto ai termini del template che desideri modificare, nel *Azioni* colonna, seleziona  **\[Altro]** → **Modifica termini**.
3. Accanto a *Adeguamenti del payout*, seleziona  **\[Attiva]** **Modifica i pagamenti in base a condizioni specifiche**.
4. Configura una modifica del pagamento [*regole*](/brand/it/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/template-terms/payout-adjustments/how-payout-rules-work.md) in base a *Stato del cliente*.
* Vedi l'esempio di configurazione qui sotto in cui generare `Nuovo` clienti comporta un aumento del pagamento del 10%, ma generare `Esistenti` clienti riduce il pagamento del 50%.
5. Nella parte inferiore della schermata, seleziona **Avanti**.
6. Scegli quando inizieranno le modifiche per i contratti attivi su quel termine del template.
7. Seleziona **Avanti**.
8. Facoltativamente, aggiungi un commento per i partner che spieghi le modifiche apportate.
9. Seleziona **Salva**.
### Crea un gruppo di pagamento
Su impact.com, puoi creare gruppi per suddividere i partner in categorie di pagamento in base a regole molto specifiche, tra cui [*Gruppi di payout*](/brand/it/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/template-terms/payout-adjustments/set-payout-rules-using-payout-groups.md) per **cambiare completamente** la commissione dovuta a un partner. Di solito creeresti gruppi di pagamento quando crei un nuovo termine del template, ma puoi anche aggiungerli a termini esistenti e [sostituire i contratti in seguito](/brand/it/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/contracts/replace-a-partners-contract.md).
1. Dalla barra di navigazione a sinistra, seleziona  **\[Engage]** → **Contratti →** [**Termini del template**](https://app.impact.com/secure/advertiser/engage/contracts/library/view-manage-ios-flow.ihtml).
2. Accanto ai termini del template che desideri modificare, seleziona  **\[Altro] → Modifica termini**.
3. Accanto a *Tipo di evento*, seleziona il tipo di evento a cui si applicherà questo termine del template.
4. Accanto a *Gruppi di payout*, seleziona  **\[Attiva]** **Configura gruppi di pagamento personalizzati**.
5. Per aggiungere i gruppi di pagamento uno alla volta, seleziona **Aggiungi nuovo**.
* Dal primo  **\[Menu a discesa]**, seleziona il gruppo di pagamento [*regole*](/brand/it/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/template-terms/payout-adjustments/how-payout-rules-work.md).
* Dal secondo  **\[Menu a discesa]**, seleziona come la regola deve essere applicata al tuo gruppo di pagamento.
* Successivamente, seleziona il valore applicabile alla regola di pagamento che hai selezionato (ad es. se hai selezionato *Valuta* come regola, dovrai selezionare il tipo di valuta in cui desideri pagare i partner)
* Nel *Pagamento* sezione, seleziona la metrica di pagamento (ovvero percentuale o fissa) e il valore numerico appropriato.
* Seleziona **Aggiungi**.
6. Per creare un altro gruppo, seleziona **Aggiungi nuovo** di nuovo.
* Se aggiungi più di una regola per gruppo di pagamento, tutte le regole dovranno corrispondere affinché quel gruppo di pagamento si applichi.
* Dovresti creare un nuovo gruppo di pagamento per ciascun *Stato del cliente* che richiede un pagamento personalizzato.
7. Seleziona **Avanti**.
8. Rivedi le modifiche ai termini del template e poi seleziona **Avanti**.
9. Scegli quando le modifiche dovrebbero iniziare per i contratti attivi su quel termine del template.
10. Seleziona se i partner possono scegliere di iniziare i nuovi termini prima del *Data di inizio della modifica*.
11. Facoltativamente, aggiungi un commento per i partner che spieghi le modifiche apportate.
12. Seleziona **Salva**.
{% endstep %}
{% endstepper %}
{% hint style="success" %}
**Nota:** Se impact.com non trova un gruppo di pagamento applicabile a un'azione generata da un partner, il *Compenso predefinito* .
{% endhint %}
## Esempio pratico
Barb Dwyer genera una vendita di incudine ($100) per il tuo brand, che si traduce in un **NUOVO** cliente. Il pagamento predefinito del contratto è il 10% della vendita, il che comporterebbe una commissione di $10 per Barb Dwyer. Tuttavia, vuoi premiare i tuoi partner per aver portato clienti NUOVI al tuo brand e decidi di aumentare del 5% i pagamenti che i tuoi partner ricevono per aver portato nuovi clienti e sperimentare con *Gruppi di payout* e *Adeguamenti del payout*.
Per prima cosa, decidi di configurare un **Gruppo di payout** nel tuo contratto con un **15% dell'importo della vendita dell'articolo** pagamento (5% in più rispetto al pagamento predefinito).
Barb Dwyer riceverà ora il 15% di $100, il che si traduce in una commissione di $15.
Successivamente, disabiliti il gruppo di pagamento e provi a configurare un **Modifica del pagamento** per aumentare del 5% i pagamenti per i nuovi clienti.
Barb Dwyer riceverà ora il suo *Compenso predefinito* del 10% ($10) più un ulteriore 5% sulla commissione ricevuta. $10 + 5% = commissione ricevuta di $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/it/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.
