# Spiegazione dei Report del Programma Advocate

<a href="https://pxa.impact.com/student/activity/1687872?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>

Advocate offre vari report scaricabili per i dati del tuo programma e dei partecipanti. Tutti i report hanno opzioni di filtro per permetterti un maggiore controllo sui dati che scarichi. Ogni report può essere scaricato come file .CSV o Excel.

Questo articolo spiega i diversi report e quale tipo di dati ciascuno include. Consulta [Esegui un report del programma Advocate](https://help.impact.com/brand/it/advocate-program/advocate-reporting-and-analytics/run-an-advocate-program-report) per le istruzioni su come generare un report.

#### Report dettagli utente

Il *report Dettagli utente* contiene informazioni dettagliate su ogni partecipante in tutti i tuoi programmi. Esporta un elenco di tutti i partecipanti per mantenere aggiornati i tuoi record con i link di condivisione e i codici di referral di Advocate.

<details>

<summary>Dettagli del report</summary>

Per impostazione predefinita, il report includerà informazioni sul partecipante come:

* Nome
* ID utente e ID account
* Indirizzo email
* Campi personalizzati
* Segmenti
* Informazioni sul referral (se applicabile)

Quando generi il report, puoi facoltativamente includere:

* **Statistiche utente**, incluse informazioni analitiche sul partecipante come traffico, entrate e altro.
* **Link e codici di condivisione per i referral**, se applicabile. Queste informazioni possono essere utili per aggiornare i record di contatto nel tuo CMS o sistema di posta elettronica per includere i link e i codici di condivisione di ciascun partecipante.

Un elenco completo dei campi può essere trovato quando [scarichi il nostro CSV di esempio](https://assets.ctfassets.net/s68ib1kj8k5n/7Am85AH6wmNdArmjRNW3vr/95f52c5d79311509d795a0be4c94166f/User_Details_Report_Sample.csv) ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media) del report dettagli utente.

**Riferimento colonne del report**

| Colonna                                               | Descrizione                                                                                                                                                                                                |
| ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Informazioni utente**                               |                                                                                                                                                                                                            |
| ID                                                    | L'identificatore univoco per il partecipante all'interno del sistema Advocate.                                                                                                                             |
| ID account                                            | L'identificatore univoco per l'account del partecipante (utilizzato in più programmi se applicabile).                                                                                                      |
| Email                                                 | L'indirizzo email del partecipante.                                                                                                                                                                        |
| Nome                                                  | Il nome del partecipante.                                                                                                                                                                                  |
| Cognome                                               | Il cognome del partecipante.                                                                                                                                                                               |
| Hash email                                            | Una versione hashata (crittografata) dell'email del partecipante, utile per il matching conforme alla privacy con altri sistemi.                                                                           |
| **Informazioni sui referral e sulla condivisione**    |                                                                                                                                                                                                            |
| Codice referral                                       | Il codice univoco legato al partecipante, usato per tracciare i referral che genera.                                                                                                                       |
| Link di condivisione                                  | Il link di referral univoco associato al partecipante.                                                                                                                                                     |
| Link di condivisione Facebook                         | Un link pre-generato per condividere il referral su Facebook.                                                                                                                                              |
| Link di condivisione Twitter                          | Un link pre-generato per condividere il referral su Twitter.                                                                                                                                               |
| Link di condivisione via email                        | Un link pre-generato per condividere il referral via email.                                                                                                                                                |
| Link di condivisione LinkedIn                         | Un link pre-generato per condividere il referral su LinkedIn.                                                                                                                                              |
| Link di condivisione pulito                           | Una versione del link di referral senza parametri di tracciamento; più neutra per alcune piattaforme o casi d'uso.                                                                                         |
| **Geolocalizzazione e impostazioni locali**           |                                                                                                                                                                                                            |
| IP visto per la prima volta                           | L'indirizzo IP dal quale il partecipante è stato registrato per la prima volta.                                                                                                                            |
| IP visto per l'ultima volta                           | L'indirizzo IP più recente registrato per questo partecipante.                                                                                                                                             |
| Locale                                                | La lingua preferita e le impostazioni regionali del partecipante (es., en-US).                                                                                                                             |
| Codice paese                                          | Il paese del partecipante basato sul locale o sull'indirizzo IP (es., ZA, US).                                                                                                                             |
| **Timestamp**                                         |                                                                                                                                                                                                            |
| Data di creazione                                     | La data e l'ora in cui l'account del partecipante è stato creato in Advocate.                                                                                                                              |
| Data invio modulo fiscale USA                         | (Se applicabile) La data in cui è stato inviato un modulo fiscale statunitense per conformità o elaborazione delle ricompense.                                                                             |
| **Statistiche utente (se incluse nell'esportazione)** |                                                                                                                                                                                                            |
| stats.date Modified                                   | L'ultima data in cui le statistiche del partecipante sono state aggiornate.                                                                                                                                |
| stats.traffic                                         | Numero totale di visite generate dall'attività di referral del partecipante.                                                                                                                               |
| stats.referrals                                       | Numero totale di referral riusciti effettuati dal partecipante.                                                                                                                                            |
| stats.conversions                                     | Numero totale di conversioni (es., acquisti, iscrizioni) risultanti da quei referral.                                                                                                                      |
| stats.goals                                           | Numero di completamenti di obiettivi specifici associati all'attività di referral del partecipante (definiti personalizzati nel programma).                                                                |
| stats.rewards                                         | Numero totale di ricompense che il partecipante ha guadagnato.                                                                                                                                             |
| stats.widget Loads                                    | Numero di volte in cui il widget di referral o l'interfaccia di condivisione è stata caricata da questo partecipante.                                                                                      |
| stats.revenue                                         | Entrate totali generate dagli utenti che sono stati referenziati da questo partecipante.                                                                                                                   |
| stats.generated Revenue                               | Sinonimo di stats.revenue; alcuni report possono distinguere se le entrate provengono da più fonti.                                                                                                        |
| stats.referred Revenue                                | Entrate attribuite specificamente agli utenti che si sono iscritti o hanno acquistato tramite il link di referral di questo partecipante.                                                                  |
| **Dati personalizzati**                               |                                                                                                                                                                                                            |
| custom Fields.example                                 | Un segnaposto per eventuali campi personalizzati definiti dal tuo programma (es., *ID fedeltà*, *note interne*, *tag regione*). Ogni campo apparirà come una colonna separata, con prefisso custom Fields. |
| **Altro**                                             |                                                                                                                                                                                                            |
| Fonte del referral                                    | La fonte o il canale originale che ha portato il partecipante al tuo programma (es., *organico*, *email*, *sito partner*).                                                                                 |

</details>

#### Esportazione eventi utente

Il *Esportazione eventi utente* il report fornisce un registro di tutti gli eventi utente che abbiamo ricevuto dalla tua organizzazione per il tuo programma Advocate. Puoi applicare filtri per restringere un intervallo di tempo, la chiave dell'evento, l'ID utente e altro.

<details>

<summary>Dettagli del report</summary>

Per impostazione predefinita, il report include:

* ID evento
* Chiave evento
* ID utente e ID account
* Data attivazione
* Data ricevuta
* Data elaborata

**Riferimento colonne del report**

| Colonna                                                     | Descrizione                                                                                                                                                                                           |
| ----------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Informazioni sull'evento e sull'utente**                  |                                                                                                                                                                                                       |
| ID evento                                                   | Un ID univoco generato per ogni evento ricevuto. Utile per tracciamento, debug o controllo degli invii di eventi.                                                                                     |
| Chiave evento                                               | Il tipo o l'etichetta dell'evento, come `acquisto`, `iscrizione`, o qualsiasi chiave personalizzata che il tuo sistema invia.                                                                         |
| ID utente                                                   | L'identificatore univoco del partecipante in Advocate a cui l'evento è associato.                                                                                                                     |
| ID account                                                  | L'ID account legato all'utente, particolarmente rilevante nei programmi in cui gli utenti possono appartenere a diverse strutture di account.                                                         |
| **Timestamp dell'evento**                                   |                                                                                                                                                                                                       |
| Data evento attivato – YYYY-MM-DD                           | La data in cui l'evento è realmente avvenuto (come riportato dal tuo sistema). Per esempio, la data in cui è avvenuto un acquisto o un'iscrizione.                                                    |
| Data evento ricevuta – YYYY-MM-DD                           | La data in cui Advocate ha ricevuto l'evento dal tuo sistema. Può differire dalla data di attivazione a causa di batching o ritardi di sistema.                                                       |
| Data evento elaborata – YYYY-MM-DD                          | La data in cui l'evento è stato elaborato e memorizzato con successo in Advocate. Indica quando l'evento è diventato utilizzabile per tracciamento, ricompense o reportistica.                        |
| **Campi dati evento (se inclusi nei payload degli eventi)** |                                                                                                                                                                                                       |
| fields.coupon                                               | Qualsiasi coupon o codice sconto applicato durante l'evento, se inviato nei dati dell'evento. Utile per tracciare l'uso di incentivi o trigger di promozioni specifiche.                              |
| fields.revenue                                              | L'ammontare di entrate associate all'evento. Tipicamente usato negli eventi di acquisto per calcolare performance, ricompense o ROI.                                                                  |
| fields.currency                                             | Il codice valuta (es., *USD*, *ZAR*, *EUR*) associato all'importo delle entrate. Importante quando si riportano dati tra regioni o si calcolano ricompense adeguate al cambio.                        |
| fields.lead Created Date                                    | La data originale in cui il lead (utente) è stato creato nel tuo sistema, se inviato come parte dell'evento. Aiuta a collegare gli eventi utente alle date di acquisizione originali o ai record CRM. |

</details>

#### Storico ricompense

Il *Storico ricompense* il report fornisce un registro dettagliato di ciascuna delle tue ricompense e delle relazioni con partecipanti e referral. Queste informazioni possono essere utili per creare bilanci, oltre a ottenere lo stato di tutte le tue ricompense in un determinato momento.

<details>

<summary>Dettagli del report</summary>

Per impostazione predefinita, il report includerà **campi ricompensa** informazioni come:

* ID ricompensa
* Tipo di ricompensa
* Valore ricompensa

Un elenco completo dei campi inclusi può essere trovato quando [scarichi il nostro CSV di esempio](https://assets.ctfassets.net/s68ib1kj8k5n/7E5DNWKrh7iQMNGYQBWRiS/3ae6c7a9109542215763a07a18cb0494/Reward_Details_Example_Report_CSV.csv), [Excel di esempio](https://assets.ctfassets.net/s68ib1kj8k5n/2MQjc4XjXGPNhsv10tHal6/dc40679812b99d0aef4ace46a780e1ee/Reward_Details_Example_Report_XLSX.xlsx) ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media) o [JSONL di esempio](https://assets.ctfassets.net/s68ib1kj8k5n/5BeuDmYM1WFAySjqntGeji/f321cf59a96d45061645d971e06fb569/Reward_Details_Example_Report_JSONL.jsonl) ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media) report dettagli ricompense.

Quando generi il report, puoi facoltativamente includere:

* **Dettagli partecipante** come nome, ID utente e account, indirizzo email, campi personalizzati, segmenti e informazioni sul referral (se applicabile).
* **Campi referral** come ID referral, campi del cliente advocate, campi dell'amico referenziato e altro.

**Riferimento colonne del report**

| Colonna                                                                                                            | Descrizione                                                                                                                                                                     |
| ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Informazioni sulla ricompensa**                                                                                  |                                                                                                                                                                                 |
| ID                                                                                                                 | ID univoco dell'istanza di ricompensa (generato da Advocate).                                                                                                                   |
| Tipo                                                                                                               | La categoria o il tipo di ricompensa (es. *Contanti*, *Carta regalo*, *Coupon*, *Personalizzato*).                                                                              |
| Valore                                                                                                             | Il valore numerico della ricompensa (es., 10, 100, ecc.).                                                                                                                       |
| Unità                                                                                                              | L'unità associata al valore (es., *USD*, *punti*, *ZAR*, *%*).                                                                                                                  |
| Nome                                                                                                               | Nome visualizzato della ricompensa (come definito nella [configurazione della ricompensa](https://help.impact.com/brand/it/advocate-program/advocate-rewards/create-a-reward)). |
| Fonte della ricompensa                                                                                             | Descrive cosa ha attivato la ricompensa (es., *Referral*, *Obiettivo*, *Manuale*, *API*).                                                                                       |
| Tipo Fuel Tank                                                                                                     | Il tipo di fondo ricompense utilizzato (se si utilizza l'integrazione FuelTank). Es., *Prepagato*, *Carta regalo*.                                                              |
| Codice Fuel Tank                                                                                                   | Il codice associato all'evasione esterna (es., codice voucher o carta regalo).                                                                                                  |
| ID programma                                                                                                       | ID del programma Advocate sotto il quale la ricompensa è stata emessa.                                                                                                          |
| Chiave ricompensa programma                                                                                        | Identificatore interno per la specifica configurazione della ricompensa utilizzata all'interno del programma.                                                                   |
| Chiave ricompensa globale                                                                                          | Identificatore cross-program per le ricompense configurate a livello globale (se applicabile).                                                                                  |
| **Timestamp della ricompensa**                                                                                     |                                                                                                                                                                                 |
| Data di creazione                                                                                                  | Quando il record della ricompensa è stato creato nel sistema.                                                                                                                   |
| Data programmata per                                                                                               | Quando la ricompensa era programmata per essere emessa (es., dopo un ritardo o un periodo di attesa).                                                                           |
| Data assegnata                                                                                                     | Quando la ricompensa è stata effettivamente emessa al partecipante.                                                                                                             |
| Data di scadenza                                                                                                   | La data di scadenza della ricompensa (se applicabile).                                                                                                                          |
| Data annullata                                                                                                     | La data in cui la ricompensa è stata annullata o annullata.                                                                                                                     |
| Data riscattata                                                                                                    | La data in cui il partecipante ha riscattato la ricompensa (se applicabile).                                                                                                    |
| Data modificata                                                                                                    | La data in cui è stato effettuato l'ultimo aggiornamento al record della ricompensa.                                                                                            |
| **Tracciamento crediti e valore**                                                                                  |                                                                                                                                                                                 |
| Credito assegnato                                                                                                  | L'importo di credito assegnato a questa ricompensa (può differire dal valore in alcuni modelli).                                                                                |
| Credito riscattato                                                                                                 | L'importo di credito che è stato riscattato dalla ricompensa.                                                                                                                   |
| Valore disponibile                                                                                                 | La porzione rimanente non utilizzata o non riscattata della ricompensa.                                                                                                         |
| **Stato e messaggi della ricompensa**                                                                              |                                                                                                                                                                                 |
| Stati                                                                                                              | Stato corrente della ricompensa (es., *In sospeso*, *Programmato*, *Erogato*, *Scaduto*, *Annullato*).                                                                          |
| meta.status                                                                                                        | Stato tecnico o a livello di sistema (utile per diagnostica o gestione degli errori).                                                                                           |
| meta.message                                                                                                       | Messaggio legato alla consegna della ricompensa (es., “Ricompensa consegnata con successo”).                                                                                    |
| meta.internal Message                                                                                              | Note interne visibili solo agli amministratori (es., spiegazioni di errori o flag).                                                                                             |
| meta.date Modified                                                                                                 | Ultima volta in cui i metadati relativi alla ricompensa sono stati aggiornati.                                                                                                  |
| meta.customMeta.testMeta                                                                                           | Un segnaposto per eventuali campi di metadati personalizzati che il tuo programma invia (in questo caso, testMeta è un esempio).                                                |
| **Informazioni sul partecipante (utente)**                                                                         |                                                                                                                                                                                 |
| user.id                                                                                                            | ID dell'utente che riceve la ricompensa.                                                                                                                                        |
| user.account Id                                                                                                    | L'ID account associato all'utente in Advocate.                                                                                                                                  |
| <p>user.first Name</p><p>user.last Name</p><p>user.email</p>                                                       | Informazioni di base sul partecipante incluse per riferimento o per il matching CRM.                                                                                            |
| **Contesto del referral (se la ricompensa è basata su referral)**                                                  |                                                                                                                                                                                 |
| referral.id                                                                                                        | L'ID del referral che ha attivato questa ricompensa.                                                                                                                            |
| referral.date Referral Started                                                                                     | Quando l'azione di referral è iniziata (es., evento di click o condivisione).                                                                                                   |
| referral.date Modified                                                                                             | Quando il record del referral è stato aggiornato l'ultima volta.                                                                                                                |
| referral.referral Code Used                                                                                        | Il codice che l'utente referenziato ha usato per iscriversi o compiere l'azione.                                                                                                |
| **Informazioni sull'utente referenziato (amico)**                                                                  |                                                                                                                                                                                 |
| referral.referred User.id                                                                                          | ID della persona che è stata referenziata (l'“amico”).                                                                                                                          |
| referral.referred User.account Id                                                                                  | L'ID account univoco del referenziato.                                                                                                                                          |
| <p>referral.referred User.first Name</p><p>referral.referred User.last Name</p><p>referral.referred User.email</p> | Dettagli di contatto di base del referenziato.                                                                                                                                  |
| **Informazioni sul referrer (Advocate)**                                                                           |                                                                                                                                                                                 |
| referral.referrer User.id                                                                                          | ID della persona che ha effettuato il referral (l'“advocate”).                                                                                                                  |
| referral.referrer User.account Id                                                                                  | L'ID account univoco del referenziato.                                                                                                                                          |
| <p>referral.referrer User.first Name</p><p>referral.referrer User.last Name</p><p>referral.referrer User.email</p> | Dettagli di contatto di base del referenziato.                                                                                                                                  |
| referral.date Converted                                                                                            | La data in cui il referral si è ufficialmente convertito (es., completamento di iscrizione o acquisto), attivando la ricompensa.                                                |

</details>

#### Storico referral

Il *Storico referral* il report fornisce un registro dello stato di ogni connessione referral effettuata nel tuo programma di referral. Queste informazioni possono essere utili per verificare il successo del tuo programma e tracciare il numero di nuovi clienti acquisiti dal programma.

<details>

<summary>Dettagli del report</summary>

Per impostazione predefinita, il report include:

* Dettagli dell'amico referenziato come nome, ID utente e account, indirizzo email e altro
* Dettagli del cliente advocate come nome, ID utente e account, indirizzo email e altro
* Stato del referral
* Stato di moderazione
* ID delle ricompense

Un elenco completo dei campi può essere trovato quando [scarichi il nostro CSV di esempio](https://assets.ctfassets.net/s68ib1kj8k5n/7B4pBHawfu9GtzE5mL1yo2/4fd194ee3080c5190639abab70b35e47/Referral_Activity_Report.csv) ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media) report attività referral.

**Riferimento colonne del report**

| Colonna                                                                                                      | Descrizione                                                                                                                                 |
| ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------- |
| **Metadati del referral**                                                                                    |                                                                                                                                             |
| ID                                                                                                           | Identificatore univoco del record referral in Advocate.                                                                                     |
| Data modificata                                                                                              | La data più recente in cui qualsiasi parte del record referral è stata aggiornata.                                                          |
| Data inizio referral                                                                                         | Quando il referral è stato avviato per la prima volta (es., quando l'utente referenziato ha cliccato un link di referral).                  |
| Data conversione                                                                                             | Quando il referral si è convertito, tipicamente quando l'utente referenziato ha completato l'azione richiesta (come iscrizione o acquisto). |
| Data ultima modifica utente                                                                                  | L'ultima volta in cui i dati utente coinvolti in questo referral (referrer o referenziato) sono stati aggiornati.                           |
| ID programma                                                                                                 | L'ID del programma referral Advocate a cui questo referral appartiene.                                                                      |
| Nome programma                                                                                               | Il nome del programma di referral, utile se si gestiscono più programmi.                                                                    |
| **Informazioni sull'amico referenziato (nuovo cliente)**                                                     |                                                                                                                                             |
| <p>Email utente referenziato</p><p>Nome utente referenziato</p><p>Cognome utente referenziato</p>            | Informazioni di identità di base dell'utente referenziato.                                                                                  |
| Codice referral utente referenziato                                                                          | Il codice di referral assegnato all'utente referenziato (nel caso possa anche referire altri in seguito).                                   |
| <p>IP visto per la prima volta utente referenziato</p><p>IP visto per l'ultima volta utente referenziato</p> | Indirizzi IP registrati alla prima e all'ultima attività dell'utente referenziato.                                                          |
| URL immagine utente referenziato                                                                             | URL dell'immagine o dell'avatar, se acquisita o assegnata all'utente referenziato.                                                          |
| Locale utente referenziato                                                                                   | Impostazione lingua/regione (es., *en-US*, *fr-FR*) dell'utente referenziato.                                                               |
| Data creazione utente referenziato                                                                           | La data in cui l'account dell'utente referenziato è stato creato in Advocate.                                                               |
| Utente referenziato                                                                                          | ID interno dell'utente referenziato nel sistema Advocate.                                                                                   |
| Account referenziato                                                                                         | ID account interno collegato all'utente referenziato (usato in programmi multi-account).                                                    |
| **Informazioni sul referrer (cliente advocate)**                                                             |                                                                                                                                             |
| <p>Email utente referrer</p><p>Nome utente referrer</p><p>Cognome utente referrer</p>                        | Informazioni di identità di base del partecipante che fa da referrer.                                                                       |
| Codice referral utente referrer                                                                              | Il codice di referral appartenente al referrer, il codice che l'utente referenziato probabilmente ha usato.                                 |
| <p>IP visto per la prima volta utente referrer</p><p>IP visto per l'ultima volta utente referrer</p>         | Indirizzi IP registrati alla prima e all'ultima attività del referrer.                                                                      |
| URL immagine utente referrer                                                                                 | L'URL dell'immagine o dell'avatar del referrer.                                                                                             |
| Locale utente referrer                                                                                       | Impostazione locale del referrer.                                                                                                           |
| Data creazione utente referrer                                                                               | Quando il referrer si è iscritto per la prima volta o è stato registrato nel sistema.                                                       |
| Utente referrer                                                                                              | ID interno del referrer in Advocate.                                                                                                        |
| Account referrer                                                                                             | ID account associato al referrer.                                                                                                           |
| **Moderazione e stato**                                                                                      |                                                                                                                                             |
| Stato moderazione                                                                                            | Stato complessivo di moderazione del referral. (Es., *Approvato*, *Respinto*, *In sospeso*.)                                                |
| Data moderazione                                                                                             | La data in cui è stata presa la decisione di moderazione (approvazione/rifiuto).                                                            |
| Data pagamento referral                                                                                      | Quando qualsiasi ricompensa associata è stata pagata per il referral.                                                                       |
| Data fine referral                                                                                           | Quando il record del referral è stato ufficialmente chiuso (es., per scadenza o completamento).                                             |
| Stato moderazione referenziato                                                                               | Stato di moderazione specifico per la parte del referenziato nel referral.                                                                  |
| Stato moderazione referrer                                                                                   | Stato di moderazione specifico per la parte del referrer nel referral.                                                                      |
| **Riferimenti alle ricompense**                                                                              |                                                                                                                                             |
| Ricompensa del referenziato                                                                                  | L'ID della ricompensa o il riferimento emesso all'utente referenziato (se applicabile).                                                     |
| Ricompensa del referrer                                                                                      | L'ID della ricompensa o il riferimento emesso al referrer (se applicabile).                                                                 |

</details>

#### Sald i ricompense per utente

Il *Sald i ricompense per utente* il report fornisce un registro delle ricompense in sospeso, compreso il valore e il destinatario previsto, generate tramite il tuo programma di referral. Questo report è spesso utilizzato come parte dell'evasione manuale delle ricompense, o come parte di un processo batch verso un sistema come Tango Card. Può anche essere utile per tracciare quanto il tuo programma di referral ha pagato in un dato periodo.

<details>

<summary>Dettagli del report</summary>

Per impostazione predefinita, il report include:

* Dettagli partecipante come nome, ID utente e account, indirizzo email e altro
* Tipo di ricompensa
* Unità della ricompensa
* Importo della ricompensa

Un elenco completo dei campi può essere trovato quando [scarichi il nostro CSV di esempio](https://assets.ctfassets.net/s68ib1kj8k5n/5iv0ByBQquLwShSyRjawck/e04b55a4e5afe24c01d5192c10682aab/Reward_Balances_by_User.csv) ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media) report saldi ricompense.

**Riferimento colonne del report**

| Colonna                           | Descrizione                                                                                                                                                                                            |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Informazioni sul partecipante** |                                                                                                                                                                                                        |
| ID utente                         | L'identificatore univoco del partecipante all'interno di Advocate. Usato per collegare il saldo della ricompensa all'utente individuale.                                                               |
| ID account                        | L'ID account interno associato al partecipante. Particolarmente rilevante se gli utenti appartengono ad organizzazioni o gruppi di account segmentati.                                                 |
| Email                             | L'indirizzo email del partecipante. Spesso usato per l'evasione manuale delle ricompense o per la sincronizzazione con sistemi esterni.                                                                |
| <p>Nome</p><p>Cognome</p>         | Il nome e il cognome del partecipante. Utile per personalizzazione o filtro durante l'elaborazione delle ricompense.                                                                                   |
| Codice referral                   | Il codice referral assegnato al partecipante. Questo è ciò che condividono per riferire altri e tracciare l'idoneità alle ricompense.                                                                  |
| **Informazioni sulla ricompensa** |                                                                                                                                                                                                        |
| Tipo                              | La categoria o il metodo della ricompensa (es., *Contanti*, *Carta regalo*, *Punti*, *Personalizzato*). Aiuta a determinare come le ricompense devono essere evase o raggruppate.                      |
| Unità                             | L'unità del valore della ricompensa (es., *USD*, *ZAR*, *Punti*, *%*). Importante per il calcolo dei saldi e per la gestione dei pagamenti regionali.                                                  |
| Importo                           | Il saldo totale disponibile delle ricompense in sospeso per questo utente. Questa è la cifra principale usata nella preparazione dei pagamenti o delle esportazioni.                                   |
| Credito totale assegnato          | L'importo totale di credito che è stato assegnato a questo utente (indipendentemente dal riscatto). Riflette il costo complessivo del programma allocato a questo partecipante.                        |
| Credito totale riscattato         | La porzione totale di ricompense che questo partecipante ha già riscattato. Utile per verifiche dei costi effettivi rispetto alle passività.                                                           |
| Credito totale scaduto            | Totale delle ricompense assegnate all'utente ma scadute prima del riscatto. Aiuta a tracciare ricompense non reclamate o opportunità di evasione perse.                                                |
| **Metadati utente**               |                                                                                                                                                                                                        |
| URL immagine                      | URL dell'immagine del profilo o avatar del partecipante (se raccolto). Principalmente estetico o usato nelle dashboard rivolte agli utenti, se applicabile.                                            |
| IP visto per la prima volta       | Il primo indirizzo IP registrato quando il partecipante è stato aggiunto o è diventato attivo. Utile per conformità, geotagging o analisi antifrode.                                                   |
| IP visto per l'ultima volta       | L'indirizzo IP più recente associato al partecipante. Aiuta a determinare se l'utente è ancora attivo o coinvolto.                                                                                     |
| Data di creazione                 | La data in cui l'account del partecipante è stato creato in Advocate. Utile per analisi per cohorte o comportamento delle ricompense nel tempo.                                                        |
| Fonte del referral                | La fonte originale o il canale attraverso cui il partecipante è stato acquisito (es., *email*, *organico*, *partner*). Aiuta a valutare la portata e l'efficacia del programma di referral per canale. |
| Locale                            | La lingua e l'impostazione regionale del partecipante (es., *en-US*, *fr-FR*). Importante per comunicazioni personalizzate o opzioni di ricompensa regionali.                                          |

</details>

#### Sald i ricompense disponibili per utente

Il *Sald i ricompense disponibili per utente* il report fornisce un elenco delle ricompense non riscattate. Questo tipo di report è destinato a essere usato come parte dell'evasione delle ricompense tramite il [processo di riscatto ricompense in blocco](https://help.impact.com/brand/it/advocate-program/advocate-rewards/redeem-rewards-in-bulk) .

<details>

<summary>Dettagli del report</summary>

Per impostazione predefinita, il report include:

* Dettagli partecipante come nome, ID utente e account, indirizzo email e altro
* Unità della ricompensa
* Valuta della ricompensa
* Importo disponibile

Un elenco completo dei campi può essere trovato quando [scarichi il nostro CSV di esempio](https://assets.ctfassets.net/s68ib1kj8k5n/7CggBzV2U5EoJqp1HFF5SA/f3b417f460c0d960f8429b26824a225b/Available_Reward_Balances_by_User.csv) ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media) nel report dei saldi ricompense disponibili.

{% hint style="info" %}
**Nota**: Questo report non include dettagli su ricompense Percentuale Sconto, Fuel Tank o Carte regalo. Usa il *Sald i ricompense per utente* report per maggiori dettagli su questi tipi di ricompense.
{% endhint %}

**Riferimento colonne del report**

| Colonna                            | Descrizione                                                                                                                                                                                                                                                                                                |
| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Informazioni sul partecipante**  |                                                                                                                                                                                                                                                                                                            |
| Nome                               | Il nome del partecipante, usato per identificazione o personalizzazione durante l'elaborazione delle ricompense.                                                                                                                                                                                           |
| Cognome                            | Il cognome del partecipante.                                                                                                                                                                                                                                                                               |
| Email                              | L'indirizzo email del partecipante, usato per inviare ricompense o per il matching con sistemi esterni come un CRM o un provider di ricompense.                                                                                                                                                            |
| ID utente                          | L'identificatore univoco assegnato al partecipante all'interno di Advocate.                                                                                                                                                                                                                                |
| ID account                         | L'ID interno dell'account collegato al partecipante.                                                                                                                                                                                                                                                       |
| Segmenti                           | Tag o categorie utilizzate per [raggruppare i partecipanti](https://help.impact.com/brand/it/advocate-program/manage-advocate-participants/manage-advocate-user-segments) (ad es., *per regione*, *fase del ciclo di vita*, *tipo di cliente*). Utile per filtrare o applicare diverse regole di evasione. |
| **Stato e tempi della ricompensa** |                                                                                                                                                                                                                                                                                                            |
| Data di blocco                     | La data in cui l'utente è stato bloccato dal ricevere ricompense, se applicabile. Uno stato di blocco potrebbe impedire il riscatto; questo campo indica quando è stato applicato quel blocco.                                                                                                             |
| **Dati della ricompensa**          |                                                                                                                                                                                                                                                                                                            |
| Nome dell'unità                    | L'etichetta o il nome visualizzato dell'unità di ricompensa (ad es., *Contanti per segnalazione*, *Credito del negozio*). Questo aiuta a distinguere tra più tipi di ricompense che un programma potrebbe offrire.                                                                                         |
| Valuta                             | Il codice valuta del valore della ricompensa (ad es., *USD*, *ZAR*, *EUR*). Necessario quando si evadono le ricompense, specialmente tra paesi o sistemi di pagamento.                                                                                                                                     |
| Valore disponibile                 | L'importo di ricompensa non riscattata attualmente disponibile per questo partecipante. Questo è il valore principale usato per determinare cosa pagare.                                                                                                                                                   |
| Valore da riscattare               | Il valore attualmente in coda per il riscatto (ad es., in attesa in un'evasione in blocco o in attesa di essere elaborato). Utile per evitare doppi riscatti o garantire che non ci siano sovrapposizioni nei riscatti.                                                                                    |
| Valore totale riscattato           | Il valore totale delle ricompense che questo partecipante ha già riscattato. Fornisce informazioni sui riscatti passati e può essere utile per il monitoraggio dei limiti di ricompensa                                                                                                                    |
| Unità                              | Il codice interno o di sistema per l'unità di ricompensa (ad es., *USD*, *punti*, ecc.). Potrebbe essere usato nelle chiamate API o nella logica interna durante l'evasione.                                                                                                                               |

</details>

#### Rapporto fiscale W-9 degli Stati Uniti

Il rapporto fiscale US W-9 mostra lo stato fiscale W-9 dei partecipanti e le ricompense guadagnate o in sospeso per anno.

<details>

<summary>Dettagli del report</summary>

Per impostazione predefinita, il report include:

* Dettagli partecipante come nome, ID utente e account, indirizzo email e altro
* Data in cui il modulo W-9 del partecipante è stato contrassegnato come raccolto
* Valore tassabile negli Stati Uniti delle ricompense guadagnate per anno fiscale
* Numero totale di ricompense guadagnate da ciascun partecipante nell'anno fiscale

**Riferimento colonne del report**

| Colonna                                                                    | Descrizione                                                                                                                                                                                                                                         |
| -------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Informazioni sul partecipante**                                          |                                                                                                                                                                                                                                                     |
| ID utente                                                                  | L'identificatore univoco del partecipante in Advocate.                                                                                                                                                                                              |
| ID account                                                                 | ID account interno associato al partecipante.                                                                                                                                                                                                       |
| Email                                                                      | L'indirizzo email del partecipante.                                                                                                                                                                                                                 |
| Nome                                                                       | Il nome del partecipante.                                                                                                                                                                                                                           |
| Cognome                                                                    | Il cognome del partecipante.                                                                                                                                                                                                                        |
| **Informazioni fiscali W-9**                                               |                                                                                                                                                                                                                                                     |
| <p>Data di invio del modulo fiscale degli Stati Uniti</p><p>AAAA-MM-GG</p> | La data in cui il modulo W-9 del partecipante è stato contrassegnato come inviato e raccolto in Advocate. Importante per la conformità con l'IRS e per verificare lo stato della documentazione fiscale.                                            |
| **Riepilogo per anno fiscale**                                             |                                                                                                                                                                                                                                                     |
| Anno                                                                       | L'anno fiscale in cui il partecipante ha guadagnato le ricompense. Usato per raggruppare le entrate per anno solare per l'elaborazione del 1099.                                                                                                    |
| Valore tassabile negli USA in centesimi                                    | Valore totale delle ricompense soggette a tassazione negli USA guadagnate da questo partecipante nell'anno fiscale specificato, espresso in centesimi (ad es., 2500 = $25,00). Aiuta con calcoli grezzi o integrazioni dove è richiesta precisione. |
| Valore tassabile negli USA in dollari                                      | Stesso valore di cui sopra, ma visualizzato nel formato standard in dollari (ad es., 25,00). Più facile per la revisione o l'inclusione nei riepiloghi ufficiali.                                                                                   |
| Conteggio delle ricompense                                                 | Numero totale di singole occorrenze di ricompensa guadagnate dal partecipante nell'anno fiscale specificato. Utile per tracce di controllo o per comprendere la frequenza delle ricompense e l'impegno nel programma.                               |

</details>

#### Pagamenti e tasse

Il *Pagamento e tasse* il rapporto mostra lo stato fiscale dei partecipanti e le ricompense guadagnate o in sospeso per anno.

Se il tuo programma prevede pagamenti in contanti ai partecipanti, alcuni campi relativi allo stato del modulo fiscale del partecipante saranno resi disponibili.

<details>

<summary>Dettagli del report</summary>

Per impostazione predefinita, il report include:

* Dettagli partecipante come nome, ID utente e account, indirizzo email e altro
* Data in cui il modulo fiscale del partecipante — come un W-8 o W-9 — è stato contrassegnato come inviato
* Valore tassabile negli Stati Uniti delle ricompense guadagnate per anno fiscale
* Numero totale di ricompense guadagnate da ciascun partecipante nell'anno fiscale
* Lo stato del modulo fiscale, ad es., *valido*, *in sospeso*, o *in attesa*. I motivi della sospensione del pagamento sono inclusi anche nel rapporto

**Riferimento colonne del report**

| Colonna                                                                    | Descrizione                                                                                                                                                                                                                                              |
| -------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Informazioni sul partecipante**                                          |                                                                                                                                                                                                                                                          |
| ID utente                                                                  | L'identificatore univoco del partecipante in Advocate.                                                                                                                                                                                                   |
| ID account                                                                 | L'ID account del partecipante, usato per raggruppamenti o report organizzativi.                                                                                                                                                                          |
| Email                                                                      | L'indirizzo email del partecipante.                                                                                                                                                                                                                      |
| Nome                                                                       | Il nome del partecipante.                                                                                                                                                                                                                                |
| Cognome                                                                    | Il cognome del partecipante.                                                                                                                                                                                                                             |
| **Informazioni fiscali W-9**                                               |                                                                                                                                                                                                                                                          |
| <p>Data di invio del modulo fiscale degli Stati Uniti</p><p>AAAA-MM-GG</p> | La data in cui il partecipante ha inviato il proprio modulo W-9 (o modulo fiscale statunitense pertinente). Importante per verificare l'idoneità fiscale prima di emettere pagamenti in contanti.                                                        |
| **Riepilogo annuale dei pagamenti**                                        |                                                                                                                                                                                                                                                          |
| Anno                                                                       | L'anno solare in cui il partecipante ha guadagnato le ricompense.                                                                                                                                                                                        |
| Valore                                                                     | Valore totale dei pagamenti in unità minori (ad es., centesimi) guadagnati o in sospeso per questo partecipante durante l'anno. Per esempio, 1750 = $17,50.                                                                                              |
| Valore in dollari                                                          | Stesso valore, visualizzato nel formato di valuta standard per una facile revisione (ad es., 17,50).                                                                                                                                                     |
| Conteggio                                                                  | Numero totale di singole occorrenze di ricompense pagate per il partecipante nell'anno specificato. Utile per capire quanto spesso un partecipante ha guadagnato pagamenti.                                                                              |
| **Idoneità e stato del pagamento**                                         |                                                                                                                                                                                                                                                          |
| Sospensione del pagamento                                                  | Indica se i pagamenti del partecipante sono attualmente sospesi (Sì o No). I pagamenti possono essere sospesi a causa di moduli fiscali mancanti o configurazione incompleta.                                                                            |
| Motivi di sospensione del pagamento                                        | Spiega perché il partecipante è soggetto a sospensione dei pagamenti (se applicabile). Esempi di motivi: *Modulo fiscale mancante*, *Informazioni bancarie non fornite*, *Revisione di conformità*.                                                      |
| Valuta del pagamento                                                       | La valuta in cui i pagamenti del partecipante sono o saranno elaborati (ad es., *USD*, *EUR*, *ZAR*). Importante per i sistemi di pagamento globali e la contabilità.                                                                                    |
| Avviata la configurazione del pagamento                                    | Indica se il partecipante ha iniziato a impostare il proprio metodo di pagamento (ad es., tramite un'integrazione con un fornitore di pagamenti). Aiuta a monitorare l'avanzamento dell'onboarding o le necessità di follow-up per pagamenti in sospeso. |

</details>
