> 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* Questa funzionalità 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 dei 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 particolare categoria di stato del cliente.
{% hint style="warning" %}
**Attenzione:** Abilitare la *mappatura dello stato del cliente* impostazione modificherà il tuo codice di tracciamento e può causare interruzioni nel tuo programma. Lavora con il tuo CSM durante il processo seguente per evitare problemi.
{% endhint %}
#### Configura la mappatura dello stato del cliente
{% stepper %}
{% step %}
**Passaggio 1: crea la logica di identificazione sui tuoi siti**
Per impostazione predefinita, impact.com non dispone di alcun modo per identificare quali visitatori del tuo sito siano nuovi clienti, clienti esistenti, acquirenti abituali, ecc. I soli dati che impact.com riceve sono i dati di conversione dopo l'avvenuto acquisto. Pertanto, il tuo team deve creare la logica infrastrutturale per identificare dinamicamente i clienti che visitano il tuo negozio online e assegnare loro un appropriato `CustomerStatus`. Questo tag di stato verrà quindi trasmesso 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 valori corrispondenti della mappatura dello stato del cliente su impact.com.
{% endstep %}
{% step %}
**Passaggio 2: configura i valori di mappatura su impact.com**
Il *mappatura dello stato del cliente* l'interruttore è attivato a livello di tipo di evento, quindi puoi abilitare l'impostazione per tipi di evento selezionati nel tuo programma. Nota che le mappature dello stato del cliente *Nuovo* e *Esistente* (senza distinzione tra maiuscole e minuscole) dovrebbe funzionare per impostazione predefinita quando invii conversioni o modifiche ai pagamenti, anche se non attivi l'impostazione.
1. Dalla 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 vuoi aggiungere i 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' *Mappatura dello stato del cliente* impostazione? Contatta il tuo CSM oppure [apri un ticket di supporto](https://app.impact.com/support/portal.ihtml) per aggiungerla 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 del cliente che vuoi utilizzare, inserisci i valori corrispondenti a quelli utilizzati dalla tua logica di identificazione.
8. Seleziona **Salva**.
{% endstep %}
{% step %}
**Passaggio 3: assicurati che il parametro venga passato a impact.com**
Per precauzione, devi testare se il parametro viene passato 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 passare 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 nell'intervallo di date scelto. Le azioni, il costo dell'azione e i ricavi generati da ciascun tipo di cliente sono aggregati in base al partner che ha generato l'azione.
* Report delle prestazioni per giorno per stato del cliente
Il [Report delle 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 [Nuovo 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 relativi ad azioni, costo dell'azione e ricavi vengono prima aggregati per giorno e poi ulteriormente analizzati per stato del cliente.
* Advanced Action Listing
Il [Advanced Action Listing](/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 deselezionata]** **Stato cliente** casella, quindi seleziona  **\[Cerca]**.
{% endstep %}
{% step %}
**Passaggio 4: aggiorna i tuoi pagamenti**
Dopo aver implementato con successo la mappatura dello stato del cliente nel tuo codice di tracciamento, puoi creare partner *Adeguamenti del pagamento* o *Gruppi di payout*. Queste impostazioni ti consentono di modificare o aggiungere a quanto viene pagato ai partner, in base alla categoria di stato del cliente per la quale generano la conversione (ad es., pagamenti più alti per `Nuovo` 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, inclusi *Stato cliente*. *Adeguamenti del pagamento* **modifica** la commissione dovuta a un partner da *Payout predefinito* (o il *Gruppo di payout*, se pertinente) di un importo o di una percentuale.
{% hint style="info" %}
**Nota:** Per i brand che pagano ai propri partner una *Percentuale della vendita online* come commissione anziché una *Tariffa di posizionamento*, impact.com consiglia di utilizzare *Gruppi di payout* per impostare la percentuale finale del pagamento invece di provare ad adeguare la percentuale del pagamento usando *Adeguamenti del pagamento*.
{% endhint %}
1. Dal menu di navigazione a sinistra, seleziona  **\[Engage]** → **Contratti → Termini del modello**.
2. Accanto ai termini del modello che vuoi modificare, nella *Azioni* colonna, seleziona  **\[Altro]** → **Modifica termini**.
3. Accanto a *Adeguamenti del pagamento*, seleziona  **\[Attiva]** **Modifica i pagamenti in base a condizioni specifiche**.
4. Imposta una modifica del pagamento in base a *Stato cliente*.
* Vedi l'immagine qui sotto per un esempio di configurazione in cui generare `Nuovo` clienti comporta un aumento del pagamento del 10%, ma generare `Esistente` clienti riduce il pagamento 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 pagamento**
Su impact.com, puoi creare gruppi per classificare i partner in categorie di pagamento in base a regole molto specifiche, inclusi *Gruppi di payout* **cambia completamente** la commissione dovuta a un partner. I gruppi di pagamento vengono solitamente creati quando crei un nuovo termine del modello, ma puoi anche aggiungerli a termini esistenti e sostituire i contratti in un secondo momento.
1. Dal menu di navigazione a sinistra, seleziona  **\[Engage]** → **Contratti → Termini del modello**.
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 payout*, seleziona  **\[Attiva]** **Configura gruppi di pagamenti personalizzati**.
5. Per aggiungere i gruppi di pagamento uno alla volta, seleziona **Aggiungi nuovo**.
* Dal primo  **\[Menu a discesa]**, seleziona gruppo di pagamento *Regole* .
* Dal secondo  **\[Menu a discesa]**, seleziona come la regola deve applicarsi al tuo gruppo di pagamento.
* Quindi, 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)
* Nella *Pagamento* sezione, seleziona la metrica di pagamento (vale a dire, 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 venga applicato.
* Dovresti creare un nuovo gruppo di pagamento per ogni *Stato cliente* che richiede un pagamento personalizzato.
7. Seleziona **Avanti**.
8. Rivedi le modifiche ai termini del 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 del *Data di inizio della modifica*.
11. Facoltativamente, aggiungi un commento per i partner che spieghi le modifiche apportate.
12. Seleziona **Salva**.
{% hint style="info" %}
**Nota:** Se impact.com non trova un gruppo di pagamento applicabile a un'azione generata da un partner, il *Payout predefinito* verrà applicato.
{% endhint %}
{% hint style="info" %}
**Esempio:** Barb Dwyer genera una vendita di un'incudine ($100) per il tuo brand, il 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 generato clienti NUOVI per il 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 pagamento*.
Per prima cosa, decidi di configurare un **Gruppo di payout** nel tuo contratto con un **pagamento del 15% dell'importo della vendita dell'articolo** (5% in più rispetto al pagamento predefinito).
Barb Dwyer riceverà ora il 15% di $100, il che si traduce in una commissione di $15.
Poi disattivi il gruppo di pagamento e provi a configurare una **Modifica del pagamento** per aumentare i pagamenti per i nuovi clienti del 5%.
Barb Dwyer riceverà ora il suo *Payout predefinito* del 10% ($10) più un ulteriore 5% sulla commissione ricevuta. $10 + 5% = $10,50 di commissione ricevuta.
{% 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/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.