> 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 dispongono di opzioni di filtro per offrirti un maggiore controllo sui dati che scarichi. Ogni report può essere scaricato come file .CSV o Excel. Questo articolo spiega i diversi report e 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 su come generare un report. #### Report dei dettagli utente Il *Dettagli utente* il report contiene informazioni dettagliate su ciascun partecipante in tutti i tuoi programmi. Esporta un elenco di tutti i partecipanti per mantenere aggiornati i tuoi record con i link di condivisione e i codici 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**, comprese informazioni di analisi sul partecipante come traffico, ricavi 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, includendo i link e i codici di condivisione Advocate di ciascun partecipante. Un elenco completo dei campi è disponibile quando [scarichi il nostro CSV di esempio](https://assets.ctfassets.net/s68ib1kj8k5n/7Am85AH6wmNdArmjRNW3vr/95f52c5d79311509d795a0be4c94166f/User_Details_Report_Sample.csv) ![](/files/9dd6b56c8e6674cad6e2bac8013a48849cd2f09c) 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 (utilizzato su 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 l'abbinamento conforme alla privacy con altri sistemi. | | **Informazioni su referral e condivisione** | | | Codice referral | Il codice univoco associato al partecipante, utilizzato per tracciare i referral che genera. | | Link condivisibile | 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 alcune piattaforme o casi d'uso. | | **Geolocalizzazione e impostazioni locali** | | | IP visto per la prima volta | L'indirizzo IP da cui il partecipante è stato registrato per la prima volta. | | IP visto più di recente | L'indirizzo IP più recente rilevato per questo partecipante. | | Impostazioni locali | La lingua preferita del partecipante e le impostazioni regionali (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 l'account del partecipante è stato creato in Advocate. | | Data di invio del modulo fiscale statunitense | (Se applicabile) La data in cui è stato inviato un modulo fiscale statunitense per la conformità o l'elaborazione dei premi. | | **Statistiche utente (se incluse nell'esportazione)** | | | stats.data 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.widget caricamenti | Numero di volte in cui il widget di referral o l'interfaccia di condivisione è stato caricato da questo partecipante. | | stats.ricavi | Ricavi totali generati dagli utenti referenziati da questo partecipante. | | stats.ricavi generati | Sinonimo di stats.revenue; alcuni report possono distinguerlo se i ricavi provengono da più fonti. | | stats.ricavi referenziati | Ricavi attribuiti specificamente ai partecipanti che si sono iscritti 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, con il prefisso campi personalizzati. | | **Altro** | | | Sorgente del referral | La sorgente o il canale originale che ha portato il partecipante al tuo programma (ad es., *organico*, *email*, *sito partner*). |
#### Esportazione degli eventi utente Il *Esportazione eventi utente* il report fornisce un registro di tutti gli eventi utente che abbiamo ricevuto dalla tua organizzazione per il tuo programma Advocate. Puoi applicare filtri per restringere un intervallo di tempo, una chiave evento, un ID utente e altro ancora.
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 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 `purchase`, `registrazione`, o qualsiasi chiave definita personalizzata che il tuo sistema invia. | | ID utente | L'identificatore univoco del partecipante in Advocate a cui è associato l'evento. | | ID account | L'ID account associato all'utente, particolarmente rilevante nei programmi in cui gli utenti possono appartenere a strutture di account diverse. | | **Timestamp dell'evento** | | | Data di attivazione dell'evento – 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 aggregazioni o ritardi del sistema. | | Data di elaborazione dell'evento – YYYY-MM-DD | La data in cui l'evento è stato elaborato e archiviato con successo in Advocate. Segna il momento in cui l'evento è diventato utilizzabile per tracciamento, premi o reportistica. | | **Campi dati dell'evento (se inclusi nei payload dell'evento)** | | | fields.coupon | Qualsiasi coupon o codice sconto applicato durante l'evento, se inviato nei dati dell'evento. Utile per tracciare l'uso degli incentivi o specifici trigger promozionali. | | fields.ricavi | L'importo dei ricavi associati 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 dei ricavi. Importante quando si riportano dati tra regioni o si calcolano premi adeguati al tasso di cambio. | | fields.data 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 dei premi Il *Cronologia dei premi* il report fornisce un registro dettagliato di ciascuno dei tuoi premi e delle relazioni con partecipanti e referral. Queste informazioni possono essere utili per creare bilanci, oltre che per ottenere lo stato di tutti i tuoi premi in un dato momento.
Dettagli del report Per impostazione predefinita, il report includerà **campi premio** informazioni come: * ID premio * Tipo di premio * Valore del premio Un 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) ![](/files/9dd6b56c8e6674cad6e2bac8013a48849cd2f09c) oppure [JSONL di esempio](https://assets.ctfassets.net/s68ib1kj8k5n/5BeuDmYM1WFAySjqntGeji/f321cf59a96d45061645d971e06fb569/Reward_Details_Example_Report_JSONL.jsonl) ![](/files/9dd6b56c8e6674cad6e2bac8013a48849cd2f09c) rapporti dettagliati sui premi. Quando generi il report, puoi includere facoltativamente: * **Dettagli del partecipante** come nome, ID utente e account, indirizzo email, campi personalizzati, segmenti e informazioni di referral (se applicabile). * **Campi referral** come ID referral, campi customer advocate, campi amico referenziato 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. *Contanti*, *Carta regalo*, *Buono*, *Personalizzata*). | | 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., *Referral*, *Obiettivo*, *Manuale*, *API*). | | Tipo Fuel Tank | Il tipo di fondo premio utilizzato (se si usa l'integrazione FuelTank). Ad es., *Prepagato*, *Carta 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 è stato emesso il premio. | | Chiave premio del programma | Identificatore interno per la specifica configurazione del premio utilizzata all'interno del programma. | | Chiave premio globale | Identificatore interprogramma 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 prevista per | Quando il premio era programmato per essere emesso (ad es., dopo un ritardo o un periodo di attesa). | | Data di assegnazione | 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 cancellato. | | Data di riscatto | La data in cui il partecipante ha riscattato il premio (se applicabile). | | Data di modifica | La data dell'ultimo aggiornamento apportato al record del premio. | | **Tracciamento di credito e valore** | | | Credito assegnato | L'importo di 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 del premio non utilizzata o non riscattata. | | **Stato del premio e messaggistica** | | | Stati | Stato attuale del premio (ad es., *In sospeso*, *Programmato*, *Assegnato*, *Scaduto*, *Annullato*). | | meta.stato | Stato tecnico o di sistema (utile per diagnostica o gestione degli errori). | | meta.messaggio | Messaggio associato alla consegna del premio (ad es., “Premio consegnato con successo”). | | meta.messaggio interno | Note solo interne per gli amministratori (ad es., spiegazioni di errori o flag). | | meta.data modificata | Ultima volta in cui sono stati aggiornati i 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.nome

user.cognome

user.email

| Informazioni di base sul partecipante incluse come riferimento o per l'abbinamento CRM. | | **Contesto del referral (se il premio si basa su referral)** | | | referral.id | L'ID del referral che ha attivato questo premio. | | referral.data inizio referral | Quando è iniziata l'azione di referral (ad es., evento di click o condivisione). | | referral.data modificata | Quando il record di referral è stato aggiornato l'ultima volta. | | referral.codice referral utilizzato | Il codice che l'utente referenziato ha usato per iscriversi o agire. | | **Informazioni sull'utente referenziato (amico)** | | | referral.utente referenziato.id | ID della persona che è stata referenziata (l'“amico”). | | referral.utente referenziato.account ID | L'ID account univoco di chi ha effettuato il referral. | |

referral.utente referenziato.nome

referral.utente referenziato.cognome

referral.utente referenziato.email

| I dettagli di contatto di base di chi ha effettuato il referral. | | **Informazioni sul referrer (customer advocate)** | | | referral.referrer User.id | ID della persona che ha effettuato il referral (l'“advocate”). | | referral.referrer User.account ID | L'ID account univoco di chi ha effettuato il referral. | |

referral.referrer User.nome

referral.referrer User.cognome

referral.referrer User.email

| I dettagli di contatto di base di chi ha effettuato il referral. | | referral.data convertita | La data in cui il referral è stato ufficialmente convertito (ad es., iscrizione o acquisto completato), attivando il premio. |
#### Cronologia dei referral Il *Cronologia dei referral* il report fornisce un registro dello stato di ciascuna connessione di referral effettuata nel tuo programma di referral. Queste informazioni possono essere utili per verificare il successo del tuo programma e monitorare il numero di nuovi clienti che il tuo programma ha acquisito.
Dettagli del report Per impostazione predefinita, il report include: * Dettagli dell'amico referenziato, come nome, ID utente e account, indirizzo email e altro ancora * Dettagli del customer advocate, come nome, ID utente e account, indirizzo email e altro ancora * Stato del referral * Stato di moderazione * ID premio Un elenco completo dei campi è disponibile quando [scarichi il nostro CSV di esempio](https://assets.ctfassets.net/s68ib1kj8k5n/7B4pBHawfu9GtzE5mL1yo2/4fd194ee3080c5190639abab70b35e47/Referral_Activity_Report.csv) ![](/files/9dd6b56c8e6674cad6e2bac8013a48849cd2f09c) report di attività di referral. **Riferimento alle colonne del report** | Colonna | Descrizione | | ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Metadati referral** | | | ID | Identificatore univoco del record di referral in Advocate. | | Data di modifica | La data più recente in cui è stata aggiornata qualsiasi parte del record di referral. | | Data di inizio referral | Quando il referral è stato avviato per la prima volta (ad es., quando l'utente referenziato ha fatto clic su un link di referral). | | Data di conversione | Quando il referral è stato convertito, di solito quando l'utente referenziato ha completato l'azione richiesta (come una registrazione o un acquisto). | | Data modifica utente | L'ultima volta in cui i dati dell'utente coinvolti in questo referral (chi ha effettuato o chi ha ricevuto il referral) 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 referenziato (nuovo cliente)** | | |

Email utente referenziato

Nome utente referenziato

Cognome utente referenziato

| Informazioni di base sull'identità dell'utente referenziato. | | Codice referral dell'utente referenziato | Il codice di referral assegnato all'utente referenziato (nel caso in cui possa a sua volta referenziare altri in seguito). | |

IP visto per la prima volta dell'utente referenziato

IP visto più di recente dell'utente referenziato

| Indirizzi IP registrati alla prima e all'attività più recente dell'utente referenziato. | | URL immagine utente referenziato | URL dell'immagine o dell'avatar, se acquisito o assegnato all'utente referenziato. | | Impostazioni locali utente referenziato | Impostazione lingua/regione (ad es., *en-US*, *fr-FR*) dell'utente referenziato. | | Data creazione utente referenziato | La data in cui l'account dell'utente referenziato è stato creato in Advocate. | | Utente referenziato | ID interno dell'utente referenziato nel sistema Advocate. | | Account referenziato | ID account interno collegato all'utente referenziato (usato in programmi multi-account). | | **Informazioni sul referrer (customer advocate)** | | |

Email utente referrer

Nome utente referrer

Cognome utente referrer

| Informazioni di base sull'identità del partecipante che effettua il referral. | | Codice referral utente referrer | Il codice di referral appartenente al referrer, il codice che probabilmente è stato usato dall'utente referenziato. | |

IP visto per la prima volta dell'utente referrer

IP visto più di recente dell'utente referrer

| Indirizzi IP registrati alla prima e all'attività più recente del referrer. | | URL immagine utente referrer | L'URL dell'immagine o dell'avatar del referrer. | | Impostazioni locali utente referrer | Impostazione locale del referrer. | | Data creazione utente referrer | Quando il referrer si è unito per la prima volta o è stato registrato nel sistema. | | Utente referrer | ID interno del referrer in Advocate. | | Account referrer | ID account associato al referrer. | | **Moderazione e stato** | | | Stato di moderazione | Stato complessivo di moderazione del referral. (Ad es., *Approvata*, *Rifiutati*, *In sospeso*.) | | Data di moderazione | La data in cui è stata presa la decisione di moderazione (approvazione/rifiuto). | | Data pagamento referral | Quando è stato pagato qualsiasi premio associato al referral. | | Data fine referral | Quando il record di referral è stato ufficialmente chiuso (ad es., per scadenza o completamento). | | Stato moderazione utente referenziato | Stato di moderazione specifico della parte del referral relativa all'utente referenziato. | | Stato di moderazione del referrer | Stato di moderazione specifico per la parte della segnalazione del referrer. | | **Riferimenti della ricompensa** | | | Ricompensa del segnalato | L'ID della ricompensa o il riferimento assegnato all'utente segnalato (se applicabile). | | Ricompensa del referrer | L'ID della ricompensa o il riferimento assegnato al referrer (se applicabile). |
#### Saldi delle ricompense per utente Il *Saldi delle ricompense per utente* Il report fornisce un registro delle ricompense in sospeso, inclusi il valore e il destinatario previsto, generate tramite il tuo programma di referral. Questo report viene spesso usato come parte dell'assegnazione manuale delle ricompense o come parte di un processo batch verso un sistema come Tango Card. Può anche essere utile per tenere traccia di quanto il tuo programma di referral ha pagato 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 Un elenco completo dei campi è disponibile quando [scarichi il nostro CSV di esempio](https://assets.ctfassets.net/s68ib1kj8k5n/5iv0ByBQquLwShSyRjawck/e04b55a4e5afe24c01d5192c10682aab/Reward_Balances_by_User.csv) ![](/files/9dd6b56c8e6674cad6e2bac8013a48849cd2f09c) report dei saldi delle ricompense. **Riferimento alle colonne del report** | Colonna | Descrizione | | --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Informazioni sul partecipante** | | | ID utente | L'identificatore univoco del partecipante in Advocate. Usato per collegare il saldo della ricompensa al singolo utente. | | ID account | L'ID account interno associato al partecipante. Particolarmente rilevante se gli utenti appartengono a organizzazioni o gruppi di account segmentati. | | Email | L'indirizzo email del partecipante. Spesso usato per l'assegnazione manuale delle ricompense o per la sincronizzazione con sistemi esterni. | |

Nome

Cognome

| Nome e cognome del partecipante. Utile per la personalizzazione o il filtraggio durante l'elaborazione delle ricompense. | | Codice referral | Il codice di referral assegnato al partecipante. È ciò che condividono per segnalare altri e tracciare l'idoneità alle ricompense. | | **Informazioni sul premio** | | | Tipo | La categoria o il metodo della ricompensa (ad es., *Contanti*, *Carta regalo*, *Punti*, *Personalizzata*). Aiuta a determinare 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. | | Amount | Il saldo totale disponibile delle ricompense in sospeso per questo utente. Questo è il valore principale usato quando si preparano pagamenti o esportazioni. | | Credito totale assegnato | L'importo totale di credito che è mai stato assegnato a questo utente (indipendentemente dal riscatto). Riflette il costo complessivo del programma allocato a questo partecipante. | | Credito totale riscattato | La porzione totale di ricompense che questo partecipante ha già riscattato. Utile per verificare i costi effettivi rispetto alle passività. | | Credito totale scaduto | Ricompense totali assegnate all'utente ma scadute prima di essere riscattate. Aiuta a tracciare le ricompense non reclamate o le opportunità di erogazione perse. | | **Metadati utente** | | | URL immagine | URL dell'immagine del profilo o avatar del partecipante (se raccolto). Principalmente estetico o usato in dashboard rivolte agli utenti, se applicabile. | | IP visto per la prima volta | Il primo indirizzo IP registrato quando il partecipante è stato aggiunto o è diventato attivo. Utile per conformità, geolocalizzazione o analisi antifrode. | | IP visto più di recente | L'indirizzo IP più recente associato al partecipante. Aiuta a determinare se l'utente è ancora attivo o coinvolto. | | Data di creazione | La data in cui l'account del partecipante è stato creato in Advocate. Utile per analisi di coorte o del comportamento di ricompensa nel tempo. | | Sorgente del referral | L'origine o il canale tramite cui il partecipante è stato acquisito (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*). Importante per comunicazioni personalizzate o opzioni di ricompensa regionali. |
#### Saldi premi disponibili per utente Il *Saldi premi disponibili per utente* Il report fornisce un elenco delle ricompense non riscattate. Questo tipo di report è pensato per essere usato come parte dell'assegnazione 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 Un 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) ![](/files/9dd6b56c8e6674cad6e2bac8013a48849cd2f09c) nel report dei saldi delle ricompense disponibili. {% hint style="info" %} **Nota**: Questo report non include dettagli sulle ricompense Sconto Percentuale, Fuel Tank o Gift Card. Usa il *Saldi delle ricompense per utente* report 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 abbinarle con sistemi esterni come un CRM o un fornitore di ricompense. | | ID utente | L'identificatore 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*, *stadio del ciclo di vita*, *tipo di cliente*). Utili per filtrare o applicare diverse regole di erogazione. | | **Stato e tempistiche della ricompensa** | | | Data di blocco | La data in cui all'utente è stato impedito di ricevere ricompense, se applicabile. Uno stato bloccato potrebbe impedire il riscatto; questo campo indica quando il blocco è stato applicato. | | **Dati della ricompensa** | | | Nome dell'unità | L'etichetta o nome visualizzato dell'unità della ricompensa (ad es., *Referral Cash*, *Credito del 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 durante l'erogazione delle ricompense, soprattutto 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 quanto pagare. | | Valore da riscattare | Il valore attualmente in coda per il riscatto (ad es., in sospeso in un'erogazione massiva o in attesa di elaborazione). Utile per evitare doppi riscatti o garantire che non vi sia sovrapposizione nei riscatti. | | Valore totale riscattato | Il valore totale delle ricompense che questo partecipante ha già riscattato. Fornisce informazioni sui riscatti passati e può essere utile per il monitoraggio del limite delle ricompense | | 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. |
#### report fiscale U.S. W-9 Il report fiscale US W-9 mostra lo stato fiscale W-9 degli utenti e le ricompense guadagnate 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 Stati Uniti delle ricompense guadagnate per anno fiscale * Numero totale di ricompense guadagnate da ciascun partecipante nell'anno fiscale **Riferimento alle colonne del report** | Colonna | Descrizione | | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Informazioni sul partecipante** | | | ID utente | L'identificatore univoco del partecipante in Advocate. | | ID account | ID account interno associato al partecipante. | | Email | L'indirizzo email del partecipante. | | Nome | Il nome del partecipante. | | Cognome | Il cognome del partecipante. | | **Informazioni fiscali W-9** | | |

Data di invio del modulo fiscale US

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 guadagnato le ricompense. Usato per raggruppare i guadagni per anno solare per l'elaborazione del 1099. | | Valore imponibile negli Stati Uniti in centesimi | Valore totale delle ricompense soggette a tassazione negli Stati Uniti guadagnate 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 negli Stati Uniti in dollari | Stesso valore, visualizzato nel formato standard in dollari per una facile consultazione (ad es., 25,00). Più semplice per la revisione o l'inclusione nei riepiloghi ufficiali. | | Conteggio ricompense | Numero totale di singole istanze di ricompensa guadagnate dal partecipante nell'anno fiscale specificato. Utile per tracciare la cronologia di audit o comprendere la frequenza delle ricompense e il coinvolgimento nel programma. |
#### Pagamenti e tasse Il *Pagamento e tasse* il report mostra lo stato fiscale degli utenti e le ricompense guadagnate o in sospeso per anno. Se il tuo programma fornisce pagamenti in denaro 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 Stati Uniti delle ricompense guadagnate per anno fiscale * Numero totale di ricompense guadagnate da ciascun partecipante nell'anno fiscale * Lo stato del modulo fiscale, ad es., *valido*, *in sospeso*, oppure *in attesa*. I motivi di sospensione del pagamento sono inclusi anche nel report **Riferimento alle colonne del report** | Colonna | Descrizione | | ----------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Informazioni sul partecipante** | | | ID utente | L'identificatore univoco del partecipante in Advocate. | | ID account | L'ID account del partecipante, usato per raggruppamento o reporting organizzativo. | | 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 US

YYYY-MM-DD

| La data in cui il partecipante ha inviato il proprio modulo W-9 (o il modulo fiscale statunitense pertinente). Importante per verificare l'idoneità fiscale prima di erogare pagamenti in denaro. | | **Riepilogo dell'anno di pagamento** | | | Anno | L'anno solare in cui il partecipante ha guadagnato le ricompense. | | Valore | Valore totale dei pagamenti in unità minori (ad es., centesimi) guadagnati o in sospeso per questo partecipante durante l'anno. Ad esempio, 1750 = $17,50. | | Valore in dollari | Stesso valore, visualizzato nel formato standard della valuta per una facile consultazione (ad es., 17,50). | | Conteggio | Numero totale di singole istanze di ricompensa di pagamento per il partecipante nell'anno specificato. Utile per capire quante volte un partecipante ha guadagnato pagamenti. | | **Idoneità e stato del pagamento** | | | Blocco del pagamento | Indica se i pagamenti del partecipante sono attualmente bloccati (Sì o No). I pagamenti possono essere bloccati a causa di moduli fiscali mancanti o configurazione incompleta. | | Motivi del blocco del pagamento | Spiega perché il partecipante è in blocco pagamento (se applicabile). Esempi di motivi: *Modulo fiscale mancante*, *Informazioni bancarie non fornite*, *Revisione di conformità*. | | Valuta del pagamento | La valuta in cui i pagamenti del partecipante vengono o verranno elaborati (ad es., *USD*, *EUR*, *ZAR*). Importante per sistemi di pagamento globali e contabilità. | | Avvio configurazione pagamento | Indica se il partecipante ha iniziato a configurare il proprio metodo di pagamento (ad es., tramite un'integrazione con un fornitore di pagamenti). Aiuta a monitorare l'avanzamento dell'onboarding o le necessità di follow-up per pagamenti in sospeso. |
--- # 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.