> 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 potrà 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 promotori ai loro amici segnalati e offrono uno sconto. Una volta che l'amico segnalato usa il proprio codice promozionale al checkout, il codice viene attribuito al promotore, che a sua volta riceve una ricompensa.
Puoi creare codici promozionali referral per i tuoi promotori caricando codici promozionali nelle regole del programma. Una volta che hai configurato 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) configurato il tuo *Codici promozionali* sezione per caricare un batch di codici promozionali referral.
{% hint style="success" %}
**Nota**: Questa funzionalità è separata da [ricompense Fuel Tank](/brand/it/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/fuel-tank-rewards-explained.md). Anche le ricompense Fuel Tank usano codici, ma questi codici servono solo a premiare il partecipante, non a creare un'attribuzione tra il promotore e l'amico segnalato.
{% endhint %}
#### Configura i codici promozionali 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 referral questo potrebbe essere impostato su **Riutilizzo multiplo** o **Uso singolo**.
* Si consiglia di utilizzare codici a uso singolo invece di codici a riutilizzo multiplo, poiché possono aiutare a ridurre al minimo le frodi.
3. Seleziona il numero di codici che desideri rendere disponibili per ciascun promotore. Questa opzione è disponibile solo se hai scelto di creare **Uso singolo** codici promozionali.
* A un promotore può essere assegnato un certo numero di codici. Il promotore riceve automaticamente un altro codice promozionale quando uno di quelli che aveva è stato utilizzato.
4. Puoi impostare quando desideri ricevere una notifica quando i codici promozionali stanno per esaurirsi.
* Quando il numero di codici raggiunge il numero impostato nella sezione di notifica, 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 una volta che iniziano a scarseggiare per mantenere il tuo programma senza intoppi.
5. Seleziona **Carica codici** per caricare un batch di codici promozionali referral.
* Verrai reindirizzato a una pagina in cui potrai caricare il tuo batch di codici in uno dei formati di file accettati.
6. Seleziona **Salva** una volta configurati i tuoi codici promozionali. Apparirà un pop-up che ti chiederà se sei sicuro di voler salvare. Una volta abilitati i codici monouso, l'azione non potrà essere annullata.
7. Seleziona  **\[casella di spunta]** 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 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ù sui [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 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 promotore vengono forniti 5 codici diversi tra cui può alternare e copiare per condividerli con i referral. Se un codice è stato copiato in precedenza, verrai notificato 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 promotore esaurisca i codici e ti contatti per averne altri, puoi crearne uno manualmente 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 scheda **Codici e link** , e seleziona **Aggiungi codice referral** per generare un nuovo codice per lui. Il codice verrà aggiunto al batch esistente nel suo widget.
{% endhint %}
#### Attribuzione al momento dell'evento
I referral vengono attribuiti tramite upsert degli utenti, e ciò avviene tramite chiamate API, importazioni di utenti o persino caricamenti dei widget. I codici promozionali referral possono anche essere inviati indietro con gli eventi di acquisto. Puoi passarci l'evento nel `OrderPromoCode` dalle 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 schermata *Visualizza codici* . Potrai distinguere tra codici monouso e a riutilizzo multiplo controllando il tipo di codice. Potrai anche vedere quali codici sono già stati utilizzati e quali promotori sono stati attribuiti a quali referral.
{% hint style="success" %}
**Nota**: I codici monouso sono un ottimo modo per ridurre al minimo le possibilità di utilizzo fraudolento dei tuoi codici promozionali. Mentre i codici a riutilizzo multiplo sono spesso condivisi su siti di terze parti, i codici monouso possono essere usati una sola volta e riducono la probabilità di diffusione su fonti inaffidabili.
{% endhint %}
1. Nel menu di navigazione a sinistra, seleziona  **\[Engage] →** **Premi → Gestione codici**.
2. Seleziona il partecipante per cui desideri visualizzare i codici.
3. Nella *Visualizza codici* schermata troverai tutte le informazioni pertinenti sul tipo di codici emessi, su quelli utilizzati 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.