> 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 si basano sull’abbinamento di regole e azioni per premiare adeguatamente i partecipanti o avviare determinate attività (ad esempio, l’invio di un’email). L’insieme di queste regole e azioni costituisce le regole del programma. Una regola definisce ciò che vuoi che faccia l’utente target. Nei programmi di referral, le regole possono riguardare sia i promotori clienti sia gli amici che invitano. Un’azione viene attivata quando il partecipante soddisfa una regola.

<details>

<summary>Regole</summary>

Le regole da impostare dipendono dal programma e dai risultati che vuoi ottenere. Ogni programma di referral deve includere almeno una regola di conversione. Ecco alcuni esempi di regole:

* L’amico invitato effettua un acquisto
* Il promotore cliente invita 5 persone
* L’amico invitato diventa un lead qualificato

**Attivatori delle regole**

impact.com utilizza gli eventi che ci invii come attivatori delle regole. Durante [la configurazione del programma](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/advocate-program/getting-started-with-advocate/configure-your-advocate-program.md), seleziona l’attivatore della regola e una chiave evento.

| Attivatore                                 | Descrizione                                                                                    |
| ------------------------------------------ | ---------------------------------------------------------------------------------------------- |
| Inizia il referral                         | Quando viene avviato un referral.                                                              |
| L’amico effettua un acquisto               | Quando l’amico invitato effettua un acquisto monitorato tramite un evento.                     |
| L’amico rimborsa un acquisto               | Quando l’amico invitato restituisce un prodotto acquistato, monitorato tramite un evento.      |
| L’amico esegue un’azione                   | Quando l’amico invitato esegue un’azione monitorata tramite un evento, ad esempio un acquisto. |
| Il segmento e/o il campo dell’amico cambia | Quando un campo o un segmento dell’amico invitato viene aggiornato o modificato.               |

<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 delle regole**

Puoi impostare condizioni per una regola se vuoi che venga attivata solo in situazioni specifiche. Ecco alcune condizioni applicabili a una regola.

* Un amico invitato effettua un acquisto per un importo totale di almeno 100 $.
* Il promotore cliente invita 5 persone che rimangono abbonate attive per almeno sei mesi.
* Un amico invitato attiva un abbonamento e anche il promotore deve essere un abbonato attivo.

Le condizioni delle regole possono basarsi su diversi tipi di dati presenti nei nostri database:

| Dati                                                | Descrizione                                                                                                                                                                                                                                                                                                  |
| --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Oggetto utente (promotore cliente o amico invitato) | Include i dati di base dell’utente, come l’indirizzo email e il nome, oltre ai campi personalizzati.                                                                                                                                                                                                         |
| Evento                                              | Include tutti i campi dell’evento che può attivare una regola, come il fatturato, il nome del prodotto o il piano.                                                                                                                                                                                           |
| Regole                                              | La logica del programma può accedere al conteggio delle regole e dei referral e verificare se è la prima volta che una regola viene attivata. Questa funzione è utile per eseguire programmi che assegnano premi ogni X referral o per assicurarsi che una regola o un’azione venga attivata una sola volta. |
| Tempo                                               | Il sistema può consultare l’ora corrente e confrontarla con date importanti del referral (ad esempio, la data di avvio) o dell’utente (ad esempio, la data di creazione dell’account).                                                                                                                       |

Una *condizione temporale* determina se la regola viene attivata. Per applicare azioni diverse in base al momento in cui si verifica l’attività di referral, usa le [azioni basate sulla data](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/advocate-program/advocate-program-settings/date-based-actions-in-advocate-program-rules-explained.md) .

</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

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]** <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>

| Attivatore                                 | Descrizione                                                                                    |
| ------------------------------------------ | ---------------------------------------------------------------------------------------------- |
| Inizia il referral                         | Quando viene avviato un referral.                                                              |
| L’amico effettua un acquisto               | Quando l’amico invitato effettua un acquisto monitorato tramite un evento.                     |
| L’amico rimborsa un acquisto               | Quando l’amico invitato restituisce un prodotto acquistato, monitorato tramite un evento.      |
| L’amico esegue un’azione                   | Quando l’amico invitato esegue un’azione monitorata tramite un evento, ad esempio un acquisto. |
| Il segmento e/o il campo dell’amico cambia | Quando un campo o un segmento dell’amico invitato viene aggiornato o modificato.               |

</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 attivata questa opzione, in *Valuta la tempistica* *con*, seleziona la data da confrontare con l'intervallo di date di ciascuna azione. Le date tra cui puoi scegliere dipendono dal trigger. Per maggiori dettagli, consulta [Azioni basate sulla data in Advocate](https://help.impact.com/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 si verifica l'evento 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 viene attivata la regola.
8. Inserisci un **Nome della regola**. Una volta salvato, non potrai più modificarlo.
   {% 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 advocate può guadagnare quando viene attivata una regola.
11. Nella sezione *Se* , puoi impostare condizioni per una regola se vuoi che venga attivata solo in situazioni specifiche. Ecco alcune condizioni che puoi applicare a una regola.
    * Un amico effettua un acquisto per un importo pari o superiore a 100 $.
    * Il promotore cliente invita 5 persone che rimangono abbonate attive per almeno sei mesi.
    * Un amico invitato attiva un abbonamento e anche il promotore deve essere un abbonato attivo.

<details>

<summary>Riferimento delle condizioni</summary>

Le condizioni delle regole possono basarsi su diversi tipi di dati presenti nei nostri database:

| Dati                                                | Descrizione                                                                                                                                                                                                                                                                                                  |
| --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Oggetto utente (promotore cliente o amico invitato) | Include i dati di base dell’utente, come l’indirizzo email e il nome, oltre ai campi personalizzati.                                                                                                                                                                                                         |
| Evento                                              | Include tutti i campi dell’evento che può attivare una regola, come il fatturato, il nome del prodotto o il piano.                                                                                                                                                                                           |
| Regole                                              | La logica del programma può accedere al conteggio delle regole e dei referral e verificare se è la prima volta che una regola viene attivata. Questa funzione è utile per eseguire programmi che assegnano premi ogni X referral o per assicurarsi che una regola o un’azione venga attivata una sola volta. |
| Tempo                                               | Il sistema può fare riferimento all'ora corrente e confrontarla con date importanti del referral, ad esempio quando è stato avviato, o dell'utente, ad esempio quando è stato creato.                                                                                                                        |

Una *condizione temporale* determina se la regola viene attivata. Per applicare azioni diverse in base al momento in cui si verifica l’attività di referral, usa le [azioni basate sulla data](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/advocate-program/advocate-program-settings/date-based-actions-in-advocate-program-rules-explained.md) .

</details>
{% endstep %}

{% step %}

### Aggiungi un'azione

{% hint style="info" %}
**Limitato**: se devi aggiungere più azioni al tuo programma, potrebbe essere necessario passare a un piano superiore. [Contatta l'assistenza](https://app.impact.com/support/portal.ihtml?createTicket=true&) per passare a un piano superiore per il tuo programma Advocate.
{% endhint %}

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

12. Seleziona uno dei riquadri delle azioni. Le azioni includono:

* **Premio ed email:** Assegna un premio e invia un'email al partecipante per informarlo.
* **Solo email:** Invia un'email al partecipante.
* **Premi a livelli ed email:** Offri premi diversi in base al segmento del partecipante, all'importo dell'acquisto e ad altri fattori.

13. Scegli a chi si applica l'azione:
    * **Promotore**: il partecipante che condivide il proprio link o codice di referral per invitare un amico a conoscere il tuo brand.
    * **Amico**: il partecipante che usa il link o il codice di referral per registrarsi o effettuare un acquisto.
14. Assegna un nome all'azione.
15. (Condizionale) Se hai abilitato le azioni basate su date, ![](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 in cui si applica l'azione. Se la data selezionata al passaggio 5 non rientra nell'intervallo, si applica un'azione diversa. Per i dettagli, consulta [Azioni basate su date in Advocate](https://help.impact.com/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:** Puoi impostare una regola di acquisto effettuato con l'azione associata Premio ed e-mail. Con questa coppia di regola e azione, il promotore cliente riceve una notifica via e-mail e un premio ogni volta che un amico invitato 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 %}

### Aggiungere un premio (condizionale)

Se hai selezionato **Premio ed e-mail** oppure **Premio a livelli ed e-mail**, dovrai configurare il premio. Per le istruzioni di configurazione, consulta la sezione *Crea un premio* in [Configurare il programma Advocate](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/advocate-program/getting-started-with-advocate/configure-your-advocate-program.md).
{% endstep %}

{% step %}

### Verifica la regola

Prima di salvare, la schermata *Revisione* riepiloga 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 una 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 ripetere i passaggi precedenti.
18. Seleziona **Salva** al termine.

<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 le regole e le azioni come una serie di istruzioni «se-allora». Vediamo alcuni esempi.

| Risultato desiderato                                                                                                                                                                                  | Se (regola)                                          | Allora (azione)                                                                                   |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| Premiare il promotore cliente con una carta regalo da 20 $ ogni 5 lead qualificati che segnala                                                                                                        | L’amico invitato diventa un lead qualificato         | Premio ed e-mail                                                                                  |
| Premiare l'amico segnalato con un credito di 100 $ al momento della registrazione iniziale e il promotore cliente 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 e-mail (promotore cliente)</li><li>Premio ed e-mail (amico segnalato)</li></ul> |
| Inviare un'e-mail di notifica al promotore cliente quando la persona segnalata completa una demo.                                                                                                     | L’amico invitato 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.
