> 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/getting-started-with-advocate/advocate-program-rules-explained.md).

# Configura le regole del programma in Advocate

<a href="https://pxa.impact.com/student/activity/2345886?sid=0c0e3e5c-54c9-4435-9bee-ebcdccb7f292&#x26;sid_i=0?utm_source=app.impact.com&#x26;utm_medium=owned-platform&#x26;utm_content=&#x26;utm_campaign=help-center" class="button primary">Segui il corso PXA</a>

I programmi di referral dipendono da coppie di regole e azioni per premiare adeguatamente i partecipanti o attivare azioni (come l'invio di un'email). Insieme, queste regole e azioni costituiscono le regole del programma. Una regola è ciò che vuoi che il tuo utente target faccia. Nei programmi di referral, gli utenti possono applicarsi sia ai customer advocate sia agli amici che segnalano. Un'azione viene attivata quando il partecipante raggiunge una regola.

<details>

<summary>Regole</summary>

Le regole che imposti dipenderanno dal tuo programma e dai risultati che vuoi ottenere. Per ogni programma di referral è richiesta almeno una regola di conversione. Esempi di regole includono:

* L'amico segnalato effettua un acquisto
* Il promotore effettua 5 referral
* L'amico segnalato diventa un lead qualificato

**Trigger della regola**

impact.com si basa sugli eventi che ci invii per fungere da trigger per la regola. Durante [la configurazione del programma](/brand/it/what-would-you-like-to-learn-about/advocate-program/getting-started-with-advocate/configure-your-advocate-program.md), seleziona il trigger della tua regola e una chiave evento.

| Trigger                                      | Descrizione                                                                                    |
| -------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| Inizio del referral                          | Quando un referral viene avviato.                                                              |
| L'amico effettua un acquisto                 | Quando l'amico segnalato effettua un acquisto tracciato da un evento.                          |
| L'amico rimborsa un acquisto                 | Quando un amico segnalato restituisce un prodotto acquistato tracciato da un evento.           |
| L'amico esegue un'azione                     | Quando l'amico segnalato esegue un'azione tracciata da un evento, come effettuare un acquisto. |
| Il segmento e/o il campo dell'amico cambiano | Quando un campo o un segmento dell'amico segnalato viene aggiornato o cambia.                  |

<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-52c2fb38ab99941f251d244ee053c56842fd1c2d%2Fc0a9e0fd245d4c823bf495b51eb1f0b15b33d8eb416d9fcd8bd41fa224f93041.jpg?alt=media" alt="" width="563"><figcaption></figcaption></figure></div>

**Condizioni della regola**

Puoi impostare condizioni su una regola se vuoi che venga attivata solo in situazioni specifiche. Ecco alcune condizioni che possono essere applicate a una regola.

* Un amico segnalato effettua un acquisto e il totale dell'acquisto è di almeno 100 $.
* Il promotore effettua 5 referral che rimangono abbonati attivi per almeno sei mesi.
* Un amico segnalato avvia un abbonamento e il promotore deve essere anch'esso un abbonato attivo.

Le condizioni della regola possono basarsi su diversi tipi di dati provenienti dai nostri database:

| Dati                                               | Descrizione                                                                                                                                                                                                                                                                                                            |
| -------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Oggetto utente (sia promotore che amico segnalato) | Include i loro dettagli principali, come email e nome, oltre ai campi personalizzati.                                                                                                                                                                                                                                  |
| Evento                                             | Include tutti i campi all'interno dell'evento che possono attivare una regola, come ricavi, nome del prodotto o piano.                                                                                                                                                                                                 |
| Regole                                             | Un conteggio di regole e referral viene reso disponibile nella logica del programma, così come l'informazione se questa è la prima volta che la regola viene attivata. Questo è utile per eseguire programmi che assegnano premi ogni X referral, o per garantire che una regola/azione venga attivata solo una volta. |
| Tempo                                              | Il sistema può fare riferimento all'ora corrente e confrontarla con date chiave del referral (come quando il referral è stato avviato) o dell'utente (come quando l'utente è stato creato).                                                                                                                            |

</details>

Completa le sezioni seguenti per configurare le regole del programma e seleziona **Avanti** dopo aver completato ogni sezione.

{% stepper %}
{% step %}

### Accedi alle regole del programma&#x20;

1. Dal 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]** <i class="fa-arrow-right">:arrow-right:</i> **Regole del programma** <i class="fa-arrow-right">:arrow-right:</i> **Regole del programma**.
2. Nella *Regole del programma* sezione, seleziona **Aggiungi regola**.
   {% endstep %}

{% step %}

### Scegli e configura una regola del programma

3. Sotto *Cosa attiva questa regola?*, dal ![](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 un trigger. Alcune configurazioni differiscono in base alla selezione della regola.

<details>

<summary>Riferimento al trigger</summary>

| Trigger                                      | Descrizione                                                                                    |
| -------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| Inizio del referral                          | Quando un referral viene avviato.                                                              |
| L'amico effettua un acquisto                 | Quando l'amico segnalato effettua un acquisto tracciato da un evento.                          |
| L'amico rimborsa un acquisto                 | Quando un amico segnalato restituisce un prodotto acquistato tracciato da un evento.           |
| L'amico esegue un'azione                     | Quando l'amico segnalato esegue un'azione tracciata da un evento, come effettuare un acquisto. |
| Il segmento e/o il campo dell'amico cambiano | Quando un campo o un segmento dell'amico segnalato viene aggiornato o cambia.                  |

</details>

4. Se applicabile, seleziona l'evento di acquisto o di azione che attiverà la regola, oppure specifica un campo o un segmento.
5. &#x20;![](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]** **Azioni basate sulla data** per eseguire azioni diverse in base a quando si verifica l'attività di referral. Una volta abilitato, sotto *Valuta il timing* *usando*, scegli quale evento viene usato per valutare la regola: la data di inizio del referral, la sua data di conversione o la data di acquisto.&#x20;
6. ![](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]** **Attiva solo la prima volta** per attivare la regola solo la prima volta che l'evento si verifica per un dato referral.
7. ![](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]** **Converti il referral** per contrassegnarlo come convertito quando la regola viene attivata.
8. Inserisci un **Nome della regola**. Una volta salvato, non può essere modificato.
   {% endstep %}

{% step %}

### Aggiungi impostazioni avanzate (facoltativo)&#x20;

9. Seleziona **Impostazioni avanzate** per aggiungere limiti o condizioni alla regola.
10. ![](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]** **Limita il numero di ricompense** per definire il numero massimo di ricompense che un promotore può guadagnare quando una regola viene attivata.
11. Sotto la *Se* sezione, applica condizioni a una regola se vuoi che venga attivata solo in situazioni specifiche. Ecco alcune condizioni che possono essere applicate a una regola.
    * Un amico effettua un acquisto e il totale dell'acquisto è di almeno 100 $.
    * Il promotore effettua 5 referral che rimangono abbonati attivi per almeno sei mesi.
    * Un amico segnalato avvia un abbonamento e il promotore deve essere anch'esso un abbonato attivo.

<details>

<summary>Riferimento alle condizioni</summary>

Le condizioni della regola possono basarsi su diversi tipi di dati provenienti dai nostri database:

| Dati                                               | Descrizione                                                                                                                                                                                                                                                                                                            |
| -------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Oggetto utente (sia promotore che amico segnalato) | Include i loro dettagli principali, come email e nome, oltre ai campi personalizzati.                                                                                                                                                                                                                                  |
| Evento                                             | Include tutti i campi all'interno dell'evento che possono attivare una regola, come ricavi, nome del prodotto o piano.                                                                                                                                                                                                 |
| Regole                                             | Un conteggio di regole e referral viene reso disponibile nella logica del programma, così come l'informazione se questa è la prima volta che la regola viene attivata. Questo è utile per eseguire programmi che assegnano premi ogni X referral, o per garantire che una regola/azione venga attivata solo una volta. |
| Tempo                                              | Il sistema può fare riferimento all'ora corrente e confrontarla con date chiave del referral, come quando il referral è stato avviato, o dell'utente, come quando l'utente è stato creato.                                                                                                                             |

</details>
{% endstep %}

{% step %}

### Aggiungi un'azione

{% hint style="info" %}
**Limitato**: Se devi aggiungere più azioni per il tuo programma, potrebbe essere necessario aggiornare il tuo account. [Contatta l'assistenza](https://app.impact.com/support/portal.ihtml?createTicket=true&) per aggiornare il tuo programma per promotori.
{% endhint %}

È possibile aggiungere criteri sia alle regole sia alle azioni, poiché più regole possono applicarsi alla stessa azione. Anche se le condizioni di una regola sono state soddisfatte, potresti voler impostare condizioni dell'azione per controllare quale ricompensa viene erogata o quale email viene inviata. Questo è possibile solo a determinati livelli di programma; contatta [l'assistenza](https://app.impact.com/support/portal.ihtml) per ulteriori informazioni.

12. Seleziona una delle tessere azione. Le azioni includono:

* **Ricompensa ed email:** Fornisci una ricompensa e avvisa il partecipante con un'email.
* **Solo email:** Invia un'email al partecipante.
* **Ricompense a livelli ed email:** Offri ricompense diverse in base al segmento di un partecipante, al valore dell'acquisto e altro ancora.

13. Scegli a chi si applica l'azione:
    * **Promotore**: Il partecipante che condivide il proprio link o codice di referral per invitare un amico al tuo brand.
    * **Amico**: Il partecipante che usa il link o codice di referral per registrarsi o effettuare un acquisto.
14. Assegna un nome all'azione.
15. (Condizionale) Se hai abilitato le azioni basate sulla data, ![](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]** **Limita l'azione a un intervallo di date** e scegli un periodo in cui la regola deve essere attivata.
16. Facoltativamente, seleziona **Impostazioni avanzate** per aggiungere condizioni a un'azione se vuoi che venga attivata solo in situazioni specifiche.

{% hint style="info" %}
**Esempio:** Potresti impostare una regola di acquisto con la relativa azione Ricompensa ed email. Con questa coppia di regola e azione, il tuo promotore viene avvisato via email e riceve una ricompensa ogni volta che un amico da lui segnalato effettua un acquisto.
{% endhint %}

<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%2FRJnDay3QTI9kGA02BlLJ%2FScreenshot%202026-08-25%20at%2008.21.15.png?alt=media&amp;token=fc9ab230-f10c-496d-8d25-70e6175e16f9" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### Aggiungi una ricompensa (condizionale)

Se hai selezionato **Ricompensa ed email** o **Ricompensa a livelli ed email**, dovrai configurare la ricompensa. Per le istruzioni di configurazione, consulta la *sezione Crea una ricompensa* in [Configura il tuo programma per promotori](/brand/it/what-would-you-like-to-learn-about/advocate-program/getting-started-with-advocate/configure-your-advocate-program.md).
{% endstep %}

{% step %}

### Rivedi la tua regola

Prima di salvare, la *Riepilogo* schermata riassume la regola.&#x20;

17. Facoltativamente, aggiorna la regola:
    1. Seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fut4jbWXPGIqKlOpfrxol%2Fadvocate_edit.svg?alt=media\&token=3a645b22-237b-429e-be28-5a4d92fab66c) **\[Modifica]** accanto a qualsiasi riga per modificarla
    2. Seleziona ![](broken://files/37df61c3f498148db62759a70efa3aaaf657aa47) **\[Aggiungi azione]** per allegare un'altra azione senza tornare ai passaggi precedenti.
18. Seleziona **Salva** quando hai finito.

<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%2FYW2FIPxQ7QjzZegAfE4B%2FScreenshot%202026-05-15%20at%2011.31.37.png?alt=media&amp;token=bfa99c0a-4c10-49e8-894d-8182801d6e34" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

## Esempi di regole e azioni

Puoi considerare regole e azioni come una serie di istruzioni if-then. Diamo un'occhiata ad alcuni esempi.

| Risultato desiderato                                                                                                                                                            | Se (regola)                                          | Allora (azione)                                                                                 |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| Premia il promotore con una carta regalo da 20 $ per ogni 5 lead qualificati che segnala                                                                                        | L'amico segnalato diventa un lead qualificato        | Ricompensa ed email                                                                             |
| Premia l'amico segnalato con un credito di 100 $ alla registrazione iniziale e il promotore con un credito di 500 $ se l'opportunità in Salesforce è impostata su “Closed Won”. | L'amico segnalato completa la registrazione iniziale | <ul><li>Ricompensa ed email (promotore)</li><li>Ricompensa ed email (amico segnalato)</li></ul> |
| Invia al promotore un'email di notifica quando la persona che ha segnalato completa con successo una demo.                                                                      | L'amico segnalato completa una demo                  | Solo email                                                                                      |


---

# 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/getting-started-with-advocate/advocate-program-rules-explained.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.
