> 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 il tuo programma e i dati dei partecipanti. Tutti i report hanno opzioni di filtro per darti un maggiore controllo sui dati scaricati. 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 le 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 referral di Advocate.
Dettagli del report
Per impostazione predefinita, il report includerà informazioni sul partecipante come:
* Nome
* ID utente e ID account
* Indirizzo email
* Campi personalizzati
* Segmenti
* Informazioni di referral (se applicabile)
Quando generi il report, puoi facoltativamente includere:
* **Statistiche utente**, comprese informazioni analitiche 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, così da includere i link e i codici di condivisione di 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)  report dei dettagli utente.
**Riferimento alle colonne del report**
| Colonna | Descrizione |
| ----------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Informazioni utente** | |
| ID | L'identificativo univoco del partecipante nel sistema Advocate. |
| ID account | L'identificativo univoco dell'account del partecipante (usato 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 hash (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, usato per tracciare i referral che genera. |
| Link di condivisione | Il link referral univoco associato al partecipante. |
| Link di condivisione Facebook | Un link pre-generato per condividere il referral su Facebook. |
| Link di condivisione Twitter | Un link pre-generato per condividere il referral su Twitter. |
| Link di condivisione via email | Un link pre-generato per condividere il referral via email. |
| Link di condivisione LinkedIn | Un link pre-generato per condividere il referral su LinkedIn. |
| Link di condivisione pulito | Una versione del link referral senza parametri di tracciamento; più neutra per determinate piattaforme o casi d'uso. |
| **Geolocalizzazione e locale** | |
| IP rilevato per primo | L'indirizzo IP da cui il partecipante è stato registrato per la prima volta. |
| Ultimo IP rilevato | 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 finalità di conformità o elaborazione delle ricompense. |
| **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, registrazioni) 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.ricompense | Numero totale di ricompense guadagnate dal partecipante. |
| stats.caricamenti widget | Numero di volte in cui il widget 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 distinguerli se i ricavi provengono da più fonti. |
| stats.ricavi da referral | Ricavi attribuiti specificamente ai partecipanti che si sono registrati o hanno acquistato tramite il link 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 colonna separata, preceduta da campi personalizzati. |
| **Altro** | |
| Fonte del 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 evento utente* il report fornisce una registrazione di tutti gli eventi utente che abbiamo ricevuto dalla tua organizzazione per il tuo programma Advocate. Puoi applicare filtri per restringere un intervallo di tempo, la chiave evento, l'ID utente e altro.
Dettagli del report
Per impostazione predefinita, il report include:
* ID evento
* Chiave evento
* ID utente e ID account
* Data 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 di eventi. |
| Chiave evento | Il tipo o l'etichetta dell'evento, ad esempio `acquisto`, `registrazione`, o qualsiasi chiave definita 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 evento** | |
| Data attivazione evento – AAAA-MM-GG | La data in cui l'evento è realmente avvenuto (come riportato dal tuo sistema). Ad esempio, la data in cui è avvenuto un acquisto o una registrazione. |
| Data di ricezione evento – AAAA-MM-GG | La data in cui Advocate ha ricevuto l'evento dal tuo sistema. Può differire dalla data di attivazione a causa di raggruppamenti o ritardi del sistema. |
| Data di elaborazione evento – AAAA-MM-GG | La data in cui l'evento è stato elaborato e salvato con successo in Advocate. Indica quando l'evento è diventato utilizzabile per il tracciamento, le ricompense o i report. |
| **Campi dati evento (se inclusi nei payload degli eventi)** | |
| fields.coupon | Eventuali coupon o codici sconto applicati durante l'evento, se inviati nei dati dell'evento. Utili per tracciare l'uso degli incentivi o specifici trigger promozionali. |
| fields.ricavi | L'importo dei ricavi associati all'evento. In genere usato negli eventi di acquisto per calcolare performance, ricompense o ROI. |
| fields.valuta | Il codice valuta (ad es., *USD*, *ZAR*, *EUR*) associato all'importo dei ricavi. Importante quando si fanno report tra regioni o si calcolano ricompense adeguate al 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 delle ricompense
Il *Cronologia delle ricompense* il report fornisce una registrazione dettagliata di ciascuna delle tue ricompense e delle relazioni con partecipanti e referral. Queste informazioni possono essere utili per creare bilanci, oltre che per ottenere lo stato di tutte le tue ricompense in un determinato momento.
Dettagli del report
Per impostazione predefinita, il report includerà **campi della ricompensa** informazioni come:
* ID ricompensa
* 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), [file 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)  report dei dettagli della ricompensa.
Quando generi il report, puoi facoltativamente includere:
* **Dettagli partecipante** come nome, ID utente e ID account, indirizzo email, campi personalizzati, segmenti e informazioni di referral (se applicabile).
* **Campi referral** come ID referral, campi customer advocate, campi dell'amico referenziato e altro.
**Riferimento alle colonne del report**
| Colonna | Descrizione |
| ---------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Informazioni sulla ricompensa** | |
| ID | ID univoco dell'istanza della ricompensa (generato da Advocate). |
| Tipo | La categoria o il tipo della ricompensa (ad es., *Contanti*, *Carta regalo*, *Coupon*, *Personalizzato*). |
| Valore | Il valore numerico della ricompensa (ad es., 10, 100, ecc.). |
| Unità | L'unità associata al valore (ad es., *USD*, *punti*, *ZAR*, *%*). |
| Nome | Nome visualizzato della ricompensa (come definito nella [configurazione della ricompensa](/brand/it/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/create-a-reward.md)). |
| Fonte della ricompensa | Descrive ciò che ha attivato la ricompensa (ad es., *Riferimento*, *Obiettivo*, *Manuale*, *API*). |
| Tipo Fuel Tank | Il tipo di fondo ricompensa utilizzato (se si usa l'integrazione FuelTank). Ad es., *Prepagato*, *Carta regalo*. |
| Codice Fuel Tank | Il codice associato all'evasione esterna (ad es., codice voucher o carta regalo). |
| ID programma | ID del programma Advocate sotto il quale è stata emessa la ricompensa. |
| Chiave ricompensa programma | Identificatore interno per la specifica configurazione della ricompensa usata nel programma. |
| Chiave ricompensa globale | Identificatore tra programmi per le ricompense configurate a livello globale (se applicabile). |
| **Timestamp della ricompensa** | |
| Data di creazione | Quando il record della ricompensa è stato creato nel sistema. |
| Data pianificata per | Quando è stata pianificata l'emissione della ricompensa (ad es., dopo un ritardo o un periodo di attesa). |
| Data assegnata | Quando la ricompensa è stata effettivamente assegnata al partecipante. |
| Data di scadenza | La data di scadenza della ricompensa (se applicabile). |
| Data di annullamento | La data in cui la ricompensa è stata annullata o invalidata. |
| Data riscattata | La data in cui il partecipante ha riscattato la ricompensa (se applicabile). |
| Data modificata | La data in cui è stato effettuato l'aggiornamento più recente del record della ricompensa. |
| **Tracciamento di credito e valore** | |
| Credito assegnato | L'importo di credito assegnato a questa ricompensa (in alcuni modelli può differire dal valore). |
| Credito riscattato | L'importo di credito riscattato dalla ricompensa. |
| Valore disponibile | La parte rimanente della ricompensa non utilizzata o non riscattata. |
| **Stato e messaggi della ricompensa** | |
| Stati | Stato attuale della ricompensa (ad es., *In sospeso*, *Pianificata*, *Assegnata*, *Scaduto*, *Annullato*). |
| meta.stato | Stato tecnico o di sistema (utile per diagnostica o gestione degli errori). |
| meta.messaggio | Messaggio associato alla consegna della ricompensa (ad es., Ricompensa consegnata con successo). |
| meta.messaggio interno | Note riservate agli amministratori (ad es., spiegazioni di errore o flag). |
| meta.data modificata | Ultimo aggiornamento dei metadati relativi alla ricompensa. |
| meta.customMeta.testMeta | Un segnaposto per eventuali campi di metadati personalizzati inviati dal tuo programma (in questo caso, testMeta è un esempio). |
| **Informazioni sul partecipante (utente)** | |
| user.id | ID dell'utente che riceve la ricompensa. |
| user.account Id | L'ID account associato all'utente in Advocate. |
| user.first Name
user.last Name
user.email
| Informazioni di base sul partecipante incluse come riferimento o per l'abbinamento con il CRM. |
| **Contesto del referral (se la ricompensa si basa su referral)** | |
| referral.id | L'ID del referral che ha attivato questa ricompensa. |
| referral.data Inizio referral | Quando è iniziata l'azione di referral (ad es., clic o evento di condivisione). |
| referral.data modificata | Quando il record del referral è stato aggiornato l'ultima volta. |
| referral.codice referral utilizzato | Il codice usato dall'utente referenziato per iscriversi o eseguire un'azione. |
| **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 del referente. |
| referral.utente referenziato.nome
referral.utente referenziato.cognome
referral.utente referenziato.email
| I dettagli di contatto di base del referente. |
| **Informazioni sul referente (Advocate)** | |
| referral.referente.id | ID della persona che ha effettuato il referral (l'advocate). |
| referral.referente.account Id | L'ID account univoco del referente. |
| referral.referente.nome
referral.referente.cognome
referral.referente.email
| I dettagli di contatto di base del referente. |
| referral.data conversione | La data in cui il referral si è ufficialmente convertito (ad es., completamento della registrazione o dell'acquisto), attivando la ricompensa. |
#### Cronologia dei referral
Il *Cronologia dei referral* il report fornisce una registrazione dello stato di ciascuna connessione di referral effettuata nel tuo programma referral. Queste informazioni possono essere utili per verificare il successo del programma e monitorare il numero di nuovi clienti portati dal programma.
Dettagli del report
Per impostazione predefinita, il report include:
* Dettagli dell'amico referenziato come nome, ID utente e account, indirizzo email e altro
* Dettagli del customer advocate come nome, ID utente e account, indirizzo email e altro
* Stato del referral
* Stato di moderazione
* ID ricompense
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 dell'attività di referral.
**Riferimento alle colonne del report**
| Colonna | Descrizione |
| ---------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Metadati del referral** | |
| ID | Identificatore univoco del record di referral in Advocate. |
| Data modificata | La data più recente in cui una qualsiasi parte del record di referral è stata aggiornata. |
| 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 referral). |
| Data di conversione | Quando il referral si è convertito, in genere 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 utente coinvolti in questo referral (referente o referenziato) sono stati aggiornati. |
| ID programma | L'ID del programma referral Advocate a cui appartiene questo referral. |
| Nome del programma | Il nome del programma referral, utile se gestisci più programmi. |
| **Informazioni sull'amico referenziato (nuovo cliente)** | |
| Email dell'utente referenziato
Nome dell'utente referenziato
Cognome dell'utente referenziato
| Informazioni di base sull'identità dell'utente referenziato. |
| Codice referral dell'utente referenziato | Il codice referral assegnato all'utente referenziato (nel caso possa a sua volta referenziare altri in seguito). |
| IP di primo rilevamento dell'utente referenziato
Ultimo IP rilevato dell'utente referenziato
| Indirizzi IP registrati alla prima e all'ultima attività dell'utente referenziato. |
| URL immagine dell'utente referenziato | URL dell'immagine o dell'avatar, se acquisito o assegnato all'utente referenziato. |
| Locale dell'utente referenziato | Impostazione lingua/regione (ad es., *en-US*, *fr-FR*) dell'utente referenziato. |
| Data di creazione dell'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 nei programmi multi-account). |
| **Informazioni sul referente (customer advocate)** | |
| Email del referente
Nome del referente
Cognome del referente
| Informazioni di base sull'identità del partecipante che effettua il referral. |
| Codice referral del referente | Il codice referral appartenente al referente, il codice che probabilmente l'utente referenziato ha usato. |
| IP di primo rilevamento del referente
Ultimo IP rilevato del referente
| Indirizzi IP registrati alla prima e all'ultima attività del referente. |
| URL immagine del referente | L'URL dell'immagine o dell'avatar del referente. |
| Locale del referente | Impostazione locale del referente. |
| Data di creazione del referente | Quando il referente si è iscritto per la prima volta o è stato registrato nel sistema. |
| Referente | ID interno del referente in Advocate. |
| Account del referente | ID account associato al referente. |
| **Moderazione e stato** | |
| Stato di moderazione | Stato complessivo di moderazione della segnalazione. (Ad es., *Approvato*, *Rifiutate*, *In sospeso*.) |
| Data di moderazione | La data in cui è stata presa la decisione di moderazione (approvazione/rifiuto). |
| Data di pagamento della segnalazione | Quando è stato pagato qualsiasi premio associato alla segnalazione. |
| Data di fine della segnalazione | Quando il record della segnalazione è stato chiuso ufficialmente (ad es., per scadenza o completamento). |
| Stato di moderazione del segnalato | Stato di moderazione specifico per la parte della segnalazione relativa all'utente segnalato. |
| Stato di moderazione del segnalante | Stato di moderazione specifico per la parte della segnalazione relativa al segnalante. |
| **Riferimenti ai premi** | |
| Premio del segnalato | L'ID o riferimento del premio assegnato all'utente segnalato (se applicabile). |
| Premio del segnalante | L'ID o riferimento del premio assegnato al segnalante (se applicabile). |
#### Saldi premi per utente
Il *Saldi premi per utente* il report fornisce un registro dei premi non ancora erogati, incluso il valore e il destinatario previsto, generati tramite il tuo programma di segnalazione. Questo report è spesso usato come parte dell'erogazione manuale dei premi o come parte di un processo batch verso un sistema come Tango Card. Può anche essere utile per monitorare quanto il tuo programma di segnalazione ha erogato 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 premio
* Unità del premio
* Importo del premio
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)  report dei saldi premi.
**Riferimento alle colonne del report**
| Colonna | Descrizione |
| --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Informazioni sul partecipante** | |
| ID utente | L'identificatore univoco del partecipante in Advocate. Usato per collegare il saldo premio 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 usato per l'erogazione manuale dei premi o la sincronizzazione con sistemi esterni. |
| Nome
Cognome
| Il nome e cognome del partecipante. Utile per la personalizzazione o il filtraggio durante l'elaborazione dei premi. |
| Codice referral | Il codice di segnalazione assegnato al partecipante. È ciò che condivide per segnalare altri e tracciare l'idoneità al premio. |
| **Informazioni sulla ricompensa** | |
| Tipo | La categoria o il metodo del premio (ad es., *Contanti*, *Carta regalo*, *Punti*, *Personalizzato*). Aiuta a determinare come i premi debbano essere erogati o raggruppati. |
| Unità | L'unità del valore del premio (ad es., *USD*, *ZAR*, *Punti*, *%*). Importante per calcolare i saldi e per la gestione dei pagamenti regionali. |
| Importo | Il saldo totale disponibile dei premi in sospeso per questo utente. È il valore principale usato nella preparazione dei pagamenti o delle esportazioni. |
| Credito totale assegnato | L'importo totale del credito mai assegnato a questo utente (indipendentemente dal riscatto). Riflette il costo complessivo del programma allocato a questo partecipante. |
| Credito totale riscattato | La parte totale dei premi che questo partecipante ha già riscattato. 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 tracciare i premi non reclamati o le opportunità di erogazione perse. |
| **Metadati utente** | |
| URL immagine | URL dell'immagine del profilo o avatar del partecipante (se raccolta). Principalmente estetico o usato nelle dashboard rivolte agli utenti, se applicabile. |
| IP rilevato per primo | Il primo indirizzo IP registrato quando il partecipante è stato aggiunto o è diventato attivo. Utile per conformità, geolocalizzazione o analisi antifrode. |
| 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 in cui l'account del partecipante è stato creato in Advocate. Utile per l'analisi di coorte o del comportamento dei premi nel tempo. |
| Fonte del referral | La fonte o il canale originale tramite cui il partecipante è stato acquisito (ad es., *email*, *organico*, *partner*). Aiuta a valutare la portata e l'efficacia del programma di segnalazione per canale. |
| Locale | La lingua e l'impostazione regionale del partecipante (ad es., *en-US*, *fr-FR*). Importante per comunicazioni personalizzate o opzioni di premio regionali. |
#### Saldi premi disponibili per utente
Il *Saldi premi disponibili per utente* il report fornisce un elenco dei premi non riscattati. Questo tipo di report è pensato per essere usato come parte dell'erogazione dei premi tramite il [riscatto collettivo dei premi](/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à del premio
* Valuta del premio
* 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 report dei saldi premi disponibili.
{% hint style="info" %}
**Nota**: Questo report non include dettagli sui premi Sconto percentuale, Serbatoio carburante o Carta regalo. Usa il *Saldi premi per utente* report per maggiori dettagli su questi tipi di premi.
{% 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 dei premi. |
| Cognome | Il cognome del partecipante. |
| Email | L'indirizzo email del partecipante, usato per inviare premi o abbinarli a sistemi esterni come un CRM o un fornitore di premi. |
| 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*, *fase del ciclo di vita*, *tipo di cliente*). Utile per filtrare o applicare regole diverse di erogazione. |
| **Stato e tempistiche del premio** | |
| Data di blocco | La data in cui all'utente è stato impedito di ricevere premi, se applicabile. Uno stato bloccato può impedire 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., *Contanti per segnalazione*, *Credito in negozio*). Questo aiuta a distinguere tra più tipi di premio che un programma potrebbe offrire. |
| Valuta | Il codice valuta del valore del premio (ad es., *USD*, *ZAR*, *EUR*). Necessario per erogare i premi, soprattutto tra paesi o sistemi di pagamento. |
| Valore disponibile | L'importo del premio non riscattato attualmente disponibile per questo partecipante. È il valore principale usato per determinare quanto pagare. |
| Valore da riscattare | Il valore attualmente in coda per il riscatto (ad es., in attesa in un'erogazione collettiva o in elaborazione). Utile per evitare doppi riscatti o garantire che non vi siano sovrapposizioni nei riscatti. |
| Valore totale riscattato | Il valore totale dei premi che questo partecipante ha già riscattato. Offre una panoramica dei riscatti passati e può essere utile per il monitoraggio dei 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. |
#### Report fiscale W-9 USA
Il report fiscale US W-9 mostra lo stato fiscale US W-9 dei partecipanti e i premi guadagnati 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 dei premi guadagnati per anno fiscale
* Numero totale di premi guadagnati 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 USA
AAAA-MM-GG
| 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 anno fiscale** | |
| Anno | L'anno fiscale in cui il partecipante ha guadagnato premi. Usato per raggruppare i guadagni per anno solare ai fini dell'elaborazione 1099. |
| Valore imponibile USA in centesimi | Valore totale dei premi imponibili negli USA guadagnati da questo partecipante nell'anno fiscale specificato, espresso in centesimi (ad es., 2500 = $25,00). Aiuta nei calcoli grezzi o nelle integrazioni in cui è richiesta precisione. |
| Valore imponibile USA in dollari | Come sopra, ma visualizzato nel formato standard in dollari (ad es., 25,00). Più facile da verificare o includere nei riepiloghi ufficiali. |
| Numero di premi | Numero totale di singole istanze di premio guadagnate dal partecipante nell'anno fiscale specificato. Utile per tracce di audit o per comprendere la frequenza dei premi e il coinvolgimento nel programma. |
#### Pagamenti e tasse
Il *Pagamento e tasse* il report mostra lo stato fiscale dei partecipanti e i premi guadagnati o in sospeso per anno.
Se il tuo programma fornisce pagamenti in denaro ai partecipanti, verranno 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 W-9 — è stato contrassegnato come inviato
* Valore imponibile negli Stati Uniti dei premi guadagnati per anno fiscale
* Numero totale di premi guadagnati da ciascun partecipante nell'anno fiscale
* Lo stato del modulo fiscale, ad es., *valido*, *in sospeso*, oppure *in attesa*. Nel report sono incluse anche le motivazioni del blocco dei pagamenti
**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 il raggruppamento o per 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
AAAA-MM-GG
| La data in cui il partecipante ha inviato il proprio modulo W-9 (o il modulo fiscale USA pertinente). Importante per verificare l'idoneità fiscale prima di effettuare pagamenti in denaro. |
| **Riepilogo anno di pagamento** | |
| Anno | L'anno solare in cui il partecipante ha guadagnato i premi. |
| 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 | Lo stesso valore, visualizzato nel formato valuta standard per una facile consultazione (ad es., 17,50). |
| Conteggio | Numero totale di singole istanze di pagamento per il partecipante nell'anno specificato. Utile per comprendere con quale frequenza un partecipante ha guadagnato pagamenti. |
| **Idoneità e stato del pagamento** | |
| Blocco del pagamento | Indica se i pagamenti del partecipante sono attualmente in sospeso (Sì o No). I pagamenti possono essere sospesi per moduli fiscali mancanti o configurazione incompleta. |
| Motivi del blocco del pagamento | Spiega perché il partecipante è in blocco di pagamento (se applicabile). Motivi di esempio: *Modulo fiscale mancante*, *Informazioni bancarie non fornite*, *Revisione della conformità*. |
| Valuta del pagamento | La valuta in cui i pagamenti del partecipante 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 i 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 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=&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.