Cet article explique comment préparer un fichier "contacts" pour l'import avec Splio. Tous les exemples utilisés dans ce fichier sont anonymes ou fictifs.

Pré-requis

Connaissance de base du format CSV et de l’encodage UTF-8.
Un éditeur de texte compatible UTF-8.
Un tableur
La sous-séquence doit être définie dans le fichier de configuration dans le scope "contacts".

Préparation d'un fichier de contacts

Modifiez le fichier d'importation à l'aide de votre éditeur de texte favori compatible UTF-8. Si nécessaire, utilisez un tableur avec lequel vous êtes à l'aise pour contrôler le nombre et la position des colonnes.

📘
N'oubliez pas d'utiliser l’encodage UTF-8 sans BOM.

🚧
Veuillez limiter la taille de votre fichier à 200K lignes.

En-tête et colonnes

La première ligne du fichier, appelée en-tête, est utilisée pour déterminer le contenu des lignes suivantes. Elle ne doit donc être construite qu'à partir des noms des colonnes.

🚧
N'oubliez pas que Splio ignorera le fichier si il rencontre un nom de colonne qu'il ne peut pas reconnaître, ou si le fichier ne contient pas les colonnes obligatoires.

Les colonnes suivantes sont disponibles dans les fichiers "contacts":

Colonne	Obligatoire	Type	Description
email	*	Texte (max. 100 caractères)	L'email du contact. Cette colonne est la clé client par défaut (voir ci-dessous). Il doit être en minuscules.
customer_key	*	Texte (max. 100 caractères)	Dans des cas spécifiques, votre univers Splio peut utiliser un autre champ que l'email comme clé unique. Dans ces cas, ce champ doit être mappé ici. Voir l'exemple 2 ci-dessous.
lastname	Non	Texte (max. 255 caractères)	Le nom de famille du contact.
firstname	Non	Texte (max. 255 caractères)	Son prénom.
language	Non	code langue (2 lettres)	Le code langue associé au contact (en minuscules). La liste des codes que nous acceptons : ar, br, ca, cz, de, en, es, fr, gr, it, ja, kr, nl, pl, ru, tr, zh.
cellphone	Non	Texte (max. 30 caractères) 0033XXXXXXXXX	Le numéro de téléphone du contact. Par défaut, l'indicatif sera celui qui correspond à la langue de l'univers.
dateOfCreation	Non	YYYY-MM-DD HH:MM:SS	La valeur de date de création du contact dans la base Splio, sous forme de date.
subscriptions	Oui	(spécial)	Des nombres qui permettent d'inscrire des contacts à des listes. Voir les inscriptions ci-dessous.
c0	Non		Un champ custom défini dans votre univers pour les contact. Vous pouvez en inclure jusqu'à 180, de “c0” à “c179”.

📘

Les noms de colonnes sont case sensitive, donc “cellphone” et “CellPhone” sont deux colonnes différentes.

Chaque nom de colonne doit être utilisé une seule fois.

L'email et la colonne “clé unique” sont obligatoires, mais vous pouvez n'utiliser que l'une d'entre elles, en fonction de la configuration de votre univers. Pour plus de détails, voir la section " Customer Key " ci-dessous.

Clé unique

Splio utilise une seule colonne pour reconnaître les contacts uniques dans la base de données. Elle est souvent appelée "clé unique" car chaque valeur de cette colonne est toujours unique et vous pouvez identifier vos enregistrements client (contacts) par cette valeur. Pour cette raison, la colonne de clé unique est toujours obligatoire.

Par défaut, le champ "email" est la clé unique. Ce cas est présenté dans l'exemple 1.

Votre univers SCP peut être configuré pour utiliser une colonne personnalisée au lieu de "email" pour identifier les contacts. S'il en est ainsi, cette colonne remplace "email" comme clé unique et devient obligatoire. Utilisez l'alias de cette colonne personnalisée dans l'en-tête de votre fichier d'import.

🚧
N'oubliez pas que Splio ne fait normalement pas de distinction entre les contacts sur la base des numéros de téléphone ou ne vérifie pas les numéros de téléphone en double, à moins que la clé unique de l'univers soit le numéro de téléphone. C'est à vous de dédupliquer les données mobiles si nécessaire.

Exemple 1 : clé unique par défaut

Cet exemple montre le cas par défaut lorsque l'adresse e-mail du contact est la clé unique. Utilisez "email" dans l'en-tête pour l'identifier :

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"

📘

Il y a 6 colonnes dans l'exemple. Les adresses e-mail seront comparées à la base de données pour voir si chaque enregistrement existe déjà. De nouveaux enregistrements seront ajoutés et ceux existants mis à jour, selon les paramètres de votre fichier de configuration.

Notez que le numéro de téléphone dans la première ligne sous l'en-tête n'a pas le code du pays. Dans un tel cas, le code par défaut défini dans le fichier de configuration sera utilisé.

La dernière colonne indique à Splio de souscrire tous les contacts à la liste n ° 2. Voir ci-dessous pour plus d'informations sur les abonnements à la liste.

Exemple 2 : colonne personnalisée comme clé client

Cet exemple présente un fichier d'import pour un univers Splio qui utilise un champ personnalisé pour distinguer les contacts uniques.

Dans cet univers, nous utiliserons la colonne personnalisée "c0". Cette colonne a également un alias, "externalId". On doit utiliser l'alias lorsque cela est possible pour des raisons de clarté.

"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"

📘

Sept colonnes sont visibles, la première est la colonne personnalisée "customer_key" qui contient des identifiants externes. Splio utilisera ces valeurs pour vérifier quels enregistrements sont nouveaux et lesquels existent déjà.

La colonne "e-mail" est toujours utilisée pour importer les adresses e-mail des contacts.

Nommez votre fichier

Enregistrez votre fichier sous un nom composé du nom de l'univers, du scope ("contacts"), de la sous-séquence et de la date actuelle. Par exemple :

myuniverse_contacts_business_20180410.csv

Ce nom de fichier appartient à l'univers "myunivers", sous-séquence "business" défini pour les contacts, et est daté du 10 avril 2018.

Vous pouvez maintenant télécharger le fichier sur SFTP / FTPS.

Explications

Cette section contient des explications supplémentaires qui peuvent s'avérer utiles lorsque vous travaillez avec des fichiers de contacts.

Liste d’abonnements

Les contacts dans Splio peuvent appartenir à des listes numérotées et les imports vous permettent d'effectuer des abonnements et des désabonnements par lots à l'aide de la colonne des abonnements.

La colonne contient une liste de numéros signés séparés par des virgules (","). Chaque numéro doit être précédé du signe plus ("+") pour vous abonner (par exemple, "+3") ou du signe moins ("-") pour vous désinscrire (par exemple, "-6"). La liste entière doit être placée entre guillemets, comme "+ 3, -6".

Dans l'exemple suivant, le contact est abonné aux listes 1 et 7 et se désabonne des listes 2 et 4 :

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

Soyez prudent lorsque vous modifiez des fichiers contenant la colonne d'abonnement avec un tableur. Il peut mal interpréter la liste et la casser, surtout s'il veut utiliser la virgule (",") comme séparateur.

Dates

Les dates dans le champ "dateOfCreation" sont composées de 4 chiffres pour un an, 2 pour un mois et 2 pour un jour, suivis des heures, des minutes et des secondes, 2 chiffres chacun. Une date correcte pour le 11 mars 2021, 13h17, prendra la forme suivante :

2021-03-11 13:17:00

Le jour et l'heure sont séparés par un espace vide. Vous pouvez omettre la partie heure et utiliser uniquement la date. Si vous le faites, Splio considérera l'heure la plus tôt possible pour la journée (minuit). Donc,

2021-03-07 est traité exactement comme si vous aviez entré2021-03-07 00:00:00

N'oubliez pas que si vous ne spécifiez pas la dateOfCreation, Splio utilisera la date et l'heure d'import.

🚧

Les dates doivent toujours être utilisées avec les heures et les minutes. 00:00:00 correspond à minuit et Splio considèrera cette heure telle qu'elle. Ceci peut causer de nombreuses erreurs et problèmes d'automatisation. Un autre avantage de l'utilisation de dates complètes est que vous pourrez effectuer des recherches et des filtrages par date avec beaucoup plus de précision.

Lorsque vous importez des dates avec de l'heure, veillez à toujours utiliser le fuseau horaire CEST.)

Explications : NULL et valeurs de suppression

NULL est une valeur spéciale qui indique à la base de données que le champ qui la contient est vide.

NULL est une valeur spéciale qui indique à la base de données que le champ qui la contient est vide. Votre univers Splio peut être configuré pour interpréter les valeurs NULL comme des instructions pour vider les champs. Vous pouvez l'utiliser pour effacer les valeurs stockées dans la base de données. Pour ce faire, assurez-vous que la valeur importée est exactement NULL. Vous devez éviter les espaces de début ou de fin: "NULL " ou " NULL" seront reconnus comme des valeurs de chaîne.

Si cette option n'est pas définie, Splio conservera les valeurs des champs où la valeur importée est NULL.

Différence entre NULL et une chaîne vide

"" est une chaîne vide. Dans la plupart des cas, NULL et "" seront importés en tant que valeur vide. Plus important encore, la chaîne vide "" n'est jamais considérée comme une valeur NULL, donc elle n'entraînera pas l'effacement d'une valeur existante.