> 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 funzionalità ti consente di distinguere tra i tuoi clienti esistenti, clienti che non hanno mai acquistato da te in precedenza, clienti abituali, ecc. Queste informazioni sono utili nei report quando visualizzi il tasso di acquisizione di nuovi clienti del tuo programma o il numero di acquirenti abituali. Le informazioni possono anche essere utilizzate quando crei modifiche ai pagamenti dei partner, per incentivare i partner a generare conversioni per una particolare categoria di stato del cliente.
{% hint style="warning" %}
**Avvertenza:** Abilitare 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 seguente processo per evitare problemi.
{% endhint %}
#### Configura la mappatura dello stato del cliente
{% stepper %}
{% step %}
**Passaggio 1: crea la logica di identità nei 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 taggarli con un'appropriata `CustomerStatus`. Questo tag di stato verrà quindi passato a impact.com insieme ai dati di conversione, come valore nel `customerStatus={-the dynamic value-}` parametro.
Dopo aver implementato questa logica dal tuo lato, puoi configurare i valori corrispondenti di 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 è abilitato a livello di tipo di evento, quindi puoi abilitare l'impostazione per i tipi di evento selezionati nel tuo programma. Tieni presente che le mappature dello stato del cliente *Nuovo* e *Esistente* (non sensibile alle maiuscole/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 o [apri 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 del cliente che vuoi utilizzare, inserisci i valori corrispondenti a quelli utilizzati dalla tua logica di identità.
8. Seleziona **Salva**.
{% endstep %}
{% step %}
**Passaggio 3: assicurati che il parametro venga passato a impact.com**
Come precauzione, devi testare se il parametro viene passato a impact.com con i dati di conversione. Esistono 3 report in cui puoi visualizzare i dati sullo stato del cliente come modo per assicurarti di passare il `customerStatus` parametro:
* Report clienti nuovi vs. clienti di ritorno
Il [Report clienti 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 *Riattivato* clienti nell'intervallo di date scelto. Le azioni, il costo dell'azione e il fatturato generati da ciascun tipo di cliente sono aggregati in base al partner che ha generato l'azione.
* Report delle performance giornaliere per stato del cliente
Il [Report delle performance giornaliere 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 [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) report. I dati di azione, costo dell'azione e fatturato vengono prima aggregati per giorno e poi ulteriormente suddivisi per stato del cliente.
* Elenco avanzato delle azioni
Il [Elenco avanzato delle azioni](/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 non selezionata]** **Stato del cliente** casella, quindi seleziona  **\[Cerca]**.
{% endstep %}
{% step %}
**Passaggio 4: aggiorna i tuoi pagamenti**
Dopo aver implementato correttamente la mappatura dello stato del cliente nel tuo codice di tracciamento, puoi creare i *Adeguamenti del compenso* o *Gruppi di compenso*. Queste impostazioni ti consentono di modificare o aggiungere a ciò che viene pagato ai partner, in base alla categoria di stato del cliente per cui generano conversioni (ad es. pagamenti più elevati per i `Nuovo` clienti).
**Crea un adeguamento del pagamento**
Su impact.com, puoi creare regole che regolano il pagamento per un'azione in base a condizioni molto specifiche, tra cui *Stato del cliente*. *Adeguamenti del compenso* **regola** la commissione dovuta a un partner da *Compenso predefinito* (o la *Gruppo di compenso*, se pertinente) di un importo o di una percentuale.
{% hint style="info" %}
**Nota:** Per i brand che pagano i propri partner una *Percentuale della vendita online* come commissione anziché una *Tariffa di posizionamento*, impact.com consiglia di utilizzare *Gruppi di compenso* per impostare la percentuale finale del pagamento anziché cercare di regolare la percentuale del pagamento usando *Adeguamenti del compenso*.
{% endhint %}
1. Dalla barra di navigazione a sinistra, seleziona  **\[Interagisci]** → **Contratti → Termini del modello**.
2. Accanto ai termini del modello che vuoi modificare, nel *Azioni* colonna, seleziona  **\[Altro]** → **Modifica termini**.
3. Accanto a *Adeguamenti del compenso*, seleziona  **\[Attiva]** **Regola i pagamenti in base a condizioni specifiche**.
4. Imposta una modifica del pagamento basata su *Stato del cliente*.
* Guarda 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 alla schermata, 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 ordinare i partner in categorie di pagamento in base a regole molto specifiche, tra cui *Gruppi di compenso* **cambiare 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 ai termini esistenti e sostituire in seguito i contratti.
1. Dalla barra di navigazione a sinistra, seleziona  **\[Interagisci]** → **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 compenso*, seleziona  **\[Attiva]** **Configura gruppi di pagamento personalizzati**.
5. Per aggiungere gruppi di pagamento uno alla volta, seleziona **Aggiungi nuovo**.
* Dal primo  **\[Menu a discesa]**, seleziona il gruppo di pagamento *Regole* .
* Dal secondo  **\[Menu a discesa]**, seleziona come la regola dovrebbe applicarsi 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 vuoi pagare i partner)
* Nel *Pagamento* sezione, seleziona la metrica di pagamento (cioè 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 ogni *Stato del cliente* che richiede un pagamento 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 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 *Compenso predefinito* verrà applicato.
{% endhint %}
{% hint style="info" %}
**Esempio:** Barb Dwyer genera una vendita di incudini ($100) per il tuo brand, il che comporta 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 i pagamenti che i tuoi partner ricevono per l'acquisizione di nuovi clienti del 5% e sperimentare con *Gruppi di compenso* e *Adeguamenti del compenso*.
Per prima cosa, decidi di impostare un **Gruppo di compenso** 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 comporta una commissione di $15.
Successivamente, disattivi il gruppo di pagamento e provi a impostare una **Adeguamento del pagamento** per aumentare i pagamenti per i nuovi clienti del 5%.
Barb Dwyer riceverà ora il suo *Compenso 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.