Questo articolo spiega come preparare un file “contatti” da importare su Splio. Tutti gli esempi utilizzati in questo file sono anonimi o fittizi.

Prerequisiti

Conoscenza di base del formato CSV e della codifica UTF-8.
Un editor di testo compatibile con UTF-8.
Un software per fogli di calcolo
La sottosequenza deve essere definita nel file di configurazione nella sezione "contatti".

Preparare un file di contatti

Modifica l'import file con l'editor di testo compatibile con UTF-8 di tua preferenza. Se necessario, utilizza un software per fogli di calcolo con cui hai dimestichezza per gestire il numero e la posizione delle colonne.

📘
Ricordati sempre di salvare utilizzando la codifica UTF-8 senza BOM.

🚧
Si prega di limitare le dimensioni del file a 200K righe.

Header e Colonne

La prima riga del file chiamata header viene utilizzata per determinare il contenuto delle righe successive. Pertanto, deve essere costruita solo a partire dai nomi delle colonne.

🚧
Tieni presente che Splio non importerà il file se il nome di una colonna non è identificabile o se mancano le colonne obbligatorie.

Questi sono i campi che troverai nei file "contatti":

Colonna	Obbligatorio	Tipo	Descrizione
email	*	Testo (max. 100 caratteri)	L'indirizzo email del contatto, che dev'essere scritto in minuscolo. Questa colonna è la chiave primaria predefinita del cliente (vedi sotto).
customer_key	*	Testo (max. 100 caratteri)	Nel caso in cui la chiave unica del database non sia l'email ma un campo personalizzato, questo campo dovrebbe essere associato a questa colonna. Consultare l'esempio 2 qui sotto.
lastname	No	Testo (max. 255 caratteri)	Il cognome del contatto.
firstname	No	Testo (max. 255 caratteri)	Il nome del contatto.
language	No	Codice lingua (2 lettere)	Il codice della lingua assegnata al contatto (i codici sono in minuscolo). Ecco l'elenco dei codici accettati: ar, br, ca, cz, de, en, es, fr, gr, it, ja, kr, nl, pl, ru, tr, zh.
cellphone	No	Testo (max. 30 caratteri) 0033XXXXXXXXX	Il numero di cellulare del contatto. Di default, il prefisso internazionale corrisponderà alla lingua usata nell'universo.
dateOfCreation	No	YYYY-MM-DD HH:MM:SS	È il valore inserito come data di creazione di un contatto nel database di Splio.
subscriptions	Yes	(speciale)	Una lista di numeri utilizzata per iscrivere e disiscrivere i contatti dalle liste. Vedi "iscrizioni" qui sotto.
c0	No		Una colonna personalizzata definita nel tuo universo per i contatti. Puoi includere fino a 180 colonne denominate da 'c0' a 'c179'.

📘

È importante notare che i nomi delle colonne devono rispettare le differenze tra maiuscole e minuscole, come ad esempio "cellphone" e "CellPhone", che rappresentano colonne distinte.

Ogni nome di colonna dovrebbe essere utilizzato una sola volta.

Le colonne "email" e "customer_key" sono obbligatorie, ma devi sempre utilizzare solo una di queste, a seconda della configurazione del tuo universo Splio. Per maggiori dettagli, consulta la sezione "Chiave Cliente" qui sotto.

Chiave Cliente

Splio utilizza una singola colonna per riconoscere i contatti unici nel database. Questa colonna è spesso denominata "chiave cliente" perché ogni valore in essa è sempre unico e consente di identificare i dati relativi ai clienti (contatti) in base a esso. Per questo motivo, la colonna chiave cliente è sempre obbligatoria.

Di default, il campo “email” funge da chiave del cliente, come illustrato nell'Esempio 1.

Il tuo universo SCP può essere configurato per utilizzare una colonna personalizzata al posto di "email" per identificare i contatti. In questo caso, questa colonna sostituisce "email" come chiave cliente e diventa obbligatoria. Utilizza l'alias di questa colonna personalizzata nell'intestazione del file di importazione.

🚧
Si noti che Splio di solito non distingue tra contatti in base ai numeri di telefono né controlla i duplicati di numeri di telefono, a meno che il campo "cellulare" non sia impostato come chiave cliente. Quindi, assicurati rimuovere i duplicati dei numeri di cellulare se necessario.

Esempio 1: Default Customer Key

Questo esempio illustra il caso predefinito quando l'indirizzo email del contatto è la chiave cliente. Utilizza "email" nell'header per identificarlo:

email;cellphone;firstname;lastname;language;subscriptions 
"[email protected]";"2235334599";"Spotty";"Spots";"fr";"+2" 
"[email protected]";"+4499884472525";"Monica";"Jameson";"en";"+2" 
"[email protected]";"+48502553311";"Lukas";"Syndyk";"pl";"+2"

📘

Nell'esempio ci sono 6 colonne. Gli indirizzi email saranno confrontati con il database per verificare se ci sono già dati esistenti. I nuovi dati saranno aggiunti e quelli esistenti aggiornati, in base alle impostazioni nel tuo file di configurazione.

Nota che il numero di telefono nella prima riga sotto l'header non include il prefisso internazionale del paese. In questo caso, verrà utilizzato il prefisso predefinito impostato nel file di configurazione.

L'ultima colonna indica a Splio di iscrivere tutti i contatti alla lista n. 2. Consulta "iscrizioni alle liste" qui sotto.

Esempio 2: Colonna personalizzata come Chiave Cliente

Questo esempio presenta un file di importazione per un universo Splio che utilizza un campo personalizzato per distinguere i contatti unici.

In questo universo la colonna "c0" è stata configurata per identificare i contatti. Questa colonna ha l'alias “ExternalId”. Si consiglia di utilizzare l'alias per maggiore chiarezza.

"ExternalId";email;cellphone;firstname;lastname;language;subscriptions 
"PPL000000045732";"[email protected]";"+332235334599";"Mister";"Jinx";"fr";"+1,+2,-11" 
"PPL000000107463";"[email protected]";"+4499884472525";"Monica";"Jameson";"en";"+1,+2,-11" 
"PPL000000084232";"[email protected]";"+420257537371";"Ijon";"Tichy";"cz";"+1,+3,-11"

📘

Si possono notare sette colonne, la prima è la colonna personalizzata "customer_key" che contiene gli id esterni. Splio utilizzerà questi valori per verificare quali dati sono nuovi e quali, invece, sono già esistenti.

La colonna “email” è ancora utilizzata per importare gli indirizzi email dei contatti.

Nominare il file

Per salvare il tuo file, usa un nome che includa il nome dell'universo, la sezione ("contatti"), la sottosequenza e la data attuale. Per esempio:

myuniverse_contacts_business_20180410.csv

Il nome di questo file appartiene all'universo "myuniverse", alla sottosequenza "business" impostata per i contatti, ed è datato 10 aprile 2018.

Se hai bisogno di ulteriori informazioni, consulta la guida su come nominare e raggruppare i file.

A questo punto, è possibile caricare il file su SFTP/FTPS.

Dettagli aggiuntivi

Questa sezione contiene ulteriori dettagli che possono essere utili quando si gestiscono file di contatti.

Iscrizioni alle liste

I contatti su Splio possono appartenere a liste numerate, e le importazioni consentono di iscrivere e disiscrivere in batch utilizzando la colonna delle iscrizioni.

La colonna contiene una lista di numeri contrassegnati separati da virgole (“,”). Ogni numero deve essere preceduto dal segno più (“+”) per effettuare l'iscrizione (es. “+3”) o dal segno meno (“-”) per annullarla (es. “-6”). L'intero elenco deve essere racchiuso tra virgolette, come “+3,-6”.

Nell'esempio seguente, il contatto è attualmente iscritto alle liste 1 e 7, mentre si è disiscritto dalle liste 2 e 4:

email;subscriptions 
"[email protected]";"+1,-2,-4,+7"

Fai attenzione quando lavori su file che includono la colonna delle iscrizioni usando software per fogli elettronici perché potrebbe interpretare erroneamente l'elenco e danneggiarlo, specialmente se usa la virgola (",") come separatore.

Date

Nel campo "dateOfCreation" le date sono formate da 4 cifre per l'anno, 2 per il mese e 2 per il giorno, seguite da ore, minuti e secondi, ciascuno con 2 cifre. Ad esempio, Il formato corretto per l'11 marzo 2021 alle 13:17, è il seguente:

2021-03-11 13:17:00

Il giorno e l'ora sono separati da uno spazio. È possibile omettere l'orario e inserire solo la data. In tal caso, Splio considererà automaticamente la mezzanotte come ora di riferimento. Quindi,

2021-03-07 è trattata esattamente come se avessi inserito 2021-03-07 00:00:00

Ricorda che se non specifichi il campo "dateOfCreation", Splio utilizzerà la data e l'ora dell'importazione.

🚧

Usare date senza l'ora non dovrebbe mai essere un'opzione per le date e gli orari: 00:00:00 è mezzanotte e Splio tenterà di elaborare la data come tale. Questo può causare errori e alcuni trigger associati alle date non funzioneranno. Un ulteriore vantaggio dell'uso delle date complete è che sarà possibile cercare e filtrare per data con molta più precisione.

Quando importi le date con l'orario, assicurati di utilizzare sempre il fuso orario CEST.

NULL e valori di cancellazione

NULL è un valore specifico che indica al database che il campo corrispondente è vuoto.

Puoi configurare il tuo universo Splio affinché interpreti i valori NULL come istruzioni per svuotare i campi. Questa funzione ti consente di cancellare i dati memorizzati nel database. Assicurati che il valore importato sia esattamente NULL, senza spazi aggiuntivi all'inizio o alla fine, altrimenti " NULL" o “NULL” verranno trattati come valori di stringa.

Se non abiliti questa opzione, Splio manterrà i valori per i campi in cui il valore importato è “NULL”.

Differenza tra NULL e stringa vuota

“”è una stringa vuota. Nella maggior parte dei casi, sia NULL che“” saranno importati come valori vuoti.

In particolare, la stringa vuota ""non viene mai considerata come un valore NULL, quindi non provoca la cancellazione di un valore esistente.