# 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 dispongono di opzioni di filtro per offrirti un maggiore controllo sui dati che scarichi. Ogni report può essere scaricato come file .CSV o Excel.

Questo articolo spiega i diversi report e quali tipi di dati include ciascuno. Fai riferimento a [Esegui un report del programma Advocate](https://help.impact.com/brand/it/cosa-vorresti-imparare/advocate-program/advocate-reporting-and-analytics/run-an-advocate-program-report) per istruzioni sulla generazione di un report.

#### Report dei dettagli utente

Il *dettagli utente* report contiene informazioni dettagliate su ciascun 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 referral di Advocate.

<details>

<summary>Dettagli del report</summary>

Per impostazione predefinita, il report includerà informazioni sui partecipanti come:

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

Quando generi il report, puoi facoltativamente includere:

* **Statistiche utente**, incluse informazioni di analisi sul partecipante come traffico, ricavi e altro.
* **Link e codici di condivisione referral**, se applicabile. Queste informazioni possono essere utili per aggiornare i record dei contatti nel tuo CMS o sistema email in modo da includere i link e i codici di condivisione Advocate di ciascun partecipante.

Un elenco completo dei campi può essere trovato quando [scaricando 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) report dettagli utente.

**Riferimento colonne del report**

| Colonna                                               | Descrizione                                                                                                                                                                                                 |
| ----------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Informazioni utente**                               |                                                                                                                                                                                                             |
| ID                                                    | L'identificatore univoco del partecipante all'interno del sistema Advocate.                                                                                                                                 |
| ID account                                            | L'identificatore univoco dell'account del partecipante (utilizzato in più programmi, se applicabile).                                                                                                       |
| Email                                                 | 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 l'abbinamento conforme alla privacy con altri sistemi.                                                                          |
| **Informazioni referral e di condivisione**           |                                                                                                                                                                                                             |
| Codice referral                                       | Il codice univoco associato al partecipante, utilizzato per tracciare i referral che genera.                                                                                                                |
| Link di condivisione                                  | Il link 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 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 referral senza parametri di tracciamento; più neutra per alcune piattaforme o casi d'uso.                                                                                             |
| **Geolocalizzazione e locale**                        |                                                                                                                                                                                                             |
| IP visto per la prima volta                           | L'indirizzo IP da cui il partecipante è stato registrato per la prima volta.                                                                                                                                |
| Ultimo IP visto                                       | L'indirizzo IP più recente rilevato per questo partecipante.                                                                                                                                                |
| Locale                                                | La lingua preferita e le impostazioni regionali del partecipante (ad es., en-US).                                                                                                                           |
| Codice paese                                          | Il paese del partecipante in base al locale o all'indirizzo IP (ad 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 la conformità o l'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 andati a buon fine effettuati dal partecipante.                                                                                                                                   |
| stats.conversions                                     | Numero totale di conversioni (ad es. acquisti, registrazioni) risultanti da tali referral.                                                                                                                  |
| stats.goals                                           | Numero di completamenti di obiettivi specifici associati all'attività di referral del partecipante (definiti in modo personalizzato nel programma).                                                         |
| stats.rewards                                         | Numero totale di ricompense guadagnate dal partecipante.                                                                                                                                                    |
| stats.widget Loads                                    | Numero di volte in cui il widget di referral o l'interfaccia di condivisione è stato caricato da questo partecipante.                                                                                       |
| stats.revenue                                         | Ricavo totale generato dagli utenti riferiti da questo partecipante.                                                                                                                                        |
| stats.generated Revenue                               | Sinonimo di stats.revenue; alcuni report possono distinguerlo se il ricavo proviene da più fonti.                                                                                                           |
| stats.referred Revenue                                | Ricavo attribuito specificamente ai partecipanti che si sono registrati o hanno acquistato tramite il link referral di questo partecipante.                                                                 |
| **Dati personalizzati**                               |                                                                                                                                                                                                             |
| custom Fields.example                                 | Un segnaposto per eventuali campi personalizzati definiti dal tuo programma (ad es., *ID fedeltà*, *note interne*, *tag regione*). Ogni campo apparirà come propria colonna, con il prefisso custom Fields. |
| **Altro**                                             |                                                                                                                                                                                                             |
| Origine referral                                      | La fonte o il canale originale che ha portato il partecipante al tuo programma (ad es., *organico*, *email*, *sito partner*).                                                                               |

</details>

#### Esportazione eventi utente

Il *Report esportazione eventi utente* 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 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 account
* Data di attivazione
* Data di ricezione
* Data di elaborazione

**Riferimento colonne del report**

| Colonna                                                     | Descrizione                                                                                                                                                                                           |
| ----------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Informazioni su evento e utente**                         |                                                                                                                                                                                                       |
| ID evento                                                   | Un ID univoco generato per ogni evento ricevuto. Utile per il tracciamento, il debug o la verifica degli invii di eventi.                                                                             |
| Chiave evento                                               | Il tipo o l'etichetta dell'evento, come `acquisto`, `registrazione`, o qualsiasi chiave personalizzata inviata dal tuo sistema.                                                                       |
| ID utente                                                   | L'identificatore univoco del partecipante in Advocate a cui è associato l'evento.                                                                                                                     |
| ID account                                                  | L'ID account associato all'utente, particolarmente rilevante nei programmi in cui gli utenti possono appartenere a diverse strutture di account.                                                      |
| **Timestamp evento**                                        |                                                                                                                                                                                                       |
| Data evento attivato – YYYY-MM-DD                           | La data in cui l'evento è effettivamente avvenuto (come segnalato dal tuo sistema). Ad esempio, la data in cui ha avuto luogo un acquisto o una registrazione.                                        |
| Data evento ricevuto – YYYY-MM-DD                           | La data in cui Advocate ha ricevuto l'evento dal tuo sistema. Può differire dalla data di attivazione a causa di elaborazioni in batch o ritardi di sistema.                                          |
| Data evento elaborato – YYYY-MM-DD                          | La data in cui l'evento è stato elaborato con successo e memorizzato in Advocate. Indica quando l'evento è diventato utilizzabile per il tracciamento, le ricompense o i report.                      |
| **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 specifici trigger promozionali.                                |
| fields.revenue                                              | L'importo di ricavo associato all'evento. Solitamente usato negli eventi di acquisto per calcolare performance, ricompense o ROI.                                                                     |
| fields.currency                                             | Il codice valuta (ad es., *USD*, *ZAR*, *EUR*) associato all'importo del ricavo. Importante quando si riportano dati tra regioni o si calcolano ricompense adeguate al tasso di cambio.               |
| fields.lead Created Date                                    | La data originale in cui il lead (utente) è stato creato nel tuo sistema, se inviata come parte dell'evento. Aiuta a collegare gli eventi utente alle date di acquisizione originali o ai record CRM. |

</details>

#### Cronologia ricompense

Il *Cronologia ricompense* fornisce un registro dettagliato di ciascuna tua ricompensa 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 della ricompensa

Un elenco completo dei campi inclusi può essere trovato quando [scaricando 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 ricompensa.

Quando generi il report, puoi facoltativamente includere:

* **Dettagli del partecipante** come nome, ID utente e account, indirizzo email, campi personalizzati, segmenti e informazioni di referral (se applicabile).
* **Campi referral** come ID referral, campi customer advocate, campi amico riferito 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 (ad es. *Contanti*, *Carta regalo*, *Coupon*, *Personalizzato*).                                                                                                  |
| Valore                                                                                                             | Il valore numerico della ricompensa (ad es. 10, 100, ecc.).                                                                                                                                            |
| Unità                                                                                                              | L'unità associata al valore (ad es., *USD*, *punti*, *ZAR*, *%*).                                                                                                                                      |
| Nome                                                                                                               | Nome visualizzato della ricompensa (come definito nella [configurazione della ricompensa](https://help.impact.com/brand/it/cosa-vorresti-imparare/advocate-program/advocate-rewards/create-a-reward)). |
| Fonte della ricompensa                                                                                             | Descrive cosa ha attivato la ricompensa (ad es., *Referral*, *Obiettivo*, *Manuale*, *API*).                                                                                                           |
| Tipo Fuel Tank                                                                                                     | Il tipo di fondo ricompensa utilizzato (se si usa l'integrazione FuelTank). Ad es., *Prepagato*, *Carta regalo*.                                                                                       |
| Codice Fuel Tank                                                                                                   | Il codice associato all'evasione esterna (ad es. voucher o codice carta regalo).                                                                                                                       |
| ID programma                                                                                                       | ID del programma Advocate in cui la ricompensa è stata emessa.                                                                                                                                         |
| Chiave ricompensa programma                                                                                        | Identificatore interno per la specifica configurazione di ricompensa utilizzata all'interno del programma.                                                                                             |
| Chiave ricompensa globale                                                                                          | Identificatore cross-programma per le ricompense configurate a livello globale (se applicabile).                                                                                                       |
| **Timestamp ricompensa**                                                                                           |                                                                                                                                                                                                        |
| Data di creazione                                                                                                  | Quando il record della ricompensa è stato creato nel sistema.                                                                                                                                          |
| Data programmata per                                                                                               | Quando la ricompensa è stata programmata per essere emessa (ad es. dopo un ritardo o un periodo di attesa).                                                                                            |
| Data concessa                                                                                                      | 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 resa nulla.                                                                                                                                           |
| Data riscattata                                                                                                    | La data in cui il partecipante ha riscattato la ricompensa (se applicabile).                                                                                                                           |
| Data modificata                                                                                                    | La data in cui è stato effettuato l'aggiornamento più recente al record della ricompensa.                                                                                                              |
| **Tracciamento credito e valore**                                                                                  |                                                                                                                                                                                                        |
| Credito assegnato                                                                                                  | L'importo di credito assegnato a questa ricompensa (in alcuni modelli può differire dal valore).                                                                                                       |
| Credito riscattato                                                                                                 | L'importo di credito che è stato riscattato dalla ricompensa.                                                                                                                                          |
| Valore disponibile                                                                                                 | La parte residua non utilizzata o non riscattata della ricompensa.                                                                                                                                     |
| **Stato e messaggistica della ricompensa**                                                                         |                                                                                                                                                                                                        |
| Stati                                                                                                              | Stato corrente della ricompensa (ad es., *In sospeso*, *Programmato*, *Concesso*, *Scaduto*, *Annullato*).                                                                                             |
| meta.status                                                                                                        | Stato tecnico o a livello di sistema (utile per diagnostica o gestione degli errori).                                                                                                                  |
| meta.message                                                                                                       | Messaggio associato alla consegna della ricompensa (ad es. “Ricompensa consegnata con successo”).                                                                                                      |
| meta.internal Message                                                                                              | Note interne solo per gli amministratori (ad es. spiegazioni dei fallimenti 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 inviati dal tuo programma (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 dell'utente in Advocate.                                                                                                                                                        |
| <p>user.first Name</p><p>user.last Name</p><p>user.email</p>                                                       | Informazioni di base del partecipante incluse come riferimento o per l'abbinamento CRM.                                                                                                                |
| **Contesto del referral (se la ricompensa si basa su un referral)**                                                |                                                                                                                                                                                                        |
| referral.id                                                                                                        | L'ID del referral che ha attivato questa ricompensa.                                                                                                                                                   |
| referral.date Referral Started                                                                                     | Quando è iniziata l'azione di referral (ad es. clic o evento di condivisione).                                                                                                                         |
| referral.date Modified                                                                                             | Quando il record referral è stato aggiornato l'ultima volta.                                                                                                                                           |
| referral.referral Code Used                                                                                        | Il codice utilizzato dall'utente referenziato per iscriversi o compiere un'azione.                                                                                                                     |
| **Info utente referenziato (amico)**                                                                               |                                                                                                                                                                                                        |
| referral.referred User.id                                                                                          | ID della persona referenziata (l'“amico”).                                                                                                                                                             |
| referral.referred User.account Id                                                                                  | L'ID account univoco del referente.                                                                                                                                                                    |
| <p>referral.referred User.first Name</p><p>referral.referred User.last Name</p><p>referral.referred User.email</p> | I dati di contatto di base del referente.                                                                                                                                                              |
| **Informazioni sul referente (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 referente.                                                                                                                                                                    |
| <p>referral.referrer User.first Name</p><p>referral.referrer User.last Name</p><p>referral.referrer User.email</p> | I dati di contatto di base del referente.                                                                                                                                                              |
| referral.date Converted                                                                                            | La data in cui il referral si è ufficialmente convertito (ad es. registrazione o acquisto completati), attivando la ricompensa.                                                                        |

</details>

#### Cronologia referral

Il *Cronologia referral* fornisce un registro dello stato di ciascuna connessione referral effettuata nel tuo programma referral. Queste informazioni possono essere utili per verificare il successo del tuo programma e monitorare il numero di nuovi clienti portati dal tuo 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 customer advocate come nome, ID utente e account, indirizzo email e altro
* Stato del referral
* Stato di moderazione
* ID ricompense

Un elenco completo dei campi può essere trovato quando [scaricando 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 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 (ad es. quando l'utente referenziato ha cliccato su un link referral).                        |
| Data conversione                                                                                  | Quando il referral si è convertito, di solito quando l'utente referenziato ha completato l'azione richiesta (come una registrazione o un acquisto). |
| Data modifica utente                                                                              | L'ultima volta in cui i dati dell'utente coinvolti in questo referral (referente o referenziato) sono stati aggiornati.                             |
| ID programma                                                                                      | L'ID del programma referral Advocate a cui appartiene questo referral.                                                                              |
| Nome programma                                                                                    | Il nome del programma referral, utile se gestisci 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 referral assegnato all'utente referenziato (nel caso in cui possa anche riferire altri in seguito).                                       |
| <p>IP visto per la prima volta utente referenziato</p><p>Ultimo IP visto utente referenziato</p>  | Indirizzi IP registrati alla prima e più recente attività dell'utente referenziato.                                                                 |
| URL immagine utente referenziato                                                                  | URL dell'immagine o avatar, se acquisito o assegnato all'utente referenziato.                                                                       |
| Locale utente referenziato                                                                        | Impostazione lingua/regionale (ad 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 (utilizzato nei programmi multi-account).                                                      |
| **Informazioni sul referente (customer advocate)**                                                |                                                                                                                                                     |
| <p>Email utente referente</p><p>Nome utente referente</p><p>Cognome utente referente</p>          | Informazioni di identità di base del partecipante che effettua il referral.                                                                         |
| Codice referral utente referente                                                                  | Il codice referral appartenente al referente, il codice che l'utente referenziato probabilmente ha usato.                                           |
| <p>IP visto per la prima volta utente referente</p><p>Ultimo IP visto utente referente</p>        | Indirizzi IP registrati alla prima e più recente attività del referente.                                                                            |
| URL immagine utente referente                                                                     | L'URL dell'immagine o avatar del referente.                                                                                                         |
| Locale utente referente                                                                           | Impostazione locale del referente.                                                                                                                  |
| Data creazione utente referente                                                                   | Quando il referente si è unito per la prima volta o è stato registrato nel sistema.                                                                 |
| Utente referente                                                                                  | ID interno del referente in Advocate.                                                                                                               |
| Account referente                                                                                 | ID account associato al referente.                                                                                                                  |
| **Moderazione e stato**                                                                           |                                                                                                                                                     |
| Stato di moderazione                                                                              | Stato generale di moderazione del referral. (Ad es., *Approvato*, *Rifiutato*, *In sospeso*.)                                                       |
| Data di moderazione                                                                               | La data in cui è stata presa la decisione di moderazione (approvazione/rifiuto).                                                                    |
| Data referral pagato                                                                              | Quando è stata erogata qualsiasi ricompensa associata al referral.                                                                                  |
| Data referral terminato                                                                           | Quando il record referral è stato ufficialmente chiuso (ad es. per scadenza o completamento).                                                       |
| Stato moderazione referenziato                                                                    | Stato di moderazione specifico della parte del referral relativa all'utente referenziato.                                                           |
| Stato moderazione referente                                                                       | Stato di moderazione specifico della parte del referral relativa al referente.                                                                      |
| **Riferimenti ricompensa**                                                                        |                                                                                                                                                     |
| Ricompensa del referenziato                                                                       | L'ID o il riferimento della ricompensa emessa all'utente referenziato (se applicabile).                                                             |
| Ricompensa del referente                                                                          | L'ID o il riferimento della ricompensa emessa al referente (se applicabile).                                                                        |

</details>

#### Saldo delle ricompense per utente

Il *Saldo delle ricompense per utente* fornisce un registro delle ricompense non ancora riscattate, incluso il valore e il destinatario previsto, generate tramite il tuo programma referral. Questo report viene spesso utilizzato come parte dell'evasione manuale delle ricompense, oppure come parte di un processo batch verso un sistema come Tango Card. Può anche essere utile per tracciare quanto ha pagato il tuo programma referral in un determinato periodo di tempo.

<details>

<summary>Dettagli del report</summary>

Per impostazione predefinita, il report include:

* Dettagli del 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 [scaricando 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 al singolo utente.                                                                    |
| ID account                        | L'ID account interno associato al partecipante. Particolarmente rilevante se gli utenti appartengono a 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 cognome del partecipante. Utile per la personalizzazione o il filtraggio durante l'elaborazione delle ricompense.                                                                            |
| Codice referral                   | Il codice referral assegnato al partecipante. È ciò che condivide per riferire altri e tracciare l'idoneità alle ricompense.                                                                           |
| **Informazioni sulla ricompensa** |                                                                                                                                                                                                        |
| Tipo                              | La categoria o il metodo della ricompensa (ad es., *Contanti*, *Carta regalo*, *Punti*, *Personalizzato*). Aiuta a determinare come le ricompense devono essere evase o raggruppate.                   |
| Unità                             | L'unità del valore della ricompensa (ad es., *USD*, *ZAR*, *Punti*, *%*). Importante per calcolare i saldi e per la gestione dei pagamenti regionali.                                                  |
| Importo                           | Il saldo totale disponibile delle ricompense in sospeso per questo utente. Questo è il valore principale usato nella preparazione dei pagamenti o delle esportazioni.                                  |
| Credito totale assegnato          | L'importo totale di credito che è mai stato assegnato a questo utente (indipendentemente dal riscatto). Riflette il costo complessivo del programma allocato a questo partecipante.                    |
| Credito totale riscattato         | La parte totale di ricompense che questo partecipante ha già riscattato. Utile per verificare i costi effettivi rispetto alle passività.                                                               |
| Credito totale scaduto            | Totale delle ricompense assegnate all'utente ma scadute prima di essere riscattate. Aiuta a tracciare le ricompense non reclamate o le opportunità di evasione perse.                                  |
| **Metadati utente**               |                                                                                                                                                                                                        |
| URL immagine                      | URL dell'immagine del profilo o dell'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à, tagging della posizione o analisi antifrode.                                      |
| Ultimo IP visto                   | 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 l'analisi di coorte o del comportamento delle ricompense nel tempo.                                                    |
| Origine referral                  | La fonte o il canale originale attraverso cui il partecipante è stato acquisito (ad es., *email*, *organico*, *partner*). Aiuta a valutare la portata e l'efficacia del programma referral per canale. |
| Locale                            | L'impostazione della lingua e della regione del partecipante (ad es., *en-US*, *fr-FR*). Importante per comunicazioni personalizzate o opzioni di ricompensa regionali.                                |

</details>

#### Saldi ricompense disponibili per utente

Il *Saldi ricompense disponibili per utente* report fornisce un elenco delle ricompense non riscattate. Questo tipo di report è pensato per essere utilizzato come parte dell'evasione delle ricompense tramite il [riscatto massivo delle ricompense](https://help.impact.com/brand/it/cosa-vorresti-imparare/advocate-program/advocate-rewards/redeem-rewards-in-bulk) processo.

<details>

<summary>Dettagli del report</summary>

Per impostazione predefinita, il report include:

* Dettagli del 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 [scaricando 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 sulle ricompense Sconto percentuale, Fuel Tank o Carta regalo. Usa il *Saldo delle 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 l'identificazione o la personalizzazione durante l'elaborazione delle ricompense.                                                                                                                                                                                                                 |
| Cognome                                 | Il cognome del partecipante.                                                                                                                                                                                                                                                                                                          |
| Email                                   | L'indirizzo email del partecipante, usato per inviare le ricompense o abbinarle a sistemi esterni come un CRM o un fornitore 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 utilizzati per [raggruppare i partecipanti](https://help.impact.com/brand/it/cosa-vorresti-imparare/advocate-program/manage-advocate-participants/manage-advocate-user-segments) (ad esempio, *per regione*, *fase del ciclo di vita*, *tipo di cliente*). Utile per filtrare o applicare regole di evasione diverse. |
| **Stato e tempistica 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 il blocco.                                                                                                                                          |
| **Dati della ricompensa**               |                                                                                                                                                                                                                                                                                                                                       |
| Nome unità                              | L'etichetta o il nome visualizzato dell'unità di ricompensa (ad esempio, *Contanti referral*, *Credito negozio*). Questo aiuta a distinguere tra più tipi di ricompensa che un programma potrebbe offrire.                                                                                                                            |
| Valuta                                  | Il codice valuta del valore della ricompensa (ad esempio, *USD*, *ZAR*, *EUR*). Necessario quando si evadono le ricompense, soprattutto tra paesi o sistemi di pagamento diversi.                                                                                                                                                     |
| Valore disponibile                      | L'importo della ricompensa non riscattata attualmente disponibile per questo partecipante. Questo è il valore principale utilizzato per determinare quanto pagare.                                                                                                                                                                    |
| Valore da riscattare                    | Il valore attualmente in coda per il riscatto (ad esempio, in attesa in un'evasione massiva o in attesa di elaborazione). Utile per evitare doppi riscatti o garantire che non vi siano sovrapposizioni nei riscatti.                                                                                                                 |
| Valore totale riscattato                | Il valore totale delle ricompense che questo partecipante ha già riscattato. Fornisce indicazioni sui riscatti passati e può essere utile per il monitoraggio del tetto massimo delle ricompense                                                                                                                                      |
| Unità                                   | Il codice interno o di sistema per l'unità di ricompensa (ad esempio, *USD*, *punti*, ecc.). Potrebbe essere utilizzato nelle chiamate API o nella logica interna durante l'evasione.                                                                                                                                                 |

</details>

#### Rapporto fiscale statunitense W-9

Il rapporto fiscale statunitense 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 del 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 imponibile 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'identificativo univoco del partecipante in Advocate.                                                                                                                                                                                                 |
| ID account                                                            | ID account interno associato al partecipante.                                                                                                                                                                                                          |
| Email                                                                 | 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 statunitense</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à IRS e per verificare lo stato della documentazione fiscale.                                                     |
| **Riepilogo dell'anno fiscale**                                       |                                                                                                                                                                                                                                                        |
| Anno                                                                  | L'anno fiscale in cui il partecipante ha guadagnato le ricompense. Usato per raggruppare i guadagni per anno solare ai fini dell'elaborazione del 1099.                                                                                                |
| Valore imponibile negli Stati Uniti in centesimi                      | Valore totale delle ricompense imponibili negli Stati Uniti guadagnate da questo partecipante nell'anno fiscale specificato, espresso in centesimi (ad esempio, 2500 = $25,00). Utile per calcoli grezzi o integrazioni in cui è richiesta precisione. |
| Valore imponibile negli Stati Uniti in dollari                        | Lo stesso valore di cui sopra, ma visualizzato nel formato standard in dollari (ad esempio, 25,00). Più facile da esaminare o includere nei riepiloghi ufficiali.                                                                                      |
| Conteggio ricompense                                                  | Numero totale di singole ricompense guadagnate dal partecipante nell'anno fiscale specificato. Utile per tracciare gli audit o comprendere la frequenza delle ricompense e il coinvolgimento nel programma.                                            |

</details>

#### Pagamenti e imposte

Il *Pagamento e imposte* report mostra lo stato fiscale dei partecipanti e le ricompense guadagnate o in sospeso per anno.

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

<details>

<summary>Dettagli del report</summary>

Per impostazione predefinita, il report include:

* Dettagli del 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 imponibile 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 esempio *valido*, *in sospeso*, o *in attesa*. Anche i motivi del blocco del pagamento sono inclusi nel report

**Riferimento colonne del report**

| Colonna                                                               | Descrizione                                                                                                                                                                                                                                                     |
| --------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Informazioni sul partecipante**                                     |                                                                                                                                                                                                                                                                 |
| ID utente                                                             | L'identificativo univoco del partecipante in Advocate.                                                                                                                                                                                                          |
| ID account                                                            | L'ID dell'account del partecipante, usato per la reportistica di gruppo o organizzativa.                                                                                                                                                                        |
| Email                                                                 | 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 statunitense</p><p>AAAA-MM-GG</p> | La data in cui il partecipante ha inviato il proprio modulo W-9 (o il modulo fiscale statunitense pertinente). Importante per verificare l'idoneità fiscale prima di emettere pagamenti in contanti.                                                            |
| **Riepilogo dell'anno dei pagamenti**                                 |                                                                                                                                                                                                                                                                 |
| Anno                                                                  | L'anno solare in cui il partecipante ha guadagnato le ricompense.                                                                                                                                                                                               |
| Valore                                                                | Valore totale del pagamento in unità minori (ad esempio, centesimi) guadagnato o in sospeso per questo partecipante durante l'anno. Ad esempio, 1750 = $17,50.                                                                                                  |
| Valore in dollari                                                     | Lo stesso valore, visualizzato nel formato standard della valuta per una facile revisione (ad esempio, 17,50).                                                                                                                                                  |
| Conteggio                                                             | Numero totale di singole istanze di ricompensa del pagamento per il partecipante nell'anno specificato. Utile per capire quanto spesso un partecipante ha guadagnato pagamenti.                                                                                 |
| **Idoneità e stato del pagamento**                                    |                                                                                                                                                                                                                                                                 |
| Blocco del pagamento                                                  | Indica se i pagamenti del partecipante sono attualmente bloccati (Sì o No). I pagamenti possono essere bloccati a causa di moduli fiscali mancanti o configurazione incompleta.                                                                                 |
| Motivi del blocco del pagamento                                       | Spiega perché il partecipante è in blocco del pagamento (se applicabile). Motivi di esempio: *Modulo fiscale mancante*, *Informazioni bancarie non fornite*, *Revisione della conformità*.                                                                      |
| Valuta del pagamento                                                  | La valuta in cui i pagamenti del partecipante sono o saranno elaborati (ad esempio, *USD*, *EUR*, *ZAR*). Importante per i sistemi di pagamento globali e la contabilità.                                                                                       |
| Configurazione del pagamento avviata                                  | Indica se il partecipante ha iniziato a configurare il proprio metodo di pagamento (ad esempio, tramite un'integrazione con un provider di pagamenti). Aiuta a monitorare l'avanzamento dell'onboarding o le necessità di follow-up per i pagamenti in sospeso. |

</details>
