> 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
Segui il corso PXA
Advocate offre vari report scaricabili per i dati del tuo programma e dei partecipanti. Tutti i report hanno opzioni di filtro per darti un maggiore controllo sui dati che scarichi. Ogni report può essere scaricato come file .CSV o Excel.
Questo articolo spiega i diversi report e il tipo di dati che ciascuno include. Fai riferimento a [Esegui un report del programma Advocate](/brand/it/what-would-you-like-to-learn-about/advocate-program/advocate-reporting-and-analytics/run-an-advocate-program-report.md) per istruzioni sulla generazione di un report.
#### Report dei dettagli utente
Il *Dettagli utente* contiene informazioni dettagliate su ogni partecipante in tutti i tuoi programmi. Esporta un elenco di tutti i partecipanti per mantenere aggiornati i tuoi record con i link di condivisione e i codici di referral di Advocate.
Dettagli del report
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 includere facoltativamente:
* **Statistiche utente**, incluse informazioni analitiche sul partecipante come traffico, entrate e altro.
* **Link e codici di condivisione del referral**, se applicabile. Queste informazioni possono essere utili per aggiornare i record dei contatti nel tuo CMS o sistema email per includere i link e i codici di condivisione Advocate di ciascun partecipante.
L'elenco completo dei campi è disponibile quando [scarichi il nostro CSV di esempio](https://assets.ctfassets.net/s68ib1kj8k5n/7Am85AH6wmNdArmjRNW3vr/95f52c5d79311509d795a0be4c94166f/User_Details_Report_Sample.csv)  del report dei dettagli utente.
**Riferimento alle 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 (usato tra più programmi, se applicabile). |
| Email | L'indirizzo email del partecipante. |
| Nome | Il nome del partecipante. |
| Cognome | Il cognome del partecipante. |
| Hash email | Una versione hashata (crittografata) dell'email del partecipante, utile per corrispondenze conformi alla privacy con altri sistemi. |
| **Informazioni di referral e condivisione** | |
| Codice referral | Il codice univoco associato al partecipante, usato per tracciare i referral che genera. |
| Link di condivisione | Il link di referral univoco associato al partecipante. |
| Link di condivisione Facebook | Un link pre-generato per condividere il referral su Facebook. |
| Link di condivisione Twitter | Un link pre-generato per condividere il referral su Twitter. |
| Link di condivisione email | Un link pre-generato per condividere il referral via email. |
| Link di condivisione LinkedIn | Un link pre-generato per condividere il referral su LinkedIn. |
| Link di condivisione pulito | Una versione del link di referral senza parametri di tracciamento; più neutra per determinate piattaforme o casi d'uso. |
| **Geolocalizzazione e locale** | |
| IP del primo accesso | L'indirizzo IP dal quale 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 di invio del modulo fiscale USA | (Se applicabile) La data in cui è stato inviato un modulo fiscale statunitense per conformità o elaborazione del premio. |
| **Statistiche utente (se incluse nell'esportazione)** | |
| stats.date Modificata | L'ultima data in cui le statistiche del partecipante sono state aggiornate. |
| stats.traffico | Numero totale di visite generate dall'attività di referral del partecipante. |
| stats.referral | Numero totale di referral riusciti effettuati dal partecipante. |
| stats.conversioni | Numero totale di conversioni (ad es. acquisti, iscrizioni) risultate da quei referral. |
| stats.obiettivi | Numero di completamenti di obiettivi specifici associati all'attività di referral del partecipante (definiti in modo personalizzato nel programma). |
| stats.premi | Numero totale di premi guadagnati dal partecipante. |
| stats.caricamenti widget | Numero di volte in cui il widget di referral o l'interfaccia di condivisione è stato caricato da questo partecipante. |
| stats.entrate | Entrate totali generate dagli utenti segnalati da questo partecipante. |
| stats.entrate generate | Sinonimo di stats.revenue; alcuni report possono distinguere se le entrate provengono da più fonti. |
| stats.entrate da referral | Entrate attribuite specificamente ai partecipanti che si sono registrati o hanno acquistato tramite il link di referral di questo partecipante. |
| **Dati personalizzati** | |
| campi personalizzati.esempio | Un segnaposto per eventuali campi personalizzati definiti dal tuo programma (ad es., *ID fedeltà*, *note interne*, *tag regione*). Ogni campo apparirà come una propria colonna, preceduto da campi personalizzati. |
| **Altro** | |
| Fonte di referral | La fonte o il canale originale che ha portato il partecipante al tuo programma (ad es., *organico*, *email*, *sito partner*). |
#### Esportazione eventi utente
Il *Esportazione eventi utente* report fornisce un resoconto 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, una chiave evento, un ID utente e altro.
Dettagli del report
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 su evento e utente** | |
| ID evento | Un ID univoco generato per ogni evento ricevuto. Utile per il tracciamento, il debug o l'audit degli invii degli eventi. |
| Chiave evento | Il tipo o l'etichetta dell'evento, ad esempio `acquisto`, `registrazione`, o qualsiasi chiave definita in modo personalizzato inviata dal tuo sistema. |
| ID utente | L'identificatore univoco del partecipante in Advocate a cui l'evento è associato. |
| ID account | L'ID account associato all'utente, particolarmente rilevante nei programmi in cui gli utenti possono appartenere a diverse strutture di account. |
| **Timestamp dell'evento** | |
| Data evento attivato – YYYY-MM-DD | La data in cui l'evento è effettivamente avvenuto (come riportato dal tuo sistema). Ad esempio, la data in cui si è verificato 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 di elaborazioni batch o ritardi del sistema. |
| Data di elaborazione dell'evento – YYYY-MM-DD | La data in cui l'evento è stato elaborato con successo e salvato in Advocate. Segna il momento in cui l'evento è diventato utilizzabile per il tracciamento, i premi o i report. |
| **Campi dati evento (se inclusi nei payload degli eventi)** | |
| fields.coupon | Qualsiasi codice coupon o sconto applicato durante l'evento, se inviato nei dati dell'evento. Utile per tracciare l'uso degli incentivi o specifici trigger promozionali. |
| fields.entrate | L'importo delle entrate associato all'evento. Tipicamente usato negli eventi di acquisto per calcolare performance, premi o ROI. |
| fields.valuta | Il codice valuta (ad es., *USD*, *ZAR*, *EUR*) associato all'importo delle entrate. Importante quando si riportano dati tra regioni o si calcolano premi adeguati al cambio. |
| fields.data di creazione lead | 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. |
#### Cronologia premi
Il *Cronologia 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, oltre a ottenere lo stato di tutti i tuoi premi in un determinato momento.
Dettagli del report
Per impostazione predefinita, il report includerà **campi premio** informazioni come:
* ID premio
* Tipo di ricompensa
* 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)  o [JSONL di esempio](https://assets.ctfassets.net/s68ib1kj8k5n/5BeuDmYM1WFAySjqntGeji/f321cf59a96d45061645d971e06fb569/Reward_Details_Example_Report_JSONL.jsonl)  dei report dei dettagli premio.
Quando generi il report, puoi includere facoltativamente:
* **Dettagli 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 segnalato e altro.
**Riferimento alle colonne del report**
| Colonna | Descrizione |
| ------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Informazioni premio** | |
| ID | ID univoco dell'istanza del premio (generato da Advocate). |
| Tipo | La categoria o il tipo di premio (ad es. *Contanti*, *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](/brand/it/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/create-a-reward.md)). |
| Fonte del premio | Descrive cosa ha attivato il premio (ad es., *Riferimento*, *Obiettivo*, *Manuale*, *API*). |
| Tipo 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'evasione esterna (ad es., codice voucher o carta regalo). |
| ID programma | ID del programma Advocate in cui il premio è stato emesso. |
| Chiave premio del programma | Identificatore interno per la specifica configurazione del premio usata all'interno del programma. |
| Chiave premio globale | Identificatore cross-programma per i premi configurati a livello globale (se applicabile). |
| **Timestamp del premio** | |
| Data di creazione | Quando il record del premio è stato creato nel sistema. |
| Data programmata per | Quando il premio era programmato per essere emesso (ad es., dopo un ritardo o un periodo di attesa). |
| Data assegnata | Quando il premio è stato effettivamente emesso 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 riscattata | La data in cui il partecipante ha riscattato il premio (se applicabile). |
| Data di modifica | La data dell'aggiornamento più recente apportato al record del premio. |
| **Tracciamento credito e valore** | |
| Credito assegnato | L'importo del credito assegnato a questo premio (in alcuni modelli può differire dal valore). |
| Credito riscattato | L'importo di credito riscattato dal premio. |
| Valore disponibile | La parte rimanente non utilizzata o non riscattata del premio. |
| **Stato del premio e messaggistica** | |
| Stati | Stato attuale del premio (ad es., *In sospeso*, *Programmato*, *Erogato*, *Scaduto*, *Annullato*). |
| meta.stato | Stato tecnico o a livello di sistema (utile per diagnostica o gestione errori). |
| meta.messaggio | Messaggio associato alla consegna del premio (ad es., “Premio consegnato con successo”). |
| meta.messaggio interno | Note riservate agli amministratori (ad es., spiegazioni di errori o flag). |
| meta.data Modificata | Ultimo aggiornamento dei metadati relativi al premio. |
| 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 il premio. |
| user.account Id | L'ID account associato dell'utente in Advocate. |
| user.first Name
user.last Name
user.email
| Informazioni di base sul partecipante incluse per riferimento o corrispondenza CRM. |
| **Contesto del referral (se il premio è basato su referral)** | |
| referral.id | L'ID del referral che ha attivato questo premio. |
| referral.data Inizio referral | Quando l'azione di referral è iniziata (ad es., evento di clic o condivisione). |
| referral.data Modificata | Quando il record del referral è stato aggiornato l'ultima volta. |
| referral.codice referral usato | Il codice usato dall'utente segnalato per iscriversi o compiere un'azione. |
| **Informazioni sull'utente segnalato (amico)** | |
| referral.utente segnalato.id | ID della persona segnalata (l'“amico”). |
| referral.utente segnalato.ID account | L'ID account univoco del segnalatore. |
| referral.utente segnalato.nome
referral.utente segnalato.cognome
referral.utente segnalato.email
| I dettagli di contatto di base del segnalatore. |
| **Informazioni sul segnalatore (Advocate)** | |
| referral.utente segnalatore.id | ID della persona che ha effettuato il referral (l'“advocate”). |
| referral.utente segnalatore.ID account | L'ID account univoco del segnalatore. |
| referral.utente segnalatore.nome
referral.utente segnalatore.cognome
referral.utente segnalatore.email
| I dettagli di contatto di base del segnalatore. |
| referral.data Conversione | La data in cui il referral è stato ufficialmente convertito (ad es., iscrizione o acquisto completato), attivando il premio. |
#### Cronologia referral
Il *Cronologia referral* report fornisce un resoconto dello stato di ciascuna connessione di referral creata nel tuo programma di referral. Queste informazioni possono essere utili per verificare il successo del tuo programma e monitorare il numero di nuovi clienti portati dal tuo programma.
Dettagli del report
Per impostazione predefinita, il report include:
* Dettagli dell'amico segnalato 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 premio
L'elenco completo dei campi è disponibile quando [scarichi il nostro CSV di esempio](https://assets.ctfassets.net/s68ib1kj8k5n/7B4pBHawfu9GtzE5mL1yo2/4fd194ee3080c5190639abab70b35e47/Referral_Activity_Report.csv)  report di attività di referral.
**Riferimento alle colonne del report**
| Colonna | Descrizione |
| -------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| **Metadati del referral** | |
| ID | Identificatore univoco del record di referral in Advocate. |
| Data di modifica | La data più recente in cui è stata aggiornata una parte qualsiasi del record di referral. |
| Data inizio referral | Quando il referral è stato avviato per la prima volta (ad es., quando l'utente segnalato ha fatto clic su un link di referral). |
| Data di conversione | Quando il referral si è convertito, in genere quando l'utente segnalato ha completato l'azione richiesta (come registrazione o acquisto). |
| Data di modifica utente | L'ultima volta che i dati dell'utente coinvolto in questo referral (segnalatore o segnalato) sono stati aggiornati. |
| ID programma | L'ID del programma di referral Advocate a cui appartiene questo referral. |
| Nome programma | Il nome del programma di referral, utile se si gestiscono più programmi. |
| **Informazioni sull'amico segnalato (nuovo cliente)** | |
| Email utente segnalato
Nome utente segnalato
Cognome utente segnalato
| Informazioni di base sull'identità dell'utente segnalato. |
| Codice referral dell'utente segnalato | Il codice di referral assegnato all'utente segnalato (nel caso in cui possa a sua volta segnalare altri in seguito). |
| IP del primo accesso dell'utente segnalato
IP dell'ultimo accesso dell'utente segnalato
| Indirizzi IP registrati alla prima e all'attività più recente dell'utente segnalato. |
| URL immagine utente segnalato | URL dell'immagine o dell'avatar dell'utente segnalato, se acquisito o assegnato. |
| Locale utente segnalato | Impostazione lingua/area geografica (ad es., *en-US*, *fr-FR*) dell'utente segnalato. |
| Data di creazione dell'utente segnalato | La data in cui l'account dell'utente segnalato è stato creato in Advocate. |
| Utente segnalato | ID interno dell'utente segnalato nel sistema Advocate. |
| Account segnalato | ID account interno collegato all'utente segnalato (usato nei programmi multi-account). |
| **Informazioni sul segnalatore (customer advocate)** | |
| Email utente segnalatore
Nome utente segnalatore
Cognome utente segnalatore
| Informazioni di base sull'identità del partecipante segnalatore. |
| Codice referral dell'utente segnalatore | Il codice di referral appartenente al segnalatore, il codice che l'utente segnalato probabilmente ha usato. |
| IP del primo accesso dell'utente segnalatore
IP dell'ultimo accesso dell'utente segnalatore
| Indirizzi IP registrati alla prima e all'attività più recente del segnalatore. |
| URL immagine utente segnalatore | L'URL dell'immagine o dell'avatar del segnalatore. |
| Locale utente segnalatore | Impostazione locale del segnalatore. |
| Data di creazione dell'utente segnalatore | Quando il segnalatore si è unito per la prima volta o è stato registrato nel sistema. |
| Utente segnalatore | ID interno del segnalatore in Advocate. |
| Account segnalatore | ID account associato al referrer. |
| **Moderazione e stato** | |
| Stato di moderazione | Stato complessivo di moderazione della segnalazione. (Ad es., *Approvato*, *Rifiutato*, *In sospeso*.) |
| Data di moderazione | La data in cui è stata presa la decisione di moderazione (approvazione/rifiuto). |
| Data di pagamento della segnalazione | Quando è stata erogata l'eventuale ricompensa associata alla segnalazione. |
| Data di fine della segnalazione | Quando la segnalazione è stata ufficialmente chiusa (ad es., per scadenza o completamento). |
| Stato di moderazione del segnalato | Stato di moderazione specifico della parte della segnalazione relativa all'utente segnalato. |
| Stato di moderazione del referrer | Stato di moderazione specifico della parte della segnalazione relativa al referrer. |
| **Riferimenti alle ricompense** | |
| Ricompensa del segnalato | L'ID o riferimento della ricompensa assegnata all'utente segnalato (se applicabile). |
| Ricompensa del referrer | L'ID o riferimento della ricompensa assegnata al referrer (se applicabile). |
#### Saldi delle ricompense per utente
Il *Saldi delle ricompense per utente* Il rapporto fornisce un registro delle ricompense in sospeso, incluso il valore e il destinatario previsto, generate tramite il tuo programma di referral. Questo rapporto viene spesso usato come parte dell'erogazione manuale delle ricompense, oppure come parte di un processo batch verso un sistema come Tango Card. Può anche essere utile per tenere traccia di quanto ha erogato il tuo programma di referral in un determinato periodo di tempo.
Dettagli del report
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
L'elenco completo dei campi è disponibile quando [scarichi il nostro CSV di esempio](https://assets.ctfassets.net/s68ib1kj8k5n/5iv0ByBQquLwShSyRjawck/e04b55a4e5afe24c01d5192c10682aab/Reward_Balances_by_User.csv)  rapporto sui saldi delle ricompense.
**Riferimento alle colonne del report**
| Colonna | Descrizione |
| --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Informazioni sul partecipante** | |
| ID utente | L'identificativo univoco del partecipante in Advocate. Usato per ricondurre 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'erogazione manuale delle ricompense o per la sincronizzazione con sistemi esterni. |
| Nome
Cognome
| 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. È quello che condivide per segnalare altri e monitorare l'idoneità alla ricompensa. |
| **Informazioni premio** | |
| Tipo | La categoria o il metodo della ricompensa (ad es., *Contanti*, *Buono regalo*, *Punti*, *Personalizzato*). Aiuta a stabilire come le ricompense devono essere erogate 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 quando si preparano i pagamenti o le esportazioni. |
| Credito totale assegnato | L'importo totale di credito che è stato assegnato a questo utente in qualunque momento (indipendentemente dal riscatto). Riflette il costo complessivo del programma allocato a questo partecipante. |
| Credito totale riscattato | La parte totale delle ricompense che questo partecipante ha già riscattato. Utile per verificare i costi effettivi rispetto alle passività. |
| Credito totale scaduto | Il totale delle ricompense assegnate all'utente ma scadute prima di essere riscattate. Aiuta a tenere traccia delle ricompense non reclamate o delle opportunità di erogazione perse. |
| **Metadati dell'utente** | |
| URL immagine | URL dell'immagine del profilo o dell'avatar del partecipante (se raccolta). Principalmente estetico o usato nelle dashboard rivolte agli utenti, se applicabile. |
| IP del primo accesso | Il primo indirizzo IP registrato quando il partecipante è stato aggiunto o è diventato attivo. Utile per conformità, geolocalizzazione o analisi antifrode. |
| Ultimo IP visto | L'indirizzo IP più recente associato al partecipante. Aiuta a stabilire 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 per coorti o del comportamento delle ricompense nel tempo. |
| Fonte di referral | La fonte o il canale originario attraverso cui il partecipante è stato acquisito (ad es., *email*, *organico*, *partner*). Aiuta a valutare la portata e l'efficacia del programma di referral per canale. |
| Locale | La lingua e l'impostazione regionale del partecipante (ad es., *en-US*, *fr-FR*). Importante per comunicazioni personalizzate o opzioni di ricompensa regionali. |
#### Saldi dei premi disponibili per utente
Il *Saldi dei premi disponibili per utente* Il rapporto fornisce un elenco delle ricompense non riscattate. Questo tipo di rapporto è destinato a essere usato come parte dell'erogazione delle ricompense tramite il [riscatto massivo delle ricompense](/brand/it/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/redeem-rewards-in-bulk.md) processo.
Dettagli del report
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
L'elenco completo dei campi è disponibile quando [scarichi il nostro CSV di esempio](https://assets.ctfassets.net/s68ib1kj8k5n/7CggBzV2U5EoJqp1HFF5SA/f3b417f460c0d960f8429b26824a225b/Available_Reward_Balances_by_User.csv)  nel rapporto sui saldi delle ricompense disponibili.
{% hint style="info" %}
**Nota**: Questo rapporto non include dettagli sulle ricompense Sconto percentuale, Fuel Tank o Gift Card. Usa il *Saldi delle ricompense per utente* rapporto per maggiori dettagli su questi tipi di ricompense.
{% endhint %}
**Riferimento alle 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 confrontarle con sistemi esterni come un CRM o un fornitore di ricompense. |
| ID utente | L'identificativo univoco assegnato al partecipante in Advocate. |
| ID account | L'ID account interno collegato al partecipante. |
| Segmenti | Tag o categorie usati per [raggruppare i partecipanti](/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*). Utile per filtrare o applicare regole di erogazione diverse. |
| **Stato e tempistiche della ricompensa** | |
| Data di blocco | La data in cui all'utente è stato impedito di ricevere ricompense, se applicabile. Uno stato di blocco potrebbe impedire il riscatto; questo campo indica quando è stato applicato il blocco. |
| **Dati della ricompensa** | |
| Nome dell'unità | L'etichetta o nome visualizzato dell'unità della ricompensa (ad es., *Contanti da 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 es., *USD*, *ZAR*, *EUR*). Necessario quando si erogano ricompense, specialmente tra paesi o sistemi di pagamento. |
| Valore disponibile | L'importo della ricompensa non riscattata attualmente disponibile per questo partecipante. Questo è il valore principale usato per determinare cosa erogare. |
| Valore da riscattare | Il valore attualmente in coda per il riscatto (ad es., in attesa in un'erogazione massiva o di elaborazione). Utile per evitare doppi riscatti o assicurare che non vi siano sovrapposizioni nei riscatti. |
| Valore totale riscattato | Il valore totale delle ricompense che questo partecipante ha già riscattato. Offre informazioni sui riscatti passati e può essere utile per tenere traccia dei limiti massimi di ricompensa |
| Unità | Il codice interno o di sistema per l'unità della ricompensa (ad es., *USD*, *punti*, ecc.). Potrebbe essere usato nelle chiamate API o nella logica interna durante l'erogazione. |
#### Rapporto fiscale W-9 statunitense
Il rapporto fiscale W-9 statunitense mostra lo stato fiscale W-9 statunitense dei partecipanti e le ricompense maturate o in sospeso per anno.
Dettagli del report
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 USA delle ricompense maturate per anno fiscale
* Numero totale di ricompense maturate da ciascun partecipante nell'anno fiscale
**Riferimento alle 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 | L'indirizzo email del partecipante. |
| Nome | Il nome del partecipante. |
| Cognome | Il cognome del partecipante. |
| **Informazioni fiscali W-9** | |
| Data di invio del modulo fiscale USA
YYYY-MM-DD
| 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 maturato le ricompense. Usato per raggruppare i guadagni per anno solare per l'elaborazione 1099. |
| Valore imponibile USA in centesimi | Valore totale delle ricompense imponibili negli Stati Uniti maturate da questo partecipante nell'anno fiscale specificato, espresso in centesimi (ad es., 2500 = $25.00). Utile per calcoli grezzi o integrazioni in cui è richiesta precisione. |
| Valore imponibile USA in dollari | Stesso valore, ma visualizzato nel formato standard in dollari (ad es., 25.00). Più facile da verificare o includere in riepiloghi ufficiali. |
| Conteggio ricompense | Numero totale di singole ricompense maturate dal partecipante nell'anno fiscale specificato. Utile per le tracce di audit o per comprendere la frequenza delle ricompense e il coinvolgimento nel programma. |
#### Erogazioni e tasse
Il *Erogazione e tasse* Il rapporto mostra lo stato fiscale dei partecipanti e le ricompense maturate o in sospeso per anno.
Se il tuo programma offre pagamenti in contanti ai partecipanti, saranno resi disponibili alcuni campi relativi allo stato del modulo fiscale del partecipante.
Dettagli del report
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 un W-9 — è stato contrassegnato come inviato
* Valore imponibile negli USA delle ricompense maturate per anno fiscale
* Numero totale di ricompense maturate da ciascun partecipante nell'anno fiscale
* Lo stato del modulo fiscale, ad es., *valido*, *in sospeso*, oppure *in sospeso*. Nel rapporto sono incluse anche le ragioni del blocco delle erogazioni
**Riferimento alle colonne del report**
| Colonna | Descrizione |
| ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Informazioni sul partecipante** | |
| ID utente | L'identificativo univoco del partecipante in Advocate. |
| ID account | L'ID account del partecipante, usato per raggruppamento o reportistica organizzativa. |
| Email | L'indirizzo email del partecipante. |
| Nome | Il nome del partecipante. |
| Cognome | Il cognome del partecipante. |
| **Informazioni fiscali W-9** | |
| Data di invio del modulo fiscale USA
YYYY-MM-DD
| La data in cui il partecipante ha inviato il modulo W-9 (o il relativo modulo fiscale statunitense). Importante per verificare l'idoneità fiscale prima di erogare pagamenti in contanti. |
| **Riepilogo dell'anno di erogazione** | |
| Anno | L'anno solare in cui il partecipante ha maturato le ricompense. |
| Valore | Valore totale delle erogazioni in unità minori (ad es., centesimi) maturato o in sospeso per questo partecipante durante l'anno. Ad esempio, 1750 = $17.50. |
| Valore in dollari | Stesso valore, visualizzato nel formato valuta standard per una facile verifica (ad es., 17.50). |
| Conteggio | Numero totale di singole istanze di ricompense di erogazione per il partecipante nell'anno specificato. Utile per capire con quale frequenza un partecipante ha maturato erogazioni. |
| **Idoneità e stato dell'erogazione** | |
| Blocco dell'erogazione | Indica se le erogazioni del partecipante sono attualmente in sospeso (Sì o No). Le erogazioni possono essere sospese a causa di moduli fiscali mancanti o configurazione incompleta. |
| Motivi del blocco dell'erogazione | Spiega perché il partecipante è in blocco erogazioni (se applicabile). Esempi di motivi: *Modulo fiscale mancante*, *Informazioni bancarie non fornite*, *Revisione di conformità*. |
| Valuta dell'erogazione | La valuta in cui le erogazioni del partecipante sono o saranno elaborate (ad es., *USD*, *EUR*, *ZAR*). Importante per i sistemi di erogazione globali e la contabilità. |
| Avvio configurazione erogazione | Indica se il partecipante ha iniziato a configurare il proprio metodo di erogazione (ad es., tramite un'integrazione con un fornitore di pagamenti). Aiuta a monitorare l'avanzamento dell'onboarding o eventuali azioni di follow-up per le erogazioni in sospeso. |
---
# 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
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=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.