Questo articolo illustra l'import automatico delle iscrizioni al programma loyalty. Le iscrizioni corrispondono a codici di carta loyalty, ognuno dei quali rappresenta l'adesione ad un programma che può essere collegato ad un individuo. Quando importi un file di iscrizioni, aggiungi nuovi membri a un programma loyalty. In questo articolo vedrai anche come cambiare il livello di un batch di membri Loyalty.

Prerequisiti

Conoscenza di base del formato CSV e della codifica UTF-8
Un editor di testo compatibile con la codifica UTF-8
Un software di fogli di calcolo
Generazione della sotto-sequenza nel file di configurazione in ambito “cardcode”
Identificazione della chiave unica del tuo universo
Una certa comprensione dei dati loyalty importati in Splio

Preparazione di un file di import "iscrizioni" (subscriptions)

🚧
Per favore, limita le dimensioni del file a 200K.

Prepara un file CSV contenente le colonne della tabella qui di seguito.

Colonna	Necessaria	Formato	Descrizione
card_code	Sì	Testo	ID della carta loyalty. I codici sono unici: se indichi un codice esistente, il record sarà aggiornato. ⚠️ \| Questa colonna è obbligatoria, ma l'universo Splio può essere configurato per generare automaticamente dei codici carta. In tal caso, Splio fornirà i valori mancanti di "card_code" in formato EAN13. In questo caso, la colonna può avere un valore vuoto (ma è comunque necessario includerlo nel file).
customer_key	Sì	Testo	Colonna speciale che identifica il titolare della carta. In genere contiene almeno l'indirizzo email del titolare. Se vuoto, il codice carta non verrà collegato ad alcun contatto.
id_program	Sì	Numero intero positivo	ID del programma loyalty a cui appartiene l'iscrizione. Si tratta di un numero che dovresti ricevere dal tuo contatto presso Splio. Puoi trovarlo anche nell'URL del programma. ⚠️ \| Questa colonna dovrebbe essere utilizzata solamente per importare nuove iscrizioni. Assicurati di eliminarla quando importi degli aggiornamenti: tutti i tentativi per aggiornare "id_program" avranno esito negativo, in quanto le linee saranno ignorate.
join_date	No	YYYY-MM-DD HH:MM:SS	La data in cui il titolare della carta si è iscritto al programma. Se vuoto, verrà integrato con l'ora di import. Vedi qui di seguito per una spiegazione più dettagliata sulle date.
expiration_date	No	YYYY-MM-DD HH:MM:SS	La data in cui l'iscrizione scadrà.
birthday	No	YYYY-MM-DD HH:MM:SS	Data (senza orario) del compleanno del titolare della carta. Utilizzata in molte sotto-operazioni.
id_tier	No	ID livello per inserire il numero di carta in un dato livello (livelli VIP compresi). Se vuoto, restituirà il livello più basso del tuo programma. Funziona solo per la creazione del codice carta e non per un aggiornamento.	ID livello per inserire il numero di carta in un dato livello (livelli VIP compresi). Se vuoto, restituirà il livello più basso del tuo programma. Funziona solo per la creazione del codice carta e non per un aggiornamento.

🚧
L'ordine dei campi nell'importazione del cardcode è essenziale e deve rispettare il seguente ordine: "card_code"; "customer_key"; "id_program"; "join_date"; "custom_fields".

📘
Ricorda che Splio non importerà file con colonne obbligatorie mancanti oppure colonne che non può identificare. Le linee con valori vuoti nelle colonne obbligatorie saranno ignorate. Vedi anche le note per le singole colonne qui sopra.

Si noti che da gennaio 2024 è possibile creare un solo codice carta per contatto in un determinato programma Loyalty. I codici carta creati in precedenza non sono stati cancellati, né sono scaduti

Esempio di file di iscrizione

L'esempio qui di seguito mostra un file di import. I valori ;NULL; sono spiegati qui di seguito.

card_code;customer_key;id_program;join_date;expiration_date;birthday;id_tier
"my_card_code";"[email protected]";"1";"2019-01-01 00:00:01";"2020-01-01 00:00:01;1955-02-01";"2";
"[email protected]";"3";;;;"2"
"my_card_code1";"[email protected]";"1";;;;"4"

📘
Non ci sono errori evidenti in questo file, eppure la prima linea contiene molte più informazioni rispetto alle altre due. Nota che al centro della linea non c'è il codice carta: se la generazione automatica del codice carta è attiva, Splio fornirà tale numero. In caso contrario, questa linea causerà un errore e non verrà importata.

Cambio di livello

Importare codici carta ti serve anche per cambiare il livello di un batch di membri del tuo programma loyalty.

A tal fine, occorre preparare un file con i seguenti campi:

Colonna	Obbligatorio	Formato	Descrizione
card_code	Sì	Testo	vedi sopra
tier_name	Sì	Testo	il nome del livello
context	No	Testo	il motivo per cui hai effettuato un cambio di livello
value_date	Sì	YYYY-MM-DD HH:MM:SS	la data in cui il membro passa da un livello all'altro
last_downgrade_check	No	YYYY-MM-DD HH:MM:SS	specifica la data dell'ultimo controllo sul downgrade : sarà presa in considerazione per i controlli periodici sul downgrade (giornalieri, mensili, annuali)

Denominare il file di import

Splio richiede che i file di import siano denominati in modo specifico. Ogni nome del file deve contenere il nome dell'universo, l'ambito ("cardcode" o "tierchange"), la sotto-sezione (ricevuta dal tuo contatto in Splio) e la data. L'ordine in cui i file sono elaborati dipende dagli ambiti e dalle date.

Lo schema per denominare un file è: universe_scope_subsection_YYYYMMDD.csv. Ciò significa che il nome per un file di import in un universo "myuniverse", ambito "cardcode" o "tierchange" e sottosezione "customers", datato 14 febbraio 2019 sarà:myuniverse_cardcode_customers_20190214.csv

🚧
ISe c'è più di un file cardcode al giorno, la sequenza nel nome del file è obbligatoria.

Spiegazione: date

Tutte le date utilizzate nei file di import di iscrizione vengono formattate nel seguente modo: 4 cifre per l'anno, 2 per il mese e 2 per il giorno, seguite da ore, minuti e secondi con 2 cifre per ciascuno. Il formato corretto per la data del 9 agosto 2018 alle 10:00:05 sarà:2018-08-09 10:00:05

Il giorno e l'ora sono separati da uno spazio vuoto. Puoi omettere la parte dell'orario e utilizzare solo la data. In tal caso Splio utilizzerà il primo orario possibile del giorno (mezzanotte). Quindi, 2018-09-09 equivale a 2018-09-09 00:00:00.

🚧

Questa non dovrebbe mai essere un'opzione per le date e gli orari. 00:00:00 corrisponde alla mezzanotte e Splio tenterà di elaborare ogni data in questo modo. Quest'azione potrebbe generare degli errori e dei trigger associati alle date potrebbero non avvenire in modo corretto. Inoltre, tutti i dati loyalty sono sempre paragonabili a dati economici, pertanto è importante non trascurare nulla.
Un ulteriore vantaggio nell'utilizzare una data completa è che sarai in grado di cercare e filtrare per data con maggior precisione

"birthday" è l'unico campo dove l'import senza orario è sicuro e consigliabile.

Utilizza sempre lo fuso orario CEST.

Spiegazione: cancellazione dei valori

Solo per l'ambito delle iscrizioni loyalty, i valori NULL non funzionano per cancellare i dati. Utilizzare "" oppure un valore vuoto per questo scopo.