Importa i dati del tuo programma referral

Quando passi da un’altra piattaforma di referral ad Advocate, non stai solo importando dati — stai migliorando il potenziale del tuo programma con monitoraggio avanzato, esperienze personalizzabili e supporto esperto. Questo articolo ti guida attraverso:

• Perché la migrazione è importante
• Come si presenta un piano di migrazione strategico
• Quali dati possono essere importati
• Come preparare i file
• Errori di convalida comuni e come evitarli

Perché pianificare una migrazione strategica?

Migrare il tuo programma di referral non è solo un’attività tecnica — è un’occasione per migliorare il modo in cui coinvolgi e premi i tuoi clienti. Una migrazione ben pianificata aiuta a:

• Ridurre al minimo le interruzioni nella tua esperienza di referral
• Conservare i dati storici e garantire la continuità dei premi
• Consentire una separazione pulita dai sistemi legacy
• Rilanciare il tuo programma di referral con entusiasmo e chiarezza

La migrazione di referral e premi dipende dalla tua capacità di esportare i dati dal sistema attuale. Il tuo team Advocate può dirti cosa è possibile in base ai dati di esportazione che fornisci.

Il tuo team Advocate lavorerà con te per esaminare i file esportati, identificare ciò che è fattibile e creare un piano che si adatti alle esigenze e agli obiettivi del tuo programma.

Cosa dovrai fare

• Esporta dal tuo programma i dati utente, dati di referrale dati dei premi. Contatta il tuo CSM sulla tua vecchia piattaforma di referral per assistenza, oppure usa uno strumento di esportazione integrato nella piattaforma, se disponibile.
• Scarica ciascuno dei 3 report di dati in un file CSV separato, ad es. user_data.CSV, referral_data.CSVe reward_data.CSV.

  • Consulta gli esempi qui sotto per vedere come potrebbero apparire i contenuti di ciascun file .csv, oppure consulta il riferimento completo del campo Destination.

Questo include email, codici referral, share link e campi personalizzati. Gli affiliati dovrebbero essere filtrati per evitare doppi premi.

Dipendente dal formato dello sharelink e dall’uso di un sottodominio personalizzato.

Il file Dati utente conterrà informazioni dettagliate su ciascun partecipante del tuo programma. Esporta un elenco di tutti i partecipanti per mantenere il tuo programma aggiornato con i loro share link e codici referral.

I seguenti campi sono obbligatori:

• ID utente
• ID account

Usa l’email dell’utente come suo ID utente e ID account. Le date devono essere formattate in millisecondi dall’epoch Unix. Scarica un esempio dei campi richiesti oppure usa l’esempio qui sotto nel formato .csv .

id,accountId,email,firstName,lastName,dateCreated,locale,countryCode,segments
[e-mail],[e-mail],[e-mail],First,Last,1741051242000,en_US,US,
[e-mail],[e-mail],[e-mail],First,Last,,,,"vip,newuser"
[e-mail],[e-mail],[e-mail],First,Last,,en_CA,,
[e-mail],[e-mail],[e-mail],First,Last,,,,newuser

Questo include le date di inizio e conversione, e le relazioni tra referente e referenziato. Supporta la mappatura delle prestazioni storiche dei referral.

Il file dei dati di referral fornisce una registrazione dello stato di ciascuna connessione di referral creata nel tuo programma di referral.

I seguenti campi sono obbligatori:

• ID utente Advocate
• ID account Advocate
• ID utente referenziato
• ID account referenziato

Usa l’email dell’utente come suo ID utente e ID account. Le date devono essere formattate in millisecondi dall’epoch Unix. Scarica un esempio dei campi richiesti oppure usa l’esempio qui sotto nel formato .csv .

referrerUser,referrerAccount,referredUser,referredAccount,dateReferralStarted,dateConverted,programId
[e-mail],[e-mail],[e-mail],[e-mail],1740824979000,1740824979000,33435
[e-mail],[e-mail],[e-mail],[e-mail],1741051242000,1741051242000,33435
[e-mail],[e-mail],[e-mail],[e-mail],,,33435
[e-mail],[e-mail],[e-mail],[e-mail],,,33435

Questo include valori, date assegnate/incassate, tipi di premio e stati. Permette di preservare credibilità ed equità con gli utenti.

Il file Dati premi fornisce una registrazione della cronologia dei premi dei partecipanti, incluso il loro valore e l’importo riscattato generato tramite il tuo programma di referral.

I seguenti campi sono obbligatori:

• ID utente Advocate
• ID account Advocate
• Nome del premio
• Unità del premio
• Valore del premio
• Data di creazione
• Data di assegnazione
• Data di riscatto
• Importo riscattato

Usa l’email dell’utente come suo ID utente e ID account. Le date devono essere formattate in millisecondi dall’epoch Unix.

Il valore del premio è il valore numerico del premio nella sua più piccola unità di misura (ad es., per un premio in denaro di 1,00 $, il valore sarebbe 100 centesimi). Se l’unità del premio è denaro, deve includere il codice valuta nel seguente formato <nomeUnità>/<Valuta> (es. Cash/USD).

Importante: Se i Data di riscatto e Importo riscattato campi non sono impostati correttamente — il che significa che sono lasciati vuoti o contengono valori errati (ad es. una data futura o un importo riscattato inesatto) — il premio potrebbe tornare disponibile per essere riscattato di nuovo dall’utente.

Scarica un esempio dei campi richiesti oppure usa l’esempio qui sotto nel formato .csv .

User ID,Acccount ID,Referred User ID,Referred Account ID,Reward Name,Reward Unit,Reward Value,Redeemed Amount,Date Created,Date Given,Date Redeemed
[e-mail],[e-mail],[e-mail],[e-mail],Dollars,CASH/USD,1000,1000,1709712158000,1709712158000,1709712158000
[e-mail],[e-mail],[e-mail],[e-mail],Points,POINT,100,100,1726164909682,1726164909682,1726164909682
[e-mail],[e-mail],[e-mail],[e-mail],Points,POINT,100,100,1726164887075,1726164887075,1726164887075
[e-mail],[e-mail],[e-mail],[e-mail],Points,POINT,100,100,1726164875888,1726164875888,1726164875888
[e-mail],[e-mail],[e-mail],[e-mail],Points,POINT,10,10,1726164828986,1726164828986,1726164828986
[e-mail],[e-mail],[e-mail],[e-mail],Credito account,USD,8000,8000,1726164289997,1726164289997,1726164289997
[e-mail],[e-mail],,,Gift Card,USD,10000,10000,1726163864871,1726163864871,1726163864871
[e-mail],[e-mail],,,Points,POINT,800,800,1726095906392,1726095906392,1726095906392
[e-mail],[e-mail],,,Gift Card,USD,30000,30000,1726163769157,1726163769157,1726163769157
[e-mail],[e-mail],,,20% di sconto,%,20,20,1726180309034,1726180309034,1726180309034

Importante: Tutti e 3 i file di esportazione devono contenere dati di un solo programma. Se i file contengono dati di più programmi, l’importazione li consoliderà in un unico programma.

Un piano di migrazione di esempio

Ogni migrazione è unica, ma quelle di successo seguono una struttura simile che bilancia preparazione, comunicazione ed esecuzione. Di seguito trovi un piano di migrazione che garantisce continuità e un’esperienza senza interruzioni sia per il tuo team sia per i tuoi advocate. Le tempistiche e le fasi possono variare in base alla configurazione del tuo programma.

Fase 1: Pianificazione e preparazione (1–2 settimane)

Questa è la fase in cui getti le basi, preparando il terreno per una transizione fluida.

Obiettivi	• Allineare gli stakeholder. • Configurazione tecnica. • Confermare l’ambito della migrazione. • Pianificare la comunicazione agli utenti.
Attività	• Procurati un set di esempio dei tuoi dati storici (utenti, referral, premi) e condividilo con il team Advocate per la revisione e la mappatura dei campi . • Esporta i set completi di dati una volta che il campione è stato convalidato. Molto probabilmente i dati di esportazione dovranno essere manipolati (ad es. adattando intestazioni, nomi dei campi o struttura del file) per soddisfare i requisiti di importazione. • Imposta una data di go-live e una finestra di rollback. • Aggiungi i widget di Advocate in modalità nascosta (ambiente di test o pagine non collegate). • Configura le integrazioni necessarie (ad es. Shopify, HubSpot, Segment). • Completa la configurazione del programma in Advocate (ad es. impostazione dei premi, regole del programma, modelli email, segmentazione). • Testa la funzionalità del programma end-to-end — verifica che condivisioni, conversioni e premi siano tracciati correttamente in un ambiente di test prima del go-live. • Redigi i messaggi per comunicare la transizione agli advocate. La migrazione di referral e premi dipende dalla tua capacità di esportare i dati dal sistema attuale. Il tuo team Advocate può dirti cosa è possibile in base ai dati di esportazione che fornisci.
Suggerimenti	• Se stai sovrapponendo le piattaforme, assicurati che solo una eroghi i premi. • Identifica gli utenti power che potrebbero richiedere un trattamento speciale (VIP, influencer).

Fase 2: Cutover e go-live (1-2 giorni)

Questo è il momento della transizione. Pianifica una breve pausa nel tracciamento tra i sistemi e, se possibile, programma il passaggio nelle ore di minor traffico.

Obiettivi	• Passa senza soluzione di continuità dalla tua piattaforma legacy ad Advocate. • Assicurati che gli utenti possano accedere immediatamente alla nuova esperienza. • Evita la perdita di dati di referral o premi.
Attività	• Rimuovi dal sito gli script/widget della vecchia piattaforma. • Pubblica i widget di Advocate. • Importa i dati finali di utenti, referral e premi. • Traccia/segnala manualmente eventuali conversioni tra lo spegnimento del sistema e il lancio. • Monitora il dashboard di Advocate per l’attività. • Invia la comunicazione di lancio ai tuoi advocate. Fai sapere agli utenti che i loro link di referral sono stati aggiornati e, idealmente, includi direttamente i nuovi link nell’email per rendergli facile iniziare subito a condividerli.
Suggerimenti	• Se necessario, includi un breve buffer di blackout dei premi (ad es. “I referral effettuati il 15 maggio saranno esaminati e aggiunti dopo il lancio.”). • Usa la comunicazione rivolta agli advocate per creare entusiasmo (ad es. “Abbiamo migliorato la tua esperienza di referral!”).

Fase 3: Post-migrazione e pulizia (1–2 giorni)

Ora che sei online, assicurati che il tuo programma funzioni come previsto e risolvi eventuali aspetti in sospeso.

Obiettivi	• Verifica l’integrità dei dati e il tracciamento dei premi. • Recupera eventuali conversioni mancate. • Supporta ed educa gli utenti.
Attività	• Verifica che le relazioni tra referente e referenziato funzionino in modalità live. • Importa eventuali conversioni mancate avvenute durante il cutover. • Esegui un test QA (fai un referral a te stesso, conferma il tracciamento e la logica dei premi). • Fornisci FAQ o documenti di supporto interni ed esterni. • Monitora la casella di supporto per problemi relativi agli utenti legacy.
Suggerimenti	• Se stai dismettendo un conto legacy di finanziamento premi, concedi agli utenti un periodo di grazia per riscattare. • Usa email o promemoria in-app per incentivare le prime attività di referral nel nuovo programma.

Importa i dati del tuo programma

1. Dal menu di navigazione a sinistra, seleziona [Engage] → Reporting → Importazioni ed esportazioni.
2. Nell'angolo in alto a destra, seleziona Importa.
3. Seleziona il filtro Tipo di importazione tra le opzioni disponibili:

   Tipo di importazione	Descrizione
   Utenti	Seleziona questa opzione per caricare nuovi utenti o dati di utenti esistenti. Puoi anche scegliere di importare questi dati da un account o da una piattaforma diversa.
   Aggiorna i saldi premi degli utenti	Seleziona questa opzione per aggiornare e riscattare i saldi premi degli utenti.
   Eventi utente	Seleziona questa opzione per caricare i dati degli eventi utente.
   Elimina utenti	Seleziona questa opzione se vuoi eliminare in blocco gli utenti esistenti dal tuo programma. Puoi anche disattivare la gestione degli utenti e scegliere di: • Conservare gli account vuoti • Impedire che gli utenti eliminati vengano creati di nuovo
   Cronologia premi	Seleziona questa opzione per caricare una registrazione di tutte le informazioni sui premi. Puoi anche scegliere di importare questi dati da un account o da una piattaforma diversa.
   Cronologia referral	Seleziona questa opzione per caricare una registrazione di tutte le connessioni di referral. Puoi anche scegliere di importare questi dati da un account o da una piattaforma diversa.

4. Seleziona Scegli file oppure trascina e rilascia il file che desideri importare.
5. Seleziona Importa per caricare i tuoi dati.

   • Se elimini utenti in blocco, seleziona Eliminazione massiva.

Riferimento agli errori di convalida

Puoi ricevere 3 tipi di errori di convalida:

1. Messaggio di errore inline: questi compaiono nella tabella di convalida dell’anteprima e fanno sì che le righe con errore vengano evidenziate in rosso:

   • INVALID_FIELD — ad es., il Data di creazione campo non è stato formattato in millisecondi dall’epoch Unix .
   • MISSING_FIELD — ad es., un campo obbligatorio come ID utente oppure ID account manca.

   
2. Messaggio 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 oppure Valore del premio manca.
   • CSV_PARSING — ad es., il file CSV contiene caratteri speciali formattati in modo errato.
   • FILE_REF_IO — ad es., il file è danneggiato e non può essere letto.

   
3. Errori elencati: questi compaiono come un elenco di conteggi degli errori nella Importazioni ed esportazioni schermata all’interno della Reportistica sezione quando il tipo di importazione non dispone di una tabella di convalida dell’anteprima. Gli errori di riga e gli errori del file verranno mostrati insieme:

   

Supporto

Non devi affrontare la migrazione da solo. Il nostro team di onboarding di Advocate è pronto ad aiutarti con:

• Supporto alla mappatura dei campi
• Guida alla formattazione dei dati
• Strategia di migrazione dei premi
• Test e QA

Contatta il tuo team di supporto Advocate.