> 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/getting-started-with-advocate/import-referral-program-data-from-saasquatch.md). # Importa i dati del programma di 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 dei dati degli 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 rilevato per primo		L'indirizzo IP del partecipante la prima volta che ha eseguito un upsert non API.
Ultimo IP rilevato		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'epoch 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 via email		Il link di condivisione via 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 dei dati dei referral

Colonna	Obbligatorio	Descrizione
Utente segnalato - ID utente		L'ID utente esterno dell'amico segnalato.
Utente segnalato - ID account		L'ID account esterno dell'amico segnalato.
Utente segnalante - ID utente		L'ID utente esterno del promotore.
Utente segnalante - ID account		L'ID account esterno del promotore.
ID referral		L'identificatore univoco del referral.
Data modificata		La data dell'ultima modifica del referral (ad es. avviato, convertito, moderato, ecc.), formattata in millisecondi dall'epoch Unix .
Data di inizio referral		La data di creazione del referral, formattata in millisecondi dall'epoch Unix .
Data di conversione		La data in cui è stato raggiunto il primo obiettivo, formattata in millisecondi dall'epoch 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'epoch Unix .
ID programma		L'identificatore del programma per cui è stato creato il referral.
Nome del programma		Il nome del programma per cui è stato creato il referral.
Utente segnalato - Email		L'indirizzo email dell'amico segnalato.
Utente segnalato - Nome		Il nome dell'amico segnalato.
Utente segnalato - Cognome		Il cognome dell'amico segnalato.
Utente segnalato - Codice referral		Il codice referral principale dell'amico segnalato (dipende dal programma in cui è stato creato questo referral.
Utente segnalato - IP del primo accesso		Il primo indirizzo IP usato dall'amico segnalato quando caricava un widget.
Utente segnalato - Ultimo IP rilevato		L'indirizzo IP più recente usato dall'amico segnalato quando caricava un widget.
Utente segnalato - URL immagine		L'immagine dell'amico segnalato.
Utente segnalato - Lingua e località		La lingua e località dell'amico segnalato.
Utente segnalato - Data di creazione		La data in cui l'amico segnalato è stato visto per la prima volta da SaaSquatch (creato in SaaSquatch), formattata in millisecondi dall'epoch Unix .
Utente segnalato - Segmenti		I segmenti utente dell'amico segnalato.
referredUserCustomFields.<fieldName>		I campi personalizzati dell'amico segnalato.
Utente segnalante - Email		L'indirizzo email del promotore.
Utente segnalante - Nome		Il nome del promotore.
Utente segnalante - Cognome		Il cognome del promotore.
Utente segnalante - Codice referral		Il codice referral principale del promotore (ad es. il codice referral usato per creare questo referral).
Utente segnalante - IP del primo accesso		Il primo indirizzo IP usato dal promotore quando caricava un widget.
Utente segnalante - Ultimo IP rilevato		L'indirizzo IP più recente usato dal promotore quando caricava un widget.
Utente segnalante - URL immagine		L'immagine del promotore.
Utente segnalante - Lingua e località		La lingua e località del promotore.
Utente segnalante - Data di creazione		La data in cui il promotore è stato visto per la prima volta da SaaSquatch (creato in SaaSquatch), formattata in millisecondi dall'epoch Unix .
Stato di moderazione		Lo stato di moderazione della frode del referral (ad es., `IN SOSPESO`, `INTERVENUTO`).
Data di moderazione		La data di inizio del referral, formattata in millisecondi dall'epoch Unix .
Utente segnalato - ID reward		L'identificatore del reward dell'amico segnalato.
Utente segnalante - ID reward		L'identificatore del reward del promotore.
Utente segnalante - Segmenti		I segmenti utente del promotore.
referrerUserCustomFields.<fieldName>		I campi personalizzati del promotore.
Codice referral usato		Il codice referral del promotore usato per il referral.
Link di condivisione usato		Il link di condivisione del promotore usato per il referral.

File dei dati dei 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, Gift card, ecc.
Unità della ricompensa		l'unità in cui i reward vengono guadagnati, ad es. Denaro, Punti, Mesi, ecc.
Valore del premio		Il valore numerico del reward nella sua unità di misura più piccola, ad es. per un reward in denaro di $1,00, il valore sarebbe 100 (centesimi).
Nome del reward		Il nome che hai assegnato al reward quando lo hai creato nel tuo programma.
Valore in USD		Il valore del reward in USD.
ID programma		L'identificatore del programma per cui è stato creato il reward.
Chiave ricompensa globale		Chiave della configurazione globale del reward nel catalogo dei reward. Si trova sotto Rewards → Catalogo → Crea reward → Nome reward.
Fonte della ricompensa		Come è stato creato il reward, ad es., Manuale, Utente segnalato, Registrazione dell'amico.
Data di creazione		La data in cui il reward è stato guadagnato, formattata in millisecondi dall'epoch Unix .
Data assegnata		La data in cui il reward è stato assegnato, formattata in millisecondi dall'epoch Unix . (Questo valore può differire da Data di creazione se il reward era in sospeso).
Data pianificata per		La data in cui il reward era programmato per essere assegnato all'utente, formattata in millisecondi dall'epoch Unix .
Data di scadenza		La data dopo la quale il reward non può più essere riscattato, formattata in millisecondi dall'epoch Unix .
Data di annullamento		La data in cui hai annullato il reward, formattata in millisecondi dall'epoch Unix .
Data modificata		La data in cui hai apportato modifiche al reward, formattata in millisecondi dall'epoch Unix .
Data riscattata		La data in cui l'intero reward è stato riscattato dall'utente, formattata in millisecondi dall'epoch Unix .
Credito assegnato		L'importo nell'unità di base per i reward di tipo Credito. Questo è l'equivalente di Valore del premio, ma per i reward di tipo Credito.
Importo riscattato		Il Valore della parte del reward che è stata riscattata.
Tipo Fuel Tank		Può essere Credito o % di sconto.
Codice Fuel Tank		È come un codice coupon, ad es., SummerSave20, 20%OFF, ecc.
ID utente segnalato		L'identificatore utente dell'amico segnalato.
ID account segnalato		L'identificatore dell'account dell'amico segnalato.
referral.referredUser.id		Usato in combinazione con 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 in combinazione con 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 validazione Puoi ottenere 3 tipi di errori di validazione: 1. **Messaggio di errore in linea:** questi appaiono nella tabella di anteprima della validazione e fanno sì che le righe con errore vengano evidenziate in rosso: * `INVALID_FIELD` — ad es., il *Data di creazione* campo non era formattato in [millisecondi dall'epoch Unix](https://currentmillis.com/) . * `MISSING_FIELD` — ad es., un campo obbligatorio come *ID utente* o *ID account* manca.

2. **Richiamo di errore:** questi appaiono al posto della tabella di anteprima della validazione come messaggi di avviso rossi: * `MISSING_HEADER` — ad es., un'intestazione di colonna obbligatoria come *ID account* o *Valore del 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 appaiono come un elenco di conteggi di errori nella *Importazioni ed esportazioni* schermata quando il tipo di importazione non ha una tabella di anteprima della validazione. Gli errori di riga e gli errori del file verranno visualizzati insieme: 1. Nella barra di navigazione a sinistra, seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage] → Reportistica**. 2. Seleziona **Importazioni ed esportazioni** per visualizzare il report. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://help.impact.com/brand/it/what-would-you-like-to-learn-about/advocate-program/getting-started-with-advocate/import-referral-program-data-from-saasquatch.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.