> 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). # Report del programma Advocate spiegati Segui il corso PXA Advocate offre diversi 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 quale tipo di dati include ciascuno. 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 dettagli utente Il *Dettagli utente* report contiene informazioni dettagliate su ciascun partecipante in tutti i tuoi programmi. Esporta un elenco di tutti i partecipanti per mantenere aggiornati i tuoi record con i link di condivisione e i codici 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 analitiche sul partecipante come traffico, ricavi e altro ancora. * **Link e codici di condivisione referral**, se applicabile. Queste informazioni possono essere utili per aggiornare i record dei contatti nel tuo CMS o sistema email, 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) report 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 dell'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 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 alcune piattaforme o casi d'uso. | | **Geolocalizzazione e locale** | | | Primo IP rilevato | 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 alla località o all'indirizzo IP (ad es., ZA, US). | | **Timestamp** | | | Data di creazione | La data e l'ora in cui l'account del partecipante è stato creato in Advocate. | | Data invio modulo fiscale USA | (Se applicabile) La data in cui è stato inviato un modulo fiscale statunitense per la conformità o l'elaborazione del premio. | | **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) risultanti da tali referral. | | stats.obiettivi | Numero di completamenti di obiettivi specifici associati all'attività di referral del partecipante (definiti personalizzatamente nel programma). | | stats.premi | Numero totale di premi guadagnati dal partecipante. | | stats.caricamenti del widget | Numero di volte in cui il widget di referral o l'interfaccia di condivisione è stata caricata da questo partecipante. | | stats.ricavi | Ricavo totale generato dagli utenti referenziati da questo partecipante. | | stats.ricavo generato | Sinonimo di stats.revenue; alcuni report possono distinguere se il ricavo proviene da più fonti. | | stats.ricavo da referral | Ricavo attribuito specificamente ai partecipanti che si sono iscritti o hanno acquistato tramite il link di referral di questo partecipante. | | **Dati personalizzati** | | | custom Fields.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, con prefisso custom Fields. | | **Altro** | | | Fonte referral | La fonte o il canale originario che ha portato il partecipante al tuo programma (ad es., *organico*, *email*, *sito partner*). |
#### Esportazione degli eventi utente Il *Esportazione degli eventi utente* 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 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 personalizzata inviata dal tuo sistema. | | ID utente | L'identificatore univoco del partecipante in Advocate a cui l'evento è associato. | | ID account | L'ID account collegato all'utente, particolarmente rilevante nei programmi in cui gli utenti possono appartenere a strutture account diverse. | | **Timestamp evento** | | | Data evento attivato – AAAA-MM-GG | 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 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 di 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, i premi o i report. | | **Campi dati evento (se inclusi nei payload degli eventi)** | | | fields.coupon | Eventuale coupon o codice sconto applicato durante l'evento, se inviato nei dati dell'evento. Utile per tracciare l'uso degli incentivi o trigger di promozioni specifiche. | | fields.ricavo | L'importo del ricavo associato all'evento. Di solito usato negli eventi di acquisto per calcolare performance, premi o ROI. | | fields.valuta | Il codice valuta (ad es., *USD*, *ZAR*, *EUR*) associato all'importo del ricavo. Importante quando si fanno report su più regioni o si calcolano premi adeguati 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 premi Il *Cronologia premi* 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 a ottenere lo stato di tutti i tuoi premi in un determinato momento.
Dettagli del report Per impostazione predefinita, il report includerà **campi del premio** informazioni come: * ID premio * Tipo di ricompensa * Valore del premio Un elenco completo dei campi inclusi si può trovare quando [scarichi il nostro CSV di esempio](https://assets.ctfassets.net/s68ib1kj8k5n/7E5DNWKrh7iQMNGYQBWRiS/3ae6c7a9109542215763a07a18cb0494/Reward_Details_Example_Report_CSV.csv), [l'Excel di esempio](https://assets.ctfassets.net/s68ib1kj8k5n/2MQjc4XjXGPNhsv10tHal6/dc40679812b99d0aef4ace46a780e1ee/Reward_Details_Example_Report_XLSX.xlsx) ![](/files/9dd6b56c8e6674cad6e2bac8013a48849cd2f09c) o [il JSONL di esempio](https://assets.ctfassets.net/s68ib1kj8k5n/5BeuDmYM1WFAySjqntGeji/f321cf59a96d45061645d971e06fb569/Reward_Details_Example_Report_JSONL.jsonl) ![](/files/9dd6b56c8e6674cad6e2bac8013a48849cd2f09c) i report dei dettagli del 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 dell'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*, *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., *Referral*, *Obiettivo*, *Manuale*, *API*). | | Tipo Fuel Tank | Il tipo di fondo premio utilizzato (se si utilizza 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 il premio è stato emesso. | | Chiave premio programma | Identificatore interno della specifica configurazione del premio utilizzata 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 è stata pianificata l'emissione del premio (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 reso nullo. | | Data di riscatto | La data in cui il partecipante ha riscattato il premio (se applicabile). | | Data di modifica | La data in cui è stato effettuato l'aggiornamento più recente del record del premio. | | **Tracciamento del credito e del 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 restante del premio non utilizzata o non riscattata. | | **Stato e messaggistica del premio** | | | Stati | Stato attuale del premio (ad es., *In sospeso*, *Programmato*, *Assegnato*, *Scadute*, *Annullato*). | | meta.status | Stato tecnico o a livello di sistema (utile per diagnostica o gestione degli errori). | | meta.message | Messaggio associato alla consegna del premio (ad es., “Premio consegnato con successo”). | | meta.messaggio interno | Note riservate solo agli amministratori (ad es., spiegazioni dei guasti o flag). | | meta.data modificata | Ultima volta in cui i metadati relativi al premio sono stati aggiornati. | | meta.customMeta.testMeta | Un segnaposto per eventuali campi di metadati personalizzati inviati dal tuo programma (in questo caso, testMeta è un esempio). | | **Informazioni sul partecipante (utente)** | | | user.id | ID dell'utente che riceve 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 come riferimento o per l'abbinamento nel 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 è iniziata l'azione di referral (ad es., evento di clic o di condivisione). | | referral.data modificata | Quando il record del referral è stato aggiornato l'ultima volta. | | referral.codice referral utilizzato | Il codice che l'utente referenziato ha utilizzato per iscriversi o compiere un'azione. | | **Informazioni sull'utente referenziato (amico)** | | | referral.utente referenziato.id | L'ID della persona referenziata (l'“amico”). | | referral.utente referenziato.ID account | 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 (customer advocate)** | | | referral.utente referente.id | L'ID della persona che ha effettuato il referral (l'“advocate”). | | referral.utente referente.ID account | L'ID account univoco del referente. | |

referral.utente referente.nome

referral.utente referente.cognome

referral.utente referente.email

| I dettagli di contatto di base del referente. | | referral.data conversione | La data in cui il referral è stato ufficialmente convertito (ad es., completamento della registrazione o dell'acquisto), attivando il premio. |
#### Cronologia referral Il *Cronologia referral* report fornisce un registro dello stato di ciascun collegamento di referral creato nel tuo programma di referral. Queste informazioni possono essere utili per verificare il successo del tuo programma e tracciare il numero di nuovi clienti acquisiti.
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 sull'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 si è convertito, in genere quando l'utente referenziato ha completato l'azione richiesta (come registrazione o 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 di referral Advocate a cui appartiene questo referral. | | Nome del programma | Il nome del programma di referral, utile se si gestiscono 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 in cui possa a sua volta referire altri in seguito). | |

Primo IP rilevato dell'utente referenziato

Ultimo IP rilevato dell'utente referenziato

| Indirizzi IP registrati alla prima e alla più recente 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 creazione utente referenziato | La data in cui l'account dell'utente referenziato è stato creato in Advocate. | | Utente referenziato | ID interno dell'utente referenziato nel sistema Advocate. | | Account referenziato | ID account interno collegato all'utente referenziato (utilizzato nei programmi multi-account). | | **Informazioni sul referente (customer advocate)** | | |

Email dell'utente referente

Nome dell'utente referente

Cognome dell'utente referente

| Informazioni di base sull'identità del partecipante che effettua il referral. | | Codice referral dell'utente referente | Il codice referral appartenente al referente, il codice che probabilmente ha utilizzato l'utente referenziato. | |

Primo IP rilevato dell'utente referente

Ultimo IP rilevato dell'utente referente

| Indirizzi IP registrati alla prima e alla più recente attività del referente. | | URL immagine dell'utente referente | L'URL dell'immagine o dell'avatar del referente. | | Locale dell'utente referente | Impostazione locale del referente. | | Data creazione utente referente | Quando il referente si è unito per la prima volta o è stato registrato nel sistema. | | Utente referente | ID interno del referente in Advocate. | | Account referente | ID account associato al referente. | | **Moderazione e stato** | | | Stato di moderazione | Stato complessivo di moderazione del referral. (Ad es., *Approvate*, *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 di moderazione dell'utente referenziato | Stato di moderazione specifico della parte della segnalazione riferita all'utente. | | Stato di moderazione del segnalatore | Stato di moderazione specifico della parte della segnalazione relativa al segnalatore. | | **Riferimenti alla ricompensa** | | | Ricompensa del segnalato | L'ID o riferimento della ricompensa assegnato all'utente segnalato (se applicabile). | | Ricompensa del segnalatore | L'ID o riferimento della ricompensa assegnato al segnalatore (se applicabile). |
#### Saldi delle ricompense per utente Il *Saldi delle ricompense per utente* Il report fornisce un registro delle ricompense non ancora erogate, incluso il valore e il destinatario previsto, generate tramite il tuo programma di segnalazione. Questo report viene spesso usato come parte dell'erogazione 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 segnalazione ha distribuito 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 ancora * 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 all'interno di Advocate. Usato per associare 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 di segnalazione assegnato al partecipante. È quello che condivide 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*, *Personalizzato*). 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. | | 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 in qualsiasi momento a questo utente (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 | Importo totale di ricompense assegnate all'utente ma scadute prima di essere riscattate. Aiuta a tracciare le ricompense non richieste 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 nelle dashboard rivolte agli utenti, se applicabile. | | Primo IP rilevato | Il primo indirizzo IP registrato quando il partecipante è stato aggiunto o è diventato attivo. Utile per conformità, etichettatura geografica 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 delle ricompense nel tempo. | | Fonte referral | La fonte o il canale originario 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 ricompensa regionali. |
#### Saldi premio disponibili per utente Il *Saldi premio disponibili per utente* report fornisce un elenco delle ricompense non riscattate. Questo tipo di report è pensato per essere usato come parte dell'erogazione delle ricompense tramite il [riscatto collettivo 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 ancora * 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 Percentage Discount, Fuel Tank o Gift Card. Usa il *Saldi delle ricompense per utente* report per ulteriori 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 a sistemi esterni come un CRM o un fornitore di ricompense. | | ID utente | L'identificatore univoco assegnato al partecipante all'interno di Advocate. | | ID account | L'ID 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 bloccato potrebbe impedire il riscatto; questo campo indica quando il blocco è stato applicato. | | **Dati della ricompensa** | | | Nome unità | L'etichetta o il nome visualizzato dell'unità della ricompensa (ad es., *Ricompensa referral in denaro*, *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 le ricompense, soprattutto tra paesi o sistemi di pagamento diversi. | | Valore disponibile | L'importo della ricompensa non riscattata attualmente disponibile per questo partecipante. Questo è il valore principale 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 attesa di elaborazione). Utile per evitare doppi riscatti o garantire che non vi siano sovrapposizioni nei riscatti. | | Valore totale riscattato | Il valore totale delle ricompense che questo partecipante ha già riscattato. Fornisce informazioni sui riscatti passati e può essere utile per tracciare i limiti 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 statunitense W-9 Il report fiscale statunitense W-9 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 ancora * Data in cui il modulo W-9 del partecipante è stato contrassegnato come raccolto * Valore imponibile statunitense 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'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 statunitense

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 per 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 del 1099. | | Valore imponibile statunitense 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 $). Aiuta con i calcoli grezzi o con le integrazioni in cui è richiesta precisione. | | Valore imponibile statunitense in dollari | Stesso valore, ma visualizzato nel formato standard in dollari (ad es., 25,00). Più facile da rivedere o includere nei riepiloghi ufficiali. | | Conteggio ricompense | Numero totale di singole istanze di ricompensa 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. |
#### Pagamenti e tasse Il *Pagamento e tasse* report mostra lo stato fiscale dei partecipanti e le ricompense maturate o in sospeso per anno. Se il tuo programma prevede pagamenti in denaro ai partecipanti, saranno 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 ancora * Data in cui il modulo fiscale del partecipante — come un W-8 o un W-9 — è stato contrassegnato come inviato * Valore imponibile statunitense 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*, o *in sospeso*. I motivi del blocco dei pagamenti 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 il raggruppamento o per la 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 statunitense

AAAA-MM-GG

| La data in cui il partecipante ha inviato il proprio modulo W-9 (o il modulo fiscale statunitense pertinente). Importante per verificare l'idoneità fiscale prima di emettere pagamenti in denaro. | | **Riepilogo per anno dei pagamenti** | | | Anno | L'anno solare in cui il partecipante ha maturato le ricompense. | | Valore | Valore totale del pagamento 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 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 con quale frequenza un partecipante ha maturato 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 per moduli fiscali mancanti o configurazione incompleta. | | Motivi del blocco del pagamento | Spiega perché il pagamento del partecipante è bloccato (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 sono o saranno elaborati (ad es., *USD*, *EUR*, *ZAR*). Importante per i sistemi di pagamento globali e la contabilità. | | Configurazione del pagamento avviata | Indica se il partecipante ha iniziato a configurare il proprio metodo di pagamento (ad es., tramite un'integrazione con un fornitore di pagamenti). Aiuta a monitorare i progressi di onboarding o la 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 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.