Cet article explique comment préparer un fichier "stores" pour l'import avec Splio.
Vous trouverez un exemple de fichier pour ce scope à la fin de l'article.
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".
Comment préparer un fichier de magasins
Si nécessaire, utilisez votre tableur pour enregistrer le fichier des magasins au format CSV ou pour supprimer les colonnes que vous ne pouvez pas (ou ne souhaitez pas) importer.
💡 | N'oubliez pas d'enregistrer avec le codage UTF-8 sans BOM et d'utiliser des points-virgules (";") pour séparer les colonnes.
En-tête et colonnes
La première ligne du fichier est l'en-tête. Assurez-vous qu'il ne contient que des noms de colonne, sinon l'import échouera.
⚠️ | 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 le champ obligatoire store_id.
Les colonnes suivantes sont disponibles dans les fichiers "magasins" :
Colonne |
Obligatoire |
Type de champ / longueur max |
Description |
store_id |
Oui |
Texte (max. 50 caractères) |
L'ID externe du magasin ; cette colonne est obligatoire et doit être unique pour chaque magasin. |
name |
Non |
Texte (max. 120 caractères) |
Le nom du magasin. |
online |
Non |
0 ou 1 |
1 si ecommerce, 0 si magasin physique. |
date_updated |
Non |
YYYY-MM-DD HH:MM:SS |
Date de dernière mise à jour du magasin |
manager |
Non |
Texte (max. 120 caractères) |
Le nom du manager du magasin. |
store_type |
Non |
Texte (max. 120 caractères) |
Le type de magasin à afficher dans Splio. |
date_added |
Non |
YYYY-MM-DD HH:MM:SS |
La date de création du magasin |
c0 |
Non |
|
Une colonne personnalisée définie dans votre univers pour les magasins. Vous pouvez en inclure jusqu'à 32 columns, de “c0” à “c31”. |
📗 | Tous les noms de colonnes sont en minuscules.
Exemple de fichier
Voici un fichier court qui contient trois magasins :
store_id;name;online;manager
MSEST;"Megastore East";"0";"Emma Smith"
EXBBY;"Express Store Brigby";"0";"Bob Brown"
OLDLV;"Online Delivery";"1";NULL
📗 | Toutes les lignes ont quatre colonnes, store_id, name, online (seulement la dernière ligne est online), et manager. Pas de colonnes personnalisées dans cet exemple.
Nommez votre fichier
Enregistrez votre fichier sous un nom composé du nom de l'univers, du scope ("magasins"), de la sous-séquence et de la date actuelle. Par exemple :
myuniverse_stores_apparel_20210315.csv
Ce nom de fichier appartient à l'univers "myuniverse", sous-séquence "habillement" défini pour les magasins, et est daté du 15 mars 2021.
Consultez notre Introduction pour en savoir plus sur les conventions de nommage.
Vous pouvez maintenant télécharger le fichier sur SFTP / FTPS.
Chaque date se compose de 4 chiffres pour un an, 2 pour un mois et 2 pour un jour, suivis des heures, des minutes et des secondes, de 2 chiffres chacun. Une date correcte pour le 15 mars 2018, 13h17, prendra la forme suivante :
2018-08-09 10:00:05
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,
2018-09-09
est traité exactement comme si vous aviez entré
2018-09-09 00:00:00
⚠️ | Il est obligatoire d'utiliser les heures, minutes et secondes pour les dates : 00:00:00 équivaut à minuit et Splio traitera chaque date sans heure comme ceci. Cela peut causer des erreurs et des triggers associés avec des dates échoueront. Toutes les données loyalty sont considérées comme des informations financières. Cela signifie que vous et votre marque êtes responsables de ces données et vous ne devez pas laisser de côté les détails.
📗 | Importer des dates avec des heures permet de surcroit de faire un ciblage beaucoup plus précis.
⚠️ | Utilisez toujours la même timezone pour les dates (c'est GMT+1 pour les clients en dehors de la Chine, et GMT+8 pour les clients chinois).
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. 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.