> 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* ti consente di distinguere tra i clienti esistenti, quelli che non hanno mai acquistato da te, i clienti abituali e così via. Queste informazioni sono utili nei report per consultare il tasso di acquisizione di nuovi clienti del tuo programma o il numero di acquirenti abituali. Puoi inoltre utilizzare queste informazioni per creare modifiche ai compensi dei partner e incentivare i partner a generare conversioni per una determinata categoria di stato del cliente.

{% hint style="warning" %}
**Attenzione:** L'attivazione dell'impostazione *di mappatura dello stato del cliente* modificherà il codice di tracciamento e potrebbe causare interruzioni nel tuo programma. Collabora con il tuo CSM durante il processo descritto di seguito per evitare problemi.
{% endhint %}

{% stepper %}
{% step %}

## Crea la logica di identificazione sui tuoi siti

Per impostazione predefinita, impact.com non dispone di un metodo per identificare quali visitatori del tuo sito siano nuovi clienti, clienti esistenti, acquirenti abituali e così via. impact.com riceve soltanto i dati sulle conversioni dopo che è stato effettuato un acquisto. Il tuo team deve quindi creare la logica infrastrutturale necessaria per identificare dinamicamente i clienti che visitano il tuo negozio online e assegnare loro un valore appropriato `CustomerStatus`. Questo tag di stato verrà quindi trasmesso a impact.com insieme ai dati di conversione, come valore del parametro `customerStatus={-the dynamic value-}` .

Dopo aver implementato questa logica, puoi configurare i valori di mappatura dello stato del cliente corrispondenti su impact.com.
{% endstep %}

{% step %}

## Configura i valori di mappatura su impact.com

L'interruttore *di mappatura dello stato del cliente* si trova a livello del tipo di evento, quindi puoi attivare l'impostazione per i tipi di evento selezionati nel tuo programma. Nota che le mappature dello stato del cliente *New* e *Existing* (senza distinzione tra maiuscole e minuscole) dovrebbero funzionare per impostazione predefinita quando invii conversioni o modifiche ai compensi, anche se non attivi l'impostazione.

1. Nella barra di navigazione superiore, seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F210dEQa93qyQgoJDkieL%2FUser%20profile.svg?alt=media\&token=f84c5b17-fae4-4a30-990a-9de5e57a150b) **\[Profilo utente] → Impostazioni**.
2. A destra, in *Monitoraggio*, seleziona **Tipi di evento**.
3. Accanto al tipo di evento a cui vuoi aggiungere i valori di mappatura dello stato del cliente, seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FMLtRUwWz0pujlfmYWOgg%2FMoreVN.svg?alt=media\&token=03a3c355-a347-4207-baf7-c44fadf6d080) **\[Altro]** → **Visualizza/Modifica**.
4. In fondo, seleziona **Mostra impostazioni avanzate**.
5. Accanto a *Mappatura dello stato del cliente*, seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fkka3dqJOx8ZhiX82RDLt%2FEdit_light.svg?alt=media\&token=f454405c-ebd8-49af-90db-22efc27476bf) **\[Modifica]**.
   * Non trovi l'impostazione *Mappatura dello stato del cliente* ? Contatta il tuo CSM oppure [crea una richiesta di assistenza](https://app.impact.com/support/portal.ihtml) per aggiungerla al tuo account impact.com.
6. Seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FiZjM1xY8o3v1iR3Zaysd%2FToggle.svg?alt=media\&token=b1550d48-bba9-4e81-8604-bc12370c5caa) **\[Attiva] Aggiungi la mappatura dei valori per applicare compensi diversi ai nuovi clienti**.
7. Accanto agli stati del cliente che vuoi utilizzare, inserisci i valori corrispondenti a quelli usati dalla tua logica di identificazione.
8. Seleziona **Salva**.
   {% endstep %}

{% step %}

## Assicurati che il parametro venga trasmesso a impact.com

Per precauzione, verifica che il parametro venga trasmesso a impact.com insieme ai dati di conversione. Puoi consultare i dati sullo stato del cliente in 3 report per assicurarti di trasmettere il parametro `customerStatus` :

* Report Nuovi clienti e clienti di ritorno

  Il [Report Nuovi clienti e clienti di ritorno](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/platform-features/multi-program-reports/performance-reports-for-brands/new-vs-return-customer-report.md) mostra i dati sulle azioni generate da *Nuovi*, *Esistenti* e *Riattivati* clienti nell'intero intervallo di date selezionato. Le azioni, il costo delle azioni e i ricavi generati da ciascun tipo di cliente vengono aggregati in base al partner che ha generato l'azione.
* Report sul rendimento giornaliero per stato del cliente

  Il [Report sul rendimento giornaliero per stato del cliente](https://help.impact.com/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 clienti e clienti di ritorno](https://help.impact.com/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 [Rendimento giornaliero](https://help.impact.com/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 relativi alle azioni, al costo delle azioni e ai ricavi vengono prima aggregati per giorno e poi suddivisi ulteriormente in base allo stato del cliente.
* Elenco avanzato delle azioni

  La [Elenco avanzato delle azioni](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/platform-features/multi-program-reports/performance-reports-for-brands/advanced-action-listing-report.md) ti fornisce molti dati diversi su ogni azione generata nell'intervallo di date selezionato. Per visualizzare lo stato del cliente (se presente) associato alle azioni mostrate in questo report, seleziona il filtro **Mostra** , seleziona la casella ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-b5e1740618ed6571d97b8fed7c25a7678f85d375%2F299632fb6f4f91fbf9847471754cc6180e4284a65b4960af4c4ea472a159f552.svg?alt=media) **\[Casella non selezionata]** **Stato del cliente** e poi seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-26956d35e17c61868ca8dba76097721fd6066ab4%2F69945c787eb2db89761c82e0cd32fb31d2fc690bfb8592d9a08b7e7983b7445b.svg?alt=media) **\[Cerca]**.
  {% endstep %}

{% step %}

## Aggiorna i tuoi pagamenti

Dopo aver implementato correttamente la mappatura dello stato del cliente nel codice di tracciamento, puoi creare *modifiche ai pagamenti* o *gruppi di pagamento*. Queste impostazioni ti consentono di modificare o integrare i pagamenti ai partner in base alla categoria di stato del cliente per cui generano conversioni (ad es. pagamenti più elevati per i clienti `New` ).

### Crea una modifica al pagamento

Su impact.com puoi creare regole che modificano il pagamento di un'azione in base a condizioni molto specifiche, tra cui *Stato del cliente*. *Le modifiche ai pagamenti* **modificano** la commissione dovuta a un partner in base al *pagamento predefinito* (o al *gruppo di pagamento*, se pertinente) di un importo o di una percentuale.

{% hint style="success" %}
**Nota:** Per i brand che pagano i partner con una *percentuale della vendita online* come commissione anziché con una *commissione di posizionamento*, impact.com consiglia di usare i *gruppi di pagamento* per impostare la percentuale di pagamento finale, invece di provare a modificare la percentuale di pagamento usando le *modifiche ai pagamenti*.
{% endhint %}

1. Nella barra di navigazione a sinistra, seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[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 colonna *Azioni* , seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FMLtRUwWz0pujlfmYWOgg%2FMoreVN.svg?alt=media\&token=03a3c355-a347-4207-baf7-c44fadf6d080) **\[Altro]** → **Modifica termini**.
3. Accanto a *Adeguamenti dei pagamenti*, seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FiZjM1xY8o3v1iR3Zaysd%2FToggle.svg?alt=media\&token=b1550d48-bba9-4e81-8604-bc12370c5caa) **\[Attiva]** **Adegua i pagamenti in base a condizioni specifiche**.
4. Configura una regola di adeguamento dei pagamenti [*regole*](https://help.impact.com/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*.
   * Ecco un esempio di configurazione in cui indirizzare i clienti `New` comporta un aumento del pagamento del 10%, mentre indirizzare i clienti `Existing` riduce il pagamento del 50%.
5. Nella parte inferiore dello schermo, seleziona **Avanti**.
6. Scegli quando entreranno in vigore le modifiche per i contratti attivi associati a quel termine del modello.
7. Seleziona **Avanti**.
8. Facoltativamente, aggiungi un commento per i partner per spiegare 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 pagamento*](https://help.impact.com/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 **modificare completamente** la commissione dovuta a un partner. Di solito si creano gruppi di pagamento quando si crea un nuovo termine del modello, ma è anche possibile aggiungerli ai termini esistenti e [sostituire i contratti in un secondo momento](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/contracts/replace-a-partners-contract.md).

1. Nella barra di navigazione a sinistra, seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[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 ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FMLtRUwWz0pujlfmYWOgg%2FMoreVN.svg?alt=media\&token=03a3c355-a347-4207-baf7-c44fadf6d080) **\[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 ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FiZjM1xY8o3v1iR3Zaysd%2FToggle.svg?alt=media\&token=b1550d48-bba9-4e81-8604-bc12370c5caa) **\[Attiva]** **Configura gruppi di pagamento personalizzati**.
5. Per aggiungere i gruppi di pagamento uno alla volta, seleziona **Aggiungi nuovo**.
   * Dal primo ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c2cb550b55c51ea1eeff0acbd6f437a03b621a2c%2F60d033ae8a04c14498d5229c3c0160ac05feea7f605dbd770741793c900469f0.svg?alt=media) **\[Menu a discesa]**, seleziona la regola del gruppo di pagamento [*regole*](https://help.impact.com/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 ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c2cb550b55c51ea1eeff0acbd6f437a03b621a2c%2F60d033ae8a04c14498d5229c3c0160ac05feea7f605dbd770741793c900469f0.svg?alt=media) **\[Menu a discesa]**, seleziona come applicare la regola al gruppo di pagamento.
   * Quindi, seleziona il valore applicabile alla regola di pagamento selezionata (ad esempio, se hai selezionato *Valuta* come regola, dovrai selezionare il tipo di valuta in cui vuoi pagare i partner)
   * Nella sezione *Pagamento* , seleziona la metrica di pagamento (ovvero percentuale o importo fisso) e il valore numerico appropriato.
   * Seleziona **Aggiungi**.
6. Per creare un altro gruppo, seleziona di nuovo **Aggiungi nuovo** .
   * Se aggiungi più di una regola per gruppo di pagamento, tutte le regole dovranno essere soddisfatte affinché il 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. Esamina le modifiche ai termini del modello e seleziona **Avanti**.
9. Scegli quando devono entrare in vigore le modifiche per i contratti attivi associati a questi termini del modello.
10. Seleziona se i partner possono scegliere di iniziare ad applicare i nuovi termini prima della *Data di inizio della modifica*.
11. Facoltativamente, aggiungi un commento per i partner per spiegare 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, verrà applicato il *Pagamento predefinito* .
{% endhint %}

## Esempio pratico

Barb Dwyer genera una vendita di un'incudine (100 $) per il tuo brand, che porta a un cliente **NUOVO** . Il pagamento predefinito del contratto è pari al 10% della vendita, il che corrisponderebbe a una commissione di 10 $ per Barb Dwyer. Tuttavia, vuoi premiare i partner che portano nuovi clienti al tuo brand e decidi di aumentare del 5% i pagamenti ricevuti dai partner per i nuovi clienti e di sperimentare con i *Gruppi di pagamento* e gli *Adeguamenti dei pagamenti*.

Per prima cosa, decidi di configurare nel tuo contratto un **Gruppo di pagamento** con un pagamento pari al **15% dell'importo della vendita dell'articolo** (il 5% in più rispetto al pagamento predefinito).

<div data-with-frame="true"><figure><img src="https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FHCTLWwaGnyuj4Nj5NCaL%2FScreenshot%202026-05-06%20at%2011.18.07.png?alt=media&amp;token=c18c92fc-e087-4b27-80ac-f71d562a4e48" alt="" width="563"><figcaption></figcaption></figure></div>

Barb Dwyer riceverà ora il 15% di 100 $, pari a una commissione di 15 $.

Poi disattivi il gruppo di pagamento e provi a configurare un **Adeguamento del pagamento** per aumentare del 5% i pagamenti per i nuovi clienti.

<div data-with-frame="true"><figure><img src="https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fl4ZWk1s1g9RVXmmPI054%2FScreenshot%202026-05-06%20at%2011.30.10.png?alt=media&amp;token=3ce198d5-0c42-401d-842d-955006d4e06e" alt="" width="563"><figcaption></figcaption></figure></div>

Barb Dwyer riceverà ora il suo *Pagamento predefinito* del 10% (10 $), più un ulteriore 5% sulla commissione ricevuta. 10 $ + 5% = 10,50 $ di commissione.


---

# 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=<question>&goal=<user_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.
