> 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 promozionali di referral per i partecipanti
{% hint style="danger" %}
**Importante**: Una volta attivata la funzionalità per il tuo programma, non potrà essere disattivata.
{% endhint %}
I codici promozionali per referral sono un ottimo modo per condensare attribuzione e ricompensa in 1 passaggio all' **inizio** del processo di referral. I voucher vengono presentati dai sostenitori ai loro amici segnalati e offrono uno sconto. Una volta che l'amico segnalato usa il suo codice promozionale al momento del checkout, il codice viene attribuito al sostenitore, che a sua volta riceve una ricompensa.
Puoi creare codici promozionali per referral per i tuoi sostenitori caricando codici promozionali nelle regole del tuo programma. Una volta che hai [regole del programma](/brand/it/what-would-you-like-to-learn-about/advocate-program/getting-started-with-advocate/configure-your-advocate-program.md) configurato il tuo *Codici promozionali* sezione per caricare un batch di codici promozionali per 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). Fuel tank rewards utilizza anch'esso 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 per referral
1. Nel menu di navigazione a sinistra, seleziona  **\[Engage] → Regole del programma**.
2. Scorri fino alla *Codici promozionali* sezione, quindi seleziona **Configura codici promozionali**. Per i codici promozionali per referral, questo può essere impostato come **Multiuso** o **Uso singolo**.
* Si consiglia di usare codici a uso singolo invece di codici multiuso, poiché può aiutare a ridurre le frodi.
3. Seleziona il numero di codici che desideri rendere disponibili per ogni sostenitore. Questa opzione è disponibile solo se hai selezionato di creare **Uso singolo** codici promozionali.
* A un sostenitore può essere assegnato un certo numero di codici. Al sostenitore viene assegnato automaticamente un altro codice promozionale quando uno di quelli che aveva è stato utilizzato.
4. Puoi impostare quando desideri ricevere una notifica per la scarsa disponibilità di codici promozionali.
* Quando il numero di codici raggiunge il valore che hai impostato nella sezione delle notifiche, ti verrà inviata un'email per ricordarti che i codici stanno per finire. È molto importante assicurarsi che il tuo programma non arrivi a zero, quindi assicurati di creare altri codici quando stanno per finire per mantenere il programma operativo senza problemi.
5. Seleziona **Carica codici** per caricare un batch di codici promozionali per referral.
* Verrai reindirizzato a una pagina in cui potrai caricare il tuo batch di codici in uno qualsiasi dei formati di file accettati.
6. Seleziona **Salva** una volta configurati i tuoi codici promozionali. Apparirà un pop-up che chiederà se sei sicuro di voler salvare. Una volta abilitati i codici a uso singolo, l'azione non può essere annullata.
7. Seleziona  **\[casella di controllo]** per applicare automaticamente un nuovo modello di codice promozionale al tuo widget.
* In alternativa, se hai già un widget o un microsito, puoi aggiungere manualmente il componente del codice promozionale per referral. Puoi farlo andando su **Contenuto** nella barra di navigazione a 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 [i componenti di widget e micrositi](/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 per 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 che può alternare e copiare per condividerli con i referral. Se un codice è stato copiato in precedenza, verrai avvisato sotto il campo del codice. Questo aiuta a evitare situazioni in cui potresti inviare lo stesso codice a più persone.
{% hint style="success" %}
**Nota**: Nel caso in cui il tuo sostenitore esaurisca i codici e ti contatti per ottenerne altri, puoi crearne manualmente uno per lui se desideri fornire codici in circostanze speciali. Per farlo vai su **Partecipanti**. Seleziona il partecipante per cui desideri generare un nuovo codice, quindi seleziona la **Codici e link** scheda, quindi seleziona **Aggiungi codice referral** per generare per loro un nuovo codice. Il codice verrà aggiunto al loro batch esistente nel loro widget.
{% endhint %}
#### Attribuzione al momento dell'evento
I referral vengono attribuiti tramite upsert degli utenti, che avvengono tramite chiamate API, importazioni di utenti o persino caricamenti di widget. I codici promozionali per referral possono anche essere inviati insieme agli eventi di acquisto. Puoi inviarci l'evento nel `OrderPromoCode` della conversions API. 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 multiuso controllando il tipo di codice. Potrai anche vedere quali codici sono già stati utilizzati e 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 multiuso sono spesso condivisi su siti di terze parti, i codici a uso singolo possono essere utilizzati solo una volta e riducono la probabilità di essere diffusi tramite fonti non affidabili.
{% endhint %}
1. Nel menu di navigazione a sinistra, seleziona  **\[Engage] →** **Premi → Gestione codici**.
2. Seleziona il partecipante di cui desideri visualizzare i codici.
3. Nel *Visualizza codici* nella schermata troverai tutte le informazioni pertinenti sul tipo di codici emessi, su ciò che è stato utilizzato e altro ancora.
---
# 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=&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.