# Importa i dati del tuo programma 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 ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c11b6248bd7b0ef1b687330c8c79fba510517058%2Ff18ad34bbbcaa64fb7feb774bf5d7e154b2a259f3a75f2c3b60ec0ed3ed2371d.svg?alt=media) * Permettere una separazione pulita dai sistemi legacy * Reintrodurre il tuo programma di referral con entusiasmo e chiarezza ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c11b6248bd7b0ef1b687330c8c79fba510517058%2Ff18ad34bbbcaa64fb7feb774bf5d7e154b2a259f3a75f2c3b60ec0ed3ed2371d.svg?alt=media) 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`, e `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 di referral, link di condivisione ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c11b6248bd7b0ef1b687330c8c79fba510517058%2Ff18ad34bbbcaa64fb7feb774bf5d7e154b2a259f3a75f2c3b60ec0ed3ed2371d.svg?alt=media), e campi personalizzati. Gli affiliati dovrebbero essere filtrati per evitare doppie ricompense. ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c11b6248bd7b0ef1b687330c8c79fba510517058%2Ff18ad34bbbcaa64fb7feb774bf5d7e154b2a259f3a75f2c3b60ec0ed3ed2371d.svg?alt=media) 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](https://currentmillis.com/). Scarica un [esempio dei campi richiesti](https://res.cloudinary.com/product-enablement/raw/upload/v1750169976/CSVs/Migration_User_Import_examples_-_User_Data.csv) o utilizza l'esempio sotto in `.csv` formato. ```programlisting id,accountId,email,firstName,lastName,dateCreated,locale,countryCode,segments User1@example.com,User1@example.com,User1@example.com,First,Last,1741051242000,en_US,US, User2@example.com,User2@example.com,User2@example.com,First,Last,,,,"vip,newuser" User3@example.com,User3@example.com,User3@example.com,First,Last,,en_CA,, User4@example.com,User4@example.com,User4@example.com,First,Last,,,,newuser ``` 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](https://currentmillis.com/). Scarica un [esempio dei campi richiesti](https://res.cloudinary.com/product-enablement/raw/upload/v1750249453/CSVs/Migration_User_Import_examples_-_Referral_Data_-_Referral_Data.csv) o utilizza l'esempio sotto in `.csv` formato. ```programlisting referrerUser,referrerAccount,referredUser,referredAccount,dateReferralStarted,dateConverted,programId User2@example.com,User2@example.com,User12@example.com,User12@example.com,1740824979000,1740824979000,33435 User1@example.com,User1@example.com,User13@example.com,User13@example.com,1741051242000,1741051242000,33435 User1@example.com,User1@example.com,User17@example.com,User17@example.com,,,33435 User1@example.com,User1@example.com,User18@example.com,User18@example.com,,,33435 ``` 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](https://currentmillis.com/). 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 `/` (Es.: Cash/USD). {% hint style="warning" %} **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. {% endhint %} Scarica un [esempio dei campi richiesti](https://res.cloudinary.com/product-enablement/raw/upload/v1750249453/CSVs/Migration_User_Import_examples_-_Reward_Data_-_Reward_Data.csv) o utilizza l'esempio sotto in `.csv` formato. ```programlisting User ID,Acccount ID,Referred User ID,Referred Account ID,Reward Name,Reward Unit,Reward Value,Redeemed Amount,Date Created,Date Given,Date Redeemed User1@example.com,User1@example.com,User2@example.com,User2@example.com,Dollars,CASH/USD,1000,1000,1709712158000,1709712158000,1709712158000 User1@example.com,User1@example.com,User3@example.com,User3@example.com,Points,POINT,100,100,1726164909682,1726164909682,1726164909682 User1@example.com,User1@example.com,User4@example.com,User4@example.com,Points,POINT,100,100,1726164887075,1726164887075,1726164887075 User1@example.com,User1@example.com,User5@example.com,User5@example.com,Points,POINT,100,100,1726164875888,1726164875888,1726164875888 User1@example.com,User1@example.com,User6@example.com,User6@example.com,Points,POINT,10,10,1726164828986,1726164828986,1726164828986 User1@example.com,User1@example.com,User7@example.com,User7@example.com,Account Credit,USD,8000,8000,1726164289997,1726164289997,1726164289997 User1@example.com,User1@example.com,,,Gift Card,USD,10000,10000,1726163864871,1726163864871,1726163864871 User1@example.com,User1@example.com,,,Points,POINT,800,800,1726095906392,1726095906392,1726095906392 User1@example.com,User1@example.com,,,Gift Card,USD,30000,30000,1726163769157,1726163769157,1726163769157 User1@example.com,User1@example.com,,,20 Off,%,20,20,1726180309034,1726180309034,1726180309034 ``` {% hint style="warning" %} **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. {% endhint %}
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 1. Dal menu 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] → Reporting → Importazioni & Esportazioni**. 2. In alto a destra, seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-ec3276f07285180fbb2167a40e148d3e43e8681c%2F05aa88f72076df5a744d4620574f19cc187b7154fe1f3bb73ad7a892b7d23002.svg?alt=media) **Importa**. 3. Seleziona il *Tipo di importazione* dalle 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 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. | 4. Seleziona **Scegli file** o trascina e rilascia il file che desideri importare. 5. 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: 1. **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](https://currentmillis.com/) . * `CAMPO_MANCANTE` — ad es., un campo obbligatorio come *ID utente* o *ID account* manca.
2. **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.
3. **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](mailto:support-advocate@impact.com).