Les données sont transférées de et vers Emarsys en fichier de format (.csv) séparé par une virgule. Afin de vous assurer que les bonnes valeurs atteignent les bons champs de la base de données, voici un aperçu des conventions que nous utilisons.
Étant donné que les fichiers de données produit et les fichiers de données de vente utilisés pour Predict et Smart Insight doivent absolument suivre les conventions développées ci-dessous, nous vous conseillons fortement de les appliquer également à vos importations et exportations régulières de données de contact, puisqu'elles correspondent à la norme du secteur et vous permettront aussi de tirer profit de notre fonctionnalité de validation de fichier importé.
Table des matières
Introduction
Tous les fichiers de données entrants doivent être de type .csv (valeurs séparées par une virgule) et cryptés en UTF-8 Unicode.
Si vous utilisez Predict ou Smart Insight, il vous faut aussi confirmer avec le Support Emarsys que la structure de vos données correspond aux exigences de votre configuration particulière, surtout s'agissant des champs personnalisés.
La règle la plus importante à suivre pour le téléchargement de données est de s'assurer de la cohérence continue du format de tous les fichiers téléchargés. Une fois qu'un format a été choisi, il ne doit plus changer. Si vous souhaitez tout de même le modifier, veuillez contacter le Support Emarsys avant que ces changements ne prennent effet.
Syntaxe CSV
Voici nos règles fondamentales pour les fichiers .csv :
- Le séparateur de champ est toujours une virgule.
- Les valeurs contenants des virgules peuvent être citées à l'aide de guillemets doubles.
- Aucun champs ne peut contenir de caractères de saut de ligne (même entre guillemets).
- Les guillemets peuvent être éviter à l'intérieur des champs en les doublant :
""
. - La première ligne doit être la rangée d' en-tête contenant les noms de champ ; les lignes suivantes contiennent les champs dans l'ordre défini par l' en-tête.
- Les espaces vides redondants (en tête et en queue) sont automatiquement supprimés à moins d'être entre guillemets (e.g.
1, 2, 3
équivaut à1,2,3
).
Cryptage
Afin de maximiser le support en langues étrangères et d'assurer que le contenu s'affiche correctement, Emarsys insiste sur l'application du cryptage UTF-8 comme norme standard.
Pour les flotteurs, vous devez toujours utiliser un point (.) comme séparateur décimal, même dans les idiomes qui utilisent un caractère différent, tel qu'une virgule.
Modifier le cryptage
La plupart des éditeurs de textes offrent la fonctionnalité de changer le cryptage de votre contenu, ou bien vous laisseront choisir le cryptage d'un fichier si vous le sauvegardez (par exemple à l'intérieur de la boîte de dialogue Sauvegarder sous).
Cryptage d'URL
Les URLs (par exemple dans le champ lien
du catalogue produit), doivent être correctement cryptées pour URL. Les caractères tels que les espaces (`) ou les crochets (
[,
]`) sont à exclure de ces valeurs.
Les URLs doivent inclure le protocole, qui peut être de forme http://
, https://
ou encore //
en fonction du protocole.
Champs à valeurs multiples
Des valeurs multiples dans le fichier de données de contact
Lorsque vous préparez un fichier CSV pour l'importation de données de contact, assurez-vous que chaque valeur pour un champ à choix multiple a sa propre colonne.
L'en-tête de colonne doit contenir à la fois le nom du champ et al valeur, séparés par deux points (:), comme dans : field_name:field_value
.
Par exemple, si vous avez un champ Interested_in
et les options Sports, Jeux-vidéo, Films, Musique et Alimentation, votre fichier pourrait ressembler à ça :
Pour chacune des colonnes de valeur à choix multiple, utilisez soit le nom de la valeur (pour inclure cette valeur dans le fichier DB du contact) ou utilisez une valeur vide (pour omettre cette valeur s'agissant de ce contact en particulier).
Des valeurs multiples dans le fichier de données de produit
Certains champs de catalogue produit, tels que auteur
, peuvent avoir plusieurs valeurs, qui doivent être séparés par une barre verticale (|
) , par exemple :
item, title, author BOOK0012, Best essays of 1908, Charles Dickens | Oscar Wilde | Douglas Adams
Des valeurs multiples dans le fichier de données de ventes
Smart Insight n'accepte des valeurs multiples que dans un champ : catégorie
(voir ci-dessous).
Pour tous les autres champs, les valeurs multiples séparées par des barres verticales seront stockées par Smart Insight en une seule série, par exemple : Charles Dickens|Oscar Wilde|Douglas Adams
.
Format de catégorie
Le chemin de catégorie produit est une série d'ensembles de mieux en mieux affinés qui décrivent le produit. Par exemple, Le guide du voyageur galactique peut être classé comme Littérature > Fiction > SF
. Notez que les éléments du chemin de catégorie sont séparés par le caractère >
dans le fichier de catalogue produit. Dans une librairie, tous les produits se trouveraient dans le rayon Littérature
. Si une catégorie comprend tous les articles, nous l'appelons la catégorie source. Le champ catégorie
ne doit pas inclure la source.
Certains articles peuvent appartenir à plusieurs catégories. Par exemple, Le guide du voyageur galactique pourrait aussi être classé dans Littérature > Littérature anglaise > Contemporaine
. Les catégories multiples doivent être séparées par la barre verticale, |
.
La valeur correcte du champ catalogue
dans cet exemple serait :
Fiction > Sci-Fi | British literature > Contemporary
Remarque : Predict n'impose aucune limite au nombre de hiérarchies de catégorie, mais Smart Insight, qui utilise aussi le catalogue produit, n'accepte que les cinq premières et ne prend pas en compte les autres. Pour en savoir plus sur la gestion de catégories dans Predict, consultez les Catégories produit.
Format de date fort
Lorsque vous utilisez des champs de date, les formats suivants sont acceptés par Emarsys pour l'importation et l'exportation de données :
Format de date fort | Type de données |
---|---|
AAAA-MM-JJ | Données de contact, de ventes et de produit. |
JJ.MM.AAAA | Données de contact seulement. |
JJ/MM/AAAA | Données de contact seulement. |
MM/JJ/AAAA | Données de contact seulement. |
Horodatage
Lorsque vous utilisez un champ d'horodatage, par exemple pour identifier les achats individuels, vous devez utiliser le format UTC suivant :
- AAAA-MM-JJTHH:MM:SSZ
Mettre entre guillemets
Si les données elles-mêmes contiennent le caractère séparateur, vous devez alors indiquer au mécanisme d'importation que cela fait partie de la valeur du champ, de sorte qu'il ne l'interprète pas comme le signal de commencer une nouvelle rangée de données. Pour ce faire vous devez mettre l'intégralité de la valeur de champ entre doubles guillemets. Dans l'exemple ci-dessous, le séparateur , apparaît dans le texte de la seconde valeur de champ. Ainsi lorsque c'est au tour de ce champ d'être importé, la valeur entière et mise entre guillemets.
Valeur dans la base de données | Valeur dans CSV | Commentaires |
---|---|---|
Ordinateurs portables | ,Ordinateurs portables, | Aucuns guillemets requis. |
Ordinateurs portables, PC portables | ,"Ordinateurs portables, PC portables", | Guillemets obligatoires. |
Éviter
Comme pour le caractère séparateur, si le texte importé contient le caractère de guillemets, cela doit aussi être indiqué au mécanisme d'importation, cette fois en l'évitant. L'évitement est réalisé en ajoutant un autre caractère de guillemets à celui existant et en utilisant des guillemets pour entourer la valeur entière. Dans le premier exemple ci-dessous, le caractère de guillemets est utilisé dans le texte comme une abréviation pour l'unité de mesure pouce . Dans le second exemple, les guillemets sont utilisés non seulement pour éviter le symbole 'pouce', mais aussi pour indiquer que la valeur inclut le séparateur, ainsi que :
Valeur dans la base de données | Valeur dans CSV | Commentaires |
---|---|---|
Écrans de contrôle 21 | "Écrans de contrôle""21". | Le guillemet a été évité. |
Écrans de contrôle 21, écrans plats | ,"Écrans de contrôle "21"", écrans plats", | Guillemets et séparateurs sont utilisés. |
Remarque : Le séparateur tout comme les guillemets peuvent être personnalisés, mais dans tous les cas le caractère utilisé doit être choisi avec soin.
Valeurs vides
Les champs sans valeurs doivent tout de même être exportés en tant que valeur vide et sans guillemets du tout, de façon à ce que la structure des données n'en soit pas affectée
Exemple
Valeur dans la base de données | Valeur dans CSV | Commentaires |
---|---|---|
NUL | ,, | L'importation reconnaît un champ vide. |
Fichiers types
Voici quelques fichiers types comportant une sélection de champs typiques que vous pouvez télécharger et adapter à votre guise :