Flux XML
Nous vous recommandons l'utilisation de flux XML pour partager les données du catalogue produits avec Bazaarvoice, car le XML est suffisamment flexible pour pouvoir inclure autant d'attributs personnalisés que vous le souhaitez, tout en étant suffisamment structuré pour fournir des approches efficaces de modification et de dépannage.
Créer un flux XML de catalogue produits
Si vous décidez de fournir votre catalogue à Bazaarvoice dans un flux XML, ce que nous recommandons, il est essentiel que le flux des produits soit correctement structuré pour garantir le succès de cette opération. L'exemple suivant illustre la structure générale d'un flux de produits XML simplifié :
<?xml version="1.0" encoding="UTF-8"?> <Feed> <Brands> <Brand>...</Brand> ... </Brands> <Categories> <Category>...</Category> ... </Categories> <Products> <Product>...</Product> ... </Products> </Feed>
Veuillez suivre les étapes ci-dessous de cette section pour créer un flux XML et l'importer sur Bazaarvoice.
Étapes de démarrage rapide
Cette section présente les étapes pour commencer rapidement à créer votre flux de produits. Reportez-vous aux autres sections de cette rubrique pour en savoir plus sur la création et la validation du flux de produits.
-
Créez ou actualisez le flux de produits XML tel que décrit dans le schéma XML
. Vous pouvez utiliser le Product Feed Generator (Générateur de flux de produits) pour vous y aider.Chaque produit du flux doit inclure les propriétés suivantes :
- Brand
- ID du produit
- Nom du produit
- URL du produit
- URL de l'image
- EAN, UPC ou MPN
Remarque : l'identifiant de produit est défini dans la balisedivoù l'attribut data-bv-show apparaît sur la page de votre produit. Si votre implémentation actuelle utilise le fichier scout (bvapi.js), vous pouvez définir l'identifiant de produit dans l'appel de configuration$BV.uide votre page produit. Dans le flux de produits, vous devez indiquer la valeur de l'identifiant de produit dansExternalId.L'élément
ExternalIdest particulièrement important car en son absence, il est impossible de mettre les produits en correspondance dans les différentes fonctionnalités de Bazaarvoice. L'identifiant de produit est également utilisé dans le cadre des liens des formulaires de soumission (productId), dans le code d'intégration des pages de description des produits (PDP), ainsi que dans le paramètresku(UGS) lors de transactions BV Pixel.Si nécessaire, reportez-vous à cet exemple de flux XML.
- Utilisez cet outil de validation pour valider le flux XML d'après le schéma.
- Chargez le flux sur le serveur SFTP de production ou de pré-production de Bazaarvoice, dans
/import-inbox. Les flux sont ajoutés à une liste et traités quotidiennement à 2 h, heure du Centre (UTC-6 en hiver ou UTC-5 en été), puis placés dans le dossier/backup. - Vérifiez les résultats à partir de votre Workbench de serveur de production ou de pré-production.
Étape 1 : Créez un fichier XML du flux.
Générez votre flux comme vous l'entendez en fonction de votre système et de vos processus. Quelle que soit la situation, chaque flux doit être un fichier XML suivant la même structure.
Commencez à structurer votre flux de produits en vous référant à ce qui suit :
- Le générateur de flux de produits, qui vous servira de point de départ pour créer votre flux de produits ;
-
Le schéma de flux de produits XML
, qui définit la structure et le contenu du flux.Remarque : La version 14.3+ du schéma n'impose pas de contraintes en ce qui concerne la longueur ou les chiffres des UPC, des EAN et des ISBN. N’importe quelle chaîne dans l’un de ces champs est considérée comme valide par le schéma du produit. Toutefois, seules les valeurs valides dans les champs UPC, EAN and ISBN sont enregistrées lors de l'importation du catalogue. Vous trouverez la syntaxe exhaustive des identifiants uniques au niveau mondial dans ce fichier d'exemple.
Bazaarvoice vous recommande de respecter les meilleures pratiques suivantes lorsque vous créez un flux de produits :
- Vérifiez que la première ligne de votre flux correspond au format suivant :
<?xml version="1.0" encoding="utf-8"?>
- Tout caractère spécial que vous utilisez dans le flux doit correspondre au schéma standard pour l'encodage des caractères, tel que UTF-8 ou Windows-1252.
- Si vous ne disposez d'aucune valeur pour un champ particulier, omettez-le. N'incluez pas de champs vides dans votre flux.
Reportez-vous à l’exemple ci-dessous pour voir un flux XML comprenant plusieurs produits.
Étape 2 : Vérifiez les éléments et les attributs.
Vous devez utiliser les éléments et attributs appropriés pour décrire le flux, la marque, la catégorie et les informations sur le produit. Reportez-vous aux tableaux suivants pour prendre connaissance des éléments enfants et des attributs des éléments <Feed>, <Brand>, <Categories>et <Products>.
Élément du flux
Cet élément est requis. Le tableau suivant répertorie les attributs obligatoires de l'élément <Feed>.
| Attribut | Description |
|---|---|
| name | La version courte de votre nom de client Bazaarvoice. |
| extractDate | Horodatage renseigné automatiquement au format XML DateTime . |
| incremental | À savoir si le flux inclut toutes les données du catalogue. Si vous envoyez un flux de données qui contient l'intégralité de votre catalogue produits, définissez cette valeur sur false. |
| supplemental | À savoir si le flux inclut des données supplémentaires du catalogue. Ce type de flux devrait uniquement être utilisé si vous fournissez des sources de catalogue multiples. |
| xmlns | Référence du schéma. Définissez cette valeur sur http://www.bazaarvoice.com/xs/PRR/ProductFeed/15.1. |
<Feed xmlns="http://www.bazaarvoice.com/xs/PRR/ProductFeed/15.1" name="ExampleClient" incremental="false" extractDate="2016-01-18T12:00:00">
Élément <Brands>
Vous pouvez déclarer toutes les marques de produits dans l'élément <Brands> en utilisant les éléments enfants suivants :
| Élément | Valeur |
|---|---|
Brand |
Représente une marque de produit dans votre flux et doit contenir les éléments enfants suivants : Vous pouvez inclure l'attribut removed="true dans l'élément |
ExternalId |
Identifiant unique de marque qui ne peut contenir que des caractères alphanumériques, des tirets ( Assurez-vous que l'identifiant est stable et qu'il ne changera pas dans le cadre d'une même marque logique, même si le nom de la marque elle-même change. |
Name ou Names |
Nom de la marque, visible par les utilisateurs finaux.
Si vous spécifiez des noms de marques localisés dans une implémentation multilingue, incluez un élément |
Ensuite, lorsque vous définissez les produits dans l'élément <Products>, vous pouvez utiliser l'élément <BrandExternalId> pour ajouter une référence à un identifiant de marque dans l'élément <Brands>.
<Brand> dans l'élément <Product>. Vous pouvez utiliser cette méthode à la place de l'élément <Brands> comme décrit ici.<Brands> <Brand> <ExternalId>AAA</ExternalId> <Name>First Brand</Name> </Brand> <Brand> <ExternalId>BBB</ExternalId> <!-- Default brand name --> <Name>Second Brand</Name> <!-- Localized brand names --> <Names> <Name locale="en_CA">Second Brand CA</Name> <Name locale="fr_CA">Deuxième marque CA</Name> </Names> </Brand> </Brands> <Products> <Product> <Name>First Product</Name> <ExternalId>Prod-1234</ExternalId> <BrandExternalId>AAA</BrandExternalId> ... </Product> </Products>
Élément <Categories>
L'élément <Categories> définit chaque catégorie représentée par des produits dans votre flux au moyen des éléments enfants suivants. Il peut aussi servir à définir une hiérarchie de catégories. Cet élément est requis.
| Élément | Valeur | Obligatoire |
|---|---|---|
Category |
Représente une catégorie de produits dans votre flux et peut inclure d'autres éléments parmi ceux listés dans ce tableau. Vous pouvez inclure l'attribut removed="true" dans l'élément |
Oui |
ExternalId |
Identifiant unique de catégorie ou de sous-catégorie qui ne peut contenir que des caractères alphanumériques, des tirets ( Assurez-vous que l'identifiant de catégorie est stable et qu'il ne changera pas, même si le nom de la catégorie elle-même change. |
Oui |
ParentExternalId |
Identifiant de la catégorie parente de la sous-catégorie. | Non |
Name ou Names |
Nom de la catégorie ou de la sous-catégorie, visible par les utilisateurs finaux. Si vous spécifiez des catégories localisées dans une implémentation multilingue, incluez un élément |
Oui |
CategoryPageUrl ou CategoryPageUrls |
URL unique pour la catégorie ou la sous-catégorie. Lorsque vous spécifiez une URL, tenez compte des informations suivantes :
|
Seulement si le contenu Questions & Answers est recueilli au niveau de la catégorie |
ImageUrl ou ImageUrls |
URL unique de l'image de la catégorie ou de la sous-catégorie, généralement hébergée sur votre site Web ou un réseau de distribution de contenu. Lorsque vous spécifiez une URL, tenez compte des informations suivantes :
Remarque : si Ratings & Reviews est déployé sur un site HTTPS, vous devez fournir les URL des images dans un emplacement HTTPS de votre catalogue produits. En cas de non-respect de cette précaution, vos clients verront un avertissement les prévenant du mélange des contenus.
|
Seulement si le contenu Questions & Answers est recueilli au niveau de la catégorie |
<Categories>
<Category>
<ExternalId>1010</ExternalId>
<!-- Nom par défaut de la catégorie -->
<Name>First Category</Name>
<!-- Noms localisés des catégories -->
<Names>
<Name locale="en_CA">First Category CA</Name>
<Name locale="fr_CA">Première catégorie CA</Name>
</Names>
<!-- URL de la page de catégorie par défaut -->
<CategoryPageUrl>
http://www.example.com/category.htm?cat=1010
</CategoryPageUrl>
<!--URL des pages de catégorie localisées -->
<CategoryPageUrls>
<CategoryPageUrl locale="en_CA">
http://www.example.ca/en_ca/category.htm?cat=1010
</CategoryPageUrl>
<CategoryPageUrl locale="fr_CA">
http://www.example.ca/fr_ca/category.htm?prod=1010
</CategoryPageUrl>
</CategoryPageUrls>
<!-- URL de l'image de catégorie par défaut -->
<ImageUrl>http://images.example.com/catimages/1010.gif</ImageUrl>
<!-- URLs des images de catégorie localisées -->
<ImageUrls>
<ImageUrl locale="en_CA">
http://images.example.ca/en_ca/catimages/1010.gif
</ImageUrl>
<ImageUrl locale="fr_CA">
http://images.example.ca/fr_ca/catimages/1010.gif
</ImageUrl>
</ImageUrls>
</Category>
<Category>
<ExternalId>1020</ExternalId>
<Name>Second Category</Name>
<CategoryPageUrl>
http://www.example.com/category.htm?cat=1020
</CategoryPageUrl>
<ImageUrl>http://images.example.com/catimages/1020.gif</ImageUrl>
</Category>
<Category>
<ExternalId>1021</ExternalId>
<ParentExternalId>1020</ParentExternalId>
<Name>Sub Category</Name>
<CategoryPageUrl>
http://www.example.com/category.htm?cat=1021
</CategoryPageUrl>
<ImageUrl>http://images.example.com/catimages/1021.gif</ImageUrl>
</Category>
</Categories>Élément Produit
L'élément <Products> définit chaque produit de votre flux à l'aide des éléments enfants suivants. C'est un élément obligatoire. Reportez-vous au schéma du flux de produits pour une liste complète des éléments disponibles.
| Élément | Valeur | Obligatoire |
|---|---|---|
Produit |
Représente un produit dans votre flux et peut inclure d'autres éléments parmi ceux listés dans ce tableau. Vous pouvez inclure l'attribut removed="true" dans l'élément |
Oui |
ExternalId |
Identifiant unique de produit qui ne peut contenir que des caractères alphanumériques, des tirets ( Ce format est uniquement utilisé dans le flux de données et n'est pas visible par les utilisateurs finaux. |
Oui, un pour chaque produit |
Name ou Names |
Nom ou noms du produit, visibles par les utilisateurs finaux. Si vous spécifiez des noms de produit localisés dans une implémentation multilingue, incluez un élément |
Oui, un pour chaque langue |
Description ou Descriptions |
Description du produit. Bazaarvoice recommande de créer des descriptions d'au moins 3 phrases ou 300 caractères. Si vous spécifiez des noms de produit localisés dans une implémentation multilingue, incluez un élément |
Oui, un pour chaque langue |
Brand |
Nom de la marque à laquelle le produit appartient. Vous devez inclure un élément enfant <Name> pour préciser le nom de la marque.
Remarque : vous pouvez définir
<Brand> ou <BrandExternalId> dans l'élément <Product>, mais jamais les deux à la fois. |
Oui, un par produit, si <BrandExternalId> n'est pas fourni |
BrandExternalId |
Identifiant de la marque à laquelle le produit appartient. Vous devez définir cet élément si une marque est considérée comme un élément distinct dans le bloc Remarque : vous pouvez définir
<BrandExternalId> ou <Brand> dans l'élément <Product>, mais jamais les deux à la fois. |
Oui, un par produit, si <Brand> n'est pas fourni |
CategoryExternalId |
Identifiant de la catégorie ou de la sous-catégorie du produit. Vous devez définir cet élément si une marque est considérée comme un élément distinct dans le bloc Remarque : vous pouvez définir
<CategoryExternalId> ou <CategoryPath> dans l'élément <Product>, mais jamais les deux à la fois. |
Oui, un par produit |
CategoryPath |
Une liste de catégories classées par ordre hiérarchique. Chaque catégorie doit être spécifiée dans un élément enfant Remarque : vous pouvez définir
<CategoryPath> ou <CategoryExternalId> dans l'élément <Product>, mais jamais les deux à la fois. |
Recommandé, un par produit |
ProductPageUrl ou ProductPageUrls |
URL unique et non corrompue d'une page produit. N'incluez pas les paramètres de chaîne de requête supplémentaires que vous utilisez potentiellement pour le suivi et les codes de partenariat. Lorsque vous spécifiez une URL, tenez compte des informations suivantes :
|
Oui, un par langue |
ImageUrl ou ImageUrls |
URL unique de l'image du produit. La taille d'affichage optimale est de 600 x 600 pixels, mais elle peut être légèrement différente. Lorsque vous spécifiez une URL, tenez compte des informations suivantes :
Remarque : si Ratings & Reviews est déployé sur un site HTTPS, vous devez fournir les URL des images dans un emplacement HTTPS de votre catalogue produits. En cas de non-respect de cette précaution, vos clients verront un avertissement les prévenant du mélange des contenus.
|
Oui, un par langue |
ModelNumbers |
Code de référence unique que les entreprises utilisent pour identifier une pièce utilisée par une industrie particulière. Spécifiez un élément enfant <ModelNumber> pour chaque numéro de modèle à définir. Le numéro de modèle peut contenir des lettres, des chiffres et d'autres caractères. |
Non. Si inclus, un par produit |
ManufacturerPartNumbers |
Numéro de pièce spécifique au fabricant. Spécifiez un élément enfant <ManufacturerPartNumber>
pour chaque numéro de pièce à définir. Les numéros de pièce peuvent contenir des lettres, des chiffres et d'autres caractères. |
Oui. Vous pouvez indiquer un nombre illimité d'éléments enfants. |
EANs |
European Article Number (EAN), utilisé dans le monde entier pour le marquage des biens de grande consommation. Spécifiez un élément enfant Remarque : La version 14.3+ du schéma n'impose pas de contraintes en ce qui concerne la longueur ou les chiffres des UPC, des EAN et des ISBN. N’importe quelle chaîne dans l’un de ces champs est considérée comme valide par le schéma du produit. Toutefois, seules les valeurs valides dans les champs UPC, EAN and ISBN sont enregistrées lors de l'importation du catalogue. Vous trouverez la syntaxe exhaustive des identifiants uniques au niveau mondial dans ce fichier d'exemple.
|
Un élément Si inclus, vous pouvez spécifier un nombre illimité d'éléments enfants. La correspondance de syndication s'améliore si vous indiquez plusieurs valeurs. |
UPCs |
Universal Product Code (UPC). Ce code-barres de 6 ou 12 chiffres est utilisé pour le conditionnement au détail de manière standard aux États-Unis. Spécifiez un élément enfant Remarque : La version 14.3+ du schéma n'impose pas de contraintes en ce qui concerne la longueur ou les chiffres des UPC, des EAN et des ISBN. N’importe quelle chaîne dans l’un de ces champs est considérée comme valide par le schéma du produit. Toutefois, seules les valeurs valides dans les champs UPC, EAN and ISBN sont enregistrées lors de l'importation du catalogue. Vous trouverez la syntaxe exhaustive des identifiants uniques au niveau mondial dans ce fichier d'exemple.
|
Un élément Si inclus, vous pouvez spécifier un nombre illimité d'éléments enfants. La correspondance de syndication s'améliore si vous indiquez plusieurs valeurs. |
ISBNs |
International Standard Book Number (ISBN, identifiant numérique standard destiné aux livres). Valeur à 10 ou 13 caractères utilisée majoritairement pour les produits multimédia comme les livres, la musique et les vidéos. Indiquez un élément enfant <ISBN> pour chaque numéro de modèle à définir. Le dernier caractère représente une somme de contrôle qui permet de valider l'identifiant du produit. La plupart des codes ISBN sont composés uniquement de chiffres, à l'exception de certaines valeurs ISBN à 10 caractères qui utilisent un X pour la somme de contrôle. |
Un élément Si inclus, vous pouvez spécifier un nombre illimité d'éléments enfants. La correspondance de syndication s'améliore si vous indiquez plusieurs valeurs. |
Attributs |
Attributs personnalisés qui vous permettent de définir d'autres informations spécifiques aux produits, afin de de créer des rapports sur des informations spécifiques aux produits ou de prendre en charge des familles de produits. Spécifiez un élément enfant <Attribute>
pour chaque attribut de produit à définir. Veillez à inclure le nom de l'attribut de produit à l'aide de l'attribut id de l'élément <Attribute>. Les espaces ne sont pas autorisés dans l'identifiant d'attribut. |
Non. Si inclus, vous pouvez spécifier un nombre illimité d'éléments enfants |
Couleur |
Couleur du produit. |
Non ; recommandé |
Size |
Taille du produit. |
Non ; recommandé |
Ressources |
Matériau du produit. Par exemple, acier, plastique, soie, etc. |
Non ; recommandé |
Devise |
Devise du produit dans chaque pays. Remarque : la devise doit être fournie au format ISO 4217N.
|
Non ; recommandé |
Price |
Prix du produit. |
Non ; recommandé |
Disponibilité |
Indique si un produit est disponible à l'achat ou non. Il peut être en rupture de stock ou hors saison. |
Non ; recommandé |
<Products> <Product> <ExternalId>11111111111abc</ExternalId> <Name>First Product Round with Green</Name> <Description>First Product Description Text</Description> <Brand> <Name>brand-123</Name> </Brand> <CategoryPath> <CategoryName>Category</CategoryName> <CategoryName>Sub Category</CategoryName> </CategoryPath> <ProductPageUrl>http://www.example.com/product.htm?prod=2000001</ProductPageUrl> <ImageUrl>http://images.example.com/prodimages/2000001.gif</ImageUrl> <!-- Product details needed for syndication --> <ManufacturerPartNumbers> <ManufacturerPartNumber>26-12345-8Z</ManufacturerPartNumber> </ManufacturerPartNumbers> <EANs> <EAN>0213354752286</EAN> <EAN>0188173724031</EAN> </EANs> <UPCs> <UPC>382157229380</UPC> <UPC>283929327281</UPC> </UPCs> <!-- Custom product attributes --> <Attributes> <Attribute id="SAP_STATUS"> <Value>L</Value> </Attribute> <Attribute id="BUYING_NUMBER"> <Value>Not_Available</Value> </Attribute> <Attribute id="PROD_MGMT_GRP_NUMBER"> <Value>Group56789</Value> </Attribute> </Attributes> </Product> <Product> <ExternalId>22</ExternalId> <Name>Second Product Round and Green</Name> <Description>Second Product Description Text</Description> <BrandExternalId>BBB</BrandExternalId> <CategoryExternalId>1021</CategoryExternalId> <ProductPageUrl>http://www.example.com/product.htm?prod=2000002</ProductPageUrl> <ImageUrl>http://images.example.com/prodimages/2000002.gif</ImageUrl> <ModelNumbers> <ModelNumber>1235832</ModelNumber> <ModelNumber>1235839</ModelNumber> </ModelNumbers> <ManufacturerPartNumbers> <ManufacturerPartNumber>26-12345-8W</ManufacturerPartNumber> </ManufacturerPartNumbers> <EANs> <EAN>0213354752287</EAN> </EANs> <UPCs> <UPC>138313830283</UPC> </UPCs> </Product> </Products>
Étape 3 : Validez le flux.
Votre flux doit présenter une syntaxe XML correcte et compatible avec le schéma XML de Bazaarvoice . Vérifiez que votre flux respecte le schéma avant de l'envoyer à Bazaarvoice. Vous pouvez utiliser un outil de validation XML pour valider votre flux, ou vous pouvez charger votre flux de produits via SFTP en suivant les étapes ci-dessous et déclencher l'importation via Workbench en pré-production.
Étape 4 : Chargez le flux.
Bazaarvoice recommande de charger un flux de produits mis à jour dès que votre catalogue produits est modifié sur votre site Web. Il est donc essentiel que vous fournissiez à Bazaarvoice les mises à jour correspondantes lorsque vous faites évoluer votre catalogue produits sur votre site.
Vous pouvez ajouter un niveau de sécurité à vos donnés en fournissant une clé SSH (Secure Socket Shell) à l'aide de la saisie SSH sans mot de passe. Ce processus signifie que vous utilisez une clé privée que vous seul possédez et qui sera associée à une clé publique utilisée par un serveur Bazaarvoice SFTP. Si vous souhaitez configurer cette méthode d'authentification basée sur une clé, contactez le service d'assistance de Bazaarvoice pour obtenir plus d'informations et de l'aide.
Chargez le fichier de flux XML dans le répertoire /import-inbox du serveur SFTP.
- Si vos données sont hébergées aux États-Unis, utilisez les URL suivantes :
- Serveur de test – sftp-stg.bazaarvoice.com
- Serveur de production – sftp.bazaarvoice.com
- Si vos données sont hébergées en Europe, utilisez les URL suivantes :
- Serveur de test – sftp7-stg.bazaarvoice.com
- Serveur de production – sftp7.bazaarvoice.com
Veillez à vous connecter au serveur SFTP via le port 22. Si vous ne connaissez pas vos identifiants SFTP ou si vous ne savez pas où sont hébergées vos données, veuillez contacter l'assistance client Bazaarvoice.
Une fois que vous avez chargé un flux de produits sur un serveur SFTP, Bazaarvoice lance automatiquement l'importation du flux à 2 h, heure du Centre (UTC-6 en hiver ou UTC-5 en été). Toutefois, il se peut que Bazaarvoice ne terminera l'importation que bien plus tard en raison de la durée du processus.
Si vous avez chargé le flux sur un serveur de test, vous pouvez déclencher une importation manuellement. Cela n'est en revanche pas possible sur le serveur de production. Pour ce faire, procédez comme suit :
- Dans le Workbench Bazaarvoice sur le serveur de pré-production, sélectionnez Settings > Validate Product Feed (Paramètres > Valider le flux de produits).
- Sélectionnez Schedule one-time import (Programmer une importation ponctuelle) pour importer manuellement le flux.
Étape 5 : Vérifiez le statut du flux.
Après avoir chargé un flux sur le serveur SFTP de test ou de production, vous pouvez consulter le récapitulatif de l'importation et le nombre d'erreurs ou d'avertissements. Ainsi, vous pouvez corriger les erreurs avant la prochaine importation et garantir que le flux sera valide.
Pour consulter le résumé d'importation de votre serveur de pré-production ou de production, sélectionnez Settings > Validate Product Feed (Paramètres > Valider le flux de produits). Si votre flux vous renvoie une erreur ou un avertissement, sélectionnez l'élément pour en savoir plus.
Exemple de flux XML
Bien que l'exemple de flux de produits ci-après soit probablement plus restreint et moins complexe que le vôtre, vous pouvez l'étudier pour vous familiariser avec la structure basique de flux requise par Bazaarvoice.
<?xml version="1.0" encoding="utf-8"?> <Feed xmlns="http://www.bazaarvoice.com/xs/PRR/ProductFeed/15.1" name="ExampleClient" incremental="false" extractDate="2011-10-18T12:00:00.000000"> <!-- Brands --> <Brands> <Brand> <ExternalId>AAA</ExternalId> <Name>First Brand</Name> </Brand> <Brand> <ExternalId>BBB</ExternalId> <!-- Default brand name --> <Name>Second Brand</Name> <!-- Localized brand names --> <Names> <Name locale="en_US">Second Brand US</Name> <Name locale="en_CA">Second Brand CA</Name> <Name locale="fr_CA">Deuxième marque CA</Name> </Names> </Brand> </Brands> <!-- Categories --> <Categories> <Category> <ExternalId>1010</ExternalId> <!-- Default category name --> <Name>First Category</Name> <!-- Localized category names --> <Names> <Name locale="en_US">First Category US</Name> <Name locale="en_CA">First Category CA</Name> <Name locale="fr_CA">Première catégorie CA</Name> </Names> <!-- Default category page URL --> <CategoryPageUrl>http://www.example.com/category.htm?cat=1010</CategoryPageUrl> <!-- Localized category page URLs --> <CategoryPageUrls> <CategoryPageUrl locale="en_US">http://www.example.com/en_us/category.htm?cat=1010</CategoryPageUrl> <CategoryPageUrl locale="en_CA">http://www.example.com/en_ca/category.htm?cat=1010</CategoryPageUrl> <CategoryPageUrl locale="fr_CA">http://www.example.com/fr_ca/category.htm?prod=1010</CategoryPageUrl> </CategoryPageUrls> <!-- Default category image URL --> <ImageUrl>http://images.example.com/catimages/1010.gif</ImageUrl> <!-- Localized category image URLs --> <ImageUrls> <ImageUrl locale="en_US">http://images.example.com/en_us/catimages/1010.gif</ImageUrl> <ImageUrl locale="en_CA">http://images.example.com/en_ca/catimages/1010.gif</ImageUrl> <ImageUrl locale="fr_CA">http://images.example.com/fr_ca/catimages/1010.gif</ImageUrl> </ImageUrls> </Category> <Category> <ExternalId>1020</ExternalId> <Name>Second Category</Name> <CategoryPageUrl>http://www.example.com/category.htm?cat=1020</CategoryPageUrl> <ImageUrl>http://images.example.com/catimages/1020.gif</ImageUrl> </Category> <Category> <ExternalId>1021</ExternalId> <ParentExternalId>1020</ParentExternalId> <Name>Sub Category</Name> <CategoryPageUrl>http://www.example.com/category.htm?cat=1021</CategoryPageUrl> <ImageUrl>http://images.example.com/catimages/1021.gif</ImageUrl> </Category> </Categories> <!-- Products --> <Products> <Product> <ExternalId>11111111111abc</ExternalId> <Name>First Product Round with Green</Name> <Description>First Product Description Text</Description> <BrandExternalId>AAA</BrandExternalId> <CategoryExternalId>1010</CategoryExternalId> <ProductPageUrl>http://www.example.com/product.htm?prod=2000001</ProductPageUrl> <ImageUrl>http://images.example.com/prodimages/2000001.gif</ImageUrl> <!-- Product details needed for syndication --> <ManufacturerPartNumbers> <ManufacturerPartNumber>26-12345-8Z</ManufacturerPartNumber> </ManufacturerPartNumbers> <EANs> <EAN>0213354752286</EAN> <EAN>0188173724031</EAN> <EAN>1833474920123</EAN> </EANs> <UPCs> <UPC>382157229380</UPC> <UPC>283929327281</UPC> <UPC>058227392728</UPC> </UPCs> <!-- Custom product attributes --> <Attributes> <!-- Families the product is a member of --> <Attribute id="BV_FE_FAMILY"> <Value>Green</Value> </Attribute> <Attribute id="BV_FE_FAMILY"> <Value>Round</Value> </Attribute> <!-- Product management group ID --> <Attribute id="ProductManagementGroupId"> <Value>Group56789</Value> </Attribute> </Attributes> </Product> <Product> <ExternalId>22</ExternalId> <Name>Second Product Round and Green</Name> <Description>Second Product Description Text</Description> <BrandExternalId>BBB</BrandExternalId> <CategoryExternalId>1021</CategoryExternalId> <ProductPageUrl>http://www.example.com/product.htm?prod=2000002</ProductPageUrl> <ImageUrl>http://images.example.com/prodimages/2000002.gif</ImageUrl> <ModelNumbers> <ModelNumber>1235832</ModelNumber> <ModelNumber>1235839</ModelNumber> </ModelNumbers> <ManufacturerPartNumbers> <ManufacturerPartNumber>26-12345-8W</ManufacturerPartNumber> </ManufacturerPartNumbers> <EANs> <EAN>0213354752287</EAN> </EANs> <UPCs> <UPC>138313830283</UPC> </UPCs> <!-- Custom product attributes --> <Attributes> <!-- Families the product is a member of --> <Attribute id="BV_FE_FAMILY"> <Value>Round</Value> </Attribute> <Attribute id="BV_FE_FAMILY"> <Value>Green</Value> </Attribute> <!-- Show all content from other products in the Round Family --> <Attribute id="BV_FE_EXPAND"> <Value>BV_FE_FAMILY:Round</Value> </Attribute> <!-- Product management group ID --> <Attribute id="ProductManagementGroupId"> <Value>Group56789</Value> </Attribute> </Attributes> </Product> <!-- Example product with multiple languages --> <Product> <ExternalId>333</ExternalId> <!-- Default product name --> <Name>Third Product Square and Red</Name> <!-- Localized product names --> <Names> <Name locale="en_US">Third Product US</Name> <Name locale="en_CA">Third Product CA</Name> <Name locale="fr_CA">Troisième produit CA</Name> </Names> <!-- Default product description --> <Description>Third Product Description Text</Description> <!-- Localized product descriptions --> <Descriptions> <Description locale="en_US">Third Product Description Text US</Description> <Description locale="en_CA">Third Product Description Text CA</Description> <Description locale="fr_CA">Troisième texte Description du produit</Description> </Descriptions> <BrandExternalId>BBB</BrandExternalId> <CategoryExternalId>1021</CategoryExternalId> <!-- Default product page URL --> <ProductPageUrl>http://www.example.com/product.htm?prod=2000003</ProductPageUrl> <!-- Localized product page URLs --> <ProductPageUrls> <ProductPageUrl locale="en_US">http://www.example.com/en_us/product.htm?prod=2000003</ProductPageUrl> <ProductPageUrl locale="en_CA">http://www.example.com/en_ca/product.htm?prod=2000003</ProductPageUrl> <ProductPageUrl locale="fr_CA">http://www.example.com/fr_ca/product.htm?prod=2000003</ProductPageUrl> </ProductPageUrls> <!-- Default product image URL --> <ImageUrl>http://images.example.com/prodimages/2000003.gif</ImageUrl> <!-- Localized product image URLs --> <ImageUrls> <ImageUrl locale="en_US">http://images.example.com/en_us/prodimages/2000003.gif</ImageUrl> <ImageUrl locale="en_CA">http://images.example.com/en_ca/prodimages/2000003.gif</ImageUrl> <ImageUrl locale="fr_CA">http://images.example.com/fr_ca/prodimages/2000003.gif</ImageUrl> </ImageUrls> <ModelNumbers> <ModelNumber>123523832</ModelNumber> <ModelNumber>123325839</ModelNumber> </ModelNumbers> <ManufacturerPartNumbers> <ManufacturerPartNumber>26-93812-8W</ManufacturerPartNumber> </ManufacturerPartNumbers> <EANs> <EAN>0813354723287</EAN> </EANs> <UPCs> <UPC>138313830999</UPC> </UPCs> <!-- Custom product attributes --> <Attributes> <!-- Families this product is a member of --> <Attribute id="BV_FE_FAMILY"> <Value>Red</Value> </Attribute> <Attribute id="BV_FE_FAMILY"> <Value>Square</Value> </Attribute> <!-- Show all content from other products in the Red Family --> <Attribute id="BV_FE_EXPAND"> <Value>BV_FE_FAMILY:Red</Value> </Attribute> <!-- Show all content from other products in the Square Family --> <Attribute id="BV_FE_EXPAND"> <Value>BV_FE_FAMILY:Square</Value> </Attribute> <!-- Price of this product in USA --> <Attribute id="PriceUs"> <Value>65.30</Value> </Attribute> <!-- Price of this product in Canada --> <Attribute id="PriceCa"> <Value>67.25</Value> </Attribute> <!-- Product management group ID --> <Attribute id="ProductManagementGroupId"> <Value>Group12345</Value> </Attribute> </Attributes> </Product> <Product> <ExternalId>4444</ExternalId> <Name>Fourth Product Round and Black</Name> <Description>Fourth Product Description Text</Description> <BrandExternalId>BBB</BrandExternalId> <CategoryExternalId>1021</CategoryExternalId> <ProductPageUrl>http://www.example.com/product.htm?prod=2000002</ProductPageUrl> <ImageUrl>http://images.example.com/prodimages/2000002.gif</ImageUrl> <ModelNumbers> <ModelNumber>1235832</ModelNumber> <ModelNumber>1235839</ModelNumber> </ModelNumbers> <ManufacturerPartNumbers> <ManufacturerPartNumber>26-12345-8W</ManufacturerPartNumber> </ManufacturerPartNumbers> <EANs> <EAN>0213354752287</EAN> </EANs> <UPCs> <UPC>138313830283</UPC> </UPCs> <!-- Custom product attributes --> <Attributes> <!-- Families this product is a member of --> <Attribute id="BV_FE_FAMILY"> <Value>Round</Value> </Attribute> <!-- Show all content from other products in the Round Family --> <Attribute id="BV_FE_EXPAND"> <Value>BV_FE_FAMILY:Round</Value> </Attribute> <!-- Product management group ID --> <Attribute id="ProductManagementGroupId"> <Value>Group56789</Value> </Attribute> </Attributes> </Product> <Product> <ExternalId>55555</ExternalId> <Name>Fifth Product- Family level</Name> <Description>Use this product to collect reviews at a Family level. This product is also a member of the Green Family. It has the BV_FE_EXPAND Attribute set which will pull all reviews for the family</Description> <BrandExternalId>BBB</BrandExternalId> <CategoryExternalId>1021</CategoryExternalId> <ProductPageUrl>http://www.example.com/product.htm?prod=2000002</ProductPageUrl> <ImageUrl>http://images.example.com/prodimages/2000002.gif</ImageUrl> <ModelNumbers> <ModelNumber>1235832green</ModelNumber> <ModelNumber>1235543green</ModelNumber> <ModelNumber>127654green</ModelNumber> <ModelNumber>123111green</ModelNumber> </ModelNumbers> <UPCs> <UPC>138313830281</UPC> <UPC>138313830282</UPC> <UPC>138313830283</UPC> <UPC>138313830284</UPC> </UPCs> <!-- Custom product attributes --> <Attributes> <!-- Families this product is a member of --> <Attribute id="BV_FE_FAMILY"> <Value>Green</Value> </Attribute> <!-- Show all content from other products in the Green Family --> <Attribute id="BV_FE_EXPAND"> <Value>BV_FE_FAMILY:Green</Value> </Attribute> </Attributes> </Product> </Products> </Feed>
Fichiers de flux incrémentaux
Un flux complet du catalogue produits comprend tous les produits disponibles dans votre catalogue pour lesquels vous souhaitez recueillir du contenu, tandis qu'un flux incrémental regroupe les données pour un sous-ensemble de vos produits.
Pour savoir quel flux choisir, consultez les informations ci-dessous.
- Flux complets uniquement
Vous pouvez charger dans Bazaarvoice un flux XML complet de votre catalogue de manière régulière, qui inclut toutes les données existantes pour les produits et catégories actifs. Il s'agit de la stratégie recommandée.
- Flux complets et incrémentaux
Vous pouvez envoyer à la fois des flux de catalogue complets et incrémentaux. Nous conseillons de fournir un premier flux complet de votre catalogue, puis des flux incrémentaux lorsque des changements ont été apportés aux données du catalogue. Optez pour cette stratégie dans les cas suivants :
- Vous modifiez votre catalogue produits très souvent au point que vous devez procéder à des mises à jour quotidiennes de votre flux de produits.
- Vous ne procédez qu'à des mises à jour rares ou limitées de votre flux de produits.
Toutefois, afin d'éviter des disparités dans votre ensemble de données, qui pourraient se traduire par un échec de chargement et de traitement d'un flux incrémental en particulier, nous recommandons de fournir un flux complet de manière régulière (avec les données actuelles de l'intégralité de votre catalogue).
- Flux incrémentaux uniquement
Si vous ne pouvez pas fournir les données de tous vos produits dans un seul flux de catalogue, vous pouvez envoyer uniquement des flux incrémentaux. Veillez alors à inclure l'attribut removed=”true". Reportez-vous à la section Gérer l'ensemble actif de produits pour en savoir plus sur cette approche.
Attention : Si vous n'utilisez que des flux incrémentaux sans jamais fournir un flux complet à Bazaarvoice, il est possible que vos données de catalogue ne soit plus synchronisées avec les sources de celui-ci dans le cas où le chargement d'un flux incrémental échoue ou n'a pas lieu pour une quelconque raison.
Chaque flux indique s'il s'agit d'un flux complet ou incrémental, bien que cela varie en fonction du format du flux :
- Les fichiers de flux XML utilisent l'attribut incrémental dans l'élément
<Feed> - Les fichiers de flux texte possèdent un en-tête
Filtrer les données du catalogue en fonction des attributs de produits personnalisés
Pour filtrer votre flux de produits selon des attributs de produits personnalisés, vous devez ajouter ces attributs à la configuration de votre flux. Vous pourrez ainsi filtrer les tableaux de bord et les rapports sur le contenu dans le Workbench. Les attributs de produits personnalisés vous permettent de créer des rapports sur des informations spécifiques aux produits. Toutefois, ils ne vous permettront pas d'afficher plusieurs catégories dans un même flux. Par exemple, vous pouvez définir un attribut « région » pour créer des rapports sur les hôtels d'une région du pays. Vous pouvez également définir un attribut « service » pour suivre la façon dont les produits issus de divers services sont perçus par vos clients.
La vidéo suivante vous montre comment utiliser les attributs de produits personnalisés.
Suivez les étapes ci-dessous pour ajouter un attribut à votre implémentation et activer les attributs de produits personnalisés dans le Workbench :
-
Intégrez des attributs de produits personnalisés dans le flux en ajoutant le bloc
<Attributes>à l'élément<Products>. Chaque élément<Attribute>du bloc<Attributes>identifie un attribut personnalisé. Voici trois exemples d'attributs personnalisés :<Products>
<Product> ... <Attributes> <Attribute id="CHANNEL_VISIBILITY">
<Value>Any</Value>
</Attribute>
<Attribute id="SAP_STATUS">
<Value>L</Value>
</Attribute>
<Attribute id="BUYING_NUMBER">
<Value>Not_Available</Value>
</Attribute>
</Attributes> </Product>
</Products> -
Connectez-vous au portail Bazaarvoice .
Remarque : vous pouvez créer des attributs sur votre serveur de production, mais il est préférable de les tester et de les prévisualiser dans un premier temps sur le serveur de pré-production.
- Sélectionnez Configuration dans le menu du portail
situé dans le coin supérieur gauche de l'écran.
- Sélectionnez une instance.
- Sélectionnez Go to Configuration (Aller à Configuration). Le Site Manager (gestionnaire de site) apparaît et liste les zones de déploiement et les implémentations disponibles.
Remarque : vous pouvez également ajouter de nouvelles zones de déploiement et des implémentations sur cet écran.
- Dans Implementations (Implémentations), trouvez le nom de l'implémentation dont vous avez besoin à l'aide du filtre.
- Sélectionnez Edit (Modifier) à côté de l'implémentation que vous souhaitez configurer.
Remarque : vous ne pouvez pas activer les attributs de produit personnalisés dans des zones de déploiement individuelles. Si vous ne les avez pas activés dans la zone de déploiement du site principal, ils ne s'afficheront pas dans Workbench.
- Dans le menu à gauche de la page, sélectionnez Technical Setup (Configuration technique) sous Getting Started (Démarrer).
- Sélectionnez l'onglet Product Catalog (Catalogue produits).
-
Dans la section Feed Attributes (Attributs du flux), saisissez un nom d'attribut dans le champ Custom Product Attributes (Attributs de produits personnalisés), puis sélectionnez Add (Ajouter). Le nom de l'attribut doit correspondre à l'attribut id de l'élément
<Attribute>du flux de produits. Répétez cette étape pour chaque attribut à ajouter.Cet exemple vous présente des attributs qui correspondent aux identifiants de l'exemple XML précédent :
Vous pouvez à présent utiliser les attributs de produits personnalisés pour filtrer le contenu dans les rapports d'analyse du Workbench, les dashboards et d'autres fonctionnalités.
Partager des avis à l'aide de familles de produits
Les familles de produits sont une fonctionnalité de Ratings & Reviews grâce à laquelle vous pouvez partager le CGU entre plusieurs produits appartenant à la même famille. En regroupant les produits par famille, vous pourrez faire apparaître le CGU d'un produit sur la page de chaque produit de la même famille. Dans le cadre de votre implémentation Bazaarvoice, partager des avis entre tous les produits appartenant à une même famille a un effet positif sur ces indicateurs clés de performance :
- Pourcentage des produits ayant reçu des avis affichés
- Nombre de produits ayant reçu des avis affichés
- Nombre moyen d'avis pour chaque produit
- Total des avis affichés
Types de familles de produits
Le type de famille de produit à utiliser dépend des différences entre les produits :
-
Variantes de produits : produits presque identiques en termes d'expérience pour le consommateur, mais qui ont des UGS ou des numéros de pièces différents. Ainsi, des produits disponibles dans plusieurs couleurs ou dans différentes tailles, ou encore conditionnés différemment en poids ou en quantité, peuvent être des variantes les uns des autres. Le contenu des variantes de produits est généralement partagé bilatéralement. Tous les produits d'une famille donnée présentent, ainsi, le contenu rédigé au sujet des autres produits de cette famille.
La création d'une famille de variantes de produits est plus pertinente lorsque chaque variante dispose de sa propre page produit. Si toutes les variantes de produits sont affichées sur une même page de votre site, définir ces dernières comme un unique produit lors de l'intégration à Bazaarvoice pourra être plus simple et pratique que de configurer une famille de produits.
- Pack de produits : groupe de produits vendus ensemble comme un produit unique et qui pourraient, dans d'autres circonstances, être vendus séparément. Le contenu des packs de produits est généralement partagé unilatéralement : des composants individuels vers le pack de produits. En général, tous les avis relatifs aux composants individuels sont affichés sur la page produit du pack. Cependant, la page produit de chaque composant ne présentera que les avis relatifs à ce composant.
Configurer les familles de produits
Il vous est possible de configurer des familles de produits à partir de votre flux de produits ou du Workbench. Vous pouvez ajouter un produit à une ou plusieurs familles simultanément à l'aide de ces méthodes.
Lors de la configuration de vos familles de produits, tenez compte des mises en garde suivantes :
- Les configurations de familles de produits ne sont pas transférées entre les environnements de test et de production.
- Toute modification apportée aux familles de produits dans le Workbench pourra uniquement être annulée dans le Workbench.
- Les définitions de familles dans le flux de produits n'ont pas la priorité par rapport aux opérations sur les familles dans le Workbench.
Avec le flux de produits
Si vous avez déjà une idée précise des produits qu'il vous est possible de regrouper, nous vous conseillons de créer vos familles de produits à partir du flux de produits. Il est plus simple et plus rapide d'automatiser ces relations à partir du flux de produits que de les créer dans Workbench.
Il est possible de configurer les familles dans le flux de produits en intégrant l'un des attributs suivants ou les deux à la fois :
- BV_FE_FAMILY — place un produit dans une famille donnée.
- BV_FE_EXPAND — permet à un produit d'afficher le contenu des autres produits de la même famille.
Dans cet exemple XML, tous les produits d'une famille présentent le contenu relatif à l'ensemble des autres produits de la famille.
<Product>
<ExternalId>...</ExternalId>
<Name>Green iPod Nano</Name>
<Description>...</Description>
<BrandExternalId>...</BrandExternalId>
<CategoryExternalId>...</CategoryExternalId>
<ProductPageUrl>...</ProductPageUrl>
<ImageUrl>...</ImageUrl>
<Attributes>
<Attribute id="BV_FE_FAMILY">
<Value>iPod_Nanos</Value>
</Attribute>
<Attribute id="BV_FE_EXPAND">
<Value>BV_FE_FAMILY:iPod_Nanos</Value>
</Attribute>
</Attributes>
</Product>
<Product>
<ExternalId>...</ExternalId>
<Name>Pink iPod Nano</Name>
<Description>...</Description>
<BrandExternalId>...</BrandExternalId>
<CategoryExternalId>...</CategoryExternalId>
<ProductPageUrl>...</ProductPageUrl>
<ImageUrl>...</ImageUrl>
<Attributes>
<Attribute id="BV_FE_FAMILY">
<Value>iPod_Nanos</Value>
</Attribute>
<Attribute id="BV_FE_EXPAND">
<Value>BV_FE_FAMILY:iPod_Nanos</Value>
</Attribute>
</Attributes>
</Product>
Dans l'exemple XML suivant, le pack de produits comporte l'attribut BV_FE_EXPAND. Tous les avis portant sur les composants de la famille sont donc affichés sur la page du pack. Cependant, BV_FE_EXPAND est absent des définitions <Attribute> des produits pour les composants individuels. Ainsi, les avis relatifs au pack ne sont pas affichés sur les pages des composants.
<Product> <ExternalId>...</ExternalId> <Name>Value Bundle</Name> <Description>...</Description> <BrandExternalId>...</BrandExternalId> <CategoryExternalId>...</CategoryExternalId> <ProductPageUrl>...</ProductPageUrl> <ImageUrl>...</ImageUrl> <Attributes> <Attribute id="BV_FE_FAMILY"> <Value>Value_Bundle</Value> </Attribute> <!-- Including BV_FE_EXPAND displays content from all components on the bundle page --> <Attribute id="BV_FE_EXPAND"> <Value>BV_FE_FAMILY:Value_Bundle</Value> </Attribute> </Attributes> </Product> <Product> <ExternalId>...</ExternalId> <Name>Standalone Component</Name> <Description>...</Description> <BrandExternalId>...</BrandExternalId><CategoryExternalId>...</CategoryExternalId> <ProductPageUrl>...</ProductPageUrl> <ImageUrl>...</ImageUrl> <Attributes> <Attribute id="BV_FE_FAMILY"> <Value>Value_Bundle</Value> </Attribute> </Attributes> <!-- Omitting BV_FE_EXPAND prevents content from the bundle from being displayed on the component page --> </Product>
Avec le Workbench
Il vous est conseillé de créer vos familles à partir du Workbench dans les situations suivantes :
- Si vous ne maîtrisez pas le langage XML.
- S'il vous est impossible d'apporter des modifications au flux de produits.
- Vous devez créer une famille pour laquelle les relations de partage du CGU ne sont pas directes ou impossibles à configurer à partir du flux de produits.
Les deux exemples suivants présentent des situations dans lesquelles une famille de produits doit être créée à partir du Workbench.
- Un responsable de catégorie assigné aux lecteurs MP3 souhaite partager des avis entre toutes les couleurs proposées pour ses lecteurs 32 Mo et 64 Mo. Mais, si configurer des familles distinctes pour l'appareil 32 Mo et l'appareil 64 Mo s'avère être un jeu d'enfant dans le flux, il est impossible de les regrouper dans une même famille, car ils ont des UGS différentes. Le responsable de catégorie sera donc obligé de configurer la famille dans le Workbench.
- Le Brand Manager d'une marque de produits d'hygiène souhaite créer un pack composé d'un baume à lèvres et d'un produit solaire à l'occasion des soldes d'été. Ce Brand Manager veut donc configurer une famille de produits, composée du baume à lèvres et du produit solaire, afin que les avis relatifs à chacun de ces produits soient partagés sur la page produit du pack. Cependant, le baume à lèvres et le produit solaire ne partagent pas d'élément du flux de produits qui permettrait de les lier. Il est donc conseillé au Brand Manager de configurer la famille de produits à partir du Workbench. À la fin de la saison estivale, lorsque le Brand Manager ne souhaitera plus vendre ces produits ensemble, il lui sera possible de supprimer la famille de produits de ce pack à partir du Workbench.
Pour configurer des familles de produits à partir du Workbench, respectez les étapes suivantes :
- Connectez-vous à Workbench, puis naviguez jusqu'à Content > Manage Families (Contenu > Gérer les familles).
- Sélectionnez Add New Family (Ajouter une nouvelle famille) et saisissez un nom pour la famille de produits.
- Saisissez l'identifiant du produit tel qu'il apparaît dans votre flux de produits XML, et répétez cette manipulation pour chacun des produits que vous souhaitez ajouter à la famille avant de sélectionner Ajouter un produit.
- Annulez la sélection de l'attribut Développer si vous ne souhaitez pas que le contenu des produits de la famille soit affiché sur la page du produit correspondant.
- Sélectionnez x pour revenir à la page Manage Families (Gérer les familles).
Établir une hiérarchie de catégories de produits
Si vous créez un fichier de flux XML, vous pouvez établir une hiérarchie de catégories de produits. Vous pouvez en effet associer chaque produit à une catégorie spécifique dans une hiérarchie en utilisant l'élément <CategoryExternalId>. Vous pouvez en outre définir l'élément parent d'une catégorie au moyen de l'élément <ParentExternalId>. Ce faisant, vous établissez la hiérarchie entre les catégories.
Veillez à tenir compte des informations suivantes si vous fournissez des flux multiples pour vos données de catalogue produits :
- Un produit qui apparaît dans plusieurs flux doit appartenir à la même catégorie dans tous les flux. Par conséquent, si un produit A est associé à la catégorie X dans le flux A, ce même produit ne peut se trouver dans la catégorie Y du flux B.
- Une catégorie qui apparaît dans plusieurs flux doit appartenir à la même catégorie parente dans tous les flux. Par conséquent, si une catégorie A est associée à la catégorie parente X dans le flux A, cette même catégorie ne peut se trouver dans la catégorie parente Y du flux B.
L'extrait de fichier XML suivant définit un élément <CategoryExternalId> pour une catégorie qui est ensuite référencée par un élément <ParentExternalId>.
<Categories> <Category> <ExternalId>food-1123</ExternalId> <Name>Food</Name> <= no parent category; this is a top-level hierarchy element ... </Category> <Category> <ExternalId>fruit-1789</ExternalId> <Name>Fruit</Name> <ParentExternalId>food-1123</ParentExternalId> <= "Fruit" category is a child of category “Food” ... </Category> </Categories> <Products> <Product> <ExternalId>123</ExternalId> <Name>Apple</Name> <CategoryExternalId>fruit-1789</CategoryExternalId> <= belongs to category “Fruit” ... </Product> ... </Products>
