Il est essentiel de maintenir la cohérence de vos données produits entre Emarsys et votre boutique en ligne pour vous assurer que le contenu de vos messages et leurs recommandations correspondent à ce qui est effectivement disponible en ligne.
Veuillez lire cet article avant de configurer votre planning de synchronisation des données régulier, et vous assurer que votre fichier de données produits est formaté selon les spécifications et lignes directrices décrites ci-dessous.
Important: Votre fichier de données produits 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 les produits restent en dehors du fichier ils ne seront plus disponibles dans la base de données produits Emarsys.
Avant de commencer
Qu'est-ce que les données produits ?
Les données produits sont toutes les informations sur tous les produits que vous vendez, et avez jamais vendus, sur votre site web. Elles sont d'habitude conservées dans un fichier (aussi appelé catalogue produit) sur un serveur hébergé par vous et synchronisé quotidiennement avec Emarsys.
Votre fichier de données produits peut être suivi et modifié sur la page Gestion > Sources de données Predict > Données produits.
Voici comment les éléments d'une page produit seraient convertis en champs de données produits Emarsys.
Pourquoi les données produits sont-elles importantes ?
Vos données produits sont nécessaires à la plupart des produits et fonctionnalités Emarsys, y-compris Predict et Smart Insight.
Des données produits précises vous permettent de cibler des segments de clientèle spécifiques en fonction des produits qu'ils ont achetés, consultés ou laissés dans leurs paniers, ou bien de leur envoyer des recommandations de produit dynamique et sur mesure.
Combien d'énergie cela doit-il me prendre ?
Cela dépend du format de fichier de données produits que vous allez utiliser. Nous prenons en charge deux formats :
- Le format CSV Emarsys
- Google Product Feed (GPF)
Si vous utilisez les format CSV Emarsys vous devrez générer un fichier de sortie conforme à nos spécifications, telles que 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 des données mettra jusqu'à quelques heures pour livrer ce fichier. Ensuite, si votre moteur de validation détecte des problèmes, vous devrez d'abord les régler, ce qui peut prendre encore quelques heures à votre spécialiste des données.
Voici une estimation du temps dont vous pourriez avoir besoin pour configurer votre fichier de données produits :
Action | Role | Effort maximum |
---|---|---|
Générer les données produits | Spécialistes des données | Jusqu'à 6 heures |
Valider votre fichier de données produits | Spécialistes des données | 5 mins |
Réparer un fichier produit, si besoin | Spécialistes des données | Varie en fonction du nombre et de la gravité des problèmes, mais généralement pas plus de 2 heures |
Planifier des mises à jour régulières | Marketeur / Spécialistes des données | 5 mins |
Si vous avez déjà un Google Product Feed (GPF), vous pourrez peut-être sauter ces étapes puisque votre GFP est peut-être prêt à être utilisé dans Emarsys. Assurez-vous toutefois que votre GPF contienne tous les champs obligatoires. Si vous n'en êtes pas sûr, contactez simplement le Support Emarsys et nous vérifierons votre fichier.
Le format d'image WEBP n'est pas pris en charge.
Pour minimiser l'effort à investir dans l'intégration des données produits, veuillez contacter votre Success Manager à propos du programme pilote Onboarding flexible des données produits.
Qui dois-je impliquer de mon côté ?
- Si vous utilisez le format CSV Emarsys, vous aurez besoin qu'un spécialiste des données vous fournissent les données produits et, éventuellement, qu'un product owner supervise le projet.
- Si vous réutilisez votre Google Product Feed, vous n'aurez peut-être besoin que d'un lien vers votre fichier GPF, que votre spécialiste des données devrait connaître et être en mesure de vous fournir.
Que dois-je inclure dans mon fichier de données produits ?
Nous vous recommandons fortement d'inclure tous les produits ayant jamais été vendus sur votre site web, même s'ils ne sont plus disponibles (réglez simplement la valeur correspondante dans le champ available
).
Inclure les produits et catégories passés vous aidera à construire un modèle d'affinité plus précis et robuste à partir de votre comportement web, et réduira le risque que vos données produits deviennent corrompues ou incohérentes.
Les commandes contiennent aussi typiquement un certain nombre d'éléments tels que les frais et la méthode de livraison, le packaging, les cadeaux ou les promotions etc. Emarsys ne pourra pas faire la différence entre ces derniers et les produits en tant que tels dans la commande, donc assurez-vous qu'ils sont tous indiqués dans votre fichier de données produits en tant que produits indisponibles. Cela empêchera qu'il soient jamais proposés comme recommandations.
À quelle fréquence dois-je charger mes données produits ?
Nous vous conseillons de charger vos données produits au moins une fois par jour. Vous pourriez avoir intérêt à le faire plus souvent, si des champs importants tels que le prix ou la disponibilité sont susceptibles de changer dans la journée.
Règles générales pour votre fichier de données
- Votre fichier de données produits doit être un simple tableau .csv, dont chaque ligne contient tous les attributs d'un produit donné, tels que l'ID d'article, l'URL de la page produit, un lien vers une image de produit, etc.
- Tenez compte du fait que les valeurs sont sensibles à la casse. Les identifiants
Women_Dress_100
etwomen_dress_100
sont traités comme différents. - Utilisez une bibliothèque d'exportation CSV compatible avec le format CSV standard.
- Utilisez une virgule pour séparer les champs dans une ligne.
- Dans les champs contenant plusieurs valeurs, utilisez une barre verticale (|) 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 :
value1,,value3,value4
- N'utilisez pas de caractères de saut de ligne, avec ou sans guillemets, dans les champs.
- Utilisez l'encodage UTF-8.
- Incluez les noms de champ dans la première ligne (en-tête) et assurez-vous que toutes les lignes suivantes contiennent les valeurs correspondantes aux champs indiqués dans l'en-tête.
- N'utilisez pas plus de 255 colonnes.
- N'utilisez pas de valeurs de champ plus longue que 64 KO.
- Les espaces vides redondants (au début et à la fin) sont automatiquement coupés sauf s'ils sont entre guillemets (par ex. 1, 2, 3 est pareil à 1,2,3).
- Bien que votre fichier de données produits contienne normalement des informations accessible au public sur votre site web, vous pourriez avoir intérêt à ajouter un niveau de sécurité en les protégeant par un mot de passe. Emarsys prend complètement en charge le chargement de fichiers de données produits via une connexion sécurisée par mot de passe, selon votre localisation.
Besoin d'un exemple ? Cliquez ici pour voir à quoi ressemble un fichier de données produits au format CSV Emarsys ou bien téléchargez un fichier exemple.
Taille du fichier
- Si votre fichier de données produits contient plus d'un million d'articles, veuillez contacter le Support Emarsys avant de l'importer.
- Vous pouvez charger des fichiers de données produits compressés en gzip vers Emarsys. Si votre fichier atteint plusieurs centaines de megaoctets, vous aurez peut-être intérêt à le compresser.
Catégories de produit
Dans le champ catégorie, vous soumettez le chemin de catégorie de produit de vos articles en fonction du système de classement des produits de votre boutique en ligne.
Veuillez faire particulièrement attention à la cohérence des catégories de produit dans votre web shop et votre fichier de données produits.
Une cause fréquente d'erreurs (et donc de délais) au moment de l'onboarding des données produits est que le fichier de données produits ne comprend pas les catégories de la même manière que la commande catégorie.
Un chemin de catégorie décrit l'emplacement de chaque produit dans la hiérarchie de catégorie. C'est une liste séparée par un >
de sous-catégories qui commence par la catégorie de niveau supérieur.
Par exemple, un petit magasin de vélo peut avoir la hiérarchie de catégories suivante :
Bikes Road Bikes Mountain Bikes Parts Road Tyres Chains MTB Tyres Chains
Dans cette structure Bikes
et Bikes > Road Bikes
sont des chemins de catégorie également valides, tandis que Road Bikes
en lui-même ne l'est pas, puisque ça n'est pas une catégorie de niveau supérieur.
Le chemin de catégorie pour bike1
, un super vélo de route, est Bikes > Road Bikes
, qui peut être soumis dans votre fichier de données produits comme cela :
item, title, category,... bike1, Awesome Road Bike, Bikes > Road Bikes,
Emarsys Predict prend en charge un nombre illimité de niveaux de catégorie, tandis que Smart Insight peut gérer cinq niveaux maximum. S'il y a plus de 5 niveaux, Smart Insight conserve les 5 plus hauts et ignore le reste.
Articles avec plusieurs catégories
Vous avez parfois intérêt à classer les produits dans plusieurs catégories. Par exemple, notre magasin de vélos vend pedal1
, une pédale hybride universelle qui fonctionne aussi bien sur les vélos de route que sur les vélos de montagne. Elle appartient donc à la fois à Parts > Road > Pedals
et Parts > MTB > Pedals
. Donc pedal1
appartient à une liste de catégories. Les éléments de listes doivent être séparés par une |
(barre verticale) au sein du champ category
.
item, title, category, ... pedal1, Universal Hybrid Pedal, Parts > Road > Pedals | Parts > MTB > Pedals,...
Fonctionnalité de catalogue Parent/Enfant
La fonctionnalité de catalogue Parent/Enfant vous permet de gérer la structure de produit à deux échelons et d'utiliser ces données pour les recommandations et la personnalisation.
La fonctionnalité du catalogue Parent/Enfant est actuellement en phase de release Pilote pour un nombre limité de clients. Si une participation à la phase pilote vous intéresse, veuillez vous adresser à votre Client Success Manager.
Champs de données produits standard
Champ | Requis | Type | Exemple | Description |
---|---|---|---|---|
item | Oui | String | BOOK0012 | - L'identifiant unique utilisé dans votre boutique en ligne pour identifier le produit. |
- N'incluez pas de variants de produit au niveau du SKU dans le fichier de données produits. 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. | ||||
title | Oui | String | Le guide des auto-stoppeurs | - Le nom du produit. |
- N'incluez aucun teste promotionnel. | ||||
link | Oui | URL | http://www.buy.me/hitch/ | - L'URL de la page produit des articles. |
- Commencez par le protocole, tel que http ou https. | ||||
- N'encodez pas l'URL. Remarque : Veuillez n'utiliser que des caractères ASCII pour éviter les problèmes de compatibilité avec les appareils iOS. | ||||
image | Non | URL | http://www.buy.me/hitch_thumb.jpg | - L'URL de l'image produit. |
- Commencez par le protocole, tel que http ou https. | ||||
- Notre recommandation de bonne pratique est d'utiliser une image d'une largeur de 800-pixels pour vous assurer qu'elle s'affiche correctement en toutes circonstances. | ||||
- N'utilisez pas d'images plus grandes qu' 1 MO ou 1280 x 1280 px. | ||||
- Pour les images produit en haute résolution, utilisez le champ zoom_image . | ||||
- Si vous n'avez que des images produit en haute résolution, nous pouvons créer les vignettes pour vous automatiquement. En savoir plus. | ||||
- Le format d'image WEBP n'est pas pris en charge. | ||||
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. | ||||
- Le format d'image WEBP n'est pas pris en charge. | ||||
category* | 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 donné appartient. |
available | Non | Booléen | true | - La disponibilité actuelle des produits dans votre magasin. |
- Utilisez soit les minuscules (true ) soit les majuscules (TRUE ). | ||||
- Veillez à mettre ce champ à jour régulièrement. | ||||
- Si possible, incluez tous les articles que vous ayez jamais proposés sur votre site web. Cela améliorera l'analyse des données historiques et rendra possible à Emarsys de recommander des alternatives possibles aux articles retirés de la vente. | ||||
- Soumettez les produits actuellement indisponible en tant que false . | ||||
description | Non | String | Le roman pionnier de Douglas Adams. | Une brève description du produit. |
price | Non | Float | 13.99 | - Le prix de produit actuel que vous affichez à vos clients dans votre boutique en ligne. |
- N'incluez pas la devise. | ||||
- Utilisez toujours le point (.) comme marqueur décimal. | ||||
msrp | Non | Float | 17.99 | - Le prix originel du produit (c'est-à-dire le prix avant réductions). |
- msrp doit être plus élevé que price . Si msrp est égal ou inférieur, il n'apparaîtra pas dans les recommandations email. | ||||
- N'incluez pas la devise. | ||||
- Utilisez toujours le point (.) comme marqueur décimal. | ||||
brand* | Non | String | Nike | - Le(s) nom(s) de la marque du produit. |
* Dans ce champ, vous pouvez utiliser plusieurs valeurs.
Champs Loyalty
L'add-on Loyalty permet de gérer les campagnes de fidélité pour améliorer la fidélisation client et la valeur du cycle de vie client. Pour plus d'informations, voir Emarsys Loyalty - Aperçu et Implémenter Loyalty.
Les champs suivants sont obligatoires pour prendre complètement en charge la promotion du catalogue :
Champ | Requis | Type | Exemple | Description |
---|---|---|---|---|
Brand | Oui | String | Calvin Klein | La marque de l'article |
Category | Oui | String | Shirts | La catégorie de l'article. Un article peut être dans plus d'une catégorie. Dans le cas de catégories multiples, séparez les catégories à l'aide du délimiteur barre verticale (| ). |
Autres champs prédéfinis
Champ | Requis | Type | Exemple | Description |
---|---|---|---|---|
album* | Non | String | Let it be | Le titre de l'album ou des albums sur le(s)quel(s) le produit a été commercialisé. |
actor* | Non | String | Brad Pitt | L'acteur ou les acteurs associé(s) au produit. |
artist* | Non | String | Janis Joplin | L'artiste ou les artistes associé(s) au produit. |
author* | Non | String | Douglas Adams | L'auteur ou les auteurs associé(s) au produit. |
year | Non | Entier | 1984 | L'année de publication du produit. |
* Dans ces champs, vous pouvez utiliser plusieurs valeurs.
Champs personnalisés
En plus des champs de donnés produits standard et prédéfinis, vous pouvez aussi ajouter d'autres informations de produit à votre fichier de données en utilisant les champs personnalisés. Les noms de champs personnalisés doivent commencer par le préfixe c_*
(par ex. c_color
ou c_size
).
Au moment de décider des champs personnalisés, réfléchissez au type de segmentation dont vous souhaiteriez disposer dans votre compte Emarsys, puis identifiez à partir de là les champs dont vous avez besoin pour atteindre ces objectifs.
Ceci s'applique particulièrement si vous utilisez Smart Insight, puisque ces champs vous permettront de créer des segments sur la base des attributs de produit.
Assurez-vous de n'inclure aucun des noms de champ prédéfinis dans aucune partie des noms des champs personnalisés ou facultatifs. Par exemple, un nom de champ personnalisé à éviter est c_available_colors
puisque available
est un champ standard.
Si des noms de champ facultatif commencent par un nom de champ prédéfini plutôt que le préfixe c_*
, ils seront alors ajoutés en tant que champs localisés à votre fichier de données produits.
Les champs personnalisés ne sont pas validés par Emarsys.
Localisation de champ
Si vous tenez une boutique en ligne sur plusieurs marchés ou en plusieurs langues, il peut être nécessaire d'inclure aussi les versions localisées des champs de données produits standard dans votre fichier de données produits. Nommez vos champs localisés en utilisant le schéma [field name]_[language identifier]
, c'est-à-dire que le nom du champ de données produits 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 produits standard et prédéfinis peuvent être localisés, à l'exception de item
.
Pour en savoir plus sur la localisation, regardez notre article sur les Sites web localisés.
Désambiguïsation
Puisque plusieurs attributs de produit, tels que les catégories, les auteurs et les acteurs, peuvent être utilisés pour construire des modèles statistiques, il est important de les utiliser canoniquement. Par exemple, l'auteur J. K. Rowling doit toujours être épelé exactement de la même manière dans le fichier de données produits. Quand il y a plus de strings identiques représentant les différentes valeurs d'un attribut donné, ils doivent être désambiguïsés de manière cohérente, par exemple J. Doe
et J. Doe(2)
.
Optimiser les images de données produits
La fonction optimisation d'image sur la page Données produits assure que l'image de données produits GPF que vous avez chargée soit automatiquement ajustée aux paramètres de taille recommandés. Pour plus d'informations, voir Optimiser la taille d'image de données produits du GPF.
La fonction d'optimisation d'image peut distordre votre image.
Vous pouvez désactiver la fonction d'optimisation d'image. Néanmoins la désactiver peut empêcher les grandes images d'apparaître. Vous pouvez aussi réduire la taille de l'image en Redimensionnant les images avec le proxy d'image Emarsys.
Redimensionner les images avec le proxy d'image Emarsys.
Certaines apps Emarsys, telles que les recommandations de produit, fonctionnent correctement avec de plus petites images. Si vous n'avez que des images produit en haute résolution, Emarsys peut créer leurs versions vignettes pour vous automatiquement. Pour utiliser ce service de redimensionnement d'image automatique, remplacez simplement l'URL d'image par le schémas d'URL suivant dans le champ image
:
https://imgfly.scarabresearch.com/w_<thumbnail image width in pixels>/<image URL>
Assurez-vous de faire 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 d'une largeur de 800-pixels pour vous assurer qu'elle s'affiche correctement en toutes circonstances.
Exemples
Voici à quoi ressemble un fichier de données produits au format CSV Emarsys. Cliquez ici pour télécharger un fichier exemple.
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
Le fichier ci-dessous sans espaces vides :
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 considère les deux fichiers exactement de la même manière que les espaces vides redondants et que les guillemets redondants sont ignorés. Notez aussi que les valeurs contenant le caractère séparateur doivent être mises entre double-guillemets (par ex. "Foo, Bar"
).