Importa Dati del Programma di Referral da SaaSquatch

Questo articolo contiene riferimenti utili per assisterti nell'importazione dei dati della tua piattaforma di referral da SaaSquatch a impact.com.

Riferimento colonne file CSV

File dati utenti

Colonna	Obbligatoria	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 primario del partecipante per il programma (se specificato).
URL immagine		L'URL dell'immagine del partecipante.
IP primo accesso		L'indirizzo IP del partecipante la prima volta che ha eseguito un upsert non via API.
IP ultimo accesso		L'indirizzo IP del partecipante l'ultima volta che ha eseguito un upsert non via API.
Data creazione		La data in cui questo utente partecipante è stato creato, formattata in millisecondi dall'epoch 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 primario del partecipante (se specificato).
Link condivisione Facebook		Il link di condivisione su Facebook del programma primario del partecipante (se specificato).
Link condivisione Twitter		Il link di condivisione su Twitter/X del programma primario del partecipante (se specificato).
Link condivisione email		Il link di condivisione via email del programma primario del partecipante (se specificato).
Link condivisione LinkedIn		Il link di condivisione su LinkedIn del programma primario del partecipante (se specificato).
Link di condivisione pulito		Il link vanity primario del partecipante senza codifica.
Campo personalizzato		Se un partecipante ha un campo personalizzato, {ExampleName} sarà il nome del campo.

File dati referral

Colonna	Obbligatoria	Descrizione
Utente riferito - ID utente		L'ID utente esterno dell'amico riferito.
Utente riferito - ID account		L'ID account esterno dell'amico riferito.
Utente referente - ID utente		L'ID utente esterno dell'ambasciatore cliente.
Utente referente - ID account		L'ID account esterno dell'ambasciatore cliente.
ID referral		L'identificatore univoco del referral.
Data modifica		La data in cui il referral è stato modificato l'ultima volta (es. iniziato, convertito, moderato, ecc.), formattata in millisecondi dall'epoch unix .
Data inizio referral		La data in cui il referral è stato creato, formattata in millisecondi dall'epoch unix .
Data 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 rimosso da un referral (eliminazione utente) o aggiunto a un referral, formattata in millisecondi dall'epoch 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 riferito - Email		L'indirizzo email dell'amico riferito.
Utente riferito - Nome		Il nome dell'amico riferito.
Utente riferito - Cognome		Il cognome dell'amico riferito.
Utente riferito - Codice referral		Il codice referral primario dell'amico riferito (dipende dal programma in cui questo referral è stato creato).
Utente riferito - IP primo accesso		Il primo indirizzo IP che l'amico riferito ha usato quando ha caricato un widget.
Utente riferito - IP ultimo accesso		L'indirizzo IP più recente che l'amico riferito ha usato quando ha caricato il widget.
Utente riferito - URL immagine		L'immagine dell'amico riferito.
Utente riferito - Località		La località dell'amico riferito.
Utente riferito - Data creazione		La data in cui l'amico riferito è stato visto per la prima volta da SaaSquatch (creato in SaaSquatch), formattata in millisecondi dall'epoch unix .
Utente riferito - Segmenti		I segmenti utente dell'amico riferito.
referredUserCustomFields.<fieldName>		I campi personalizzati dell'amico riferito.
Utente referente - Email		L'indirizzo email dell'ambasciatore cliente.
Utente referente - Nome		Il nome dell'ambasciatore cliente.
Utente referente - Cognome		Il cognome dell'ambasciatore cliente.
Utente referente - Codice referral		Il codice referral primario dell'ambasciatore cliente (es. il codice referral usato per creare questo referral).
Utente referente - IP primo accesso		Il primo indirizzo IP che l'ambasciatore cliente ha usato quando ha caricato un widget.
Utente referente - IP ultimo accesso		L'indirizzo IP più recente che l'ambasciatore cliente ha usato quando ha caricato un widget.
Utente referente - URL immagine		L'immagine dell'ambasciatore cliente.
Utente referente - Località		La località dell'ambasciatore cliente.
Utente referente - Data creazione		La data in cui l'ambasciatore cliente è stato visto per la prima volta da SaaSquatch (creato in SaaSquatch), formattata in millisecondi dall'epoch unix .
Stato moderazione		Lo stato di moderazione per frodi del referral (es., IN ATTESA, AZIONATO).
Data moderazione		La data in cui il referral è stato moderato, formattata in millisecondi dall'epoch unix .
Utente riferito - ID ricompensa		L'identificatore della ricompensa dell'amico riferito.
Utente referente - ID ricompensa		L'identificatore della ricompensa dell'ambasciatore cliente.
Segmenti utente referente		I segmenti utente dell'ambasciatore cliente.
referrerUserCustomFields.<fieldName>		I campi personalizzati dell'ambasciatore cliente.
Codice referral usato		Il codice referral dell'ambasciatore cliente che è stato usato per il referral.
Link condivisione usato		Il link di condivisione dell'ambasciatore cliente che è stato usato per il referral.

File dati ricompense

Colonna	Obbligatoria	Descrizione
ID utente		L'identificatore dell'utente.
ID account		L'identificatore dell'account dell'utente.
Tipo		Il tipo di ricompensa, es. Credito, Sconto, Buono regalo, ecc.
Unità ricompensa		L'unità nella quale le ricompense sono guadagnate, es. Denaro, Punti, Mesi, ecc.
Valore ricompensa		Il valore numerico della ricompensa nella sua unità di misura più piccola, es. per una ricompensa in denaro di $1,00, il valore sarebbe 100 (centesimi).
Nome ricompensa		Il nome che hai assegnato alla ricompensa quando l'hai creata nel tuo programma.
Valore in USD		Il valore della ricompensa in USD.
ID programma		L'identificatore del programma per il quale la ricompensa è stata creata.
Chiave globale ricompensa		Chiave della configurazione globale della ricompensa nel catalogo ricompense. Questo si trova sotto Ricompense → Catalogo → Crea ricompense → Nome ricompensa.
Fonte ricompensa		Come è stata creata la ricompensa, es., Manuale, Utente riferito, Registrazione amico.
Data creazione		La data in cui la ricompensa è stata guadagnata, formattata in millisecondi dall'epoch unix .
Data assegnazione		La data in cui la ricompensa è stata assegnata, formattata in millisecondi dall'epoch unix . (Questo valore può differire da Data creazione se la ricompensa era in attesa).
Data programmata per		La data in cui la ricompensa era programmata per essere assegnata all'utente, formattata in millisecondi dall'epoch unix .
Data scadenza		La data dopo la quale la ricompensa non può più essere riscattata, formattata in millisecondi dall'epoch unix .
Data cancellazione		La data in cui hai annullato la ricompensa, formattata in millisecondi dall'epoch unix .
Data modifica		La data in cui hai apportato modifiche alla ricompensa, formattata in millisecondi dall'epoch unix .
Data riscatto		La data in cui l'intera ricompensa è stata riscattata dall'utente, formattata in millisecondi dall'epoch unix .
Credito assegnato		L'importo nell'unità base per le ricompense di tipo Credito. Questo è l'equivalente di Valore ricompensa, ma per le ricompense di tipo Credito.
Importo riscattato		Il Valore della parte della ricompensa che è stata riscattata.
Tipo serbatoio carburante		Questo può essere o Credito o % sconto.
Codice serbatoio carburante		Questo è come un codice coupon, es., SummerSave20, 20%OFF, ecc.
ID utente riferito		L'identificatore utente dell'amico riferito.
ID account riferito		L'identificatore dell'account dell'amico riferito.
referral.referredUser.id		Usato in combinazione con ID programma per collegare un referral a un ID programma, se vogliamo associare un referral a una ricompensa. 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 una ricompensa. Questo potrebbe non corrispondere sempre a ID account.

Riferimento errori di convalida

Puoi ottenere 3 tipi di errori di convalida:

1. Messaggio di errore inline: questi appaiono nella tabella di convalida anteprima e fanno evidenziare le righe con errore in rosso:

   • CAMPO_NON_VALIDO — es., il Data creazione campo non era formattato in millisecondi dall'epoch unix .

   • CAMPO_MANCANTE — es., un campo obbligatorio come ID utente o ID account manca.

   
2. Richiamo errore: questi appaiono al posto della tabella di convalida anteprima come messaggi di avviso rossi:

   • INTESTAZIONE_MANCANTE — es., un'intestazione di colonna obbligatoria come ID account o Valore ricompensa manca.

   • PARSING_CSV — es., il file CSV contiene caratteri speciali formattati in modo errato.

   • RIF_IO_FILE — es., il file è corrotto e non può essere letto.

   
3. Errori elencati: questi appaiono come un elenco di conteggi degli errori nella schermata Importazioni e Esportazioni quando il tipo di importazione non dispone di una tabella di convalida anteprima. Gli errori di riga e di file verranno mostrati insieme:

   1. Nella barra di navigazione a sinistra, seleziona [Engage] → Reporting.

   2. Seleziona Importazioni e Esportazioni per visualizzare il report.