Importazione ed esportazione
Trasferisci i membri da un'altra app di loyalty con un CSV, oppure esporta i tuoi membri attuali come backup. Entrambe le funzioni si trovano in Impostazioni, sotto Importazione ed esportazione membri.
Importazione ed esportazione membri
Esportare i membri
Clicca su Esporta membri in CSV per scaricare ogni membro iscritto come file CSV. Usalo come backup, per esaminare i saldi in un foglio di calcolo o come modello di partenza per un'importazione — le colonne dell'esportazione sono un sovrainsieme di ciò che legge l'importatore, quindi un file esportato può essere modificato e reimportato così com'è.
Formato CSV
All'importatore servono solo tre colonne. Eventuali colonne extra di un'esportazione vengono ignorate. La riga di intestazione è obbligatoria e i nomi delle colonne non distinguono maiuscole e minuscole.
| Colonna | Obbligatoria | Cos'è |
|---|---|---|
email | Sì | L'email del membro. Usata per trovare il cliente Shopify corrispondente. |
points | Sì | Un numero intero ≥ 0. Diventa il saldo punti del membro (e la base dei punti totali). |
tier | No | Uno slug di tier (es. gold). Lascia vuoto per far decidere il tier ai punti. |
Il valore tier deve essere uno slug di tier, non il suo nome visualizzato — per esempio vip-member, non "VIP Member". Un'esportazione usa già gli slug, quindi i round-trip sono sicuri.
Un file di importazione minimo ha questo aspetto:
email,points,tier
alice@example.com,1200,gold
bob@example.com,350,silver
carol@example.com,0,Cosa fa un'importazione
Per ogni riga la cui email corrisponde a un cliente Shopify esistente, l'importazione:
- Iscrive il membro — senza bonus di iscrizione, indipendentemente dalla tua impostazione del bonus di iscrizione.
- Imposta i suoi punti al valore del CSV (è un'impostazione, non un'aggiunta).
- Assegna il tier dalla colonna
tier, oppure lo ricava dai punti se la colonna è vuota. - Data i punti al giorno dell'importazione — quindi se usi la scadenza progressiva (FIFO), il conteggio riparte dal giorno in cui importi.
L'importazione è una sostituzione completa. Per ogni email che corrisponde a un membro esistente, l'importazione sovrascrive il saldo attuale e cancella la cronologia punti precedente (mantenuta solo come righe annullate per audit). I codici sconto già emessi non vengono toccati. Questa operazione non può essere annullata — quindi per una migrazione una tantum, importa prima che i membri inizino a guadagnare.
Come funziona la corrispondenza
I membri vengono associati ai clienti Shopify tramite email. Se un'email non ha un cliente Shopify corrispondente, quella riga viene saltata ed elencata nel risultato — l'importazione non crea mai nuovi clienti Shopify. Le email saltate vengono mostrate al termine dell'importazione, così puoi creare quei clienti in Shopify e rieseguire se necessario.
I tier dopo l'importazione
Un tier dal CSV viene applicato immediatamente. Gibbond ricontrolla anche il tier di ogni membro una volta al giorno rispetto alle tue soglie di tier, quindi un tier è in ultima analisi determinato dai punti del membro. Se importi un tier per cui i punti non sono sufficienti, verrà riconciliato al tier basato sui punti alla successiva esecuzione giornaliera. Per mantenere stabili i tier importati, assicurati che le tue soglie di tier siano allineate ai punti che importi.
Eseguire un'importazione
Le importazioni vengono eseguite in background, così puoi lasciare la pagina mentre una è in corso. Un banner di stato mostra l'avanzamento in tempo reale e un riepilogo al termine (importati, saltati ed eventuali errori). Dopo la scrittura dei dati, Gibbond aggiorna automaticamente il saldo punti e il tier di ogni membro sulla vetrina.
| Limite | Valore |
|---|---|
| Dimensione massima del file | 5 MB |
| Righe massime per importazione | 10.000 |
| Email duplicate in un file | Vince l'ultima riga per un'email |
Rieseguire lo stesso file è sicuro: poiché ogni importazione è una sostituzione completa, reimportare semplicemente riallinea i membri ai valori del file invece di accumulare punti.