# Configura la mappatura dello stato del cliente

di impact.com *Mappatura dello stato del cliente* La funzionalità 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 quando si creano modifiche al pagamento dei partner, per incentivare i partner a generare conversioni per una particolare categoria di stato del cliente.

{% hint style="warning" %}
**Avvertenza:** L'abilitazione della *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 qualsiasi პრობლემა.
{% endhint %}

#### Configura la mappatura dello stato del cliente

{% stepper %}
{% step %}
**Passaggio 1: crea la logica di identità sui tuoi siti**

Per impostazione predefinita, impact.com non ha alcun modo per identificare quali visitatori del tuo sito sono 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 nel parametro `customerStatus={-il valore dinamico-}` .

Dopo aver implementato questa logica da parte tua, puoi configurare i corrispondenti valori 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 tipi di evento selezionati nel tuo programma. Nota che le mappature dello stato del cliente *Nuovo* e *Esistente* (non sensibile alle maiuscole/minuscole) dovrebbero funzionare per impostazione predefinita quando invii conversioni o modifiche ai pagamenti, anche se non attivi l'impostazione.

1. Dalla barra di navigazione superiore, seleziona ![](/files/a0314b1a64ec39500a614699810af2308cfe8328) **\[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 ![](/files/6a36670a9e3518128f7130049c54b7a9613f756b) **\[Altro]** → **Visualizza/Modifica**.
4. In basso, seleziona **Mostra impostazioni avanzate**.
5. Accanto a *Mappatura dello stato del cliente*, seleziona ![](/files/c0595da7b8c66cee09fe06f279139a547d17fe1d) **\[Modifica]**.
   * Non vedi l'impostazione *Mappatura dello stato del cliente* ? Rivolgiti al tuo CSM oppure [apri un ticket di supporto](https://app.impact.com/support/portal.ihtml) per aggiungerla al tuo account impact.com.
6. Seleziona ![](/files/bcb6da087265fb9beef85997a54e50203691b8d1) **\[Attiva] Aggiungi mappatura dei valori per abilitare un payout diverso per i nuovi clienti**.
7. Accanto agli stati del cliente che vuoi usare, 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**

Per precauzione, devi verificare se il parametro viene passato a impact.com insieme ai dati di conversione. Ci sono 3 report in cui puoi visualizzare i dati sullo stato del cliente come modo per assicurarti di inviare il parametro `customerStatus` :

* Report Nuovi vs. Clienti di ritorno

  Il [Report Nuovi vs. Clienti di ritorno](/brand/it/che-cosa-vorresti-imparare/platform-features/multi-program-reports/performance-reports-for-brands/new-vs-return-customer-report.md) mostrerà dati sulle azioni create da *Nuovo*, *Esistente*, e *Riconquistati* clienti nell'intervallo di date scelto. Le azioni, il costo delle azioni e le entrate generate da ciascun tipo di cliente sono 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/che-cosa-vorresti-imparare/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/che-cosa-vorresti-imparare/platform-features/multi-program-reports/performance-reports-for-brands/new-vs-return-customer-report.md) e [Prestazioni per giorno](/brand/it/che-cosa-vorresti-imparare/platform-features/multi-program-reports/performance-reports-for-brands/performance-by-day-report.md) . I dati di azione, costo dell'azione e ricavi vengono prima aggregati per giorno e poi ulteriormente analizzati per stato del cliente.
* Elenco avanzato delle azioni

  Il [Elenco avanzato delle azioni](/brand/it/che-cosa-vorresti-imparare/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 filtro **Mostra** , seleziona la casella ![](/files/cec8fb6b06bdba97a0f302d45d30862de79a5365) **\[Casella di controllo non selezionata]** **Stato del cliente** e poi seleziona ![](/files/13b49e9a391d6254326d85aca92c7d67c2b2bceb) **\[Cerca]**.
  {% endstep %}

{% step %}
**Passaggio 4: aggiorna i tuoi payout**

Dopo aver implementato correttamente la mappatura dello stato del cliente nel tuo codice di tracciamento, puoi creare *Modifiche al payout* 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 conversioni (ad es. payout più alti per `Nuovo` clienti).

**Crea una modifica al payout**

Su impact.com, puoi creare regole che modificano il payout per un'azione in base a condizioni molto specifiche, inclusa *Stato del cliente*. *Modifiche al payout* **modifica** la commissione dovuta a un partner dal *Payout predefinito* (o dal *Gruppo di payout*, se pertinente) di un importo o di una percentuale.

{% hint style="info" %}
**Nota:** Per i brand che pagano i propri partner con una *Percentuale della vendita online* come commissione invece di una *Tariffa di collocamento*, impact.com consiglia di usare *Gruppi di payout* per impostare la percentuale finale di payout invece di provare a modificare la percentuale di payout usando *Modifiche al payout*.
{% endhint %}

1. Dalla barra di navigazione a sinistra, seleziona ![](/files/56eb48c7f3195590132b62ea75c0575abe0113e5) **\[Engage]** → **Contratti → Termini del modello**.
2. Accanto ai termini del modello che vuoi modificare, nella colonna *Azioni* , seleziona ![](/files/6a36670a9e3518128f7130049c54b7a9613f756b) **\[Altro]** → **Modifica termini**.
3. Accanto a *Modifiche al payout*, seleziona ![](/files/bcb6da087265fb9beef85997a54e50203691b8d1) **\[Attiva]** **Modifica i payout in base a condizioni specifiche**.
4. Imposta una modifica del payout in base a *Stato del cliente*.
   * Consulta l'immagine qui sotto per un esempio di configurazione in cui la generazione di `Nuovo` clienti `Esistente` comporta un aumento del payout del 10%, mentre la generazione di
5. In fondo allo schermo, seleziona **Avanti**.
6. clienti riduce il payout del 50%.
7. Seleziona **Avanti**.
8. Scegli quando le modifiche inizieranno per i contratti attivi su quel termine del modello.
9. Seleziona **Salva**.

**Facoltativamente, aggiungi un commento per i partner che spieghi le modifiche apportate.**

Crea un gruppo di payout *Gruppi di payout* **modificare completamente** la commissione dovuta a un partner. I gruppi di payout vengono in genere creati quando crei un nuovo termine del modello, ma puoi anche aggiungerli ai termini esistenti e sostituire i contratti in un secondo momento.

1. Dalla barra di navigazione a sinistra, seleziona ![](/files/56eb48c7f3195590132b62ea75c0575abe0113e5) **\[Engage]** → **Contratti → Termini del modello**.
2. Accanto ai termini del modello che vuoi modificare, seleziona ![](/files/6a36670a9e3518128f7130049c54b7a9613f756b) **\[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 ![](/files/bcb6da087265fb9beef85997a54e50203691b8d1) **\[Attiva]** **Imposta gruppi di payout personalizzati**.
5. Per aggiungere i gruppi di payout uno alla volta, seleziona **Aggiungi nuovo**.
   * Dal primo ![](/files/a474859b52eb0cf0ee293759ee5542cfc1ffd5f8) **\[menu a discesa]**, seleziona il gruppo di payout *Regole* .
   * Dal secondo ![](/files/a474859b52eb0cf0ee293759ee5542cfc1ffd5f8) **\[menu a discesa]**, seleziona come la regola deve applicarsi al tuo gruppo di payout.
   * Successivamente, seleziona il valore applicabile alla regola di payout che hai scelto (ad es. se hai selezionato *Valuta* come regola, dovrai selezionare il tipo di valuta in cui vuoi pagare i partner)
   * Nella *Pagamento* sezione, seleziona la metrica di payout (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 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. Scegli quando le modifiche inizieranno per i contratti attivi su quel termine del modello.
12. Seleziona **Salva**.

{% hint style="info" %}
**Nota:** Se impact.com non trova un gruppo di payout applicabile a un'azione generata da un partner, verrà applicato il *Payout predefinito* .
{% endhint %}

{% hint style="info" %}
**Esempio:** Barb Dwyer genera una vendita di un'incudine ($100) per il tuo brand, il che comporta un **NUOVO** cliente. Il payout predefinito del contratto è il 10% della vendita, il che si tradurrebbe in 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 l'acquisizione di nuovi clienti e sperimentare con *Gruppi di payout* e *Modifiche al 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).

<img src="/files/7d5c119823a9e842ce8189b3a1650f86f96cac48" alt="" data-size="original">

Barb Dwyer riceverà ora il 15% di $100, il che si traduce in una commissione di $15.

Successivamente, disattivi il gruppo di payout e provi a impostare una **Modifica del payout** per aumentare i payout per i nuovi clienti del 5%.

<img src="/files/3031bec06202170d79751d0db498710c4073f19f" alt="" data-size="original">

Barb Dwyer riceverà ora il suo *Payout predefinito* del 10% ($10) più un ulteriore 5% sulla commissione ricevuta. $10 + 5% = commissione ricevuta di $10.50.
{% endhint %}
{% endstep %}
{% endstepper %}


---

# Agent Instructions: 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:

```
GET https://help.impact.com/brand/it/che-cosa-vorresti-imparare/platform-features/tracking/set-up-tracking/configure-customer-status-mapping.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
