Importa i Dati del Tuo Programma di Referral
Quando si passa da un'altra piattaforma di referral ad Advocate, non si sta semplicemente importando dati: si sta potenziando il potenziale del tuo programma con tracciamento avanzato, esperienze personalizzabili e supporto esperto. Questo articolo ti guida attraverso:
Perché la migrazione è importante
Come appare un piano di migrazione strategico
Quali dati possono essere importati
Come preparare i tuoi file
Errori di convalida comuni e come evitarli
Perché pianificare una migrazione strategica?
Migrare il tuo programma di referral non è solo un compito tecnico: è un'opportunità per migliorare il modo in cui coinvolgi e premi i tuoi clienti. Una migrazione ben pianificata aiuta a:
Minimizzare le interruzioni dell'esperienza di referral
Preservare i dati storici e garantire la continuità delle ricompense
Permettere una separazione pulita dai sistemi legacy
Reintrodurre il tuo programma di referral con entusiasmo e chiarezza
La migrazione di referral e ricompense dipende dalla tua capacità di esportare i dati dal sistema attuale. Il tuo team Advocate può informarti su ciò che è possibile in base ai dati di esportazione che fornisci.
Il tuo team Advocate lavorerà con te per esaminare i file di esportazione, identificare cosa è fattibile e creare un piano che corrisponda alle esigenze e agli obiettivi del tuo programma.
Cosa dovrai fare
Esporta il dati utente, dati referral, e dati sulle ricompense. Contatta il tuo CSM sulla vecchia piattaforma di referral per assistenza oppure usa uno strumento di esportazione integrato, se disponibile.
Scarica ciascuno dei 3 report dei dati in un file CSV separato, ad es.
user_data.CSV,referral_data.CSV, ereward_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 di referral, link di condivisione , e campi personalizzati. Gli affiliati dovrebbero essere filtrati per evitare doppie ricompense.
Dipende dal formato del link di condivisione e dall'uso di sottodomini personalizzati.
Il file dei dati utente conterrà informazioni dettagliate su ciascun partecipante al tuo programma. Esporta un elenco di tutti i partecipanti per mantenere il tuo programma aggiornato con i loro link di condivisione e codici di referral.
I seguenti campi sono obbligatori:
ID utente
ID account
Usa l'email dell'utente come ID utente e ID account. Le date dovrebbero essere formattate in millisecondi dall'epoca Unix. Scarica un esempio dei campi richiesti o utilizza l'esempio sotto in .csv formato.
Questo include date di inizio e di conversione e le relazioni referrer/referred. Supporta la mappatura delle prestazioni storiche dei referral.
Il file dei dati referral fornisce un registro dello stato di ciascuna connessione di referral effettuata nel tuo programma di referral.
I seguenti campi sono obbligatori:
ID utente Advocate
ID account Advocate
ID utente segnalato
ID account segnalato
Usa l'email dell'utente come ID utente e ID account. Le date dovrebbero essere formattate in millisecondi dall'epoca Unix. Scarica un esempio dei campi richiesti o utilizza l'esempio sotto in .csv formato.
Questo include valori, date assegnate/riscattate, tipi di ricompensa e stati. Consente di preservare credibilità e correttezza verso gli utenti.
Il file dei dati sulle ricompense fornisce un registro della cronologia delle ricompense dei partecipanti, compreso 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 della ricompensa
Unità della ricompensa
Valore della ricompensa
Data di creazione
Data assegnata
Data riscattata
Importo riscattato
Usa l'email dell'utente come ID utente e ID account. Le date dovrebbero essere formattate in millisecondi dall'epoca Unix.
Il valore della ricompensa è il valore numerico della ricompensa nella sua unità di misura più piccola (ad es., per una ricompensa in denaro di $1,00, il valore sarebbe 100 centesimi). Se l'unità della ricompensa è contante, dovrebbe includere il codice valuta nel seguente formato <unitName>/<Currency> (Es.: Cash/USD).
Importante: Se i Data riscattata e Importo riscattato campi non sono impostati correttamente — cioè sono lasciati vuoti o contengono valori errati (ad es., una data futura o un importo riscattato inaccurato) — la ricompensa potrebbe diventare nuovamente disponibile per il riscatto da parte dell'utente.
Scarica un esempio dei campi richiesti o utilizza l'esempio sotto in .csv formato.
Importante: Tutti e 3 i file di esportazione dovrebbero contenere dati di un unico 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 è riportato un piano di migrazione che garantisce continuità e un'esperienza senza intoppi sia per il tuo team sia per i tuoi advocate. Tempistiche e fasi possono variare a seconda della configurazione del tuo programma.
Fase 1: Pianificazione e preparazione (1–2 settimane)
Questa è la fase di definizione delle basi, che getta le fondamenta per una transizione senza problemi.
Obiettivi
• Allineare gli stakeholder.
• Configurazione tecnica.
• Confermare l'ambito della migrazione.
• Pianificare la comunicazione agli utenti.
Attività
• Ottenere un campione dei tuoi dati storici (utenti, referral, ricompense) e condividerlo con il team Advocate per la revisione e la mappatura dei campi .
• Esportare set di dati completi una volta che il campione è stato convalidato. I dati di esportazione molto probabilmente dovranno essere manipolati (ad es., modifica degli header, nomi dei campi o struttura del file) per corrispondere ai requisiti di importazione.
• Impostare una data di go-live e una finestra di rollback.
• Aggiungere i widget di Advocate in modalità nascosta (ambiente di test o pagine non collegate).
• Configurare le integrazioni necessarie (ad es., Shopify, HubSpot, Segment).
• Completare la configurazione del programma in Advocate (ad es., impostazione delle ricompense, regole del programma, template email, segmentazione).
• Testare la funzionalità del programma end-to-end — confermare che condivisioni, conversioni e ricompense vengano tracciate correttamente in un ambiente di test prima del lancio.
• Redigere i messaggi per comunicare la transizione agli advocate.
La migrazione di referral e ricompense dipende dalla tua capacità di esportare i dati dal sistema attuale. Il tuo team Advocate può informarti su ciò che è possibile in base ai dati di esportazione che fornisci.
Suggerimenti
• Se stai sovrapponendo piattaforme, assicurati che solo una emetta ricompense.
• Identificare gli utenti potenti che potrebbero necessitare di gestione 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 programma durante ore di basso traffico, se possibile.
Obiettivi
• Passare senza soluzione di continuità dalla piattaforma legacy ad Advocate.
• Assicurarsi che gli utenti possano accedere immediatamente alla nuova esperienza.
• Evitare la perdita di dati di referral o ricompense.
Attività
• Rimuovere gli script/widget della vecchia piattaforma dal tuo sito.
• Mettere online i widget di Advocate.
• Importare i dati finali di utenti, referral e ricompense.
• Tracciare/manualmente segnalare eventuali conversioni tra lo spegnimento del sistema e il lancio.
• Monitorare la dashboard di Advocate per l'attività.
• Inviare la comunicazione di lancio ai tuoi advocate. Informare gli utenti che i loro link di referral sono stati aggiornati e, idealmente, includere i nuovi link direttamente nell'email per facilitare la condivisione immediata.
Suggerimenti
• Includere un breve periodo di blackout delle ricompense se necessario (ad es., “I referral effettuati il 15 maggio saranno esaminati e aggiunti dopo il lancio.”).
• Usare comunicazioni rivolte agli advocate per creare entusiasmo (ad es., “Abbiamo aggiornato la vostra esperienza di referral!”).
Fase 3: Post-migrazione e pulizia (1–2 giorni)
Ora che sei live, assicurati che il tuo programma funzioni come previsto e affronta eventuali questioni rimaste aperte.
Obiettivi
• Verificare l'integrità dei dati e il tracciamento delle ricompense.
• Catturare eventuali conversioni mancate.
• Supportare e formare gli utenti.
Attività
• Convalidare che le relazioni referrer/referred funzionino in modalità live.
• Importare eventuali conversioni mancate che si sono verificate durante il cutover.
• Eseguire un test QA (inviati un referral, confermare il tracciamento e la logica delle ricompense).
• Fornire FAQ interne ed esterne o documenti di aiuto.
• Monitorare la casella di supporto per problemi relativi agli utenti legacy.
Suggerimenti
• Se stai dismettendo un account di finanziamento delle ricompense legacy, concedi agli utenti un periodo di grazia per riscattare.
• Usare promemoria via email o in-app per incentivare l'attività di referral iniziale nel nuovo programma.
Importa i dati del tuo programma
Dal menu di navigazione a sinistra, seleziona
[Engage] → Reporting → Importazioni & Esportazioni.In alto a destra, seleziona
Importa.Seleziona il Tipo di importazione dalle opzioni disponibili:
Tipo di importazioneDescrizioneUtenti
Seleziona questa opzione per caricare nuovi utenti o dati di utenti esistenti. Puoi anche scegliere di importare questi dati da un account o una piattaforma diversa.
Aggiorna i saldi premi degli utenti
Seleziona questa opzione per aggiornare e riscattare i saldi delle ricompense 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 gestire l'eliminazione degli utenti e scegliere di:
• Conservare gli account vuoti
• Impedire che gli utenti eliminati vengano creati di nuovo
Cronologia delle ricompense
Seleziona questa opzione per caricare un registro di tutte le informazioni sulle ricompense. Puoi anche scegliere di importare questi dati da un account o una piattaforma diversa.
Cronologia dei referral
Seleziona questa opzione per caricare un registro di tutte le connessioni di referral. Puoi anche scegliere di importare questi dati da un account o una piattaforma diversa.
Seleziona Scegli file o trascina e rilascia il file che desideri importare.
Seleziona Importa per caricare i tuoi dati.
Se elimini in blocco gli utenti esistenti, seleziona Eliminazione in blocco.
Riferimento errori di convalida
Puoi ricevere 3 tipi di errori di convalida:
Messaggio di errore inline: questi appaiono nella tabella di convalida di anteprima e fanno evidenziare le righe con errori in rosso:
CAMPO_NON_VALIDO— ad es., il Data di creazione campo non è stato formattato in millisecondi dall'epoca Unix .CAMPO_MANCANTE— ad es., un campo obbligatorio come ID utente o ID account manca.
Avviso di errore: questi appaiono al posto della tabella di convalida di anteprima come messaggi di avviso rossi:
INTESTAZIONE_MANCANTE— ad es., un'intestazione di colonna obbligatoria come ID account o Valore della ricompensa manca.PARSING_CSV— ad es., il file CSV contiene caratteri speciali formattati in modo errato.RIF_IO_FILE— ad es., il file è corrotto e non può essere letto.
Errori elencati: questi appaiono come un elenco di conteggi di errori nella schermata Importazioni & Esportazioni all'interno della sezione Reportistica quando il tipo di importazione non ha una tabella di convalida di anteprima. Gli errori di riga e gli errori di file verranno visualizzati insieme:
Supporto
Non devi affrontare la migrazione da solo. Il nostro team di onboarding Advocate è pronto ad aiutare con:
Supporto per la mappatura dei campi
Linee guida per il formato dei dati
Strategia di migrazione delle ricompense
Testing e QA
Contatta il tuo team di supporto Advocate.
Ultimo aggiornamento
È stato utile?