# Importa i dati del tuo programma di referral Quando si passa da un'altra piattaforma di referral ad Advocate, non stai solo importando dati — stai potenziando le possibilità del tuo programma con monitoraggio avanzato, esperienze personalizzabili e supporto esperto. Questo articolo ti guiderà 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'occasione per migliorare il modo in cui coinvolgi e premi i tuoi clienti. Una migrazione ben pianificata aiuta a: * Ridurre al minimo le interruzioni della tua esperienza di referral * Conservare i dati storici e garantire la continuità dei premi ![](/files/b4b476a3c2475775c360c31bec6e9342a36d1699) * Consentire una separazione netta dai sistemi legacy * Rilanciare il tuo programma di 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 utenti del tuo programma *dati utente*, *dati di referral*, e *dati premi*. Contatta il tuo CSM sulla vecchia piattaforma di referral per assistenza, oppure utilizza 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.CSV`, e `reward_data.CSV`. * Vedi gli esempi qui sotto per capire come potrebbero apparire i contenuti di ciascun file .csv, oppure consulta il riferimento completo del campo Destination. Questo include email, codici referral, sharelink ![](/files/b4b476a3c2475775c360c31bec6e9342a36d1699)e campi personalizzati. Gli affiliati dovrebbero essere filtrati per evitare doppi premi. ![](/files/b4b476a3c2475775c360c31bec6e9342a36d1699) Dipendente dal formato dello sharelink e dall'uso di un sottodominio personalizzato. Il file dei Dati Utente conterrà informazioni dettagliate su ciascun partecipante al tuo programma. Esporta un elenco di tutti i partecipanti per mantenere il 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'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) 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 date di inizio e di conversione, e relazioni tra referrer 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'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) 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à con gli utenti. Il file dei Dati Premi fornisce una registrazione della cronologia dei premi dei partecipanti, incluso il loro valore e l'importo riscattato generati tramite il tuo programma di referral. I seguenti campi sono **obbligatori**: * ID utente Advocate * ID account Advocate * Nome premio * Unità premio * Valore 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 es., per un premio in denaro di $1,00, il valore sarebbe 100 centesimi). Se l'unità del premio è denaro, dovrebbe includere il codice valuta nel seguente formato `/` (Es., Cash/USD). {% hint style="warning" %} **Importante**: Se i *Data di riscatto* e *Importo riscattato* campi non sono impostati correttamente — ovvero vengono lasciati vuoti o contengono valori errati (ad es., una data futura o un importo riscattato inesatto) — il premio potrebbe tornare 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) 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,Credito account,USD,8000,8000,1726164289997,1726164289997,1726164289997 User1@example.com,User1@example.com,,,Carta regalo,USD,10000,10000,1726163864871,1726163864871,1726163864871 User1@example.com,User1@example.com,,,Punti,POINT,800,800,1726095906392,1726095906392,1726095906392 User1@example.com,User1@example.com,,,Carta regalo,USD,30000,30000,1726163769157,1726163769157,1726163769157 User1@example.com,User1@example.com,,,20 di sconto,%,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 è riportato 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 getti le basi, preparando il terreno per una transizione senza intoppi. | | | | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Obiettivi |

• Allinea gli stakeholder.

• Configurazione tecnica.

• Conferma l'ambito della migrazione.

• Pianifica la comunicazione con gli utenti.

| | Attività |

• Ottieni un 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 manipolati (ad es., modificando 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 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., configurazione dei premi, regole del programma, modelli email, segmentazione).

• Testa 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.

• 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 stia erogando i premi.

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

| **Fase 2: passaggio 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 tutto nelle ore di minor traffico. | | | | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Obiettivi |

• Passa senza interruzioni dalla tua piattaforma legacy ad Advocate.

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

• Evita la perdita di dati di referral o premi.

| | Attività |

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

• Metti online i widget Advocate.

• Importa i dati finali di utenti, referral e premi.

• Traccia/segna manualmente eventuali conversioni tra lo spegnimento del sistema e il lancio.

• Monitora la 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 nella email i nuovi link per facilitare l'avvio immediato della condivisione.

| | Suggerimenti |

• Se necessario, includi un breve buffer di sospensione dei premi (ad es., “I referral effettuati il 15 maggio saranno esaminati e aggiunti dopo il lancio.”).

• Usa una 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 operativo, assicurati che il programma funzioni come previsto e risolvi eventuali questioni in sospeso. | | | | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Obiettivi |

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

• Recupera eventuali conversioni mancate.

• Offri supporto e formazione agli utenti.

| | Attività |

• Verifica che le relazioni tra referrer e referenziato funzionino in modalità live.

• Importa eventuali conversioni mancate avvenute tra il passaggio e il lancio.

• Esegui un test QA (fai un referral a te stesso, conferma il tracciamento e la logica dei premi).

• Fornisci FAQ o documentazione di aiuto sia interne sia esterne.

• Monitora la casella di supporto per 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 incoraggiare l'attività iniziale di referral nel nuovo programma.

|
#### Importa i dati del tuo programma 1. Dal menu di navigazione a sinistra, seleziona ![](/files/56eb48c7f3195590132b62ea75c0575abe0113e5) **\[Engage] → Reporting → Importazioni ed esportazioni**. 2. Nell'angolo in alto a destra, seleziona ![](/files/65b45ec3644c7d29d33e9400b42a6b753a094c1b) **Importa**. 3. Seleziona il *Tipo di importazione* tra le 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 account o da una piattaforma diversa. | | Aggiorna i saldi premi utente | 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 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 un registro 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 un registro di tutte le connessioni di referral. Puoi anche scegliere di importare questi dati da un account o da una piattaforma diversa. | 4. Seleziona **pulsante 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 ottenere 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 campo *Data di creazione* non è stato formattato in [millisecondi dall'epoca Unix](https://currentmillis.com/) . * `MISSING_FIELD` — ad es., un campo obbligatorio come *ID utente* o *ID account* manca.
2. **Callout 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* o *Valore 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 elenco dei conteggi degli errori nella schermata *Importazioni ed esportazioni* all'interno della sezione *Reporting* quando il tipo di importazione non dispone di una tabella di convalida dell'anteprima. Gli errori delle righe e gli errori del file verranno visualizzati 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](mailto:support-advocate@impact.com). --- # Agent Instructions: 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: ``` GET https://help.impact.com/brand/it/che-cosa-vorresti-imparare/advocate-program/getting-started-with-advocate/import-your-referral-program-data.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.