# Importa i dati del programma di referral da SaaSquatch Questo articolo contiene riferimenti utili per assisterti nell’importazione dei dati della tua piattaforma referral da SaaSquatch a impact.com. #### Riferimento colonne del file CSV

File dati utenti

Colonna	Obbligatorio	Descrizione
ID utente		L’identificativo del partecipante.
ID account		L’identificativo 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 visto per la prima volta		L’indirizzo IP del partecipante la prima volta che ha eseguito un upsert non tramite API.
Ultimo IP visto		L’indirizzo IP del partecipante l’ultima volta che ha eseguito un upsert non tramite API.
Data di creazione		La data in cui questo utente partecipante è stato creato, formattata in millisecondi dall’epoca Unix .
Hash email		Il valore hash MD5 dell’indirizzo email di un partecipante.
Località		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 segnalante - ID utente		L’id utente esterno dell’advocate del cliente.
Utente segnalante - ID account		L’id account esterno dell’advocate del cliente.
ID referral		L’identificativo 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 inizio referral		La data in cui è stato creato il 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’identificativo 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 questo referral è stato creato.
Utente referenziato - Primo IP rilevato		Il primo indirizzo IP usato dall’amico referenziato quando ha caricato un widget.
Utente referenziato - Ultimo IP rilevato		L’indirizzo IP più recente usato dall’amico referenziato quando ha caricato un widget.
Utente referenziato - URL immagine		L’immagine dell’amico referenziato.
Utente referenziato - Locale		La localizzazione dell’amico referenziato.
Utente referenziato - Data di 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 segnalante - Email		L’indirizzo email dell’advocate del cliente.
Utente segnalante - Nome		Il nome dell’advocate del cliente.
Utente segnalante - Cognome		Il cognome dell’advocate del cliente.
Utente segnalante - Codice referral		Il codice referral principale dell’advocate del cliente (ad es. il codice referral usato per creare questo referral).
Utente segnalante - Primo IP rilevato		Il primo indirizzo IP usato dall’advocate del cliente quando ha caricato un widget.
Utente segnalante - Ultimo IP rilevato		L’indirizzo IP più recente usato dall’advocate del cliente quando ha caricato un widget.
Utente segnalante - URL immagine		L’immagine dell’advocate del cliente.
Utente segnalante - Locale		La localizzazione dell’advocate del cliente.
Utente segnalante - Data di creazione		La data in cui l’advocate del cliente è stato visto per la prima volta da SaaSquatch (creato in SaaSquatch), formattata in millisecondi dall’epoca Unix .
Stato moderazione		Lo stato di moderazione antifrode del referral (ad es., `IN ATTESA`, `INTERVENUTO`).
Data moderazione		La data di avvio del referral, formattata in millisecondi dall’epoca Unix .
Utente referenziato - ID premio		L’identificativo del premio dell’amico referenziato.
Utente segnalante - ID premio		L’identificativo del premio dell’advocate del cliente.
Utente segnalante - Segmenti		I segmenti utente dell’advocate del cliente.
referrerUserCustomFields.<fieldName>		I campi personalizzati dell’advocate del cliente.
Codice referral usato		Il codice referral dell’advocate del cliente che è stato usato per il referral.
Link di condivisione usato		Il link di condivisione dell’advocate del cliente che è stato usato per il referral.

File dati premi

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

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

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

3. **Errori elencati:** questi compaiono come un elenco di conteggi di errori nella schermata *Importazioni ed Esportazioni* quando il tipo di importazione non ha una tabella di convalida dell’anteprima. Gli errori di riga e gli errori del file verranno visualizzati insieme: 1. Nella barra di navigazione a sinistra, seleziona ![](/files/56eb48c7f3195590132b62ea75c0575abe0113e5) **\[Engage] → Reporting**. 2. Seleziona **Importazioni ed Esportazioni** 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.