> 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 referral dipendono da coppie di regole e azioni per premiare in modo appropriato i partecipanti o attivare azioni (come l'invio di un'email). Insieme, queste regole e azioni formano le regole del programma. Una regola è ciò che vuoi che faccia il tuo utente target. Nei programmi referral, le regole possono applicarsi sia ai clienti promotori sia agli amici che segnalano. Un'azione viene attivata quando il partecipante soddisfa una regola.

<details>

<summary>Regole</summary>

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

* L'amico segnalato effettua un acquisto
* Il cliente 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 viene avviato un referral.                                                                       |
| L'amico effettua un acquisto               | Quando l'amico segnalato effettua un acquisto tracciato da un evento.                                   |
| L'amico rimborsa un acquisto               | Quando l'amico segnalato restituisce un prodotto acquistato tramite un acquisto tracciato da un evento. |
| L'amico compie un'azione                   | Quando l'amico segnalato compie un'azione tracciata da un evento, come effettuare un acquisto.          |
| Il segmento e/o il campo dell'amico cambia | 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 cliente promotore effettua 5 referral che restano abbonati attivi per almeno sei mesi.
* Un amico segnalato avvia un abbonamento e il promotore deve anche essere un abbonato attivo.

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

| Dati                                                 | Descrizione                                                                                                                                                                                                                                                                                                                            |
| ---------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Oggetto utente (cliente promotore o amico segnalato) | Include i loro dati 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                                               | Nel flusso logico del programma è disponibile un conteggio delle regole e dei referral, così come l'indicazione se si tratta della prima volta in cui la regola viene attivata. Questo è utile per eseguire programmi che assegnano premi ogni X referral, oppure per assicurarsi che una regola/azione venga attivata solo una volta. |
| Tempo                                                | Il sistema può fare riferimento all'ora corrente e confrontarla con le date chiave del referral (come quando il referral è stato avviato) o dell'utente (come quando l'utente è stato creato).                                                                                                                                         |

Una *Tempo* condizione determina se la regola si attiva. Per applicare azioni diverse in base al momento in cui si verifica l'attività di referral, usa [azioni basate sulla data](/brand/it/what-would-you-like-to-learn-about/advocate-program/advocate-program-settings/date-based-actions-in-advocate-program-rules-explained.md) invece.

</details>

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

{% stepper %}
{% step %}

### Accedi alle regole del programma

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 *sezione Regole del programma* seleziona **Aggiungi regola**.
   {% endstep %}

{% step %}

### Scegli e configura una regola del programma

3. Di seguito *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 variano in base alla regola selezionata.

<details>

<summary>Riferimento del trigger</summary>

| Trigger                                    | Descrizione                                                                                             |
| ------------------------------------------ | ------------------------------------------------------------------------------------------------------- |
| Inizio del referral                        | Quando viene avviato un referral.                                                                       |
| L'amico effettua un acquisto               | Quando l'amico segnalato effettua un acquisto tracciato da un evento.                                   |
| L'amico rimborsa un acquisto               | Quando l'amico segnalato restituisce un prodotto acquistato tramite un acquisto tracciato da un evento. |
| L'amico compie un'azione                   | Quando l'amico segnalato compie un'azione tracciata da un evento, come effettuare un acquisto.          |
| Il segmento e/o il campo dell'amico cambia | 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. ![](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 applicare azioni diverse a seconda di quando si verifica l'attività di referral. Una volta abilitato, sotto *Valuta il momento* *usando*, seleziona la data da confrontare con l'intervallo di date di ciascuna azione. Le date tra cui puoi scegliere dipendono dal trigger. Per i dettagli, consulta [Azioni basate sulla data in Advocate](/brand/it/what-would-you-like-to-learn-about/advocate-program/advocate-program-settings/date-based-actions-in-advocate-program-rules-explained.md).
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 determinato 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)

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 premi** per definire il numero massimo di premi che un promotore può ottenere quando una regola viene attivata.
11. Sotto la *Se* sezione, imposta 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 effettua un acquisto e il totale dell'acquisto è di almeno 100 $.
    * Il cliente promotore effettua 5 referral che restano abbonati attivi per almeno sei mesi.
    * Un amico segnalato avvia un abbonamento e il promotore deve anche essere un abbonato attivo.

<details>

<summary>Riferimento della condizione</summary>

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

| Dati                                                 | Descrizione                                                                                                                                                                                                                                                                                                                            |
| ---------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Oggetto utente (cliente promotore o amico segnalato) | Include i loro dati 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                                               | Nel flusso logico del programma è disponibile un conteggio delle regole e dei referral, così come l'indicazione se si tratta della prima volta in cui la regola viene attivata. Questo è utile per eseguire programmi che assegnano premi ogni X referral, oppure per assicurarsi che una regola/azione venga attivata solo una volta. |
| Tempo                                                | Il sistema può fare riferimento all'ora corrente e confrontarla con le date chiave del referral, come quando il referral è stato avviato, o dell'utente, come quando l'utente è stato creato.                                                                                                                                          |

Una *Tempo* condizione determina se la regola si attiva. Per applicare azioni diverse in base al momento in cui si verifica l'attività di referral, usa [azioni basate sulla data](/brand/it/what-would-you-like-to-learn-about/advocate-program/advocate-program-settings/date-based-actions-in-advocate-program-rules-explained.md) invece.

</details>
{% endstep %}

{% step %}

### Aggiungi un'azione

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

È possibile aggiungere criteri sia alle regole sia alle azioni, poiché più regole possono applicarsi alla stessa azione. Sebbene siano state soddisfatte le condizioni di una regola, potresti voler impostare condizioni dell'azione per controllare quale premio viene assegnato 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 schede di azione. Le azioni includono:

* **Premio ed email:** Assegna un premio e notifica il partecipante con un'email.
* **Solo email:** Invia un'email al partecipante.
* **Premi a livelli ed email:** Offri premi diversi in base al segmento del 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 referral per invitare un amico al tuo brand.
    * **Amico**: Il partecipante che usa il link o codice referral per iscriversi 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 il periodo durante il quale questa azione si applica. Se la data selezionata nel passaggio 5 rientra fuori dall'intervallo, si applica un'azione diversa. Per i dettagli, consulta [Azioni basate sulla data in Advocate](/brand/it/what-would-you-like-to-learn-about/advocate-program/advocate-program-settings/date-based-actions-in-advocate-program-rules-explained.md).
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 effettuato con l'azione associata Premio ed email. Con questa coppia di regola e azione, il tuo cliente promotore viene avvisato via email e riceve un premio 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 un premio (condizionale)

Se hai selezionato **Premio ed email** o **Premio a livelli ed email**, dovrai configurare il premio. Per le istruzioni di configurazione, consulta la *sezione Crea un premio* in [Configura il tuo programma advocate](/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 *schermata di revisione* riassume la regola.

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 ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FE2111giEEN8AgK2AkYBQ%2F%5BAdd%5D.svg?alt=media\&token=e4bac353-65cf-4aba-83f2-84825bc825d3) **\[Aggiungi azione]** per aggiungere 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 "se-allora". Diamo un'occhiata ad alcuni esempi.

| Risultato desiderato                                                                                                                                                                    | Se (Regola)                                          | Allora (Azione)                                                                                 |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| Premia il cliente promotore con una gift card da 20 $ per ogni 5 lead qualificati che segnala                                                                                           | L'amico segnalato diventa un lead qualificato        | Premio ed email                                                                                 |
| Premia l'amico segnalato con un credito di 100 $ alla registrazione iniziale e il cliente promotore con un credito di 500 $ se l'opportunità in Salesforce è impostata su “Closed Won.” | L'amico segnalato completa la registrazione iniziale | <ul><li>Premio ed email (cliente promotore)</li><li>Premio ed email (amico segnalato)</li></ul> |
| Invia al cliente 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 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/advocate-program/getting-started-with-advocate/advocate-program-rules-explained.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.
