> 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-your-referral-program-data.md). # Importa i dati del tuo programma di referral Quando passi da un'altra piattaforma referral ad Advocate, non stai semplicemente importando dati: stai potenziando il potenziale del tuo programma con un tracciamento 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 tuoi file * Errori di convalida comuni e come evitarli #### Perché pianificare una migrazione strategica? Migrare il tuo programma referral non è solo un compito tecnico: è 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 referral * Conservare i dati storici e garantire la continuità dei premi ![](/files/b4b476a3c2475775c360c31bec6e9342a36d1699) * Consentire una separazione netta dai sistemi legacy * Rilanciare il tuo programma referral con entusiasmo e chiarezza ![](/files/b4b476a3c2475775c360c31bec6e9342a36d1699) 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 di esportazione, identificare ciò che è fattibile e creare un piano che corrisponda alle esigenze e agli obiettivi del tuo programma. #### Cosa dovrai fare * Esporta i dati *utente*, *referral*, e *dei premi*. Contatta il tuo CSM sulla vecchia piattaforma 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 esempio, `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 al campo Destination. Questo include email, codici referral, link di condivisione ![](/files/b4b476a3c2475775c360c31bec6e9342a36d1699), e campi personalizzati. Gli affiliati dovrebbero essere filtrati per evitare doppi premi. ![](/files/b4b476a3c2475775c360c31bec6e9342a36d1699) Dipende dal formato del link di condivisione e dall'uso di un sottodominio personalizzato. Il file dei dati utente conterrà informazioni dettagliate su ciascun partecipante del tuo programma. Esporta un elenco di tutti i partecipanti per mantenere aggiornato il tuo programma con i loro link di condivisione 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'epoca Unix](https://currentmillis.com/). Scarica un [esempio dei campi obbligatori](https://res.cloudinary.com/product-enablement/raw/upload/v1750169976/CSVs/Migration_User_Import_examples_-_User_Data.csv) oppure utilizza l'esempio qui 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 le date di inizio e di conversione, e le relazioni tra chi ha segnalato e chi è stato segnalato. Supporta la mappatura delle prestazioni storiche delle referral. Il file dei dati referral fornisce una registrazione dello stato di ciascuna connessione referral creata nel tuo programma referral. I seguenti campi sono **obbligatori**: * ID utente Advocate * ID account Advocate * ID utente segnalato * ID account segnalato Usa l'email dell'utente come suo *ID utente* e *ID account*. Le date devono essere formattate in [millisecondi dall'epoca Unix](https://currentmillis.com/). Scarica un [esempio dei campi obbligatori](https://res.cloudinary.com/product-enablement/raw/upload/v1750249453/CSVs/Migration_User_Import_examples_-_Referral_Data_-_Referral_Data.csv) oppure utilizza l'esempio qui 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 di assegnazione/riscatto, tipi di premio e stati. Consente di preservare credibilità ed equità per gli utenti. Il file dei dati premi fornisce una registrazione della cronologia dei premi dei partecipanti, inclusi il loro valore e l'importo riscattato generati tramite il tuo programma 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'epoca Unix](https://currentmillis.com/). Il valore del premio è il valore numerico del premio nella sua unità di misura più piccola (ad esempio, per un premio in denaro di $1,00, il valore sarebbe 100 centesimi). Se l'unità del premio è denaro contante, dovrebbe includere il codice valuta nel seguente formato `/` (ad es. Cash/USD). {% hint style="warning" %} **Importante**: Se i *Data di riscatto* 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 inesatto) — il premio potrebbe tornare disponibile per essere riscattato di nuovo dall'utente. {% endhint %} Scarica un [esempio dei campi obbligatori](https://res.cloudinary.com/product-enablement/raw/upload/v1750249453/CSVs/Migration_User_Import_examples_-_Reward_Data_-_Reward_Data.csv) oppure utilizza l'esempio qui 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 devono contenere dati di un solo 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 trovi un piano di migrazione che garantisce continuità e un'esperienza fluida 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 poni le fondamenta, gettando le basi per una transizione fluida. | | | | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Obiettivi |

• Allineare gli stakeholder.

• Configurazione tecnica.

• Confermare l'ambito della migrazione.

• Pianificare la comunicazione agli utenti.

| | Task |

• Procurati un set campione dei tuoi dati storici (utenti, referral, premi) e condividilo con il team Advocate per la revisione e la mappatura dei campi .

• Esporta i set di dati completi una volta che il campione è stato convalidato. Molto probabilmente i dati esportati dovranno essere modificati (ad es. adattando intestazioni, nomi dei campi o struttura del file) per soddisfare i requisiti di importazione.

• Impostare una data di go-live e una finestra di rollback.

• Aggiungere i widget 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 dei premi, regole del programma, modelli email, segmentazione).

• Testare la funzionalità del programma end-to-end: verifica che condivisioni, conversioni e premi vengano tracciati correttamente in un ambiente di test prima del go-live.

• Preparare 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 piattaforme, assicurati che solo una stia emettendo premi.

• Identifica gli utenti avanzati che potrebbero richiedere un trattamento speciale (VIP, influencer).

| **Fase 2: passaggio e messa in produzione (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 interruzioni dalla tua piattaforma legacy ad Advocate.

• Assicurati che gli utenti possano accedere immediatamente alla nuova esperienza.

• Evita la perdita di dati referral o premi.

| | Task |

• Rimuovi dal tuo sito gli script/widget della vecchia piattaforma.

• Porta online i widget 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 Advocate per l'attività.

• Invia la comunicazione di lancio ai tuoi advocate. Fai sapere agli utenti che i loro link referral sono stati aggiornati e, idealmente, includi direttamente nella email i nuovi link per consentire loro di iniziare subito a condividerli.

| | Suggerimenti |

• Se necessario, includi un breve periodo di blackout per i premi (ad es. "Le referral effettuate il 15 maggio verranno esaminate e aggiunte dopo il lancio.").

• Usa la comunicazione rivolta agli advocate per creare entusiasmo (ad es. "Abbiamo migliorato la tua esperienza referral!").

| **Fase 3: post-migrazione e pulizia (1–2 giorni)** Ora che sei online, assicurati che il programma funzioni come previsto e affronta eventuali questioni rimaste in sospeso. | | | | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Obiettivi |

• Verifica l'integrità dei dati e il tracciamento dei premi.

• Recupera eventuali conversioni mancate.

• Supporta e istruisci gli utenti.

| | Task |

• Convalida che le relazioni tra chi segnala e chi è segnalato funzionino in modalità live.

• Importa eventuali conversioni mancate avvenute durante il passaggio.

• Esegui un test QA (referisci te stesso, verifica il tracciamento e la logica dei premi).

• Fornisci FAQ o documentazione di supporto interna ed esterna.

• Monitora la casella di supporto per i problemi relativi agli utenti legacy.

| | Suggerimenti |

• Se stai dismettendo un account legacy per il finanziamento dei premi, concedi agli utenti un periodo di grazia per riscattare.

• Usa email o promemoria 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 ![](/files/56eb48c7f3195590132b62ea75c0575abe0113e5) **\[Engage] → Reportistica → Importazioni ed esportazioni**. 2. Nell'angolo in alto a destra, seleziona ![](/files/65b45ec3644c7d29d33e9400b42a6b753a094c1b) **Importa**. 3. Seleziona il *Tipo di importazione* dalle opzioni disponibili: | Tipo di importazione | Descrizione | | ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Utenti | Seleziona questa opzione per caricare nuovi utenti o dati utente esistenti. Puoi anche scegliere di importare questi dati da un altro account o piattaforma. | | Aggiorna i saldi premio 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 desideri eliminare in blocco gli utenti esistenti dal tuo programma.

Puoi anche eliminare 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 altro account o piattaforma. | | Cronologia referral | Seleziona questa opzione per caricare una registrazione di tutte le connessioni referral. Puoi anche scegliere di importare questi dati da un altro account o piattaforma. | 4. Seleziona **Scegli file** oppure 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 agli errori di convalida Puoi ricevere 3 tipi di errori di convalida: 1. **Messaggio di errore inline:** questi appaiono 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 era formattato in [millisecondi dall'epoca 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 convalida dell'anteprima 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 errato. * `FILE_REF_IO` — ad es. il file è danneggiato e non può essere letto.
3. **Errori elencati:** questi appaiono come un elenco di conteggi di errore nella *Importazioni ed esportazioni* schermata all'interno della *Report* sezione quando il tipo di importazione non dispone di una tabella di convalida di 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 Advocate è pronto ad aiutarti con: * Supporto per la mappatura dei campi * Guida alla formattazione dei dati * Strategia di migrazione dei premi * Test e QA Contatta il tuo [team di supporto Advocate](mailto:support-advocate@impact.com). --- # 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.impact.com/brand/it/what-would-you-like-to-learn-about/advocate-program/getting-started-with-advocate/import-your-referral-program-data.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.