> 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/best-practices-for-referral-programs/troubleshoot-your-advocate-referrals.md).

# Risolvi i problemi dei referral Advocate

Advocate offre diversi strumenti per aiutarti a indagare e risolvere discrepanze, errori o problemi relativi ai referral individuali nel tuo programma. Questo è particolarmente utile quando gestisci le domande dei partecipanti sullo stato del referral, sull’idoneità e sui premi.

Segui questi passaggi per indagare efficacemente su un referral:

{% stepper %}
{% step %}

## **Rivedi le regole del tuo programma**

Prima di approfondire un referral specifico, rivedi prima le tue [Regole del programma](/brand/it/what-would-you-like-to-learn-about/advocate-program/getting-started-with-advocate/advocate-program-rules-explained.md) per capire:

* Cosa conta come conversione (ad es., *Chiuso-Vinto*, *Evento di acquisto*, *Demo completata*)
* Quali eventi attivano le email e la distribuzione dei premi
* Ritardi o condizioni, come una finestra di qualificazione di 90 giorni
* Limiti dei premi, come un numero massimo di premi per advocate

Puoi trovare le tue regole andando su ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage] → Regole del programma** nel tuo programma Advocate.
{% endstep %}

{% step %}

## **Raccogli le informazioni del partecipante**

Per iniziare l’indagine, raccogli almeno uno dei seguenti identificativi del partecipante:

* Indirizzo email
* Account Advocate o ID utente

Usa queste informazioni per cercare nel [Feed partecipanti](/brand/it/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/filter-and-manage-advocate-participants.md).
{% endstep %}

{% step %}

## **Conferma il collegamento del referral**

Nel *Feed partecipanti*:

1. Individua il profilo dell’advocate.
2. Scorri fino alla *Referral* sezione.
3. Conferma che:
   * L’utente segnalato è elencato
   * Lo stato del referral è **Avviato**

Se non viene trovato alcun referral, è possibile che il sharelink non sia stato usato correttamente oppure che l’attribuzione non sia riuscita.
{% endstep %}

{% step %}

## **Controlla i criteri delle regole del programma**

Apri la scheda partecipante dell’utente segnalato e:

1. Scorri verso il basso fino alla *Eventi* sezione.
2. Usa il menu a discesa per passare a **Tutti gli eventi**.
3. Cerca eventi che corrispondano ai [criteri di conversione del tuo programma](/brand/it/what-would-you-like-to-learn-about/advocate-program/getting-started-with-advocate/advocate-program-rules-explained.md) (ad es., Chiuso-Vinto, Appuntamento fissato, Demo completata).

Conferma che l’evento:

* Sia stato ricevuto in Advocate (tramite UTT, API o un’integrazione)
* Si sia verificato entro la finestra temporale richiesta
* Corrisponda a tutti i criteri di qualificazione (ad es., prodotto corretto o fase dell’opportunità)
  {% endstep %}

{% step %}

## **Conferma l’assegnazione del premio**

Tornando al *Feed partecipanti*, rivedi la [*sezione Ricompense*](/brand/it/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/reward-feed-explained.md) sezione per l’advocate e per l’utente segnalato.

Verifica che:

* È stato assegnato un premio
* Il tipo e l’importo del premio siano in linea con le regole del tuo programma

Se utilizzi [gift card Tango](/brand/it/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/gift-card-rewards-explained.md), verifica che il partecipante abbia ricevuto un’email da Tango. Per confermare la consegna, accedi al tuo account Tango o contatta il supporto Tango.

Se un premio è stato assegnato ma il partecipante segnala di non vederlo, è probabile che il premio sia corretto e che il problema riguardi il modo in cui il saldo viene mostrato. Controlla questi punti in ordine:

1. **Il componente statistico è collegato al tuo programma.** Seleziona il componente nell’editor dei widget, espandi *Impostazioni aggiuntive*, e conferma che il tuo programma Advocate sia selezionato nel *ID programma* menu a discesa. I componenti che estraggono dati specifici del programma — statistiche utente, link di condivisione, pulsanti di condivisione e la tabella della cronologia dei referral — non mostrano nulla finché questo non viene impostato.
2. **Stai utilizzando il tipo di widget corretto.** Un widget globale attinge a più programmi Advocate e non può essere associato a uno solo. Se gestisci un solo programma, usa invece un widget Verified Access o In-App.
3. **Il filtro dello stato del premio corrisponde a quanto ti aspetti.** Un componente impostato su *Disponibili* non mostrerà i premi che sono ancora in un *In sospeso* periodo di elaborazione. Vedi [Spiegazione delle statistiche di widget e microsito](/brand/it/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/widget-and-microsite-statistics-explained.md).

{% hint style="info" %}
**Nota:** La statistica del saldo pagamenti mostra l'importo attualmente disponibile per essere pagato, non i guadagni complessivi di un partecipante. Una volta che un pagamento viene trasferito all'account partner impact.com di un partecipante, esce dalla coda dei pagamenti e la statistica torna correttamente a zero.
{% endhint %}
{% endstep %}

{% step %}

## **Rivedi le email di referral (se applicabile)**

Se un utente segnala di aver ricevuto un’email inaspettata o poco chiara, rivedi le email del tuo programma per assicurarti che il messaggio sia chiaro:

1. Vai a ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage]** → **Regole del programma → Email**.
2. Verifica quali email vengono attivate in ogni fase del referral.
3. Seleziona **Modifica** per visualizzare in anteprima il contenuto dell’email (non è necessario salvare le modifiche).

Fraintendimenti comuni:

* “Il tuo referral è stato accettato” spesso significa che il lead si è qualificato, non che il referral sia convertito
* Gli advocate a volte confondono le email sullo stato del referral con le notifiche di conversione

Valuta di migliorare la chiarezza aggiornando le righe dell’oggetto o aggiungendo [tag di unione](/brand/it/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/email-experiences/merge-tags-for-program-emails.md) (ad es., nome del referral) per la personalizzazione. Personalizza le tue [email del programma advocate](/brand/it/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/email-experiences/create-and-customize-advocate-program-emails.md).
{% endstep %}

{% step %}

## **Contatta l'assistenza**

Contatta il supporto se:

* Mancano gli eventi di conversione previsti
* Le email sono state inviate in modo errato
* I premi non sono stati attivati nonostante i criteri siano stati soddisfatti

Per contattare il supporto:

1. Contatta il supporto tramite [l’invio di un ticket](https://app.impact.com/secure/advertiser/support/customer-support-portal-flow.ihtml?) oppure inviando un’email a [supporto](mailto:saasquatch-support@impact.com).
2. Fornisci le seguenti informazioni:
   * Email dell’advocate o dell’utente segnalato
   * Data approssimativa del referral
   * Descrizione dettagliata del problema
     {% endstep %}
     {% endstepper %}


---

# 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/best-practices-for-referral-programs/troubleshoot-your-advocate-referrals.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.