> 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/advocate-program/advocate-rewards/referral-promo-codes-for-participants.md).

# Codici promo referral per i partecipanti

{% hint style="danger" %}
**Importante**: Una volta attivata la funzionalità per il tuo programma, non può essere disattivata.
{% endhint %}

I codici promozionali referral sono un ottimo modo per condensare l'attribuzione e la ricompensa in 1 passaggio all' **inizio** del processo di referral. I voucher vengono presentati dai sostenitori del cliente agli amici segnalati e offrono uno sconto. Una volta che l'amico segnalato utilizza il proprio codice promozionale al checkout, il codice viene attribuito al sostenitore del cliente, che a sua volta riceve una ricompensa.

Puoi creare codici promozionali referral per i tuoi sostenitori caricando i codici promozionali nelle regole del tuo programma. Una volta che hai il tuo [regole del programma](/brand/it/what-would-you-like-to-learn-about/advocate-program/getting-started-with-advocate/configure-your-advocate-program.md) configurazione, vai alla *Codici promozionali* sezione per caricare un lotto di codici promozionali referral.

{% hint style="success" %}
**Nota**: Questa funzionalità è separata da [fuel tank rewards](/brand/it/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/fuel-tank-rewards-explained.md). Anche fuel tank rewards utilizza codici, ma questi codici servono solo a premiare il partecipante—non a creare un'attribuzione tra il sostenitore e l'amico segnalato.
{% endhint %}

#### Configura i codici promozionali referral

1. Nel menu 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] → Regole del programma**.
2. Scorri fino alla *Codici promozionali* sezione, quindi seleziona **Configura i codici promozionali**. Per i codici promozionali referral, questo può essere impostato su **Uso multiplo** o **Uso singolo**.
   * Si consiglia di usare i codici a uso singolo invece di quelli a uso multiplo, poiché può aiutare a ridurre le frodi.

     <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%2FGe75pFju4pGaCP0wkeOP%2FScreenshot%202026-05-19%20at%2011.12.14.png?alt=media&amp;token=f17160ae-8f36-484e-accc-7a03b84fe2a1" alt="" width="563"><figcaption></figcaption></figure></div>
3. Seleziona il numero di codici che desideri rendere disponibili per ogni sostenitore. Questa opzione è disponibile solo se hai scelto di creare **Uso singolo** codici promozionali.
   * A un sostenitore può essere assegnato un numero di codici. Il sostenitore riceve automaticamente un altro codice promozionale quando uno di quelli in suo possesso viene usato.

     <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%2FTg8TB9rIZdUufsT56vGR%2FScreenshot%202026-05-19%20at%2011.13.16.png?alt=media&amp;token=0697bf68-55a7-4cd5-a1aa-cd0b1a8fe48d" alt="" width="375"><figcaption></figcaption></figure></div>
4. Puoi impostare quando desideri essere avvisato quando i codici promozionali stanno per esaurirsi.
   * Una volta che il numero di codici raggiunge il numero impostato nella sezione delle notifiche, ti verrà inviata un'email per ricordarti che i codici stanno per esaurirsi. È molto importante assicurarsi che il tuo programma non arrivi a zero, quindi assicurati di creare altri codici quando stanno per finire per mantenere il tuo programma in esecuzione senza problemi.
5. Seleziona **Carica codici** per caricare un lotto di codici promozionali referral.
   * Verrai reindirizzato a una pagina in cui potrai caricare il tuo lotto di codici in uno qualsiasi dei formati di file accettati.

     <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%2FC01ajR9Orj70bvZ0Zs0M%2FScreenshot%202026-05-19%20at%2011.14.59.png?alt=media&amp;token=44888203-2077-480d-b81a-ca37492a36dc" alt="" width="375"><figcaption></figcaption></figure></div>
6. Seleziona **Salva** una volta configurati i codici promozionali. Apparirà un pop-up che chiede se sei sicuro di voler salvare. Una volta abilitati i codici a uso singolo, l'azione non può essere annullata.

   <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%2FCxnU8l4xOjtmKBqip9jl%2FScreenshot%202026-05-19%20at%2012.16.57.png?alt=media&amp;token=3158ea8d-6b22-4de8-80b5-2e4cc9e4e154" alt="" width="344"><figcaption></figcaption></figure></div>
7. Seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FwXho9QKP3e4iU4ZKUSJ5%2F167ebb8cc30303.svg?alt=media\&token=a046e9f0-63aa-46f6-8a35-f73973fd326c) **\[casella di controllo]** per applicare automaticamente un nuovo modello di codice promozionale al tuo widget.
   * In alternativa, se hai un widget o un microsito esistente, puoi aggiungere manualmente il componente del codice promozionale referral. Puoi farlo andando a **Contenuto** nella barra di navigazione sinistra e poi scegliendo di modificare il tuo widget o microsito. Seleziona **Aggiungi** a destra per aggiungere un componente al tuo widget o microsito esistente. Scopri di più su [componenti widget e microsito](/brand/it/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/widget-and-microsite-components-explained.md).

Una volta caricati i tuoi codici promozionali referral, i codici verranno generati automaticamente e forniti tramite i [widget](/brand/it/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/introduction-to-participant-experiences.md#widgets-0-0) o i micrositi che hai configurato.

Nell'immagine qui sotto, al sostenitore vengono forniti 5 codici diversi tra cui può alternare e copiare per condividerli con i referral. Se un codice è già stato copiato in precedenza, ne riceverai notifica sotto il campo del codice. Questo aiuta a evitare situazioni in cui potresti inviare lo stesso codice a più persone.

<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%2Fgit-blob-21993c32d4b6f889783325b921cbf28a6bba4c45%2Fd87e360ea05fc772c976e14f0d24ad85084e28eefdd0c1d5c9410098aa3f1a65.jpg?alt=media" alt="" width="375"><figcaption></figcaption></figure></div>

{% hint style="success" %}
**Nota**: Nel caso in cui il tuo sostenitore esaurisca i codici e ti contatti per averne altri, puoi crearne manualmente uno per lui se desideri fornire codici in circostanze speciali. Per farlo, vai a **Partecipanti**. Seleziona il partecipante per cui desideri generare un nuovo codice, quindi seleziona **Codici e link** scheda e seleziona **Aggiungi codice referral** per generare un nuovo codice per loro. Il codice verrà aggiunto al loro lotto esistente nel loro widget.
{% endhint %}

#### Attribuzione al momento dell'evento

Le segnalazioni vengono attribuite tramite upsert degli utenti, che avvengono tramite chiamate API, importazioni di utenti o persino caricamenti del widget. I codici promozionali referral possono anche essere restituiti con gli eventi di acquisto. Puoi inviarci l'evento in `OrderPromoCode` tramite la API delle conversioni. Scopri di più su come creare un [evento di conversione](https://integrations.impact.com/brand-api-reference/reference/conversions/conversions).

#### Visualizza i tuoi codici promozionali

Ci sono diversi dettagli che puoi visualizzare nella *Visualizza codici* schermata. Puoi distinguere tra codici a uso singolo e codici a uso multiplo controllando il tipo di codice. Potrai anche vedere quali codici sono già stati usati e potrai visualizzare quali sostenitori sono stati attribuiti a quali referral.

{% hint style="success" %}
**Nota**: I codici a uso singolo sono un ottimo modo per ridurre al minimo le possibilità di uso fraudolento dei tuoi codici promozionali. Mentre i codici a uso multiplo vengono spesso condivisi su siti di terze parti, i codici a uso singolo possono essere utilizzati solo una volta e riducono la probabilità di diffusione tramite fonti non affidabili.
{% endhint %}

1. Nel menu 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] →** **Ricompense → Gestione codici**.
2. Seleziona il partecipante di cui desideri visualizzare i codici.
3. Nella *Visualizza codici* nella schermata troverai tutte le informazioni rilevanti sul tipo di codici emessi, su quelli utilizzati e altro ancora.

   <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%2F5G6QGfUR6MiONqv2ki1N%2FScreenshot%202026-05-19%20at%2012.12.21.png?alt=media&amp;token=e2c4241a-5bb5-430e-8c42-cde9a31f2938" alt=""><figcaption></figcaption></figure></div>


---

# 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/advocate-program/advocate-rewards/referral-promo-codes-for-participants.md?ask=<question>&goal=<endgoal>
```

`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.
