> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/advocate-program/advocate-reporting-and-analytics/advocate-program-reports-explained.md).

# 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 diversi report scaricabili sui dati dei tuoi programmi e dei partecipanti. Tutti i report includono opzioni di filtro che ti consentono di controllare meglio i dati scaricati. Ogni report può essere scaricato in formato .CSV o Excel.

Questo articolo illustra i diversi report e i tipi di dati inclusi in ciascuno. Consulta [Eseguire un report del programma Advocate](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/advocate-program/advocate-reporting-and-analytics/run-an-advocate-program-report.md) per le istruzioni su come generare un report.

#### Report dei dettagli utente

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

<details>

<summary>Dettagli del report</summary>

Per impostazione predefinita, il report include informazioni sui partecipanti come:

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

Quando generi il report, puoi includere anche:

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

Puoi trovare l'elenco completo dei campi quando [scarichi il nostro file 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 dei dettagli utente.

**Riferimento alle colonne del report**

| Colonna                                               | Descrizione                                                                                                                                                                                                         |
| ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Informazioni utente**                               |                                                                                                                                                                                                                     |
| ID                                                    | L'identificatore univoco del partecipante nel sistema Advocate.                                                                                                                                                     |
| ID account                                            | L'identificatore univoco dell'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 sottoposta a hashing (crittografata) dell'email del partecipante, utile per confrontarla con i dati di altri sistemi nel rispetto della privacy.                                                       |
| **Informazioni su referral e condivisioni**           |                                                                                                                                                                                                                     |
| Codice referral                                       | Il codice univoco associato al partecipante, utilizzato per monitorare i referral generati.                                                                                                                         |
| Link di condivisione                                  | Il link referral univoco associato al partecipante.                                                                                                                                                                 |
| Link di condivisione Facebook                         | Un link generato in anticipo per condividere il referral su Facebook.                                                                                                                                               |
| Link di condivisione Twitter                          | Un link generato in anticipo per condividere il referral su Twitter.                                                                                                                                                |
| Link di condivisione via email                        | Un link generato in anticipo per condividere il referral via email.                                                                                                                                                 |
| Link di condivisione LinkedIn                         | Un link generato in anticipo per condividere il referral su LinkedIn.                                                                                                                                               |
| Link di condivisione pulito                           | Una versione del link referral senza parametri di monitoraggio, più neutra per determinate piattaforme o casi d'uso.                                                                                                |
| **Geolocalizzazione e impostazioni locali**           |                                                                                                                                                                                                                     |
| Primo IP rilevato                                     | L'indirizzo IP da cui è stato registrato per la prima volta il partecipante.                                                                                                                                        |
| Ultimo IP rilevato                                    | L'indirizzo IP più recente rilevato per questo partecipante.                                                                                                                                                        |
| Impostazioni locali                                   | La lingua e le impostazioni regionali preferite dal partecipante (ad es., en-US).                                                                                                                                   |
| Codice paese                                          | Il paese del partecipante in base alle impostazioni locali o all'indirizzo IP (ad es., ZA, US).                                                                                                                     |
| **Timestamp**                                         |                                                                                                                                                                                                                     |
| Data di creazione                                     | La data e l'ora in cui è stato creato l'account del partecipante in Advocate.                                                                                                                                       |
| Data di invio del modulo fiscale statunitense         | (Se applicabile) La data di invio di un modulo fiscale statunitense ai fini della conformità o dell'elaborazione dei premi.                                                                                         |
| **Statistiche utente (se incluse nell'esportazione)** |                                                                                                                                                                                                                     |
| stats.date Modified                                   | L'ultima data in cui sono state aggiornate le statistiche del partecipante.                                                                                                                                         |
| 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 o iscrizioni) generate da tali referral.                                                                                                                             |
| stats.goals                                           | Numero di obiettivi specifici completati grazie all'attività di referral del partecipante (definiti in modo personalizzato nel programma).                                                                          |
| stats.rewards                                         | Numero totale di premi ottenuti 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                                         | Entrate totali generate dagli utenti segnalati da questo partecipante.                                                                                                                                              |
| stats.generated Revenue                               | Sinonimo di stats.revenue; alcuni report potrebbero distinguere le entrate provenienti da fonti diverse.                                                                                                            |
| stats.referred Revenue                                | Entrate attribuite specificamente ai partecipanti che si sono iscritti o hanno effettuato un acquisto tramite il link di referral di questo partecipante.                                                           |
| **Dati personalizzati**                               |                                                                                                                                                                                                                     |
| custom Fields.example                                 | Segnaposto per qualsiasi campo personalizzato definito dal programma (ad es., *ID fedeltà*, *note interne*, *etichetta della regione*). Ogni campo apparirà in una colonna separata, con il prefisso custom Fields. |
| **Altro**                                             |                                                                                                                                                                                                                     |
| Fonte del referral                                    | La fonte o il canale originale che ha portato il partecipante al programma (ad es., *organico*, *email*, *sito partner*).                                                                                           |

</details>

#### Esportazione degli eventi utente

Il *report di esportazione degli eventi utente* fornisce un registro di tutti gli eventi utente ricevuti dalla tua organizzazione per il programma Advocate. Puoi applicare filtri per restringere l'intervallo di tempo, la chiave dell'evento, l'ID utente e altro ancora.

<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 alle colonne del report**

| Colonna                                                              | Descrizione                                                                                                                                                                                                   |
| -------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Informazioni sull'evento e sull'utente**                           |                                                                                                                                                                                                               |
| ID evento                                                            | ID univoco generato per ogni evento ricevuto. Utile per tracciare, eseguire il debug o verificare gli invii degli eventi.                                                                                     |
| Chiave evento                                                        | Il tipo o l'etichetta dell'evento, ad esempio `purchase`, `signup`, oppure qualsiasi chiave personalizzata inviata dal tuo sistema.                                                                           |
| ID utente                                                            | L'identificativo 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 strutture di account diverse.                                                              |
| **Timestamp dell'evento**                                            |                                                                                                                                                                                                               |
| Data di attivazione dell'evento – YYYY-MM-DD                         | La data in cui l'evento si è effettivamente verificato (secondo quanto comunicato dal tuo sistema). Ad esempio, la data in cui è stato effettuato un acquisto o una registrazione.                            |
| Data di ricezione dell'evento – YYYY-MM-DD                           | La data in cui Advocate ha ricevuto l'evento dal tuo sistema. Può differire dalla data di attivazione a causa dell'elaborazione in batch o di ritardi del sistema.                                            |
| Data di elaborazione dell'evento – YYYY-MM-DD                        | La data in cui l'evento è stato elaborato e archiviato correttamente in Advocate. Indica quando l'evento è diventato utilizzabile per il monitoraggio, i premi o la reportistica.                             |
| **Campi dei dati dell'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 monitorare l'utilizzo degli incentivi o l'attivazione di promozioni specifiche.                       |
| fields.revenue                                                       | L'importo dei ricavi associato all'evento. In genere viene utilizzato negli eventi di acquisto per calcolare le prestazioni, i premi o il ROI.                                                                |
| fields.currency                                                      | Il codice valuta (ad es., *USD*, *ZAR*, *EUR*) associato all'importo dei ricavi. È importante per la reportistica tra diverse aree geografiche o per calcolare premi adeguati ai tassi 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 dell'utente alla data di acquisizione iniziale o ai record del CRM. |

</details>

#### Cronologia dei premi

Il *Cronologia dei premi* report fornisce un resoconto dettagliato di ciascuno dei tuoi premi e delle relazioni con i partecipanti e i referral. Queste informazioni possono essere utili per creare bilanci e ottenere lo stato di tutti i premi in un determinato momento.

<details>

<summary>Dettagli del report</summary>

Per impostazione predefinita, il report include **campi dei premi** informazioni come:

* ID premio
* Tipo di premio
* Valore del premio

L'elenco completo dei campi inclusi è disponibile 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) oppure [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 dettagliati sui premi.

Quando generi il report, puoi includere anche:

* **dettagli del partecipante** come nome, ID utente e account, indirizzo email, campi personalizzati, segmenti e informazioni sui referral (se applicabile).
* **Campi di referral** come l'ID referral, i campi del sostenitore cliente, i campi dell'amico segnalato e altro ancora.

**Riferimento alle colonne del report**

| Colonna                                                                                                            | Descrizione                                                                                                                                                                                               |
| ------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Informazioni sul premio**                                                                                        |                                                                                                                                                                                                           |
| ID                                                                                                                 | ID univoco dell'istanza del premio (generato da Advocate).                                                                                                                                                |
| Tipo                                                                                                               | La categoria o il tipo di premio (ad es. *Denaro*, *Buono regalo*, *Coupon*, *Personalizzato*).                                                                                                           |
| Valore                                                                                                             | Il valore numerico del premio (ad es. 10, 100 ecc.).                                                                                                                                                      |
| Unità                                                                                                              | L'unità associata al valore (ad es. *USD*, *punti*, *ZAR*, *%*).                                                                                                                                          |
| Nome                                                                                                               | Nome visualizzato del premio (come definito nella [configurazione del premio](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/create-a-reward.md)). |
| Origine del premio                                                                                                 | Descrive cosa ha attivato il premio (ad es. *Referral*, *Obiettivo*, *Manuale*, *API*).                                                                                                                   |
| Tipo di fondo Fuel Tank                                                                                            | Il tipo di fondo premio utilizzato (se si usa l'integrazione FuelTank). Ad es. *Prepagato*, *Buono regalo*.                                                                                               |
| Codice Fuel Tank                                                                                                   | Il codice associato all'erogazione esterna (ad es. il codice di un voucher o di un buono regalo).                                                                                                         |
| ID programma                                                                                                       | ID del programma Advocate nell'ambito del quale è stato assegnato il premio.                                                                                                                              |
| Chiave premio programma                                                                                            | Identificatore interno della configurazione specifica del premio utilizzata nel programma.                                                                                                                |
| Chiave premio globale                                                                                              | Identificatore trasversale ai programmi per i premi configurati a livello globale (se applicabile).                                                                                                       |
| **Date e orari del premio**                                                                                        |                                                                                                                                                                                                           |
| Data di creazione                                                                                                  | Data e ora di creazione del record del premio nel sistema.                                                                                                                                                |
| Data prevista                                                                                                      | Data e ora in cui era prevista l'assegnazione del premio (ad es. dopo un ritardo o un periodo di attesa).                                                                                                 |
| Data di assegnazione                                                                                               | Data e ora in cui il premio è stato effettivamente assegnato al partecipante.                                                                                                                             |
| Data di scadenza                                                                                                   | La data di scadenza del premio (se applicabile).                                                                                                                                                          |
| Data di annullamento                                                                                               | La data in cui il premio è stato annullato o revocato.                                                                                                                                                    |
| Data di riscatto                                                                                                   | La data in cui il partecipante ha riscattato il premio (se applicabile).                                                                                                                                  |
| Data di modifica                                                                                                   | La data in cui è stato apportato l'aggiornamento più recente al record del premio.                                                                                                                        |
| **Monitoraggio dei crediti e dei valori**                                                                          |                                                                                                                                                                                                           |
| Credito assegnato                                                                                                  | L'importo del credito assegnato a questo premio (in alcuni modelli può differire dal valore).                                                                                                             |
| Credito riscattato                                                                                                 | L'importo del credito riscattato dal premio.                                                                                                                                                              |
| Valore disponibile                                                                                                 | La parte restante del premio, non utilizzata o non riscattata.                                                                                                                                            |
| **Stato e messaggi del premio**                                                                                    |                                                                                                                                                                                                           |
| Stati                                                                                                              | Stato attuale del premio (ad es., *In attesa*, *Programmato*, *Assegnato*, *Scaduto*, *Annullato*).                                                                                                       |
| meta.status                                                                                                        | Stato tecnico o a livello di sistema (utile per la diagnostica o la gestione degli errori).                                                                                                               |
| meta.message                                                                                                       | Messaggio relativo all'erogazione del premio (ad es., «Premio erogato correttamente»).                                                                                                                    |
| meta.internal Message                                                                                              | Note interne visibili solo agli amministratori (ad es., spiegazioni di errori o flag).                                                                                                                    |
| meta.date Modified                                                                                                 | Ultimo aggiornamento dei metadati relativi al premio.                                                                                                                                                     |
| meta.customMeta.testMeta                                                                                           | Segnaposto per eventuali campi di metadati personalizzati inviati dal programma (in questo caso, testMeta è un esempio).                                                                                  |
| **Informazioni sul partecipante (utente)**                                                                         |                                                                                                                                                                                                           |
| user.id                                                                                                            | ID dell'utente che riceve il premio.                                                                                                                                                                      |
| user.account Id                                                                                                    | ID dell'account associato dell'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 l'abbinamento con il CRM.                                                                                                            |
| **Contesto della segnalazione (se il premio è basato su una segnalazione)**                                        |                                                                                                                                                                                                           |
| referral.id                                                                                                        | ID della segnalazione che ha attivato questo premio.                                                                                                                                                      |
| referral.date Referral Started                                                                                     | Quando è iniziata l'azione di segnalazione (ad es., un clic o una condivisione).                                                                                                                          |
| referral.date Modified                                                                                             | Data dell'ultimo aggiornamento del record della segnalazione.                                                                                                                                             |
| referral.referral Code Used                                                                                        | Il codice utilizzato dall'utente segnalato per iscriversi o compiere un'azione.                                                                                                                           |
| **Informazioni sull'utente segnalato (amico)**                                                                     |                                                                                                                                                                                                           |
| referral.referred User.id                                                                                          | ID della persona segnalata (l'«amico»).                                                                                                                                                                   |
| referral.referred User.account Id                                                                                  | ID account univoco della persona che ha effettuato la segnalazione.                                                                                                                                       |
| <p>referral.referred User.first Name</p><p>referral.referred User.last Name</p><p>referral.referred User.email</p> | Informazioni di contatto di base della persona che ha effettuato la segnalazione.                                                                                                                         |
| **Informazioni sul segnalante (Advocate)**                                                                         |                                                                                                                                                                                                           |
| referral.referrer User.id                                                                                          | ID della persona che ha effettuato la segnalazione (il «segnalante»).                                                                                                                                     |
| referral.referrer User.account Id                                                                                  | ID account univoco della persona che ha effettuato la segnalazione.                                                                                                                                       |
| <p>referral.referrer User.first Name</p><p>referral.referrer User.last Name</p><p>referral.referrer User.email</p> | Informazioni di contatto di base della persona che ha effettuato la segnalazione.                                                                                                                         |
| referral.date Converted                                                                                            | La data in cui la segnalazione è stata ufficialmente convertita (ad esempio, completando la registrazione o un acquisto), attivando così il premio.                                                       |

</details>

#### Cronologia delle segnalazioni

Il *Cronologia delle segnalazioni* report fornisce una registrazione dello stato di ogni relazione di segnalazione avviata nel programma. Queste informazioni possono essere utili per verificare il successo del programma e monitorare il numero di nuovi clienti che ha acquisito.

<details>

<summary>Dettagli del report</summary>

Per impostazione predefinita, il report include:

* Dettagli dell’amico segnalato, come nome, ID utente e account, indirizzo email e altro
* Dettagli del cliente segnalante, come nome, ID utente e account, indirizzo email e altro
* Stato della segnalazione
* Stato di moderazione
* ID dei premi

L’elenco completo dei campi è disponibile [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) del report sull’attività delle segnalazioni.

**Riferimento alle colonne del report**

| Colonna                                                                                                              | Descrizione                                                                                                                                                  |
| -------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Metadati della segnalazione**                                                                                      |                                                                                                                                                              |
| ID                                                                                                                   | Identificatore univoco del record della segnalazione in Advocate.                                                                                            |
| Data di modifica                                                                                                     | La data più recente in cui è stata aggiornata una qualsiasi parte del record della segnalazione.                                                             |
| Data di inizio della segnalazione                                                                                    | Data in cui è stata avviata la segnalazione (ad esempio, quando l’utente segnalato ha fatto clic su un link di segnalazione).                                |
| Data di conversione                                                                                                  | Data in cui la segnalazione è stata convertita, in genere quando l’utente segnalato ha completato l’azione richiesta (come una registrazione o un acquisto). |
| Data di modifica dell’utente                                                                                         | Ultima data in cui sono stati aggiornati i dati dell’utente coinvolto nella segnalazione (segnalante o segnalato).                                           |
| ID programma                                                                                                         | ID del programma di segnalazione Advocate a cui appartiene questa segnalazione.                                                                              |
| Nome del programma                                                                                                   | Nome del programma di segnalazione, utile se si gestiscono più programmi.                                                                                    |
| **Informazioni sull’amico segnalato (nuovo cliente)**                                                                |                                                                                                                                                              |
| <p>Email dell’utente segnalato</p><p>Nome dell’utente segnalato</p><p>Cognome dell’utente segnalato</p>              | Informazioni di base sull’identità dell’utente segnalato.                                                                                                    |
| Codice di segnalazione dell’utente segnalato                                                                         | Codice di segnalazione assegnato all’utente segnalato (nel caso in cui possa segnalare altre persone in seguito).                                            |
| <p>IP rilevato al primo accesso dell’utente segnalato</p><p>IP rilevato all’ultimo accesso dell’utente segnalato</p> | Indirizzi IP registrati durante la prima e l’attività più recente dell’utente segnalato.                                                                     |
| URL immagine dell’utente segnalato                                                                                   | URL dell’immagine o dell’avatar, se acquisito o assegnato all’utente segnalato.                                                                              |
| Impostazioni locali dell’utente segnalato                                                                            | Impostazione della lingua e dell’area geografica (ad esempio, *en-US*, *fr-FR*) dell’utente segnalato.                                                       |
| Data di creazione dell'utente segnalato                                                                              | La data in cui è stato creato in Advocate l'account dell'utente segnalato.                                                                                   |
| Utente segnalato                                                                                                     | ID interno dell'utente segnalato nel sistema Advocate.                                                                                                       |
| Account segnalato                                                                                                    | ID account interno collegato all'utente segnalato (utilizzato nei programmi con più account).                                                                |
| **Informazioni sul segnalante (cliente promotore)**                                                                  |                                                                                                                                                              |
| <p>Email dell'utente segnalante</p><p>Nome dell'utente segnalante</p><p>Cognome dell'utente segnalante</p>           | Informazioni di base sull'identità del partecipante che ha effettuato la segnalazione.                                                                       |
| Codice di segnalazione dell'utente segnalante                                                                        | Il codice di segnalazione appartenente al segnalante, probabilmente utilizzato dall'utente segnalato.                                                        |
| <p>IP del primo accesso dell'utente segnalante</p><p>IP dell'ultimo accesso dell'utente segnalante</p>               | Indirizzi IP registrati durante la prima e la più recente attività del segnalante.                                                                           |
| URL dell'immagine dell'utente segnalante                                                                             | L'URL dell'immagine o dell'avatar del segnalante.                                                                                                            |
| Impostazioni locali dell'utente segnalante                                                                           | Impostazioni locali del segnalante.                                                                                                                          |
| Data di creazione dell'utente segnalante                                                                             | La data in cui il segnalante si è iscritto per la prima volta o è stato registrato nel sistema.                                                              |
| Utente segnalante                                                                                                    | ID interno del segnalante in Advocate.                                                                                                                       |
| Account del segnalante                                                                                               | ID account associato al segnalante.                                                                                                                          |
| **Moderazione e stato**                                                                                              |                                                                                                                                                              |
| Stato di moderazione                                                                                                 | Stato complessivo di moderazione della segnalazione. (Ad es., *Approvata*, *Rifiutata*, *In sospeso*.)                                                       |
| Data di moderazione                                                                                                  | La data in cui è stata presa la decisione di moderazione (approvazione/rifiuto).                                                                             |
| Data di pagamento della segnalazione                                                                                 | La data in cui è stato corrisposto un eventuale premio associato alla segnalazione.                                                                          |
| Data di conclusione della segnalazione                                                                               | La data in cui il record della segnalazione è stato chiuso ufficialmente (ad es., per scadenza o completamento).                                             |
| Stato di moderazione dell'utente segnalato                                                                           | Stato di moderazione relativo alla parte della segnalazione che riguarda l'utente segnalato.                                                                 |
| Stato di moderazione del segnalante                                                                                  | Stato di moderazione relativo alla parte della segnalazione che riguarda il segnalante.                                                                      |
| **Riferimenti ai premi**                                                                                             |                                                                                                                                                              |
| Premio per l'utente segnalato                                                                                        | ID o riferimento del premio assegnato all'utente segnalato (se applicabile).                                                                                 |
| Premio per il segnalante                                                                                             | ID o riferimento del premio assegnato al segnalante (se applicabile).                                                                                        |

</details>

#### Saldi dei premi per utente

Il *Saldi dei premi per utente* Il report fornisce un resoconto dei premi in sospeso, inclusi il valore e il destinatario previsto, generati tramite il programma di referral. Questo report viene spesso utilizzato per erogare manualmente i premi o come parte di un processo batch verso un sistema come Tango Card. Può anche essere utile per monitorare quanto ha erogato il programma di referral in un determinato periodo.

<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 premio
* Unità del premio
* Importo del premio

Un elenco completo dei campi è disponibile [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 dei saldi dei premi.

**Riferimento alle colonne del report**

| Colonna                           | Descrizione                                                                                                                                                                                               |
| --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Informazioni sul partecipante** |                                                                                                                                                                                                           |
| ID utente                         | L'identificatore univoco del partecipante in Advocate. Viene usato per associare il saldo dei premi al singolo utente.                                                                                    |
| ID account                        | L'ID account interno associato al partecipante. È particolarmente rilevante se gli utenti appartengono a organizzazioni o a gruppi di account segmentati.                                                 |
| Email                             | L'indirizzo email del partecipante. Spesso viene usato per l'erogazione manuale dei premi o per la sincronizzazione con sistemi esterni.                                                                  |
| <p>Nome</p><p>Cognome</p>         | Nome e cognome del partecipante. Utili per la personalizzazione o per applicare filtri durante l'elaborazione dei premi.                                                                                  |
| Codice referral                   | Il codice referral assegnato al partecipante. È il codice che condivide per segnalare altre persone e monitorare l'idoneità ai premi.                                                                     |
| **Informazioni sul premio**       |                                                                                                                                                                                                           |
| Tipo                              | La categoria o la modalità del premio (ad es., *Denaro*, *Carta regalo*, *Punti*, *Personalizzato*). Aiuta a determinare come erogare o raggruppare i premi.                                              |
| Unità                             | L'unità di misura del valore del premio (ad es., *USD*, *ZAR*, *Punti*, *%*). È importante per calcolare i saldi e gestire le erogazioni a livello regionale.                                             |
| Importo                           | Il saldo totale disponibile dei premi in sospeso per questo utente. È il dato principale utilizzato per preparare le erogazioni o le esportazioni.                                                        |
| Credito totale assegnato          | L'importo totale del credito assegnato a questo utente (indipendentemente dal fatto che sia stato riscattato). Indica il costo complessivo del programma attribuito a questo partecipante.                |
| Credito totale riscattato         | La parte totale dei premi già riscattata dal partecipante. Utile per verificare i costi effettivi rispetto alle passività.                                                                                |
| Credito totale scaduto            | Totale dei premi assegnati all'utente ma scaduti prima di essere riscattati. Aiuta a monitorare i premi non riscossi o le opportunità di erogazione perse.                                                |
| **Metadati utente**               |                                                                                                                                                                                                           |
| URL immagine                      | URL dell'immagine del profilo o dell'avatar del partecipante (se raccolto). Ha principalmente una funzione estetica o viene usato nei dashboard rivolti agli utenti, se applicabile.                      |
| Primo IP rilevato                 | Il primo indirizzo IP registrato quando il partecipante è stato aggiunto o è diventato attivo. Utile per la conformità, la geolocalizzazione o l'analisi delle frodi.                                     |
| Ultimo IP rilevato                | L'indirizzo IP più recente associato al partecipante. Aiuta a determinare se l'utente è ancora attivo o coinvolto.                                                                                        |
| Data di creazione                 | La data di creazione dell'account del partecipante in Advocate. Utile per l'analisi delle coorti o per esaminare nel tempo il comportamento relativo ai premi.                                            |
| Fonte del referral                | La fonte o il canale originale attraverso cui è stato acquisito il partecipante (ad es., *email*, *organico*, *partner*). Aiuta a valutare la portata e l'efficacia del programma di referral per canale. |
| Impostazioni locali               | La lingua e l'impostazione regionale del partecipante (ad es., *en-US*, *fr-FR*). Sono importanti per le comunicazioni personalizzate o le opzioni di premio regionali.                                   |

</details>

#### Saldi dei premi disponibili per utente

Il *Saldi dei premi disponibili per utente* Il report fornisce un elenco dei premi non riscossi. Questo tipo di report è pensato per essere utilizzato nell’ambito dell’erogazione dei premi tramite il [processo di riscatto in blocco dei premi](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/redeem-rewards-in-bulk.md) .

<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à del premio
* Valuta del premio
* Importo disponibile

È possibile trovare l’elenco completo dei campi [scaricando il nostro file 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 sui saldi dei premi disponibili.

{% hint style="info" %}
**Nota**: questo report non include i dettagli relativi ai premi con sconto percentuale, serbatoio di carburante o carta regalo. Per maggiori dettagli su questi tipi di premio, usa il report *Saldi dei premi per utente* .
{% endhint %}

**Riferimento alle colonne del report**

| Colonna                           | Descrizione                                                                                                                                                                                                                                                                                                                                   |
| --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Informazioni sul partecipante** |                                                                                                                                                                                                                                                                                                                                               |
| Nome                              | Il nome del partecipante, usato per identificarlo o personalizzare l’elaborazione dei premi.                                                                                                                                                                                                                                                  |
| Cognome                           | Il cognome del partecipante.                                                                                                                                                                                                                                                                                                                  |
| Email                             | L’indirizzo email del partecipante, usato per inviare i premi o per confrontarlo con sistemi esterni, come un CRM o un fornitore di premi.                                                                                                                                                                                                    |
| ID utente                         | L’identificativo univoco assegnato al partecipante in Advocate.                                                                                                                                                                                                                                                                               |
| ID account                        | L’ID account interno associato al partecipante.                                                                                                                                                                                                                                                                                               |
| Segmenti                          | Tag o categorie usati per [raggruppare i partecipanti](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/manage-advocate-user-segments.md) (ad es., *per regione*, *fase del ciclo di vita*, *tipo di cliente*). Utili per filtrare o applicare regole di erogazione diverse. |
| **Stato e tempistiche dei premi** |                                                                                                                                                                                                                                                                                                                                               |
| Data del blocco                   | La data in cui all’utente è stato impedito di ricevere premi, se applicabile. Lo stato di blocco potrebbe impedirne il riscatto; questo campo indica quando è stato applicato il blocco.                                                                                                                                                      |
| **Dati del premio**               |                                                                                                                                                                                                                                                                                                                                               |
| Nome dell’unità                   | L’etichetta o il nome visualizzato dell’unità premio (ad es., *Denaro per referral*, *Credito del negozio*). Aiuta a distinguere tra i diversi tipi di premio che un programma può offrire.                                                                                                                                                   |
| Valuta                            | Il codice valuta dell’importo del premio (ad es., *USD*, *ZAR*, *EUR*). È necessario per erogare i premi, soprattutto tra paesi o sistemi di pagamento diversi.                                                                                                                                                                               |
| Valore disponibile                | L’importo del premio non riscosso attualmente disponibile per questo partecipante. È il valore principale da considerare per determinare l’importo da erogare.                                                                                                                                                                                |
| Valore da riscattare              | Il valore attualmente accodato per il riscatto (ad es., in attesa di erogazione in blocco o di elaborazione). È utile per evitare doppi riscatti o sovrapposizioni.                                                                                                                                                                           |
| Valore totale riscattato          | Il valore totale dei premi già riscattati dal partecipante. Fornisce informazioni sui riscatti precedenti e può essere utile per monitorare i limiti dei premi                                                                                                                                                                                |
| Unità                             | Il codice interno o di sistema dell’unità premio (ad es., *USD*, *punti*, ecc.). Potrebbe essere usato nelle chiamate API o nella logica interna durante l’erogazione.                                                                                                                                                                        |

</details>

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

Il report fiscale W-9 degli Stati Uniti mostra lo stato fiscale W-9 dei partecipanti statunitensi e i premi maturati 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 dei premi maturati per anno fiscale
* Numero totale di premi maturati da ciascun partecipante nell'anno fiscale

**Riferimento alle colonne del report**

| Colonna                                                               | Descrizione                                                                                                                                                                                                                                     |
| --------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Informazioni sul partecipante**                                     |                                                                                                                                                                                                                                                 |
| ID utente                                                             | 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 statunitense</p><p>AAAA-MM-GG</p> | La data in cui il modulo W-9 del partecipante è stato contrassegnato come inviato e acquisito in Advocate. È importante ai fini della conformità alle norme dell'IRS e per verificare lo stato della documentazione fiscale.                    |
| **Riepilogo per anno fiscale**                                        |                                                                                                                                                                                                                                                 |
| Anno                                                                  | L'anno fiscale in cui il partecipante ha maturato i premi. Viene usato per raggruppare i guadagni per anno solare ai fini dell'elaborazione dei moduli 1099.                                                                                    |
| Valore imponibile negli Stati Uniti in centesimi                      | Valore totale dei premi imponibili negli Stati Uniti maturati da questo partecipante nell'anno fiscale specificato, espresso in centesimi (ad es., 2500 = 25,00 $). Utile per i calcoli grezzi o per le integrazioni che richiedono precisione. |
| Valore imponibile negli Stati Uniti in dollari                        | Come sopra, ma visualizzato nel formato standard in dollari (ad es., 25,00). Più facile da consultare o da includere nei riepiloghi ufficiali.                                                                                                  |
| Numero di premi                                                       | Numero totale di singoli premi maturati dal partecipante nell'anno fiscale specificato. Utile per le tracce di controllo o per comprendere la frequenza dei premi e il coinvolgimento nel programma.                                            |

</details>

#### Pagamenti e imposte

Il *report Pagamenti e imposte* mostra lo stato fiscale dei partecipanti e i premi maturati o in sospeso, suddivisi per anno.

Se il programma prevede pagamenti in denaro ai partecipanti, saranno disponibili alcuni campi relativi allo stato dei moduli fiscali dei partecipanti.

<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, ad esempio un W-8 o un W-9, è stato contrassegnato come inviato
* Valore imponibile negli Stati Uniti dei premi maturati per anno fiscale
* Numero totale di premi maturati da ciascun partecipante nell'anno fiscale
* Lo stato del modulo fiscale, ad es., *valido*, *in sospeso*, oppure *in attesa*. Nel report sono inclusi anche i motivi per cui un pagamento è sospeso

**Riferimento alle colonne del report**

| Colonna                                                               | Descrizione                                                                                                                                                                                                                                                                                  |
| --------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Informazioni sul partecipante**                                     |                                                                                                                                                                                                                                                                                              |
| ID utente                                                             | Identificatore univoco del partecipante in Advocate.                                                                                                                                                                                                                                         |
| ID account                                                            | L'ID account del partecipante, usato per il raggruppamento o la rendicontazione organizzativa.                                                                                                                                                                                               |
| 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 statunitense</p><p>AAAA-MM-GG</p> | La data in cui il partecipante ha inviato il modulo W-9 (o il modulo fiscale statunitense pertinente). È importante per verificare l'idoneità fiscale prima di effettuare pagamenti in denaro.                                                                                               |
| **Riepilogo per anno dei pagamenti**                                  |                                                                                                                                                                                                                                                                                              |
| Anno                                                                  | L'anno solare in cui il partecipante ha maturato i premi.                                                                                                                                                                                                                                    |
| Valore                                                                | Valore totale dei pagamenti in unità minori (ad es., centesimi) maturati 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 facilitarne la consultazione (ad es., 17,50).                                                                                                                                                                           |
| Numero                                                                | Numero totale dei singoli premi corrisposti al partecipante nell'anno specificato. Utile per capire con quale frequenza il partecipante ha maturato pagamenti.                                                                                                                               |
| **Idoneità e stato dei pagamenti**                                    |                                                                                                                                                                                                                                                                                              |
| Pagamento sospeso                                                     | Indica se i pagamenti del partecipante sono attualmente sospesi (Sì o No). I pagamenti possono essere sospesi se mancano moduli fiscali o se la configurazione non è completa.                                                                                                               |
| Motivi della sospensione del pagamento                                | Spiega perché il pagamento del partecipante è sospeso (se applicabile). Esempi di motivi: *Modulo fiscale mancante*, *Informazioni bancarie non fornite*, *Verifica di conformità*.                                                                                                          |
| Valuta del pagamento                                                  | La valuta in cui i pagamenti del partecipante vengono o verranno elaborati (ad es., *USD*, *EUR*, *ZAR*). Importante per i sistemi di pagamento globali e la contabilità.                                                                                                                    |
| Configurazione dei pagamenti avviata                                  | Indica se il partecipante ha iniziato a configurare il proprio metodo di pagamento (ad es. tramite l’integrazione con un fornitore di servizi di pagamento). Aiuta a monitorare i progressi dell’onboarding o la necessità di ricontattare i partecipanti in attesa di ricevere i pagamenti. |

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.impact.com/brand/it/what-would-you-like-to-learn-about/advocate-program/advocate-reporting-and-analytics/advocate-program-reports-explained.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
