> 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 il mapping dello stato del cliente
di impact.com *Mappatura dello stato del cliente* La funzione consente di distinguere tra i 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 durante la creazione di modifiche ai pagamenti dei partner, per incentivare i partner a generare conversioni per una particolare categoria di stato del cliente.
{% hint style="warning" %}
**Avvertenza:** Abilitando il *mappatura dello stato del cliente* impostazione modificherà il tuo codice di tracciamento e può causare interruzioni nel tuo programma. Collabora con il tuo CSM durante il processo seguente per evitare problemi.
{% endhint %}
{% stepper %}
{% step %}
## Crea una logica di identità sui tuoi siti
Per impostazione predefinita, impact.com non ha alcun modo di identificare quali visitatori del tuo sito siano nuovi clienti, clienti esistenti, acquirenti abituali, ecc. L'unico dato 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 taggarli con un appropriato `CustomerStatus`. Questo tag di stato verrà poi trasmesso a impact.com insieme ai dati di conversione, come valore nel `customerStatus={-il valore dinamico-}` parametro.
Dopo aver implementato questa logica dal tuo lato, 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* interruttore è abilitato a livello di tipo di evento, quindi puoi abilitare l'impostazione per i tipi di evento selezionati nel tuo programma. Nota che le mappature dello stato del cliente *Nuovo* e *Esistente* (non sensibili alle maiuscole/minuscole) dovrebbero funzionare per impostazione predefinita quando invii conversioni o modifiche ai payout, anche se non attivi l'impostazione.
1. Dalla barra di navigazione in alto, seleziona  **\[Profilo utente] → Impostazioni**.
2. A destra, sotto *Tracciamento*, seleziona **Tipi di evento**.
3. Accanto al tipo di evento a cui vuoi aggiungere valori di mappatura dello stato del cliente, seleziona  **\[Altro]** → **Visualizza/Modifica**.
4. In basso, seleziona **Mostra impostazioni avanzate**.
5. Accanto a *Mappatura dello stato del cliente*, seleziona  **\[Modifica]**.
* Non vedi l'impostazione *Mappatura dello stato del cliente* ? Rivolgiti al tuo CSM oppure [crea un ticket di assistenza](https://app.impact.com/support/portal.ihtml) per aggiungerla al tuo account impact.com.
6. Seleziona  **\[Attiva] Aggiungi la mappatura dei valori per abilitare un payout diverso per i nuovi clienti**.
7. Accanto agli stati dei clienti che desideri usare, inserisci i valori corrispondenti a quelli usati dalla tua logica di identità.
8. Seleziona **Salva**.
{% endstep %}
{% step %}
## Assicurati che il parametro venga trasmesso a impact.com
Come precauzione, devi verificare se il parametro viene trasmesso a impact.com con i dati di conversione. Ci sono 3 report in cui puoi visualizzare i dati sullo stato del cliente come modo per assicurarti di trasmettere 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*, *Esistente*, e *Riattivati* clienti durante l'intervallo di date scelto. Le azioni, il costo delle azioni e il fatturato creati da ciascun tipo di cliente vengono aggregati per il partner che ha generato l'azione.
* Report Prestazioni per giorno per stato del cliente
Il [Report Prestazioni per giorno per stato del 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 [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) 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) . I dati di azioni, costo delle azioni e fatturato 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** e poi seleziona  **\[Cerca]**.
{% endstep %}
{% step %}
## Aggiorna i tuoi payout
Dopo aver implementato correttamente la mappatura dello stato del cliente nel tuo codice di tracciamento, puoi creare i partner *Rettifiche del payout* o *Gruppi di pagamento*. Queste impostazioni ti consentono di modificare o aggiungere ciò che viene pagato ai partner, in base alla categoria di stato del cliente per la quale generano conversioni (ad esempio, payout più alti per `Nuovo` clienti).
### Crea una modifica del payout
Su impact.com, puoi creare regole che modificano il payout per un'azione in base a condizioni molto specifiche, tra cui *Stato del cliente*. *Rettifiche del payout* **modificare** la commissione dovuta a un partner dal *Payout predefinito* (o il *Gruppo di payout*, quando rilevante) di un importo o di una percentuale.
{% hint style="success" %}
**Nota:** Per i brand che pagano i propri partner una *Percentuale della vendita online* come commissione anziché una *Tariffa di placement*, impact.com consiglia di usare *Gruppi di pagamento* per impostare la percentuale finale del payout invece di cercare di modificare la percentuale del payout usando *Rettifiche del payout*.
{% endhint %}
1. Dalla barra di navigazione a sinistra, seleziona  **\[Engage]** → **Contratti →** [**Termini del modello**](https://app.impact.com/secure/advertiser/engage/contracts/library/view-manage-ios-flow.ihtml).
2. Accanto ai termini del modello che vuoi modificare, nella *Azioni* colonna, seleziona  **\[Altro]** → **Modifica i termini**.
3. Accanto a *Rettifiche del payout*, seleziona  **\[Attiva]** **Regola i payout in base a condizioni specifiche**.
4. Imposta una modifica del payout [*regole*](/brand/it/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/template-terms/payout-adjustments/come-funzionano-le-regole-di-pagamento.md) in base a *Stato del cliente*.
* Vedi la configurazione di esempio qui sotto in cui generare `Nuovo` clienti comporta un aumento del payout del 10%, mentre generare `Esistente` clienti abbassa il payout del 50%.
5. In fondo allo schermo, seleziona **Avanti**.
6. Scegli quando le modifiche inizieranno per i contratti attivi su quel termine del modello.
7. Seleziona **Avanti**.
8. Facoltativamente, aggiungi un commento per i partner che spieghi le modifiche apportate.
9. Seleziona **Salva**.
### Crea un gruppo di payout
Su impact.com, puoi creare gruppi per ordinare i partner in categorie di payout in base a regole molto specifiche, tra cui [*Gruppi di pagamento*](/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. In genere creeresti gruppi di payout quando crei un nuovo termine del modello, ma puoi anche aggiungerli ai 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 modello**](https://app.impact.com/secure/advertiser/engage/contracts/library/view-manage-ios-flow.ihtml).
2. Accanto ai termini del modello che vuoi modificare, seleziona  **\[Altro] → Modifica termini**.
3. Accanto a *Tipo di evento*, seleziona il tipo di evento a cui si applicherà questo termine del modello.
4. Accanto a *Gruppi di pagamento*, seleziona  **\[Attiva]** **Configura gruppi di pagamento personalizzati**.
5. Per aggiungere i gruppi di payout uno alla volta, seleziona **Aggiungi nuovo**.
* Dal primo  **\[menu a discesa]**, seleziona il gruppo di payout [*regole*](/brand/it/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/template-terms/payout-adjustments/come-funzionano-le-regole-di-pagamento.md).
* Dal secondo  **\[menu a discesa]**, seleziona come la regola deve applicarsi al tuo gruppo di payout.
* Quindi, seleziona il valore applicabile alla regola di payout che hai selezionato (ad es. se hai selezionato *Valuta* come regola, dovrai selezionare il tipo di valuta in cui desideri pagare i partner)
* Nella *importo del pagamento* sezione, seleziona la metrica di payout (ossia 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 payout, tutte le regole dovranno corrispondere affinché quel gruppo di payout si applichi.
* Dovresti creare un nuovo gruppo di payout per ogni *Stato del cliente* che richiede un payout personalizzato.
7. Seleziona **Avanti**.
8. Rivedi le modifiche ai termini del tuo modello e poi seleziona **Avanti**.
9. Scegli quando le modifiche dovrebbero iniziare per i contratti attivi su quel termine del modello.
10. Seleziona se i partner possono scegliere di iniziare i nuovi termini prima della *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 payout applicabile a un'azione generata da un partner, il *Payout predefinito* si applicherà.
{% endhint %}
## Esempio pratico
Barb Dwyer genera una vendita di un'incudine ($100) per il tuo brand che comporta un **NUOVO** cliente. Il payout 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 NUOVI clienti al tuo brand e decidi di aumentare del 5% i payout che i tuoi partner ricevono per aver portato nuovi clienti e sperimentare con *Gruppi di pagamento* e *Rettifiche del payout*.
Per prima cosa, decidi di impostare un **Gruppo di payout** nel tuo contratto con un **payout del 15% dell'importo della vendita dell'articolo** (5% in più rispetto al payout predefinito).
Barb Dwyer riceverà ora il 15% di $100, il che comporta una commissione di $15.
Quindi, disattivi il gruppo di payout e provi a impostare un **Rettifica del payout** per aumentare del 5% i payout per i nuovi clienti.
Barb Dwyer riceverà ora il suo *Payout predefinito* del 10% ($10) più un 5% aggiuntivo 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 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/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 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.
