> 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 esaminare e risolvere discrepanze, errori o problemi relativi ai singoli referral del tuo programma. Sono particolarmente utili per rispondere alle domande dei partecipanti sullo stato dei referral, sull’idoneità e sui premi.

Segui questi passaggi per esaminare un referral in modo efficace:

&#x20;<img src="https://1651675991-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpVKEIcehMut8QKRmaUZu%2Fuploads%2FiaGgKM32jOcur3x3IZNO%2Fai-sparkles.svg?alt=media&amp;token=65c2c155-b61d-45f8-990e-c349f0d7afdc" alt="" data-size="original"> ask impact supports this feature in chat.

{% hint style="info" %}
**Suggerimento:** Prova a chiedere ad ask impact:

* *Ho bisogno di aiuto per un premio referral mancante.*
  {% endhint %}

{% stepper %}
{% step %}

## **Esamina le regole del programma**

Prima di esaminare un referral specifico, consulta le [Regole del programma](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/advocate-program/getting-started-with-advocate/advocate-program-rules-explained.md) per capire:

* Cosa viene considerato una conversione (ad es., *Closed Won*, *Purchase Event*, *Demo Completed*)
* Quali eventi attivano l’invio di email e l’assegnazione dei premi
* Ritardi o condizioni, ad esempio un periodo di idoneità di 90 giorni
* Limiti ai premi, ad esempio il numero massimo di premi per advocate

Puoi trovare le regole selezionando ![](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] → Program Rules** nel tuo programma Advocate.
{% endstep %}

{% step %}

## **Raccogliere 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 dei partecipanti](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/filter-and-manage-advocate-participants.md).
{% endstep %}

{% step %}

## **Verificare il collegamento al referral**

Nel *Feed dei partecipanti*:

1. Individua il profilo dell’advocate.
2. Scorri fino alla sezione *Referral* .
3. Verifica che:
   * L’utente segnalato sia presente nell’elenco
   * Lo stato del referral sia **Started**

Se non trovi alcun referral, è possibile che il link di condivisione non sia stato utilizzato correttamente o che l’attribuzione non sia riuscita.
{% endstep %}

{% step %}

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

Apri la scheda del partecipante segnalato e:

1. Scorri verso il basso fino alla sezione *Events* .
2. Usa il menu a discesa per selezionare **All Events**.
3. Cerca gli eventi che corrispondono ai [criteri di conversione del programma](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/advocate-program/getting-started-with-advocate/advocate-program-rules-explained.md) (ad es., Closed Won, Appointment Set, Demo Completed).

Verifica che l’evento:

* Sia stato ricevuto da Advocate (tramite UTT, API o un’integrazione)
* Si sia verificato entro l’intervallo di tempo previsto
* Soddisfi tutti i criteri di idoneità (ad es., prodotto o fase dell’opportunità corretti)
  {% endstep %}

{% step %}

## **Verificare l’assegnazione del premio**

Tornando al *Feed dei partecipanti*, consulta la sezione [*Premi*](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/reward-feed-explained.md) sia per l'ambasciatore sia per l'utente segnalato.

Verifica che:

* Sia stato assegnato un premio
* Il tipo e l'importo del premio corrispondano alle regole del programma

Se utilizzi le [gift card Tango](https://help.impact.com/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 l'assistenza Tango.

Se è stato assegnato un premio, ma il partecipante dichiara di non vederlo, probabilmente il premio è corretto e il problema riguarda il modo in cui il saldo gli viene mostrato. Esegui queste verifiche nell'ordine indicato:

1. **Il componente delle statistiche è collegato al tuo programma.** Seleziona il componente nell'editor dei widget, espandi *Impostazioni aggiuntive*, quindi verifica che il tuo programma Advocate sia selezionato nel menu a discesa *ID programma* . I componenti che recuperano dati specifici del programma, come le statistiche utente, i link e i pulsanti di condivisione e la tabella della cronologia delle segnalazioni, non mostrano nulla finché questa opzione non è impostata.
2. **Stai utilizzando il tipo di widget corretto.** Un widget globale attinge a più programmi Advocate e non può essere associato a un solo programma. Se gestisci un solo programma, utilizza un widget Verified Access o In-App.
3. **Il filtro dello stato del premio corrisponde a quanto ti aspetti.** Un componente impostato su *Disponibile* non mostrerà i premi ancora in fase di *In sospeso* durante il periodo di compensazione. Consulta [Spiegazione delle statistiche di widget e micrositi](https://help.impact.com/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 dei pagamenti mostra l'importo attualmente disponibile per il pagamento, non i guadagni complessivi del partecipante. Una volta trasferito un pagamento sul conto partner impact.com del partecipante, questo non fa più parte della coda dei pagamenti e la statistica torna correttamente a zero.
{% endhint %}
{% endstep %}

{% step %}

## **Esamina le email di segnalazione (se applicabile)**

Se un utente dichiara di aver ricevuto un'email inattesa o poco chiara, esamina le email del 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. Esamina quali email vengono inviate in ciascuna fase della segnalazione.
3. Seleziona **Modifica** per visualizzare un'anteprima del contenuto dell'email (non è necessario salvare le modifiche).

Fraintendimenti comuni:

* «La tua segnalazione è stata accettata» spesso significa che il lead ha soddisfatto i requisiti, non che la segnalazione si è convertita
* A volte gli ambasciatori confondono le email sullo stato della segnalazione con le notifiche di conversione

Per rendere il messaggio più chiaro, valuta di aggiornare gli oggetti delle email o aggiungere [tag di fusione](https://help.impact.com/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. il nome della persona segnalata) per personalizzare il messaggio. Personalizza le [email del programma per gli ambasciatori](https://help.impact.com/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 l'assistenza se:

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

Per contattare l’assistenza:

1. Contattaci [inviando un ticket](https://app.impact.com/secure/advertiser/support/customer-support-portal-flow.ihtml?) oppure scrivendo a [supporto](mailto:saasquatch-support@impact.com).
2. Fornisci le seguenti informazioni:
   * Indirizzo email dell’ambasciatore o dell’utente che ha segnalato
   * Data approssimativa della segnalazione
   * 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.
