Dans cette section :

Préparer votre Fichier de données de ventes

Vous devez formater votre fichier de ventes en conformité avec les spécifications et les lignes directrices décrites ci-dessous.

Table des matières

Règles générales

  • Votre fichier de données de ventes doit être un simple tableur .csv , dont chaque ligne décrit les caractéristiques d'un seul article de ligne.
  • Utilisez une bibliothèque d'exportation CSV compatible avec le format CSV standard.
  • Utilisez une virgule pour séparer les champs dans une rangée.
  • Quand un champ n'a aucune valeur, laissez-le vide. Exemple: value1,,value3,value4.
  • N'utilisez pas les caractères de saut de ligne, qu'ils soient entre guillemets ou non, dans les champs.
  • Utilisez le cryptage UTF-8.
  • Intégrez les noms de champ dans la première rangée (en-tête) et assurez-vous que toutes les rangées suivantes contiennent les valeurs correspondantes aux champs énumérés dans l'en-tête. Si vous avez un doute sur comment faire cela, contactez le Support Emarsys.
  • N'utilisez pas plus de 255 colonnes.
  • N'utilisez pas de valeurs de champ plus longues que 64 KB.

Très important :

Les colonnes dans l'en-tête de votre fichier de données de ventes doivent être dans le même ordre que ce qui a été convenu pendant l'implémentation d'intégration Smart Insight. Dans le cas contraire, le téléversement échouera.

Besoin d'un exemple ? Cliquez ici pour voir à quoi ressemble un fichier de données de ventes ou bien téléchargez un fichier échantillon.

Champs obligatoires

Champ
 Requis
 Type
 Exemple
 Description
item
 Oui
 Chaîne
 BOOK0012
  • L'Identifiant unique utilisé dans votre boutique Web pour identifier le produit.
  • L'Identifiant soumis ici doit se trouver dans votre base de données produit Emarsys.
  • Pour les commandes comprenant des produits multiples, chaque produit (appelé article de ligne) doit être soumis dans une ligne séparée avec le même identifiant de commande.
prix
 Oui
 Lancement
 110.30
  • Le prix total des articles (le prix unitaire multiplié par la quantité) dans la devise définie dans la section Détails du compte de votre Page Sources de données.
  • Utilisez toujours le point (.) comme marque décimale (c'est-à-dire 10.5, et non 10,5).
  • N'utilisez AUCUN séparateur de milliers (c'est-à-dire 2000, et non 2,000).
  • N'incluez PAS la devise.
  • Pour les remboursements, soumettez toujours une valeur négative.
commande
 Oui
 Chaîne
 111-U8
  • L'identifiant unique de la commande.
  • Pour les commandes comprenant de multiples produits, utilisez le même identifiant de commande pour chaque article de ligne.
horodatage
 Oui
 Horodatage
 2016-06-06T14:02:00Z
  • La date (et éventuellement l'heure) de la transaction (sur le fuseau horaire UTC).
  • Si vous ne soumettez que la date (par exemple 06-06-2016) nous ajoutons automatiquement l'horaire 00:00:00.
client
 Oui (email ou bien customer est obligatoire. N'utilisez pas les deux !)
 Chaîne
 12343-14B
  • L'identifiant unique anonyme du client qui passe commande.
  • L'Identifiant soumis ici doit se trouver dans votre base de données de contact Emarsys.
email
 Oui (email ou bien customer est obligatoire. N'utilisez pas les deux !)
 Email
 sportscar_fanatic@gmail.com
  • L'adresse email du client qui passe commande.
  • Pour des raisons de confidentialité, Emarsys conserve les adresses email que vous indiquez dans votre fichier de données de ventes cryptées de telle manière que l'adresse email originelle ne peut pas être restaurée.
quantité
 Oui
 Lancement
 5
  • Quantité (nombre) d'article(s) achetés.
  • Utilisez toujours le point (.) comme marque décimale.
  • N'utilisez AUCUN séparateur de milliers.
  • Pour les remboursements, soumettez toujours une valeur négative.

Important: Assurez-vous d'utiliser soit customer soit email pour l'identification d'utilisateur de manière systématique dans tous vos fichiers de données de ventes et de ne pas les mélanger.

Champs personnalisés

En plus des champs de données de vente, vous pouvez aussi ajouter d'autres informations à votre fichier de données de ventes en utilisant des champs personnalisés. Les noms des champs personnalisés doivent commencer par un préfixe qui spécifie le type de données. Le préfixe doit être suivi par un soulignement (_) et le nom de la colonne personnalisée.

Préfixes de champ personnalisé disponibles :

Préfixe
 Type Exemple
i_*
 Nombre entier i_âge_client
f_*
 Lancement f_taille_client
t_*
 Horodatage t_date_de_fabrication
s_*
 Chaîne s_auteur_du livre
  • Les champs personnalisés sont validés pour un type de données et si les valeurs indiquées ne sont pas cohérentes avec le type de données attendu le fichier de données de ventes sera rejeté.
  • Les champs personnalisés peuvent être vides.

Exemple de données de vente

L'exemple suivant montre des commandes pour un magasin de chaussures avec trois colonnes sur mesure :

item,price,order,timestamp,customer,quantity,s_color,f_size,t_published 103-nike-1,24.95,112343,2016-06-06T14:02:00Z,093275854,1,blue,14.5,2016-09-20T15:00:00Z 105-adidas-66,99.95,112343,2016-06-06,493027334,3,black,14.5,2016-09-20T15:00:00Z 107-nike-24,50.99,66234,2016-06-06T17:00:00Z,672985375,1,pink,13.5,2016-08-01