Conserver la cohérence de vos données de produit entre Emarsys et votre boutique en ligne est essentiel pour s'assurer que le contenu de vos messages et leurs recommandations correspond à ce qui est effectivement disponible en ligne.
Veuillez lire cet article avant de configurer votre calendrier de synchronisation régulière des données, et vous assurer que votre fichier de données produit ets formaté selon les spécifications et lignes directrices décrites ci-dessous.
Important: Votre fichier de données produit remplace toujours le catalogue produit entier à chaque fois qu'il est importé. Toutes les données sont écrasées, plutôt que mises à jour, et si des produits manquent au fichier, ils ne seront plus disponibles dans la base de données produit Emarsys.
Avant de commencer
Qu'est-ce que les données produit ?
Les données de produit sont toutes les informations sur les produits que vous vendez et avez jamais vendus sur votre sites Web. Elles sont d'ordinaire conservées dans un fichier (le catalogue produit), sur un serveur que vous hébergez, et synchronisées quotidiennement avec Emarsys.
Votre fichier de données produit peut être suivi et modifié sur la page Gestion > Sources de données Predict > Page Données de produit.
C'est ainsi que les éléments d'une page produit seraient convertis en champs de données produit Emarsys.
Pourquoi les données produit sont-elles importantes ?
La plupart des produits et fonctionnalités Emarsys ont besoin de vos données de produit, y compris Predict et Smart Insight.
Des données de produit exactes vous permettent de cibler des segments client spécifiques sur la base des produits qu'ils ont achetés, vus ou laissés dans leur panier, ou de leur envoyer des recommandations de produit dynamiques sur mesure.
Combien d'effort dois-je investir là-dedans ?
Cela dépend du format de fichier de données produit que vous utiliserez. Nous supportons deux formats :
- Le format Emarsys CSV
- Google Product Feed (GPF)
Si vous utilisez le format Emarsys CSV, vous devrez générez un fichier sortant conforme à nos spécifications, décrites ci-dessous et dans nos lignes directrices CSV. En fonction de la taille et de la complexité de votre catalogue produit, votre spécialiste données peut mettre jusqu'à quelques heures pour livrer ce fichier. Ensuite, si notre moteur de validation détecte des problèmes, vous devrez d'abord les résoudre, ce qui peut prendre encore une ou deux heures du temps de votre spécialiste données.
Voici une estimation du temps dont vous pourriez avoir besoin pour configurer votre fichier de données produit :
Action | Rôle | Effort max |
---|---|---|
Générer les données produit | Spécialiste des données | Jusqu'à 6 heures |
Valider votre fichier de données produit | Spécialiste des données | 5 mins |
Réparer le fichier de produit, si nécessaire | Spécialiste des données | Dépend du nombre et de la gravité des problèmes, mais d'ordinaire pas plus de 2 heures |
Programmer des mises à jour régulières | Marketeur/Spécialiste des données | 5 mins |
Si vous avez déjà un Flux de Produit Google (GPF), vous pouvez sans doute vous passer de ces étapes car votre GFP pourrait être utilisable tel quel dans Emarsys. Assurez-vous toutefois que votre GPF contient tous les champs obligatoires. Si vous avez un doute, contactez sans hésiter le Support Emarsys et nous vérifierons votre fichier.
Pour minimiser l'effort à investir dans l'intégration des données produits, veuillez contacter votre Success Manager à propos du programme pilote Onboarding des données produits flexible.
Qui ai-je besoin d'impliquer de mon côté ?
- Si vous utilisez le format Emarsys CSV, vous aurez besoin d'un spécialiste des données pour fournir les données produit et, éventuellement, d'un propriétaire de produit pour superviser le projet.
- Si vous réutilisez votre Flux de Produit Google, tout ce dont vous aurez sans doute besoin est votre fichier GPF, que votre spécialistes des données doit bien connaître et être en mesure de vous fournir.
Que dois-je inclure dans mon fichier de données produit ?
Nous vous conseillons fortement d'inclure tous les produits jamais vendus sur votre site Web, même s'ils ne sont plus disponibles (configurez simplement la valeur correspondante dans le champ available
).
Inclure les produits et les catégories passés aidera à construire un modèle d'affinité plus exact et robuste à partir de votre comportement Web, et réduira le risque que vos données de produit deviennent corrompues ou incohérentes.
Les commandes contiennent aussi typiquement un certain nombre d'articles de service, tels que les coûts et la méthode de livraison, l'emballage, des cadeaux gratuits ou des réductions, etc. Emarsys ne pourra distinguer entre ceux-ci et les produits effectifs dans la commande, donc vous devez vous assurer qu'ils sont tous listés dans votre fichier de données produit en tant que produits indisponibles. Ceci empêchera qu'ils soient jamais proposés comme recommandations.
A quelle fréquence dois-je téléverser les données de produit ?
Nous vous conseillons de téléverser vos données de produit au moins une fois par jour. Vous devriez envisager de le faire plus fréquemment si des champs importants tels que le prix ou la disponibilité sont susceptibles de changer pendant la journée.
Règles générales pour votre fichier de données
- Votre fichier de données produit doit être un simple tableur .csv, chaque rangée contenant toutes les caractéristiques d'un produit donné, telles que l'ID d'article, l'URL de la page du produit, un lien vers une image du produit, etc.
- Prenez en compte que les valeurs sont sensibles à la casse. Les identifiants
Women_Dress_100
etwomen_dress_100
sont considérés comme particuliers. - 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.
- Dans les champs contenant des valeurs multiples, utilisez une tubulure (|) pour séparer les valeurs. Exemple
,John Lennon|Paul McCartney|George Harrison|Ringo Starr,...
- Quand un champ n'a aucune valeur, laissez-le vide. Exemple :
valeur1,,valeur3,valeur4
- 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.
- N'utilisez pas plus de 255 colonnes.
- N'utilisez pas de valeurs de champ plus longues que 64 KB.
- 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).
- Bien que les informations contenues dans votre fichier de données produit soient normalement accessibles publiquement sur votre site Web, il est préférable d'ajouter un niveau de sécurité en les protégeant par mot de passe. Emarsys soutien complètement le téléversement de fichiers de données produit protégés par mot de passe via une connexion sécurisée.
Besoin d'un exemple ? Cliquez ici pour voir à quoi ressemble un fichier de données produit au format CSV Emarsys ou bien télécharger un fichier échantillon.
Taille du fichier
- Si votre fichier de données produit contient plus d'un million d'articles, veuillez contacter le Support Emarsys avant de l'importer.
- Vous pouvez téléverser des fichiers de données produit compressés gzip vers Emarsys. Si la taille de votre fichier atteint les centaines de mégaoctets, vous devriez envisager de le compresser.
Catégories de produit
Dans le champ catégorie, vous soumettez le chemin de catégorie de produit de vos articles selon le système de catégorisation de produit de votre boutique en ligne.
Veuillez être particulièrement attentif à la cohérence des catégories de produit dans votre boutique en ligne et votre fichier de données produit.
Une cause fréquente d'erreurs (et par conséquent de retards) au moment de l'intégration des données produit est que le fichier de données produit ne comprend pas les catégories de la même manière que la commande catégorie du script de collecte de données Web Extend.
Un chemin de catégorie décrit la localisation de chaque produit dans la hiérarchie de catégorie. C'est une>
-liste déparée de sous-catégories qui commencent avec la catégorie de top niveau.
Par exemple, une boutique de petites bicyclettes pourrait avoir la hiérarchie de catégorie suivante :
Bikes Road Bikes Mountain Bikes Parts Road Tyres Chains MTB Tyres Chains
Dans cette structure, Vélos
et Vélos > Vélos de route
sont deux chemins de catégorie valides, tandis que Vélos de route
en lui-même ne l'est pas, puisque ce n'est pas une catégorie de top niveau.
Le chemin de catégorie pour vélo1
, un magnifique vélo de route, est Vélos > Vélos de route
, qui peut être soumis dans votre fichier de données produit comme ceci :
item, title, category,... bike1, Awesome Road Bike, Bikes > Road Bikes,
Emarsys Predict supporte un nombre illimité de niveaux de catégorie, tandis que Smart Insight peut en gérer un maximum de cinq. S'il y a plus de 5 niveaux, Smart Insight conserve le top 5 et ignore le reste.
Articles avec catégories multiples
Vous pouvez parfois avoir envie de classer des produits dans des catégories multiples. Par exemple, notre boutique de vélos vend pedal1
, une pédale hybride universelle, qui fonctionne aussi bien sur les vélos de route que les vélos de montagne. En tant que tel, elle appartient à la fois à Pièces > Route > Pédales
et à Pièces > MTB > Pédales
, donc pedal1
appartient à une liste de catégories. Les éléments de listes doivent être séparés par une |
(tubulure) à l'intérieur d'un champ de catégorie
.
item, title, category, ... pedal1, Universal Hybrid Pedal, Parts > Road > Pedals | Parts > MTB > Pedals,...
Champs de données produit standards
Champ | Requis | Type | Exemple | Description |
---|---|---|---|---|
item | Oui | Chaîne | BOOK0012 | - L'Identifiant unique utilisé dans votre boutique Web pour identifier le produit. |
- N'incluez pas de variantes de produit de niveau SKU dans le fichier de données produit. Une bonne règle générale est de considérer qu'un article est unique s'il a une URL unique dans votre boutique en ligne. | ||||
- N'incluez pas de points-virgules (; ) dans ce champ, car ils ne sont pas pris en charge. | ||||
titre | Oui | Chaîne | Le guide de l'auto-stoppeur' | - Le nom du produit. |
- N'incluez aucun texte promotionnel. | ||||
lien | Oui | URL | http://www.buy.me/hitch/ | - L'URL de la page produit de l'article. |
- Commencez par le protocole, tel que http ou https. | ||||
- Ne cryptez pas l'URL. Note : Veuillez n'utiliser que ces caractères ASCII pour éviter des problèmes de compatibilité avec les appareils iOS. | ||||
image | Non | URL | http://www.buy.me/hitch_thumb.jpg | - L'URL pour l'image du produit. |
- Commencez par le protocole, tel que http ou https. | ||||
- Notre recommandation de bonne pratique est d'utiliser une image de largeur 800-pixel pour vous assurer de sa bonne apparence sur tous les écrans. | ||||
- N'utilisez pas d'images plus grosses que 1 Mo ou 1280 x 1280 px. | ||||
- Pour des images de produit en haute résolution, utilisez le champ zoom_image . | ||||
- Si vous n'avez que des images de produit en haute résolution, nous pouvons créer des vignettes pour vous automatiquement. En savoir plus. | ||||
zoom_image | Non | URL | http://www.buy.me/hitch_fullres.jpg | - L'URL de l'image produit en haute résolution. |
- Commencez par le protocole, tel que http ou https. | ||||
categorie* | Non | Cliquez ici pour les détails | Fiction > Sci-Fi | Littérature anglaise > Sci-Fi | La liste des chemins de catégorie auxquels l'article en question appartient. |
disponible | Non | Booléen | vrai | - La disponibilité actuelle du produit dans votre boutique. |
- Utilisez soit des minuscules (true ) ou des majuscules (TRUE ). | ||||
- Assurez-vous de maintenir ce champ à jour. | ||||
- Si possible, intégrez tous les articles que vous avez jamais offert sur votre site Web. Cela améliorera l'analyse des données historiques et permet de recommander des alternatives possibles aux articles retirés de la vente. | ||||
- Soumettez les produits actuellement non disponibles comme false . | ||||
description | Non | Chaîne | L'oeuvre de fiction séminale de Douglas Adams. | Une brève description du produit. |
prix | Non | Lancement | 13.99 | - Le prix du produit actuel que vous affichez à vos clients dans votre boutique Web. |
- N'incluez pas la devise. | ||||
- Utilisez toujours le point (.) comme marque décimale. | ||||
msrp | Non | Lancement | 17.99 | - Le prix originel du produit (c'est-à-dire le prix avant réductions). |
- msrp doit être supérieur à price . Si msrp est inférieur ou égal, il n'apparaîtra pas dans les recommandations par email. | ||||
- N'incluez pas la devise. | ||||
- Utilisez toujours le point (.) comme marque décimale. |
* Dans ce champ, vous pouvez utiliser des valeurs multiples.
Autres champs prédéfinis
Champ | Requis | Type | Exemple | Description |
---|---|---|---|---|
album* | Non | Chaîne | Let it be | Le titre de(s) album(s) sur lequel le produit a été lancé. |
acteur* | Non | Chaîne | Brad Pitt | Le(s) acteur(s) associé(s) au produit. |
artiste* | Non | Chaîne | Janis Joplin | Le(s) artiste(s) associé(s) au produit. |
auteur* | Non | Chaîne | Douglas Adams | Le(s) auteur(s) associé(s) au produit. |
marque* | Non | Chaîne | Nike | - Le(s) nom(s) de marque du produit. |
année | Non | Nombre entier | 1984 | L'année de publication du produit. |
* Dans ces champs, vous pouvez utiliser des valeurs multiples.
Champs personnalisés
En plus des champs de données produit prédéfinis et standards, vous pouvez aussi ajouter d'autres informations de produit à votre fichier de données en utilisant des champs personnalisés. Les noms de champs personnalisés doivent commencer par le préfixe c_*
(par exemple c_color
ou c_size
).
Lorsque vous décidez des champs personnalisés, pensez à la sorte de segmentation que vous voulez rendre disponible dans votre compte Emarsys, puis faites le chemin inverse pour identifier les champs dont vous avez besoin afin d'atteindre ces objectifs.
C'est particulièrement pertinent si vous utilisez Smart Insight, car ces champs vous permettront de créer des segments basés sur ces caractéristiques de produit.
Assurez-vous de n'inclure aucun des noms de champs prédéfinis dans aucune partie des noms de champs personnalisés. Un nom de champ personnalisé à éviter par excellence serait c_couleurs_disponibles puisque disponible est un champ standard.
Les champs personnalisés ne sont pas validés par Emarsys.
Localisation de champ
Si vous tenez une boutique Web sur des marchés ou dans des langues multiples, il peut être nécessaire d'intégrer aussi les versions localisées des champs de données produit standards à votre fichier de données produit. Nommez vos champs localisés en utilisant le pattern [field name]_[language identifier]
, c'est-à-dire que le nom du champ de donnée produit standard doit être suivi par un soulignement et l'identifiant de langue (par exemple, title_it
pour le titre italien d'un livre).
Tous les champs de données produit standards et prédéfinis peuvent être localisés, à l'exception de l'article
.
Pour en savoir plus sur la localisation, consultez notre article sur les Sites Web localisés.
Désambiguïsation
Puisque plusieurs caractéristiques produit, telles que les catégories, les auteurs et les acteurs peuvent être utilisés dans la construction de modèles statistiques, il est important d'utiliser pour eux la référence canonique. Par exemple, l'auteur J. K. Rowling doit toujours être épelé de la même exacte manière dans le champ de données produit. Lorsqu'il y a plus de chaînes identiques représentant des valeurs différentes d'une caractéristiques donnée, l'ambiguïté doit être levée de manière cohérente, par exemple J. Doe
et J. Doe(2)
.
Redimensionner les images avec le proxy d'image Emarsys
Certaines applis Emarsys, telles que recommandations de produit, fonctionnent correctement avec des images plus petites. Si vous n'avez que des images de produit en haute résolution, Emarsys peut créer leurs versions vignettes pour vous. Pour utiliser le service de redimensionnement d'image automatique, remplacez simplement l'URL d'image par le pattern d'URL suivant dans le champ image
:
https://imgfly.scarabresearch.com/w_<thumbnail image width in pixels>/<image URL>
Assurez-vous de commencer l'URL de l'image originelle par le protocole, qui peut être soit http
soit https
, et d'utiliser la syntaxe d'URL standard.
Notre recommandation de bonne pratique est d'utiliser une image de largeur 800-pixel pour vous assurer de sa bonne apparence sur tous les écrans.
Exemples
Voici à quoi ressemble un fichier de données produit au format CSV Emarsys. Cliquez ici pour télécharger un fichier échantillon.
item,link,title,image,category,price,msrp,available,brand,description,zoom_image 103,http://www.lifestylelabels.com/steven-by-steve-madden-pryme-pump.html,"elegant red pump",http://www.lifestylelabels.com/media/catalog/product/cache/1/small_image/210x/9df78eab33525d08d6e5fb8d27136e95/s/t/steven-by-steve-madden-pryme-pump.jpg,"Shoes > Pump",299,0,true,"Steve Madden","Nothing will turn his head faster than you wearing the sexy Pryme pump from Steven by Steve Madden. This daring pump has a pretty patent leather upper with light shirring, a double stitch detail surrounding the collar, and a vampy almond shaped toe.",http://www.lifestylelabels.com/media/catalog/product/s/t/steven-by-steve-madden-pryme-pump.jpg 108,http://www.lifestylelabels.com/nine-west-women-s-lucero-pump.html,"glittering red pump",http://www.lifestylelabels.com/media/catalog/product/cache/1/small_image/210x/9df78eab33525d08d6e5fb8d27136e95/n/i/nine-west-women-s-lucero-pump.jpg,"Shoes > Pump",289.99,0,true,"Nine West","The Lucero pump from Nine West may just leave him at a loss for words. This flirty pump has a leather upper, a pretty almond-shaped toe with a slight V-cut vamp, leather linings, and a cushioned insole for long-wearing comfort.",http://www.lifestylelabels.com/media/catalog/product/n/i/nine-west-women-s-lucero-pump.jpg 112,http://www.lifestylelabels.com/womens-golf-shoes.html,"womens golf shoes",http://www.lifestylelabels.com/media/catalog/product/e/c/ecco-womens-golf-flexor-golf-shoe.jpg,"For Women > Shoes > Golf",159,0,false,"Ecco","Sporting with style, this is a durable and super-comfortable golf shoe built for performance.",http://www.lifestylelabels.com/media/catalog/product/e/c/ecco-womens-golf-flexor-golf-shoe.jpg
L'espace ci-dessus sans espaces blancs :
item,link,title,image,category,price,msrp,available,brand,description,zoom_image 103,http://www.lifestylelabels.com/steven-by-steve-madden-pryme-pump.html,"elegant red pump",http://www.lifestylelabels.com/media/catalog/product/cache/1/small_image/210x/9df78eab33525d08d6e5fb8d27136e95/s/t/steven-by-steve-madden-pryme-pump.jpg,"Shoes>Pump",299,0,true,"Steve Madden","Nothing will turn his head faster than you wearing the sexy Pryme pump from Steven by Steve Madden. This daring pump has a pretty patent leather upper with light shirring, a double stitch detail surrounding the collar, and a vampy almond shaped toe.",http://www.lifestylelabels.com/media/catalog/product/s/t/steven-by-steve-madden-pryme-pump.jpg 108,http://www.lifestylelabels.com/nine-west-women-s-lucero-pump.html,"glittering red pump",http://www.lifestylelabels.com/media/catalog/product/cache/1/small_image/210x/9df78eab33525d08d6e5fb8d27136e95/n/i/nine-west-women-s-lucero-pump.jpg,"Shoes>Pump",289.99,0,true,"Nine West","The Lucero pump from Nine West may just leave him at a loss for words. This flirty pump has a leather upper, a pretty almond-shaped toe with a slight V-cut vamp, leather linings, and a cushioned insole for long-wearing comfort.",http://www.lifestylelabels.com/media/catalog/product/n/i/nine-west-women-s-lucero-pump.jpg 112,http://www.lifestylelabels.com/womens-golf-shoes.html,"womens golf shoes",http://www.lifestylelabels.com/media/catalog/product/e/c/ecco-womens-golf-flexor-golf-shoe.jpg,"For Women>Shoes>Golf",159,0,false,"Ecco","Sporting with style, this is a durable and super-comfortable golf shoe built for performance.",http://www.lifestylelabels.com/media/catalog/product/e/c/ecco-womens-golf-flexor-golf-shoe.jpg
Notez qu'Emarsys traite les deux fichiers exactement de la même manière, les espaces vides et les guillemets redondants étant ignorés. Notez aussi que les valeurs contenant le caractère de séparation doivent être entre guillemets (par exemple "Foo, Bar"
).