# Importa i dati del programma referral da SaaSquatch Questo articolo contiene riferimenti utili per aiutarti a importare i dati della tua piattaforma di referral da SaaSquatch a impact.com. #### Riferimento alle colonne del file CSV

File dati utenti

Colonna	Obbligatorio	Descrizione
ID utente		L'identificatore del partecipante.
ID account		L'identificatore dell'account del partecipante.
Email		L'indirizzo email del partecipante.
Nome		Il nome del partecipante.
Cognome		Il cognome del partecipante.
Codice referral		Il codice referral del programma principale del partecipante (se specificato).
URL immagine		L'URL dell'immagine del partecipante.
IP prima visualizzazione		L'indirizzo IP del partecipante la prima volta che ha eseguito un upsert non API.
IP ultima visualizzazione		L'indirizzo IP del partecipante l'ultima volta che ha eseguito un upsert non API.
Data di creazione		La data di creazione di questo utente partecipante, formattata in millisecondi dall’epoca Unix .
Hash email		Il valore hash MD5 dell'indirizzo email di un partecipante.
Locale		La posizione geografica del partecipante.
Codice paese		Il codice paese del partecipante.
Segmenti		I segmenti utente del partecipante.
Link di condivisione		Il link di condivisione del programma principale del partecipante (se specificato).
Link di condivisione Facebook		Il link di condivisione Facebook del programma principale del partecipante (se specificato).
Link di condivisione Twitter		Il link di condivisione Twitter/X del programma principale del partecipante (se specificato).
Link di condivisione email		Il link di condivisione email del programma principale del partecipante (se specificato).
Link di condivisione LinkedIn		Il link di condivisione LinkedIn del programma principale del partecipante (se specificato).
Link di condivisione pulito		Il link vanity principale del partecipante senza codifica.
Campo personalizzato		Se un partecipante ha un campo personalizzato, `{ExampleName}` sarà il nome del campo.

File dati referral

Colonna	Obbligatorio	Descrizione
Utente referenziato - ID utente		L'ID utente esterno dell'amico referenziato.
Utente referenziato - ID account		L'ID account esterno dell'amico referenziato.
Utente referente - ID utente		L'ID utente esterno del customer advocate.
Utente referente - ID account		L'ID account esterno del customer advocate.
ID referral		L'identificatore univoco del referral.
Data modifica		La data dell'ultima modifica del referral (ad es. avviato, convertito, moderato, ecc.), formattata in millisecondi dall’epoca Unix .
Data avvio referral		La data di creazione del referral, formattata in millisecondi dall’epoca Unix .
Data conversione		La data in cui è stato raggiunto il primo obiettivo, formattata in millisecondi dall’epoca Unix .
Data modifica utente		La data in cui un utente è stato eliminato da un referral (eliminazione utente) o aggiunto a un referral, formattata in millisecondi dall’epoca Unix .
ID programma		L'identificatore del programma per il quale è stato creato il referral.
Nome programma		Il nome del programma per il quale è stato creato il referral.
Utente referenziato - Email		L'indirizzo email dell'amico referenziato.
Utente referenziato - Nome		Il nome dell'amico referenziato.
Utente referenziato - Cognome		Il cognome dell'amico referenziato.
Utente referenziato - Codice referral		Il codice referral principale dell'amico referenziato (dipende dal programma in cui è stato creato questo referral).
Utente referenziato - IP prima visualizzazione		Il primo indirizzo IP utilizzato dall'amico referenziato quando ha caricato un widget.
Utente referenziato - IP ultima visualizzazione		L'indirizzo IP più recente utilizzato dall'amico referenziato quando ha caricato un widget.
Utente referenziato - URL immagine		L'immagine dell'amico referenziato.
Utente referenziato - Locale		La lingua/area geografica dell'amico referenziato.
Utente referenziato - Data creazione		La data in cui l'amico referenziato è stato visto per la prima volta da SaaSquatch (creato in SaaSquatch), formattata in millisecondi dall’epoca Unix .
Utente referenziato - Segmenti		I segmenti utente dell'amico referenziato.
referredUserCustomFields.<fieldName>		I campi personalizzati dell'amico referenziato.
Utente referente - Email		L'indirizzo email del customer advocate.
Utente referente - Nome		Il nome del customer advocate.
Utente referente - Cognome		Il cognome del customer advocate.
Utente referente - Codice referral		Il codice referral principale del customer advocate (ad es. il codice referral usato per creare questo referral).
Utente referente - IP prima visualizzazione		Il primo indirizzo IP utilizzato dal customer advocate quando ha caricato un widget.
Utente referente - IP ultima visualizzazione		L'indirizzo IP più recente utilizzato dal customer advocate quando ha caricato un widget.
Utente referente - URL immagine		L'immagine del customer advocate.
Utente referente - Locale		La lingua/area geografica del customer advocate.
Utente referente - Data creazione		La data in cui il customer advocate è stato visto per la prima volta da SaaSquatch (creato in SaaSquatch), formattata in millisecondi dall’epoca Unix .
Stato moderazione		Lo stato di moderazione per frode del referral (ad es., `PENDING`, `ACTIONED`).
Data moderazione		La data di avvio del referral, formattata in millisecondi dall’epoca Unix .
Utente referenziato - ID reward		L'identificatore del reward dell'amico referenziato.
Utente referente - ID reward		L'identificatore del reward del customer advocate.
Utente referente - Segmenti		I segmenti utente del customer advocate.
referrerUserCustomFields.<fieldName>		I campi personalizzati del customer advocate.
Codice referral utilizzato		Il codice referral del customer advocate utilizzato per il referral.
Link di condivisione utilizzato		Il link di condivisione del customer advocate utilizzato per il referral.

File dati reward

Colonna	Obbligatorio	Descrizione
ID utente		L'identificatore dell'utente.
ID account		L'identificatore dell'account dell'utente.
Tipo		Il tipo di reward, ad es. Credito, Sconto, carta regalo, ecc.
Unità del premio		L'unità in cui vengono guadagnati i reward, ad es. Contanti, Punti, Mesi, ecc.
Valore del premio		Il valore numerico del reward nella sua unità di misura più piccola, ad es. per un reward in contanti di $1,00, il valore sarà 100 (centesimi).
Nome del premio		Il nome che hai assegnato al reward quando lo hai creato nel tuo programma.
Valore USD		Il valore del reward in USD.
ID programma		L'identificatore del programma per il quale è stato creato il reward.
Chiave reward globale		Chiave della configurazione del reward globale nel catalogo reward. Si trova sotto Rewards → Catalog → Create rewards → Reward Name.
Origine reward		Come è stato creato il reward, ad es. Manuale, Utente referenziato, Registrazione dell'amico.
Data di creazione		La data in cui il reward è stato guadagnato, formattata in millisecondi dall’epoca Unix .
Data di assegnazione		La data in cui il reward è stato assegnato, formattata in millisecondi dall’epoca Unix . (Questo valore può differire da Data di creazione se il reward era in sospeso).
Data programmata per		La data in cui il reward era programmato per essere assegnato all'utente, formattata in millisecondi dall’epoca Unix .
Data scadenza		La data dopo la quale il reward non può più essere riscattato, formattata in millisecondi dall’epoca Unix .
Data annullamento		La data in cui hai annullato il reward, formattata in millisecondi dall’epoca Unix .
Data modifica		La data in cui hai apportato modifiche al reward, formattata in millisecondi dall’epoca Unix .
Data di riscatto		La data in cui il reward completo è stato riscattato dall'utente, formattata in millisecondi dall’epoca Unix .
Credito assegnato		L'importo nell'unità base per i reward Credit. Questo è l'equivalente di Valore del premio, ma per i reward Credit.
Importo riscattato		Il Valore della parte del reward che è stata riscattata.
Tipo Fuel Tank		Questo può essere sia Credito o % di sconto.
Codice Fuel Tank		È simile a un codice coupon, ad es. SummerSave20, 20%OFF, ecc.
ID utente referito		L'identificatore utente dell'amico referenziato.
ID account referito		L'identificatore dell'account dell'amico referenziato.
referral.referredUser.id		Usato insieme a ID programma per collegare un referral a un ID programma, se vogliamo associare un referral a un reward. Questo potrebbe non corrispondere sempre a ID utente.
referral.referredUser.accountId		Usato insieme a ID programma per collegare un referral a un ID programma, se vogliamo associare un referral a un reward. Questo potrebbe non corrispondere sempre a ID account.

#### Riferimento agli errori di convalida Puoi ricevere 3 tipi di errori di convalida: 1. **Messaggio di errore in linea:** questi compaiono nella tabella di convalida dell’anteprima e fanno sì che le righe con errore vengano evidenziate in rosso: * `INVALID_FIELD` — ad esempio, il *Data di creazione* campo non è stato formattato in [millisecondi dall’epoca Unix](https://currentmillis.com/) . * `MISSING_FIELD` — ad esempio, un campo obbligatorio come *ID utente* o *ID account* è mancante.

2. **Messaggio di errore:** questi compaiono al posto della tabella di convalida dell’anteprima come messaggi di avviso rossi: * `MISSING_HEADER` — ad esempio, un’intestazione di colonna obbligatoria come *ID account* o *Valore del premio* è mancante. * `CSV_PARSING` — ad esempio, il file CSV contiene caratteri speciali formattati in modo errato. * `FILE_REF_IO` — ad esempio, il file è corrotto e non può essere letto.

3. **Errori elencati:** questi compaiono come un elenco di conteggi di errori nella schermata *Imports & Exports* schermata quando il tipo di importazione non ha una tabella di convalida dell'anteprima. Gli errori di riga e gli errori del file verranno mostrati insieme: 1. Nella barra di navigazione a sinistra, seleziona ![](/files/56eb48c7f3195590132b62ea75c0575abe0113e5) **\[Engage] → Reporting**. 2. Seleziona **Imports & Exports** per visualizzare il report. --- # 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/getting-started-with-advocate/import-referral-program-data-from-saasquatch.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.