# 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. Consulta [Esegui un report del programma Advocate](/brand/it/che-cosa-vorresti-imparare/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 *I 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 referral di Advocate.
Dettagli del report Per impostazione predefinita, il report includerà informazioni sui partecipanti come: * Nome * ID utente e account * Indirizzo email * Campi personalizzati * Segmenti * Informazioni di referral (se applicabile) Quando generi il report, puoi includere facoltativamente: * **Statistiche utente**, incluse informazioni di analisi sul partecipante come traffico, ricavi e altro. * **Link e codici di condivisione referral**, se applicabile. Queste informazioni possono essere utili come parte dell'aggiornamento dei record dei contatti nel tuo CMS o sistema email per includere 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 dei dettagli utente. **Riferimento alle colonne del report** | Colonna | Descrizione | | ----------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Informazioni utente** | | | ID | L'identificatore univoco del partecipante all'interno del sistema Advocate. | | ID account | L'identificatore univoco dell'account del partecipante (usato 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 corrispondenze conformi alla privacy con altri sistemi. | | **Informazioni 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 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 alcune piattaforme o casi d'uso. | | **Geolocalizzazione e località** | | | IP visto per la prima volta | L'indirizzo IP da cui il partecipante è stato registrato per la prima volta. | | Ultimo IP visto | L'indirizzo IP più recente rilevato per questo partecipante. | | Località | 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 un modulo fiscale statunitense è stato inviato per la conformità o l'elaborazione delle ricompense. | | **Statistiche utente (se incluse nell'esportazione)** | | | stats.date Modified | L'ultima data in cui le statistiche del partecipante sono state aggiornate. | | stats.traffic | Numero totale di visite generate dall'attività di referral del partecipante. | | stats.referrals | Numero totale di referral riusciti effettuati dal partecipante. | | stats.conversions | Numero totale di conversioni (ad es. acquisti, iscrizioni) risultanti da quei referral. | | stats.goals | Numero di completamenti di obiettivi specifici associati all'attività di referral del partecipante (definiti personalizzatamente nel programma). | | stats.rewards | Numero totale di ricompense guadagnate dal partecipante. | | stats.widget Loads | Numero di volte in cui il widget referral o l'interfaccia di condivisione è stato caricato da questo partecipante. | | stats.revenue | Ricavi totali generati dagli utenti referenziati da questo partecipante. | | stats.generated Revenue | Sinonimo di stats.revenue; alcuni report possono distinguerlo se i ricavi provengono da più fonti. | | stats.referred Revenue | Ricavi attribuiti specificamente ai partecipanti che si sono iscritti o hanno acquistato tramite il link referral di questo partecipante. | | **Dati personalizzati** | | | custom Fields.example | Un segnaposto per eventuali campi personalizzati definiti dal tuo programma (ad es. *ID fedeltà*, *note interne*, *tag regione*). Ogni campo apparirà come colonna separata, con il prefisso custom Fields. | | **Altro** | | | Origine 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* 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.
Dettagli del report Per impostazione predefinita, il report include: * ID evento * Chiave evento * ID utente e account * Data attivazione * Data ricezione * Data elaborazione **Riferimento alle colonne del report** | Colonna | Descrizione | | ----------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Informazioni evento e utente** | | | ID evento | Un ID univoco generato per ciascun evento ricevuto. Utile per il tracciamento, il debug o l'audit degli invii di eventi. | | Chiave evento | Il tipo o l'etichetta dell'evento, come `purchase`, `iscrizione`, o qualsiasi chiave definita personalizzatamente che il tuo sistema invia. | | ID utente | L'identificatore univoco del partecipante in Advocate a cui l'evento è associato. | | ID account | L'ID account associato all'utente, particolarmente rilevante nei programmi in cui gli utenti possono appartenere a diverse strutture account. | | **Timestamp evento** | | | Data attivazione evento – AAAA-MM-GG | La data in cui l'evento è effettivamente avvenuto (come riportato dal tuo sistema). Ad esempio, la data in cui ha avuto luogo un acquisto o un'iscrizione. | | Data 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 elaborazioni batch o ritardi di sistema. | | Data elaborazione evento – AAAA-MM-GG | La data in cui l'evento è stato elaborato e salvato con successo in Advocate. Segna quando l'evento è diventato utilizzabile per tracciamento, ricompense o reportistica. | | **Campi dati evento (se inclusi nei payload degli eventi)** | | | fields.coupon | Qualsiasi coupon o codice sconto applicato durante l'evento, se inviato nei dati evento. Utile per tracciare l'uso di incentivi o specifici trigger promozionali. | | fields.revenue | L'importo dei ricavi associati all'evento. Tipicamente usato negli eventi di acquisto per calcolare performance, ricompense o ROI. | | fields.currency | Il codice valuta (ad es. *USD*, *ZAR*, *EUR*) associato all'importo dei ricavi. Importante quando si effettuano report su più regioni o si calcolano ricompense adeguate al cambio. | | fields.lead Created Date | La data originale in cui il lead (utente) è stato creato nel tuo sistema, se inviata come parte dell'evento. Aiuta a collegare gli eventi utente alle date di acquisizione originali o ai record CRM. |
#### Cronologia ricompense Il *Cronologia ricompense* report fornisce un registro dettagliato 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 ricompensa** informazioni come: * ID ricompensa * 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) o [JSONL di esempio](https://assets.ctfassets.net/s68ib1kj8k5n/5BeuDmYM1WFAySjqntGeji/f321cf59a96d45061645d971e06fb569/Reward_Details_Example_Report_JSONL.jsonl) ![](/files/9dd6b56c8e6674cad6e2bac8013a48849cd2f09c) report dettagli ricompensa. 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 dell'amico referenziato e altro. **Riferimento alle colonne del report** | Colonna | Descrizione | | ------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Informazioni ricompensa** | | | ID | ID univoco dell'istanza di ricompensa (generato da Advocate). | | Tipo | La categoria o il tipo di 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/che-cosa-vorresti-imparare/advocate-program/advocate-rewards/create-a-reward.md)). | | Origine ricompensa | Descrive cosa ha attivato la ricompensa (ad es. *Referral*, *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. voucher o codice carta regalo). | | ID programma | ID del programma Advocate in cui la ricompensa è stata emessa. | | Chiave ricompensa programma | Identificatore interno per la specifica configurazione di ricompensa utilizzata all'interno del programma. | | Chiave ricompensa globale | Identificatore cross-programma per ricompense configurate a livello globale (se applicabile). | | **Timestamp ricompensa** | | | Data di creazione | Quando il record della ricompensa è stato creato nel sistema. | | Data programmata per | Quando la ricompensa è stata pianificata per essere emessa (ad es. dopo un ritardo o un periodo di attesa). | | Data di assegnazione | Quando la ricompensa è stata effettivamente emessa al partecipante. | | Data scadenza | La data di scadenza della ricompensa (se applicabile). | | Data annullamento | La data in cui la ricompensa è stata invalidata o annullata. | | Data di riscatto | La data in cui il partecipante ha riscattato la ricompensa (se applicabile). | | Data modifica | La data in cui è stato effettuato l'aggiornamento più recente al record della ricompensa. | | **Monitoraggio 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 che è stato riscattato dalla ricompensa. | | Valore disponibile | La parte restante non utilizzata o non riscattata della ricompensa. | | **Stato della ricompensa e messaggi** | | | Stati | Stato attuale della ricompensa (ad es. *In attesa*, *Pianificato*, *Concessa*, *Scaduto*, *Annullato*). | | meta.status | Stato tecnico o a livello di sistema (utile per diagnostica o gestione degli errori). | | meta.message | Messaggio associato alla consegna della ricompensa (ad es. “Ricompensa consegnata con successo”). | | meta.internal Message | Note interne solo per gli amministratori (ad es. spiegazioni di errore o flag). | | meta.date Modified | Ultima volta in cui i metadati relativi alla ricompensa 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 partecipante (utente)** | | | user.id | ID dell'utente che riceve la ricompensa. | | user.account Id | L'ID account associato dell'utente in Advocate. | |

user.first Name

user.last Name

user.email

| Informazioni di base del partecipante incluse come riferimento o per la corrispondenza CRM. | | **Contesto referral (se la ricompensa si basa su referral)** | | | referral.id | L'ID del referral che ha attivato questa ricompensa. | | referral.date Referral Started | Quando è iniziata l'azione di referral (ad es. clic o condivisione). | | referral.date Modified | Quando il record referral è stato aggiornato l'ultima volta. | | referral.referral Code Used | Il codice utilizzato dall'utente referenziato per iscriversi o compiere l'azione. | | **Info utente referenziato (amico)** | | | referral.referred User.id | ID della persona che è stata referenziata (l'“amico”). | | referral.referred User.account Id | L'ID account univoco del referente. | |

referral.referred User.first Name

referral.referred User.last Name

referral.referred User.email

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

referral.referrer User.first Name

referral.referrer User.last Name

referral.referrer User.email

| I dettagli di contatto di base del referente. | | referral.date Converted | La data in cui il referral è stato ufficialmente convertito (ad es. completamento dell'iscrizione o dell'acquisto), attivando la ricompensa. |
#### Cronologia referral Il *Cronologia referral* report fornisce un registro dello stato di ciascuna connessione referral effettuata nel tuo programma referral. Queste informazioni possono essere utili per verificare il successo del tuo programma e monitorare il numero di nuovi clienti portati dal tuo programma.
Dettagli del report Per impostazione predefinita, il report include: * Dettagli dell'amico 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 referral * Stato moderazione * ID ricompensa 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 attività referral. **Riferimento alle colonne del report** | Colonna | Descrizione | | ---------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | | **Metadati referral** | | | ID | Identificatore univoco del record referral in Advocate. | | Data modifica | La data più recente in cui qualsiasi parte del record referral è stata aggiornata. | | Data inizio referral | Quando il referral è stato inizialmente avviato (ad es. quando l'utente referenziato ha cliccato su un link referral). | | Data conversione | Quando il referral si è convertito, tipicamente quando l'utente referenziato ha completato l'azione richiesta (come un'iscrizione 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 si gestiscono più programmi. | | **Informazioni sull'amico referenziato (nuovo cliente)** | | |

Email utente referenziato

Nome utente referenziato

Cognome utente referenziato

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

IP visto per la prima volta dell'utente referenziato

Ultimo IP visto dell'utente referenziato

| Indirizzi IP registrati alla prima e più recente attività dell'utente referenziato. | | URL immagine utente referenziato | URL dell'immagine o avatar, se acquisito o assegnato all'utente referenziato. | | Località 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 nei programmi multi-account). | | **Informazioni sul referente (customer advocate)** | | |

Email utente referente

Nome utente referente

Cognome utente referente

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

IP visto per la prima volta dell'utente referente

Ultimo IP visto dell'utente referente

| Indirizzi IP registrati alla prima e più recente attività del referente. | | URL immagine utente referente | L'URL dell'immagine o avatar del referente. | | Località utente referente | Impostazione località 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 moderazione | Stato complessivo di moderazione del referral. (Ad es. *Approvato*, *Rifiutate*, *In attesa*.) | | Data moderazione | La data in cui è stata presa la decisione di moderazione (approvazione/rifiuto). | | Data pagamento referral | Quando è stata pagata l'eventuale ricompensa associata al referral. | | Data fine referral | Quando il record referral è stato ufficialmente chiuso (ad es. a causa di scadenza o completamento). | | Stato moderazione del referenziato | Stato di moderazione specifico alla parte del referral dell'utente referenziato. | | Stato moderazione del referente | Stato di moderazione specifico alla parte del referral del referente. | | **Riferimenti ricompensa** | | | Ricompensa referenziato | L'ID o riferimento della ricompensa emessa all'utente referenziato (se applicabile). | | Ricompensa referente | L'ID o riferimento della ricompensa emessa al referente (se applicabile). |
#### Saldi ricompensa per utente Il *Saldi ricompensa per utente* report fornisce un registro delle ricompense in sospeso, incluso il valore e il destinatario previsto, generate tramite il tuo programma referral. Questo report viene spesso usato come parte dell'evasione manuale delle ricompense o come parte di un processo batch verso un sistema come Tango Card. Può anche essere utile per tracciare quanto il tuo programma 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à ricompensa * Importo 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 saldi ricompensa. **Riferimento alle colonne del report** | Colonna | Descrizione | | ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Informazioni partecipante** | | | ID utente | L'identificatore univoco del partecipante all'interno di 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'evasione manuale delle ricompense o per la sincronizzazione con sistemi esterni. | |

Nome

Cognome

| Il nome e cognome del partecipante. Utile per la personalizzazione o il filtraggio durante l'elaborazione delle ricompense. | | Codice referral | Il codice referral assegnato al partecipante. Questo è ciò che condividono per referenziare altri e tracciare l'idoneità alla ricompensa. | | **Informazioni ricompensa** | | | Tipo | La categoria o il metodo della ricompensa (ad es. *Contanti*, *Carta regalo*, *Punti*, *Personalizzato*). Aiuta a determinare come le ricompense devono essere evase o raggruppate. | | Unità | L'unità del valore della ricompensa (ad es. *USD*, *ZAR*, *Punti*, *%*). Importante per calcolare i saldi e per la gestione regionale dei pagamenti. | | 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 è mai stato assegnato 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 | Ricompense totali assegnate all'utente ma scadute prima di essere riscattate. Aiuta a tracciare le ricompense non reclamate o le opportunità di evasione perse. | | **Metadati utente** | | | URL immagine | URL dell'immagine del profilo o avatar del partecipante (se raccolta). Principalmente estetica o usata in dashboard rivolte all'utente, se applicabile. | | IP visto per la prima volta | Il primo indirizzo IP registrato quando il partecipante è stato aggiunto o è diventato attivo. Utile per conformità, tagging della posizione o analisi antifrode. | | Ultimo IP visto | 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 delle ricompense nel tempo. | | Origine referral | La fonte o il canale originale attraverso cui il partecipante è stato acquisito (ad es. *email*, *organico*, *partner*). Aiuta a valutare la portata e l'efficacia del programma referral per canale. | | Località | 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 di ricompense non riscattate. Questo tipo di report è destinato a essere usato come parte dell'evasione delle ricompense tramite il [riscatto massivo delle ricompense](/brand/it/che-cosa-vorresti-imparare/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à ricompensa * Valuta 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 ricompensa disponibili. {% hint style="info" %} **Nota**: Questo report non include dettagli sulle ricompense Sconto percentuale, Fuel Tank o Carta regalo. Usa il *Saldi ricompensa per utente* report per maggiori dettagli su questi tipi di ricompense. {% endhint %} **Riferimento alle colonne del report** | Colonna | Descrizione | | ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Informazioni partecipante** | | | Nome | Il nome di battesimo 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 corrispondere con 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/che-cosa-vorresti-imparare/advocate-program/manage-advocate-participants/manage-advocate-user-segments.md) (ad es., *per regione*, *per fase del ciclo di vita*, *tipo di cliente*). Utile per filtrare o applicare regole di evasione diverse. | | **Stato e tempistiche ricompensa** | | | Data blocco | La data in cui all'utente è stato impedito di ricevere ricompense, se applicabile. Uno stato bloccato può impedire il riscatto; questo campo indica quando tale blocco è stato applicato. | | **Dati ricompensa** | | | Nome unità | L'etichetta o il nome visualizzato dell'unità di ricompensa (ad es. *Denaro referral*, *Credito negozio*). Questo aiuta a distinguere tra più tipi di ricompensa che un programma potrebbe offrire. | | Valuta | Il codice valuta del valore della ricompensa (ad es. *USD*, *ZAR*, *EUR*). Necessario quando si evadono 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 attesa in un'evasione batch o in attesa di elaborazione). Utile per evitare un doppio riscatto o garantire che non ci 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 il tracciamento dei limiti delle ricompense | | Unità | Il codice interno o di sistema per l'unità di ricompensa (ad es. *USD*, *punti*, ecc.). Potrebbe essere usato nelle chiamate API o nella logica interna durante l'evasione. |
#### Report fiscale statunitense W-9 Il report fiscale W-9 statunitense mostra lo stato fiscale W-9 USA dei partecipanti 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 USA 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 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 invio 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 ricompense. Usato per raggruppare i guadagni per anno solare per l'elaborazione 1099. | | Valore imponibile USA in centesimi | Valore totale delle ricompense imponibili negli USA 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 USA in dollari | Come sopra, ma visualizzato nel formato standard in dollari (ad es. 25,00). Più facile per la revisione o l'inclusione in riepiloghi ufficiali. | | Numero ricompense | Numero totale di singole istanze di ricompensa guadagnate dal partecipante nell'anno fiscale specificato. Utile per audit trail 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 guadagnate o in sospeso per anno. Se il tuo programma eroga 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 USA 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 sospeso*. Nel report sono incluse anche le ragioni della sospensione del pagamento **Riferimento alle colonne del report** | Colonna | Descrizione | | ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Informazioni partecipante** | | | ID utente | L'identificatore univoco del partecipante in Advocate. | | ID account | L'ID account del partecipante, utilizzato per il raggruppamento o la reportistica organizzativa. | | Email | L'indirizzo email del partecipante. | | Nome | Il nome del partecipante. | | Cognome | Il cognome del partecipante. | | **Informazioni fiscali W-9** | | |

Data invio modulo fiscale USA

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 effettuare pagamenti in contanti. | | **Riepilogo anno di pagamento** | | | Anno | L'anno solare in cui il partecipante ha guadagnato i premi. | | Valore | Valore totale del pagamento in unità minori (ad es. centesimi) guadagnato o in attesa per questo partecipante durante l'anno. Ad esempio, 1750 = $17,50. | | Valore in dollari | Stesso valore, visualizzato nel formato valuta standard per una facile consultazione (ad es. 17,50). | | Conteggio | Numero totale di singoli importi premio di pagamento per il partecipante nell'anno specificato. Utile per capire con quale frequenza un partecipante ha ricevuto 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 trattenuti a causa di moduli fiscali mancanti o configurazione incompleta. | | Motivi del blocco del pagamento | Spiega perché il pagamento del partecipante è in sospeso (se applicabile). Motivi di esempio: *Modulo fiscale mancante*, *Informazioni bancarie non fornite*, *Verifica 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 l'avanzamento dell'onboarding o le esigenze di follow-up per i pagamenti in sospeso. |
--- # Agent Instructions: 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: ``` GET https://help.impact.com/brand/it/che-cosa-vorresti-imparare/advocate-program/advocate-reporting-and-analytics/advocate-program-reports-explained.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.