Export de contenu
Bazaarvoice vous permet d'exporter des fichiers qui contiennent les données sur le produit et le contenu généré par les utilisateurs (CGU). Vous pouvez utiliser ces fichiers exportés pour :
- Extraire des données et les inclure dans des catalogues ou campagnes d'e-mailings
- Analyser l'opinion des consommateurs
- Intégrer les données dans votre site et améliorer la recherche ou la navigation sur votre site
- Publier du contenu sur votre site Web sans utiliser l'infrastructure d'affichage Ratings & Review de Bazaarvoice
Les exports de fichiers suivants sont disponibles :
- Le flux client standard facilite le mapping des avis et des dimensions aux produits et catégories de produits appropriés. Ce flux contient des informations spécifiques au produit, le nombre de contenus et les détails du CGU.
- Le flux de notes seules contient le contenu lié aux notes spécifiques au produit, notamment les identifiants de produit, le nombre d'avis, la note globale, le nombre de personnes ayant laissé un avis et les notes maximales. Ce flux est le plus souvent utilisé pour déclencher l'affichage des notes récapitulatives.
- Le fichier « Displayable content export » (DCE) fournit un moyen de stocker le CGU au niveau local et d'afficher ce contenu sans faire appel à l'infrastructure d'affichage Ratings & Reviews de Bazaarvoice. Ce fichier est conçu pour être utilisé en une fois (avec un volume important) et régulièrement. Le CGU peut ensuite être affiché sur un site Web ou d'autres applications.
Flux client standard
Le flux client standard est un fichier XML qui facilite le mapping des avis et des dimensions aux produits et catégories de produits appropriés. Le flux contient les données suivantes :
- Les informations liées au produit, telles que les noms, les descriptions et les ID de produit
- Le nombre d'éléments de contenu, tel que le nombre d'avis, de questions, de réponses et d'éléments de campagne
- Les détails du CGU, tels que les avis individuels
Les données d'un flux client standard sont utiles pour réaliser des tâches telles que :
- La récupération des avis des clients en vue de les inclure dans des catalogues et des campagnes par e-mail.
- La réalisation d'une analyse d'opinion sur le texte du contenu
- L'intégration de données avec la recherche et la navigation sur votre site
Outre le flux client complet, Bazaarvoice peut également envoyer un flux client incrémental contenant uniquement les changements apportés depuis la dernière création du flux client.
Activer et programmer les flux client standard
Pour recevoir un flux client standard de Bazaarvoice, vous devez l'activer et le programmer comme suit :
- Connectez-vous au portail Bazaarvoice .
- Dans le menu du portail , sélectionnez Configuration.
- Sélectionnez l'instance et 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.
- Modifiez l'implémentation principale installée sur la zone de déploiement du site principal.
- Sélectionnez Technical Setup (Configuration technique) à gauche de la page puis l'onglet Export Feeds (Exporter les flux).
- Pour activer et programmer les flux client complets :
- Sélectionnez le bouton Enabled (Activé) dans la section Full Standard Content Feed (Flux de contenu standard intégral) de la page.
- Pour activer et programmer les flux incrémentaux :
- Sélectionnez le bouton Enabled (Activé) dans la section Incremental Standard Content Feed (Flux de contenu standard incrémentiel) de la page.
- Déployez les changements dans l'implémentation.
Remarque : Seules les modifications apportées au déploiement de votre site principal affectent les flux d'exportation. Le déploiement des changements sur les autres zones de déploiement n'a aucun effet sur les flux d'exportation.
- Téléchargez les flux depuis le répertoire
/feeds
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.
- Si vos données sont hébergées aux États-Unis, utilisez les URL suivantes :
Remarque : si vous devez adapter le calendrier ou d'autres paramètres de flux, tels que l'apparence d'informations personnelles identifiables (IPI), veuillez contacter l'assistance client Bazaarvoice.
Structure des flux de contenu standard
Cette page contient des extraits de code et les descriptions de différentes parties d'un flux client standard, d'après le code de Bazaarvoice et le modèle du flux.
<Name>
ou <ExternalId>
et leurs définitions font partie de différents objets complexes du flux. Ils seront donc mentionnés dans plusieurs sections du présent document.Éléments de niveau supérieur
Vous trouverez un exemple à la fin de cette section.
Élément | Description | Type |
---|---|---|
Feed |
Élément racine du fichier XML du flux. Attributs :
|
Objet complexe |
Produit |
Élément complexe qui contient des informations sur le sujet d'un client, son contenu et ses statistiques. Reportez-vous à la section Les produits et leurs éléments pour en savoir plus. Attributs :
|
Objet complexe |
Category |
Un autre type de sujet du client. Tout comme le produit, la catégorie contient des informations sur le sujet « catégorie », son contenu et ses statistiques. Reportez-vous à la section Les catégories et leurs éléments pour en savoir plus. Attributs :
|
Objet complexe |
UserProfile |
Contient des informations sur un utilisateur donné (tel qu'un contributeur) et ses statistiques. Reportez-vous à la section Les profils d'utilisateur et leurs éléments pour en savoir plus. Attributs :
|
Objet complexe |
Exemple
<?xml version="1.0" encoding="UTF-8"?> <Feed xmlns="http://www.bazaarvoice.com/xs/PRR/StandardClientFeed/14.8" name="LeCoolRetailer" extractDate="2016-01-01T05:30:00.713-05:00"> <Product id="Product_1" disabled="false" removed="false"> ... </Product> ... <Product id="Product_N" disabled="false" removed="false"> ... </Product> <Category disabled="false"> ... </Category> ... <Category disabled="false"> ... </Category> <UserProfile id="User_1"> ... </UserProfile> ... <UserProfile id="User_N"> ... </UserProfile> </Feed>
Les produits et leurs éléments
Vous trouverez un exemple à la fin de cette section.
Élément | Description | Type |
---|---|---|
Source |
Source de cet élément de données dans le système de Bazaarvoice. Il s'agit en fait d'un nom de client. | Chaîne (255 caractères maximum) |
ExternalId |
Identifiant (tel qu’il a été fourni par le client dans le catalogue de produits). L'attribut d'identifiant de produit duplique cette valeur. | Chaîne (255 caractères maximum) |
Names |
Attribut présent si le nom d’un produit varie selon la langue. Si le produit possède un seul nom, l’élément Name est utilisé. Ces noms se trouvent dans le catalogue de produits. | Objet complexe (séquence d'éléments Name ) |
Nom |
Nom d'un produit tiré du catalogue produits du client. Un produit peut avoir plusieurs noms, qui varient selon la langue spécifiée. Attributs :
|
Chaîne de texte |
Descriptions |
Attribut présent si la description d’un produit varie selon la langue. Si le produit possède une seule description, l’élément Description est utilisé. Ces données se trouvent dans le catalogue de produits. | Objet complexe (séquence d'éléments Description ) |
Description |
Description du produit tirée du catalogue produits du client. Un produit peut avoir plusieurs descriptions, une par langue spécifiée. Attributs :
|
Chaîne de texte |
ProductPageUrls |
Présent si les URL de la page de produit varient selon la langue. Si le produit possède une seule page, l’élément ProductPageUrl est utilisé. | Objet complexe (séquence d'éléments ProductPageUrl ) |
ProductPageUrl |
URL vers la page de produit du site Web du client. Remarque : si l'URL contient un caractère réservé (spécial), vous devez encoder en URL le caractère. Ainsi, utilisez
& pour remplacer une esperluette, %20 pour un espace ou encore %5B et %5D pour les crochets ([ ]).Attributs :
|
URL / chaîne (255 caractères max) |
ReviewsPageTitles |
Présent si le client a fourni plusieurs titres de page d'avis pour chaque langue. | Objet complexe (séquence d'éléments ReviewsPageTitle ) |
ReviewsPageTitle |
Titre d’une page d’avis pour un produit spécifique. Cette valeur peut varier selon la langue. Attributs :
|
Chaîne (255 caractères maximum) |
ReviewsPageMetaDescriptions |
Présent si le client fournit plusieurs descriptions de page d'avis pour chaque langue. | Objet complexe (séquence d'éléments ReviewsPageMetaDescription ) |
ReviewsPageMetaDescription |
La description d’une page d’avis pour un produit donné. Cette valeur peut varier selon la langue. Attributs :
|
Chaîne (255 caractères maximum) |
ImageUrls |
Contient plusieurs URL d'images (si le client en a fourni plusieurs) pour différentes langues. 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.
|
Objet complexe (séquence d'éléments ImageUrl ) |
URL de l'image |
URL d'une image du produit (fournie par le client via le catalogue produits) Cet élément peut varier selon la langue. Remarque : si l'URL contient un caractère réservé (spécial), vous devez encoder en URL ce caractère. Par exemple, utilisez
& pour remplacer une esperluette, %20 pour un espace ou encore %5B et %5D pour des crochets ([ ]).Attributs :
|
URL / chaîne (255 caractères max) |
ProductReviewsUrl |
URL de la page d’avis d’un produit donné. Celle-ci est générée pour les produits actifs qui possèdent des avis. Elle est composée du nom d’hôte général des avis, du code d’affichage et de l’ID de produit : http://reviews.clientname.com/displayCode/productID/reviews.htm Remarque : si l'URL contient un caractère réservé (spécial), vous devez encoder en URL le caractère. Ainsi, utilisez
& pour remplacer une esperluette, %20 pour un espace ou encore %5B et %5D pour les crochets ([ ]). |
URL / chaîne (255 caractères max) |
ProductQuestionsUrl |
URL de la page des questions d’un produit donné. Celle-ci est générée pour les produits actifs qui comportent des questions. Elle est formée du nom d'hôte Questions & Answers, du code d'affichage et de l'identifiant du produit : http://answers.<clientName>.com/answers/<displayCode>/product/<productID>/questions.htm Remarque : si l'URL contient un caractère réservé (spécial), vous devez encoder en URL le caractère. Ainsi, utilisez
& pour remplacer une esperluette, %20 pour un espace ou encore %5B et %5D pour les crochets ([ ]). |
URL / chaîne (255 caractères max) |
ModelNumbers |
Contient plusieurs numéros de modèles applicables au produit en question. | Objet complexe (séquence d'éléments ModelNumber ) |
ModelNumber |
Le numéro de modèle d’un produit donné. Fourni par le client via le catalogue produits. | Chaîne (255 caractères maximum) |
ManufacturerPartNumbers |
Contient plusieurs numéros de pièces du fabricant applicables au produit en question. | Objet complexe (séquence d'éléments ManufacturerPartNumber ) |
ManufacturerPartNumber |
Numéro de pièce du fabricant d’un produit donné. Fourni par le client via le catalogue produits. | Chaîne (255 caractères maximum) |
EANs |
Un ensemble de code-barres EAN applicables au produit. Fourni par le client via le catalogue produits. | Objet complexe (séquence d'éléments EAN ) |
EAN |
Numéro d’article international d’un produit donné (l’un des standards de code-barres pris en charge). Valeurs acceptées : 8 chiffres ou 13 chiffres. Structure : [0-9]{8} et [0-9]{13} | Long (8 octets) |
UPCs |
Un ensemble de code-barres UPC applicables à un produit. Fourni par le client via le catalogue produits. | Objet complexe (séquence d'éléments UPC ) |
UPC |
Universal Product Code (code UPC) d’un produit donné (autre standard pris en charge par Bazaarvoice). Valeurs acceptées : 6 chiffres et 12 chiffres. Structure : [0-9]{6} and [0-9]{12} | Long (8 octets) |
ISBNs |
Un ensemble de codes barres ISBN applicables à un produit tel qu'un livre ou un e-book. Fourni par le client via le catalogue produits. | Objet complexe (séquence d'éléments ISBN ) |
ISBN |
International Standard Book Number d'un produit (identifiant numérique standard destiné aux livres). Structure : [0-9]{8,12}[0-9X] | Long (8 octets) |
NumNativeQuestions |
Nombre de questions approuvées et natives pour ce produit (non syndiquées). | Nombre entier (4 octets) |
Nombre de questions |
Nombre de questions approuvées pour ce produit (y compris syndiquées). | Nombre entier (4 octets) |
NumNativeAnswers |
Nombre de réponses approuvées et natives pour ce produit (non syndiquées). | Nombre entier (4 octets) |
Nombre de réponses |
Nombre de réponses approuvées pour ce produit (y compris syndiquées). | Nombre entier (4 octets) |
Nombre d'avis |
Nombre d'avis approuvés pour ce produit (y compris syndiqués). | Nombre entier (4 octets) |
ReviewStatistics |
Contient des informations détaillées sur l'ensemble des notes et avis du produit (les statistiques incluent les informations syndiquées). Reportez-vous à la section Blocs ReviewStatistics, QAStatistics et CommentStatistics pour en savoir plus. | Complex Object (une description de ses champs est fournie dans la section Blocs ReviewStatistics, QAStatistics et CommentStatistics) |
NativeReviewStatistics |
Contient des informations détaillées sur l'ensemble des notes et avis d'un produit (statistiques concernant les informations non syndiquées). Reportez-vous à la section Blocs ReviewStatistics, QAStatistics et CommentStatistics pour en savoir plus. | Complex Object (une description de ses champs est fournie dans la section Les produits et leurs éléments) |
Brand |
Fait référence à la marque d'un produit donné. Reportez-vous à la section Attributs, marques et CategoryItems pour en savoir plus. | Complex Object (une description de ses champs est fournie dans la section Les produits et leurs éléments ) |
CategoryItems |
Fait référence à un élément Catégories auquel appartient le produit en question. Les catégories sont représentées sous forme de chaîne et classées de la catégorie enfant à parent. Reportez-vous à la section Attributs, marques et CategoryItems pour en savoir plus. | Objet complexe (séquence d'éléments CategoryItem ) |
Attributs |
Contient une liste des attributs supplémentaires et personnalisés d’un produit. Reportez-vous à la section Les attributs, marques et CategoryItems pour en savoir plus. | Objet complexe (séquence d'éléments Attribute ) |
Questions |
Élément parent pour toutes les questions liées au produit. Reportez-vous à la section Types de contenus pour en savoir plus. | Objet complexe (séquence d'éléments Question ) |
Avis |
Élément parent pour tous les avis liés au produit. Reportez-vous à la section Types de contenus pour en savoir plus. | Objet complexe (séquence d'éléments Review ) |
Exemple
<Product id="Product154812" removed="false" disabled="false"> <Source>LeCoolRetailer</Source> <ExternalId>Produit154812</ExternalId> <!-- Product comportera un seul Name ou un élément Names --> <Name>Console de jeu imaginaire 4 500 Go - Nom du jeu : Opération Sauvetage III</Name> <Names> <Name locale="en_US">Imaginary game console 4 500GB - Some game: Green Ops III Bundle</Name> <Name locale="de_DE">Imaginäre Spielkonsole 4 500GB - Einige Spiel: Grün Ops III Bundle</Name> ... </Names> <!-- Product comportera une Description ou un élément Descriptions --> <Description>Cette console de jeu transporte le joueur dans une formidable aventure grâce à de nouveaux univers immersifs et une communauté de joueurs très impliquée. Ce système de console a été pensé pour les joueurs. Ceux-ci découvriront une gamme exceptionnelle de jeux au moment du lancement et plus de 100 500 jeux sont en cours de conception. Grâce à notre système, les joueurs pourront se plonger dans les jeux les plus populaires au monde et de nouveaux titres indépendants incontournables. </Description> <Descriptions> <Description locale="en_US"> This console system opens the door to an incredible journey through immersive new gaming worlds and a deeply connected gaming community. It puts gamers first with an astounding launch lineup and over 100500 games in development. Play amazing top-tier blockbusters and innovative indie hits on our system. </Description> <Description locale="de_DE"> Diese Konsole System öffnet die Tür zu einer unglaublichen Reise durch fesselnde neue Spielwelten und einer tief verbunden Gaming-Community. Es bringt die Spieler zuerst mit einer erstaunlichen Start-Formation und über 100500 Spiele in der Entwicklung. Spielen erstaunlich Top-Tier-Blockbustern und innovative Indie-Hits auf unserem System. </Description> ... </Descriptions> <!-- Product comportera une seule ProductPageUrl ou un élément ProductPageUrls --> <ProductPageUrl>http://www.superdistributeur.com/boutique/produit/console-imaginaire-4-noire-opération/154812</ProductPageUrl> <ProductPageUrls> <ProductPageUrl locale="en_US">http://www.lecoolretailer.com/store/product/imaginary-game-console-4-black-ops/154812</ProductPageUrl> <ProductPageUrl locale="de_DE">http://de.lecoolretailer.com/store/product/imaginare-spiel-konsole-4-black-ops/154812</ProductPageUrl> ... </ProductPageUrls> <!-- Product peut comporter un ReviewsPageTitle ou un élément ReviewsPageTitles --> <ReviewsPageTitle>Console imaginaire 4</ReviewsPageTitle> <ReviewsPageTitles> <ReviewsPageTitle locale="en_US">Imaginary game console 4</ReviewsPageTitle> <ReviewsPageTitle locale="de_DE">Imaginäre Spielkonsole 4</ReviewsPageTitle> ...</ReviewsPageTitles> <!-- Product peut comporter une ReviewsPageMetaDescription ou un élément ReviewsPageMetaDescriptions --> <ReviewsPageMetaDescription>Avis sur le produit et notes des clients. Consultez et comparez les expériences.</ReviewsPageMetaDescription> <ReviewsPageMetaDescriptions> <ReviewsPageMetaDescription locale="en_US">Product reviews and customer ratings for Console of new generation. Read and compare real experiences.</ReviewsPageMetaDescription> <ReviewsPageMetaDescription locale="de_DE"Produktbewertungen und Kundenbewertungen für Konsole der neuen Generation. Lesen und realen Erfahrungen zu vergleichen.</ReviewsPageMetaDescription> ... </ReviewsPageMetaDescriptions> <!-- Product peut comporter une ou plusieurs images dans un élément ImageUrl ou ImageUrls --> <ImageUrl>http://s7d9.scene7.com/is/image/superdistributeur_fr/15875517838466p</ImageUrl> <ImageUrls> <ImageUrl locale="en_US">http://s7d9.scene7.com/is/image/lecoolretailer_us/15875517838466p</ImageUrl> <ImageUrl locale="de_DE">http://s7d9.scene7.com/is/image/lecoolretailer_de/12312341235572d</ImageUrl> ... </ImageUrls><ProductReviewsUrl>http://reviews.lecoolretailer.com/1234/154812/imaginary-game-console-4-black-ops-reviews/reviews.htm</ProductReviewsUrl> <ProductQuestionsUrl>http://reponses.superdistributeur.com/reponses/1234/product/154812/imaginary-game-console-4-black-ops-questions-answers/questions.htm</ProductQuestionsUrl> <!-- Le numéro du modèle, les numéros de pièces, EAN, UPC et ISBN sont inclus si le client nous les a fournis dans le catalogue produits. Chacun de ces types de données peut avoir plusieurs valeurs qui seront listées dans le bloc approprié. --> <ModelNumbers> <ModelNumber>0051391</ModelNumber> ... </ModelNumbers> <ManufacturerPartNumbers> <ManufacturerPartNumber>239324</ManufacturerPartNumber> ... </ManufacturerPartNumbers> <EANs> <EAN>0711719860037</EAN> ... </EANs> <UPCs> <UPC>711719500728</UPC> ... </UPCs> <ISBNs> <ISBN>047875846913</ISBN> ... </ISBNs> <NumNativeQuestions>4</NumNativeQuestions> <NumQuestions>120</NumQuestions> <NumNativeAnswers>1</NumNativeAnswers> <NumAnswers>24</NumAnswers> <NumReviews>42</NumReviews> <!-- Les exemples et descriptions des éléments suivants sont inclus dans des sections séparées de ce document. --> <ReviewStatistics> ... </ReviewStatistics> <NativeReviewStatistics> ... </NativeReviewStatistics> <Brand disabled="false"> ... </Brand> <!-- Category chain --> <CategoryItems> ... </CategoryItems> <!-- Product attributes --> <Attributes> ... </Attributes> <Questions> ... </Questions> <Reviews> ... </Reviews> </Product>
Les catégories et leurs éléments
Vous trouverez un exemple à la fin de cette section.
Élément | Description | Type |
---|---|---|
ExternalId |
Identifiant (tel qu’il a été fourni par le client dans le catalogue de produits). Identique à l’attribut Category ID. | Chaîne (255 caractères maximum) | CategoryPath |
Une chaîne de catégories (contient les catégories parentes d'une catégorie donnée, classées par ordre hiérarchique). Chaque élément Category (lien de catégorie) fait référence à une catégorie existante dans la base de données de Bazaarvoice, et possède un ExternalId et un seul élément Name. | Objet complexe (séquence d'objets Category ) |
Nom |
Nom d’une catégorie tiré du catalogue produits du client. Les produits peuvent avoir plusieurs noms, qui varient selon la langue spécifiée. Attributs :
|
Chaîne de texte |
Names |
Attribut présent si le nom d’un produit varie selon la langue. Si le produit possède un seul nom, l’élément Name est utilisé. Ces noms se trouvent dans le catalogue de produits. | Objet complexe (séquence d'éléments Name ) |
CategoryPageUrl |
URL vers la page de catégorie du site Web du client. Remarque : si l'URL contient un caractère réservé (spécial), vous devez encoder en URL le caractère. Ainsi, utilisez
& pour remplacer une esperluette, %20 pour un espace ou encore %5B et %5D pour les crochets ([ ]).Attributs :
|
URL / chaîne (255 caractères max) |
CategoryPageUrls |
Présent si les URL de la page de produit de la catégorie varient selon la langue. Si le produit possède une seule URL de catégorie de produit, l’élément CategoryPageUrl est utilisé. | Objet complexe (séquence d'éléments CategoryPageUrl ) |
URL de l'image |
URL d'une image de la catégorie (fournie par le client via le catalogue produits). Cette valeur peut varier selon la langue. Remarque : si l'URL contient un caractère réservé (spécial), vous devez encoder en URL ce caractère. Par exemple, utilisez
& pour remplacer une esperluette, %20 pour un espace ou encore %5B et %5D pour des crochets ([ ]).Attributs :
|
URL / chaîne (255 caractères max) |
ImageUrls |
Contient plusieurs URL d'images (si le client en a fourni plusieurs) pour différentes langues. | Objet complexe (séquence d'éléments ImageUrl ) |
ReviewsPageTitles |
Présent si le client a fourni plusieurs titres de page d'avis pour chaque langue. | Objet complexe (séquence d'éléments ReviewsPageTitle ) |
ReviewsPageTitle |
Peut être utilisé afin d'archiver un titre de page des avis pour tous les produits de cette catégorie. Cette valeur peut varier selon la langue. Attributs :
|
Chaîne (255 caractères maximum) |
ReviewsPageMetaDescriptions |
Présent si le client a fourni plusieurs descriptions de page d'avis pour chaque langue. | Objet complexe (séquence d'éléments ReviewsPageMetaDescription ) |
ReviewsPageMetaDescription |
Une description de la page des avis pour les produits de la catégorie en question. Cette valeur peut varier selon la langue. Attributs :
|
Chaîne (255 caractères maximum) |
NumNativeQuestions |
Nombre de questions approuvées et natives pour cette catégorie (non syndiquées). | Nombre entier (4 octets) |
Nombre de questions |
Nombre de questions approuvées pour cette catégorie (y compris syndiquées). | Nombre entier (4 octets) |
NumNativeAnswers |
Nombre de réponses approuvées et natives pour cette catégorie (non syndiquées). | Nombre entier (4 octets) |
Nombre de réponses |
Nombre de réponses approuvées pour cette catégorie (y compris syndiquées). | Nombre entier (4 octets) |
Attributs |
Contient une liste des attributs supplémentaires et personnalisés d’une catégorie donnée. Reportez-vous à la section Les attributs, marques et CategoryItems pour en savoir plus. | Objet complexe (séquence d'éléments Attribute ) |
Questions |
Racine de toutes les questions liées à la catégorie. Reportez-vous à la section Type de question pour en savoir plus. | Objet complexe (séquence d'éléments Question ) |
Exemple
<Category disabled="false"> <ExternalId>22906</ExternalId> <CategoryPath> <Category> <ExternalId>22906</ExternalId> <Name>Acoustic</Name> </Category> <Category> <ExternalId>22905</ExternalId> <Name>Guitars</Name> </Category> <Category> <ExternalId>22904</ExternalId> <Name>Instruments</Name> </Category> </CategoryPath> <!-- Category will hold either a single Name or Names element --> <Name>Acoustic</Name> <Names> <Name locale="en_GB">Acoustic</Name> <Name locale="de_DE">Akustisch</Name> ... </Names> <!-- Category will hold either a single CategoryPageUrl or CategoryPageUrls element --> <CategoryPageUrl>https://www.THE_BEST_GUITAR_STORE_EVER.com/browse/acoustic</CategoryPageUrl> <CategoryPageUrls> <CategoryPageUrl locale="en_GB">https://www.THE_BEST_GUITAR_STORE_EVER.com/browse/acoustic</CategoryPageUrl> <CategoryPageUrl locale="de_DE">https://www.THE_BEST_GUITAR_STORE_EVER.de/browse/acoustic?language=deutsch</CategoryPageUrl> ... </CategoryPageUrls> <!-- Category will hold either a single ImageUrl or ImageUrls element --> <ImageUrl>http://www.THE_BEST_GUITAR_STORE_EVER.cimages/category/categoryimages/Acoustic.jpg</ImageUrl> <ImageUrls> <ImageUrl locale="en_GB">http://www.THE_BEST_GUITAR_STORE_EVER.cimages/category/categoryimages/Acoustic.jpg</ImageUrl> <ImageUrl locale="de_DE">http://www.THE_BEST_GUITAR_STORE_EVER.images/category/categoryimages/Acoustic.jpg</ImageUrl> ... </ImageUrls> <!-- Category might have a ReviewsPageTitle or ReviewsPageTitles element --> <ReviewsPageTitle>Share your acoustic guitar playing experience.</ReviewsPageTitle> <ReviewsPageTitles> <ReviewsPageTitle locale="en_US">Share your acoustic guitar playing experience.</ReviewsPageTitle> <ReviewsPageTitle locale="de_DE">Teilen Sie Ihre Akustikgitarre Spielerlebnis.</ReviewsPageTitle> ... </ReviewsPageTitles> <!-- Category might have a ReviewsPageMetaDescription or ReviewsPageMetaDescriptions element --> <ReviewsPageMetaDescription>Category reviews and customer ratings. Read and compare real experiences.</ReviewsPageMetaDescription> <ReviewsPageMetaDescriptions> <ReviewsPageMetaDescription locale="en_US">Category contains product with reviews and customer ratings for Acoustic guitars. Read and compare real experiences. </ReviewsPageMetaDescription> <ReviewsPageMetaDescription locale="de_DE">Kategorie hält Produkt Testberichte und Kundenbewertungen für Akustikgitarren. Lesen und realen Erfahrungen zu vergleichen.</ReviewsPageMetaDescription> ... </ReviewsPageMetaDescriptions> <NumNativeQuestions>1</NumNativeQuestions> <NumNativeAnswers>2</NumNativeAnswers> <NumQuestions>65</NumQuestions> <NumAnswers>73</NumAnswers> <!-- Examples and descriptions of the following elements are present in separate sections of this doc. --> <Attributes> ... </Attributes> <Questions> ... </Questions> </Category>
Les attributs, marques et CategoryItems
Vous trouverez un exemple à la fin de cette section.
Élément | Description | Type |
---|---|---|
Brand |
Fait référence à la marque d'un produit donné. Attributs :
|
Objet complexe |
Names |
Attribut présent si le nom d’un produit varie selon la langue. Si le produit possède un seul nom, l’élément Name est utilisé. Ces noms se trouvent dans le catalogue de produits. | Objet complexe (séquence d'éléments Name ) |
Nom |
Nom d'un produit tiré du catalogue produits du client. Les produits peuvent avoir plusieurs noms, qui varient selon la langue spécifiée. Attributs :
|
Chaîne de texte |
ExternalId |
Identifiant tel qu’il a été fourni par le client dans le catalogue produits, en général identique à l’attribut id . |
Chaîne (255 caractères maximum) |
CategoryItems |
Ce bloc fait référence aux catégories auxquelles appartient le produit en question. Les catégories sont représentées sous forme de chaîne et classées de la catégorie enfant à la racine. | Objet complexe (séquence d'éléments CategoryItem ) |
CategoryItem |
Lien de catégorie spécifique d'une chaîne de catégorie complète (racine, intermédiaire ou élément feuille). Attributs :
|
Objet complexe |
categoryId |
L'un des quelques identifiants d'une catégorie. Il s'agit de l'identifiant d'un enregistrement dans la base de données de Bazaarvoice. Il est unique pour tous les clients. | Long (8 octets) |
CategoryName |
Nom d'un élément de catégorie précis. | Chaîne (255 caractères maximum) |
Attributs |
Contient une liste des attributs supplémentaires et personnalisés d'un produit. | Objet complexe (séquence d'éléments Attribute ) |
Attribut |
Attribut d'un objet donné (produit, marque, catégorie). Peut contenir des informations supplémentaires archivées par un client dans les bases de données Bazaarvoice, telles que la section, la couleur ou la taille. Attributs :
|
Complex Object (contient un seul élément |
Valeur |
Contient le texte qui décrit ou explique un attribut. | Chaîne de texte |
Exemple
<Product id="Product-X-123890"> ... <Brand disabled="false"> <!-- La marque peut comporter un seul nom ou un élément Names --> <Name>Fender</Name> <Names> <Name locale="en_GB">Fender Brand</Name> <Name locale="de_DE">Fender Marke</Name> ... </Names> <ExternalId>810</ExternalId> <Attributes> <Attribute id="Country"> <Value>United States</Value> </Attribute> ... </Attributes> </Brand> <CategoryItems> <CategoryItem id="22906"> <ExternalId>22906</ExternalId> <CategoryId>996222</CategoryId> <CategoryName>Acoustic</CategoryName> </CategoryItem> <CategoryItem id="22905"> <ExternalId>22905</ExternalId> <CategoryId>996221</CategoryId> <CategoryName>Guitars</CategoryName> </CategoryItem> <CategoryItem id="22904"> <ExternalId>22904</ExternalId> <CategoryId>996220</CategoryId> <CategoryName>Instruments</CategoryName> </CategoryItem> </CategoryItems> <Attributes> <Attribute id="Department"> <Value>Austin Guitar House</Value> </Attribute> <Attribute id="ColorIdentifier"> <Value>Sunburst</Value> </Attribute> </Attributes> ... </Product>
Blocs ReviewStatistics, QAStatistics et CommentStatistics
Les blocs Review Statistics et Native Review Statistics ont la même structure. Review Statistics prend en compte le contenu syndiqué. C'est le seul aspect qui les distingue.
Vous trouverez un exemple à la fin de cette section.
Élément | Description | Type |
---|---|---|
AverageOverallRating |
Note moyenne calculée à partir de tous les avis approuvés pour un produit donné. | Flottant (4 octets) |
OverallRatingRange |
Valeur maximum d’une note. Les notes vont de 1 à la valeur spécifiée ici. La valeur par défaut est de 5, mais certains clients préfèrent utiliser des échelles différentes pour leur fonctionnalité Ratings & Reviews. Cette valeur est définie au cours de la phase de configuration du client. | Nombre entier (11 octets) |
TotalReviewCount |
Nombre total d'avis approuvés (qui devraient donc être affichés) pour un produit donné. | Nombre entier (4 octets) |
RatingsOnlyReviewCount |
Nombre total d'avis ne contenant que des avis approuvés pour un produit donné. Les avis ne contenant que des notes n'ont pas de texte, mais elles sont prises en compte lors du calcul des statistiques. | Nombre entier (4 octets) |
RecommendedCount |
Nombre d'avis qui portent un indicateur « Recommandé ». Cela signifie que durant l'envoi de l'avis, un utilisateur (évaluateur) a confirmé qu'il recommanderait le produit à un ami. | Nombre entier (4 octets) |
AverageRatingValues |
Contient un ensemble d'éléments AverageRatingValue. | Objet complexe (séquence d'éléments AverageRatingValue ) |
AverageRatingValue |
Contient les statistiques moyennes d'un produit calculées (et regroupées) à partir des valeurs de notes secondaires. Attributs :
|
Objet complexe |
RatingDimension |
Spécifie des informations sur des caractéristiques alternatives telles que la facilité d'utilisation, le prix, le matériau ou le confort. Attributs :
|
Objet complexe |
Note
moyenne |
Contient une valeur moyenne choisie par les utilisateurs pour ce barème de notation particulier (note secondaire). | Flottant (4 octets) |
ExternalId |
Identifiant d'un objet donné (comme le contenu, le sujet, la dimension ou la balise), unique parmi tous les objets du même type. | Chaîne (255 caractères maximum) |
RatingRange |
Tout comme l'élément OverallRatingRange, cet élément affiche la valeur maximale d'une note secondaire donnée. Les notes vont de 1 à la valeur spécifiée ici. La valeur par défaut est de 5, mais certains clients préfèrent utiliser des échelles différentes pour les fonctions de notes secondaires des produits ou services. Cette valeur est configurée dans la configuration des affichages ou des soumissions des clients. | Nombre entier (11 octets) |
Label / Label1 |
Description sous forme de texte d'une note ou d'une dimension telle que spécifiée par le client ou la configuration par défaut (le cas échéant). | Chaîne (255 caractères maximum) |
RatingDistribution |
Contient les nombres de notes et d'avis groupés par valeur d'évaluation. | Objet complexe (séquence d'éléments RatingDistributionItem ) |
RatingDistributionItem |
Reflète le nombre d'avis dotés d'une évaluation donnée. | Objet complexe |
RatingValue |
L'une des valeurs possibles de notes pour évaluer un avis. | Nombre entier (4 octets) |
TagDistribution |
Un bloc de statistiques qui montrent quelles balises ont été choisies par les évaluateurs lors de leur évaluation, ainsi que leur nombre. | Objet complexe |
TagDimension |
Une dimension permettant d'identifier un avis par un mot-clé, comme les points forts, les points faibles ou les qualités d'un produit. Attributs :
|
Objet complexe |
TagDistributionItems |
Contient un ensemble de balises uniques sélectionnées pour cette dimension de balise (tel qu'une liste de points forts groupés par valeurs uniques afin de calculer les décomptes). | Objet complexe (séquence d'éléments TagDistributionItem ) |
TagDistributionItem |
Représente la seule balise décrite par un libellé et le nombre de fois qu'elle a été utilisée dans des avis sur ce produit (élément Count ). |
Objet complexe (une description de ces champs est fournie dans ce tableau) |
LocaleDistribution |
Contient les statistiques regroupées par langue. Il s'agit de la liste des langues et des statistiques pour leurs avis. | Objet complexe (séquence d'éléments LocaleDistributionItem ) |
LocaleDistributionItem |
Cette entrée de la structure LocaleDistribution contient une clé (valeur DisplayLocale ) et une valeur (bloc ReviewStatistics ). |
Objet complexe (une description de ces champs est fournie dans ce tableau) |
DisplayLocale |
Une langue dans laquelle un certain nombre d'avis ont été soumis pour ce produit. | Chaîne (25 caractères maximum) |
ReviewStatistics |
Bloc de statistiques d'avis qui contient des chiffres et des statistiques sur les avis pour une langue d'affichage donnée (la même structure que celle que nous décrivons, mais les statistiques ne seront pas distribuées par langue). Cet élément XML est récursif. | Objet complexe (décrit dans cette section) |
Count |
Nombre d'avis qui possèdent une certaine qualité, balise ou note (en fonction de la place de l'élément XML Count ). |
Nombre entier (4 octets) |
QAStatistics |
Bloc contenant les statistiques sur les questions et réponses d'un même utilisateur. | Objet complexe (décrit dans cette section) |
ReviewCommentStatistics |
Bloc contenant les statistiques sur tous les commentaires sur l'avis d'un utilisateur. | Objet complexe (décrit dans cette section) |
TotalQuestionsCount |
Nombre de questions approuvées envoyées par un utilisateur. | Nombre entier (4 octets) |
TotalAnswersCount |
Nombre de réponses approuvées envoyées par un utilisateur. | Nombre entier (4 octets) |
QuestionHelpfulVoteCount |
Nombre de votes « Utile » récoltés par toutes les questions approuvées d'un utilisateur. | Nombre entier (4 octets) |
QuestionNotHelpfulVoteCount |
Nombre de votes « Inutile » récoltés par toutes les questions approuvées d'un utilisateur. | Nombre entier (4 octets) |
AnswerHelpfulVoteCount |
Nombre de votes « Utile » récoltés par toutes les réponses approuvées d'un utilisateur. | Nombre entier (4 octets) |
AnswerNotHelpfulVoteCount |
Nombre de votes « Inutile » récoltés par toutes les réponses approuvées d'un utilisateur. | Nombre entier (4 octets) |
HelpfulVoteCount |
Nombre total de votes « Utile » récoltés par le contenu approuvé d'un même type et publié par un utilisateur. | Nombre entier (4 octets) |
NotHelpfulVoteCount |
Nombre total de votes « Inutile » récoltés par le contenu approuvé d'un même type et publié par un utilisateur. | Nombre entier (4 octets) |
FeaturedQuestionsCount |
Nombre de questions d'un utilisateur marquées comme « Remarquables » dans l'affichage du client. | Nombre entier (4 octets) |
FeaturedAnswersCount |
Nombre de réponses d'un utilisateur marquées comme « Remarquables » dans l'affichage du client. | Nombre entier (4 octets) |
FeaturedCommentCount |
Nombre de commentaires d'un utilisateur marquées comme « Remarquables » dans l'affichage du client. | Nombre entier (4 octets) |
BestAnswersCount |
Nombre de réponses d'un utilisateur marquées comme « Meilleures » pour une question donnée. | Nombre entier (4 octets) |
FirstQuestionTime |
Date et heure de la première question envoyée par un utilisateur donné. | Date (code temporel) |
LastQuestionTime |
Date et heure de la dernière question envoyée par un utilisateur donné. | Date (code temporel) |
FirstAnswerTime |
Date et heure de la première question envoyée par un utilisateur donné. | Date (code temporel) |
LastAnswerTime |
Date et heure de la dernière question envoyée par un utilisateur donné. | Date (code temporel) |
LastQuestionAnswerDate |
Date et heure de la dernière question ou réponse envoyée par un utilisateur donné. | Date (code temporel) |
FirstSubmissionTime |
Date et heure du premier envoi d'un certain type de contenu, pour un utilisateur donné. | Date (code temporel) |
LastSubmissionTime |
Date et heure du dernier envoi d'un certain type de contenu, pour un utilisateur donné. | Date (code temporel) |
NumComments |
Nombre total de commentaires approuvés, envoyés par un utilisateur donné. | Nombre entier (4 octets) |
Exemple
<Product id="Product1234"> ... <ReviewStatistics> <AverageOverallRating>4.5</AverageOverallRating> <OverallRatingRange>5</OverallRatingRange> <TotalReviewCount>4</TotalReviewCount> <RatingsOnlyReviewCount>1</RatingsOnlyReviewCount> <RecommendedCount>4</RecommendedCount> <AverageRatingValues> <AverageRatingValue id="EaseOfUse"> <AverageRating>3.7</AverageRating> <RatingDimension id="EaseOfUse" displayType="NORMAL" selectedValueInDisplayEnabled="true"> <ExternalId>EaseOfUse</ExternalId> <RatingRange>5</RatingRange> <Label>Ease of use</Label> <Label1>Ease of use</Label1> </RatingDimension> </AverageRatingValue> <AverageRatingValue id="Quality"> <AverageRating>4.35</AverageRating> <RatingDimension id="Quality" displayType="SLIDER"> <ExternalId>Quality</ExternalId> <RatingRange>5</RatingRange> <Label>Product Quality</Label> </RatingDimension> </AverageRatingValue> ... </AverageRatingValues> <RatingDistribution> <RatingDistributionItem> <RatingValue>5</RatingValue> <Count>3</Count> </RatingDistributionItem> <RatingDistributionItem> <RatingValue>3</RatingValue> <Count>1</Count> </RatingDistributionItem> ... </RatingDistribution> <TagDistribution> ... <TagDimension id="Pro"> <ExternalId>Pro</ExternalId> <Label>Pros</Label> <TagDistributionItems> <TagDistributionItem> <Label>Nice sound</Label> <Count>5</Count> </TagDistributionItem> <TagDistributionItem> <Label>Relaxation</Label> <Count>3</Count> </TagDistributionItem> <TagDistributionItem> <Label>Entertaining Guests</Label> <Count>2</Count> </TagDistributionItem> <TagDistributionItem> <Label>Great production quality</Label> <Count>2</Count> </TagDistributionItem> <TagDistributionItem> <Label>Nothing</Label> <Count>1</Count> </TagDistributionItem> </TagDistributionItems> </TagDimension> ... </TagDistribution> <LocaleDistribution> <LocaleDistributionItem> <DisplayLocale>en_US</DisplayLocale> <ReviewStatistics> <AverageOverallRating> ... </AverageOverallRating> <OverallRatingRange> ... </OverallRatingRange> <TotalReviewCount> ... </TotalReviewCount> <RatingsOnlyReviewCount> ... </RatingsOnlyReviewCount> <RecommendedCount> ... </RecommendedCount> <AverageRatingValues> ... </AverageRatingValues> <RatingDistribution> ... </RatingDistribution> </ReviewStatistics> </LocaleDistributionItem> <LocaleDistributionItem> <DisplayLocale>de_DE</DisplayLocale> <ReviewStatistics> <AverageOverallRating>3.7</AverageOverallRating> <OverallRatingRange>5</OverallRatingRange> <TotalReviewCount>10</TotalReviewCount> <RatingsOnlyReviewCount>0</RatingsOnlyReviewCount> <RecommendedCount>7</RecommendedCount> <AverageRatingValues> ... </AverageRatingValues> <RatingDistribution> ... </RatingDistribution> </ReviewStatistics> </LocaleDistributionItem> ... </LocaleDistribution> </ReviewStatistics> ... </Product> <UserProfile id="something"> ... <!-- This review statistics block is similar to the one in Product element. Refer to the previous example and description in the Review type table. --> <ReviewStatistics> <AverageOverallRating>2.0</AverageOverallRating> <OverallRatingRange>5</OverallRatingRange> <TotalReviewCount>1</TotalReviewCount> <RatingsOnlyReviewCount>0</RatingsOnlyReviewCount> <RecommendedCount>0</RecommendedCount> <NotRecommendedCount>1</NotRecommendedCount> <FeaturedReviewCount>0</FeaturedReviewCount> <HelpfulVoteCount>0</HelpfulVoteCount> <NotHelpfulVoteCount>1</NotHelpfulVoteCount> <FirstSubmissionTime>2010-12-28T17:10:32.000-06:00</FirstSubmissionTime> <LastSubmissionTime>2010-12-28T17:10:32.000-06:00</LastSubmissionTime> <AverageRatingValues/> </ReviewStatistics> <QAStatistics> <TotalQuestionsCount>3</TotalQuestionsCount> <TotalAnswersCount>6</TotalAnswersCount> <QuestionHelpfulVoteCount>26</QuestionHelpfulVoteCount> <QuestionNotHelpfulVoteCount>5</QuestionNotHelpfulVoteCount> <AnswerHelpfulVoteCount>145</AnswerHelpfulVoteCount> <AnswerNotHelpfulVoteCount>2</AnswerNotHelpfulVoteCount> <HelpfulVoteCount>178</HelpfulVoteCount> <FeaturedQuestionsCount>3</FeaturedQuestionsCount> <FeaturedAnswersCount>8</FeaturedAnswersCount> <BestAnswersCount>23</BestAnswersCount> <FirstQuestionTime>2011-11-27T21:00:09.000-06:00</FirstQuestionTime> <LastQuestionTime>2011-11-27T21:00:09.000-06:00</LastQuestionTime> <FirstAnswerTime>2009-11-18T13:10:38.000-06:00</FirstAnswerTime> <LastAnswerTime>2009-11-18T13:10:38.000-06:00</LastAnswerTime> <LastQuestionAnswerDate>2011-11-27T21:00:09.000-06:00</LastQuestionAnswerDate> </QAStatistics> <ReviewCommentStatistics> <NumComments>23</NumComments> <HelpfulVoteCount>16</HelpfulVoteCount> <NotHelpfulVoteCount>10</NotHelpfulVoteCount> <FeaturedCommentCount>12</FeaturedCommentCount> <FirstSubmissionTime>2011-11-27T21:00:09.000-06:00</FirstSubmissionTime> <LastSubmissionTime>2011-11-27T21:00:09.000-06:00</LastSubmissionTime> </ReviewCommentStatistics> <HelpfulVoteCount>52</HelpfulVoteCount> <NotHelpfulVoteCount>12</NotHelpfulVoteCount> <FeaturedStoryCount>2</FeaturedStoryCount> <FirstSubmissionTime>2011-11-27T21:00:09.000-06:00</FirstSubmissionTime> <LastSubmissionTime>2011-11-27T21:00:09.000-06:00</LastSubmissionTime> <NumComments>6</NumComments> <HelpfulVoteCount>21</HelpfulVoteCount> <NotHelpfulVoteCount>0</NotHelpfulVoteCount> <FeaturedCommentCount>0</FeaturedCommentCount> <FirstSubmissionTime>2011-11-27T21:00:09.000-06:00</FirstSubmissionTime> <LastSubmissionTime>2011-11-27T21:00:09.000-06:00</LastSubmissionTime> ... </UserProfile>
Types de contenus
Bazaarvoice fournit les types de contenus suivants :
Toutes ces collections peuvent être exportées vers le flux client standard.
Les avis
Vous trouverez un exemple à la fin de cette section.
Élément | Description | Type |
---|---|---|
Avis |
Contient les informations sur les avis envoyés pour un produit donné. Attributs :
|
Objet complexe (une description de ces champs est fournie dans ce tableau) |
Statut de modération |
Indique le statut actuel d'un avis donné. Ce champ permet d'indiquer si l'avis attend une action de la part des modérateurs, du CMS, est approuvé ou rejeté. Valeurs possibles : NONE, SUBMITTED, APPROVED, HOLD, PENDING, REJECTED, REMOVEDBYCLIENT, REMOVEDTEST, AUTOMATEDHOLD, EXPIRED. | Enum |
LastModificationTime |
Contient l'heure à laquelle l'auteur ou tout commentaire a modifié l'avis pour la dernière fois. Le code temporel le plus récent sera indiqué. | Date (code temporel) |
Avis les plus utiles |
Marqueur booléen. La valeur est « vrai » si ce contenu est particulièrement intéressant et bien écrit. Attribué pendant la modération. | Booléen |
UserProfileReference / Reviewer / User |
Contient les informations sur le profil d'un utilisateur (voir l'extrait de code pour découvrir tous les champs possibles de ce bloc). En fonction de la version du modèle, le nom du bloc peut varier (soit Reviewer soit User / UserProfileReference). Reportez-vous à la section Les profils d'utilisateur et leurs éléments pour en savoir plus. Attributs :
|
Objet complexe (une description de ses champs est fournie dans ce document) |
RatingsOnly |
Marqueur booléen. La valeur est « vrai » si l'avis a bien été soumis mais ne contient aucun texte ou a été marqué comme RatingsOnly par le CMS (si le nombre de caractères était trop petit pour atteindre le seuil, ce qui peut être configuré à un niveau par client) | Booléen |
Titre |
Contient le titre d'un avis au format spécifié par son auteur. | Chaîne (255 caractères maximum) |
Texte de l'avis |
Contient le texte complet de l'avis tel que rédigé par son auteur. | Chaîne de texte |
DisplayLocale |
Identifie la langue dans laquelle l'avis a été envoyé. | Chaîne (25 caractères maximum) |
ReviewerNickname |
Pseudo choisi par l'auteur de l'avis. | Chaîne (255 caractères maximum) |
ReviewerLocation |
Ville de l'auteur de l'avis. | Chaîne (255 caractères maximum) |
tags |
Contient une liste de dimensions de balises. Reportez-vous à la section Objets contextuels complexes (parties de types de contenu) pour en savoir plus. | Objet complexe (séquence d'éléments TagDimension ) |
AdditionalFields |
Contient une liste de champs supplémentaires éventuellement présents dans l'avis. Reportez-vous à la section Objets contextuels complexes (parties de types de contenu) pour en savoir plus. | Objet complexe (séquence d'éléments AdditionalField ) |
Commentaires |
Contient la liste des commentaires soumis pour un avis donné. Reportez-vous à la section Type de commentaire pour en savoir plus. | Objet complexe (séquence d'éléments Comment ) |
Note |
Une valeur d'évaluation choisie par l'auteur d'un avis (reflète généralement le nombre d'« étoiles ». | Nombre entier (11 octets) |
RatingRange |
Valeur maximum d’une note. Les notes vont de 1 à la valeur spécifiée ici. La valeur par défaut est de 5, mais certains clients préfèrent utiliser des échelles différentes pour leur fonctionnalité Ratings & Reviews. Cette valeur est définie au cours de la phase de configuration du client. | Nombre entier (11 octets) |
Recommandé |
Indique si l'avis porte un indicateur « Recommandé ». Cela signifie que durant la soumission de l'avis, un utilisateur (évaluateur) a confirmé qu'il recommanderait le produit à un ami. | Booléen |
NumFeedbacks |
Nombre de retours sur un avis donné (positifs et négatifs). | Nombre entier (4 octets) |
NumPositiveFeedbacks |
Nombre de retours positifs sur un avis donné. | Nombre entier (4 octets) |
NumNegativeFeedbacks |
Nombre de retours négatifs sur un avis donné. | Nombre entier (4 octets) |
NumInappropriateFeedbacks |
Nombre de fois qu'un avis a été signalé comme inapproprié ou non pertinent par les consommateurs. | Nombre entier (4 octets) |
Net Promoter Score |
Cette valeur est un nombre entier compris entre 1 et 10 qui représente la réponse à une question telle que « Comment évalueriez-vous cette entreprise ? » ou « Quelle note donneriez-vous à ce produit ? » | Nombre entier (11 octets) |
NetPromoterComment |
Commentaire accompagnant un NetPromoterScore et expliquant la note. | Chaîne de texte |
UserEmailAddress |
Si le client préfère ajouter les données PII dans le flux, ce champ doit être inclus. Il s'agit de l'adresse e-mail de l'utilisateur (auteur de l'avis). | Chaîne (255 caractères maximum) |
SendEmailAlertWhenPublished |
Valeur booléenne qui indique si l'utilisateur a choisi d'être notifié par e-mail lorsque son avis est publié. | Booléen |
SendEmailAlertWhenCommented |
Valeur booléenne qui indique si l'utilisateur a choisi d'être informé par e-mail lorsque son avis reçoit des commentaires. | Booléen |
SendEmailAlertWhenCommentedOptOutURL |
Contient l'URL OptOut qui peut être envoyée à un utilisateur pour qu'il puisse se désabonner des communications par e-mail. Remarque : si l'URL contient un caractère réservé (spécial), vous devez encoder en URL le caractère. Ainsi, utilisez
& pour remplacer une esperluette, %20 pour un espace ou encore %5B et %5D pour les crochets ([ ]). |
URL / chaîne (255 caractères max) |
ProductReviewsUrl |
URL qui redirige vers la page d'avis d'un produit et met en surbrillance un avis donné. Remarque : si l'URL contient un caractère réservé (spécial), vous devez encoder en URL le caractère. Ainsi, utilisez
& pour remplacer une esperluette, %20 pour un espace ou encore %5B et %5D pour les crochets ([ ]). |
URL / chaîne (255 caractères max) |
ProductReviewsDeepLinkedUrl |
URL qui redirige directement vers un avis donné. Remarque : si l'URL contient un caractère réservé (spécial), vous devez encoder en URL le caractère. Ainsi, utilisez
& pour remplacer une esperluette, %20 pour un espace ou encore %5B et %5D pour les crochets ([ ]). |
URL / chaîne (255 caractères max) |
ContextDataValues |
Contient plusieurs valeurs de contexte choisies par l'utilisateur ayant rédigé l'avis (comme son âge, ses habitudes de consommation, son expérience du produit). Reportez-vous à la section Objets contextuels complexes (parties de types de contenu) pour en savoir plus. | Objet complexe (séquence d'éléments ContextDataValue ) |
RatingValues |
Contient la liste des notes secondaires (notes attribuées par l'auteur à des dimensions ou qualités d'un produit ou d'un service). Reportez-vous à la section Objets contextuels complexes (parties de types de contenu) pour en savoir plus. | Objet complexe (séquence d'éléments RatingValue ) |
Photos |
Un ensemble de références photo dotées de légendes. Reportez-vous à la section Objets contextuels complexes (parties de types de contenu) pour en savoir plus. | Objet complexe (séquence d'éléments Photo ) |
Videos |
Un ensemble de références vidéo dotées de légendes. Reportez-vous à la section Objets contextuels complexes (parties de types de contenu) pour en savoir plus. | Objet complexe (séquence d'éléments Video ) |
ClientComments |
Contient la liste des commentaires soumis par le personnel du client par rapport à un avis donné. Reportez-vous à la section Objets contextuels complexes (parties de types de contenu) pour en savoir plus. | Objet complexe (séquence d'éléments ClientComment ) |
NumComments |
Nombre de commentaires approuvés pour un avis donné. | Nombre entier (4 octets) |
SubmissionTime |
Heure d'envoi d'un avis donné par son auteur (avant le processus de modération). | Date (code temporel) |
campaignId |
Chaîne de texte qui indique la source d'un avis, comme la plateforme ou les origines. Consultez cette liste d'identifiants de campagne pour en savoir plus. | Chaîne (255 caractères maximum) |
AuthenticationType |
Le type d'authentification de l'auteur de l'avis. Valeurs possibles : SITE, FACEBOOK ou EMAIL. | Enum |
ProductReferences |
Contient la liste des références produits associées à un avis. Reportez-vous à la section Objets contextuels complexes (parties de types de contenu) pour en savoir plus. | Objet complexe (séquence d'éléments ProductReference ) |
Badges |
Contient une liste de badges attribués à un avis ou à son auteur. Reportez-vous à la section Objets contextuels complexes (parties de types de contenu) pour en savoir plus. | Objet complexe (séquence d'éléments Badge ) |
IpAddress |
Contient l'adresse IP de l'auteur. Ce champ est un champ de données PII, qui peut être activé ou non. | Chaîne (255 caractères maximum) |
OriginatingDisplayCode |
Identifie la configuration d'affichage du client utilisée pour l'envoi d'un avis donné. | Chaîne (25 caractères maximum) |
ContentCodes |
Contient une chaîne de codes de contenu, séparés par des espaces. Chaque code est attribué pendant la modération et transmet des informations sur le contenu, comme par exemple s'il fait référence à un concurrent ou le motif de l'approbation ou du rejet de l'avis. | Chaîne de texte |
ClientResponses |
Contient la liste des réponses du client à cet avis. Celles-ci sont généralement envoyées via le Workbench. Reportez-vous à la section Objets contextuels complexes (parties de types de contenu) pour en savoir plus. | Objet complexe (séquence d'éléments ClientResponse ) |
FirstPublishTime |
Date et heure de la première publication de l'avis en question (il arrive que l'avis soit publié plusieurs fois en raison du processus de modération). | Date (code temporel) |
LastPublishTime |
Date et heure de la dernière publication de l'avis en question (il arrive que l'avis soit publié plusieurs fois en raison du processus de modération). | Date (code temporel) |
Exemple
<Reviews> ... <Review id="46605115"> <ModerationStatus>APPROVED</ModerationStatus> <SubmissionTime>2013-02-14T23:23:06.000-06:00</SubmissionTime> <LastModificationTime>2013-02-16T19:30:06.000-06:00</LastModificationTime> <UserProfileReference id="z2qs1pvkj7x282z0rg0zvfx2fp"> <ExternalId>z2qs1pvkj7x282z0rg0zvfx2fp</ExternalId> <DisplayName>IAmMusician</DisplayName> <Anonymous>false</Anonymous> <HyperlinkingEnabled>false</HyperlinkingEnabled> </UserProfileReference> <Featured>false</Featured> <DisplayLocale>en_US</DisplayLocale> <RatingsOnly>false</RatingsOnly> <Title>Great guitar! Worth every penny!</Title> <ReviewText>Bought this great 12-strings acoustic guitar in the NAT color. Got half price off as it'd been in store for few years. Condition is excellent and it sounds great.</ReviewText> <ReviewerNickname>PowerMan332</ReviewerNickname> <ReviewerLocation>Overland Park, KS</ReviewerLocation> <Rating>5</Rating> <RatingRange>5</RatingRange> <Recommended>true</Recommended> <NumFeedbacks>3</NumFeedbacks> <NumPositiveFeedbacks>2</NumPositiveFeedbacks> <NumNegativeFeedbacks>1</NumNegativeFeedbacks> <NumInappropriateFeedbacks>1</NumInappropriateFeedbacks> <NetPromoterScore>10</NetPromoterScore> <NetPromoterComment>High quality. Know that this guitar will serve me well.</NetPromoterComment> <UserEmailAddress>PowerMan332@gmail.com</UserEmailAddress> <SendEmailAlertWhenPublished>false</SendEmailAlertWhenPublished> <SendEmailAlertWhenCommented>true</SendEmailAlertWhenCommented> <SendEmailAlertWhenCommentedOptOutURL>http://reviews.GUITARSTORECLIENT.com/displayCode/productId/review/46605115/startunsubscribecommentedreview.htm?signature=16982abb3fdf31d2500aaa237560d3073234373939333037</SendEmailAlertWhenCommentedOptOutURL> <ProductReviewsUrl>http://rCampaignIdeviews.GUITARSTORECLIENT.com/<displayCode>/<ProductID>/reviews.htm?reviewID=46605115</ProductReviewsUrl> <ProductReviewsDeepLinkedUrl>http://reviews.GUITARSTORECLIENT.com/<displayCode>/<ProductID>/review/46605115/redirect.htm</ProductReviewsDeepLinkedUrl> <NumComments>0</NumComments> <CampaignId>BV_REVIEW_DISPLAY</CampaignId> <AuthenticationType>SITE</AuthenticationType> <IpAddress>172.0.0.1</IpAddress> <OriginatingDisplayCode>1234-en_us</OriginatingDisplayCode> <ContentCodes>IU ABC</ContentCodes> <FirstPublishTime>2013-02-16T19:30:06.000-06:00</FirstPublishTime> <LastPublishTime>2013-02-16T19:30:06.000-06:00</LastPublishTime> <!-- Following elements are described in other sections of this doc. <ClientResponses> <ClientResponse> ... </ClientResponse> ... </ClientResponses> <ContextDataValues> <ContextDataValue id="25to34"> ... </ContextDataValue> ... </ContextDataValues> <RatingValues> <RatingValue> ... </RatingValue> ... </RatingValues> <Photos> <Photo id="104358"> ... </Photo> ... </Photos> <Videos> <Video> ... </Video> ... </Videos> <ClientComments> <ClientComment> ... </ClientComment> ... </ClientComments> <Tags> <TagDimension id="Pros"> ... </TagDimension> ... </Tags> <AdditionalFields> <AdditionalField id="SpringDealer"> ... </AdditionalField> ... </AdditionalFields> <Comments> <Comment id="26859"> ... </Comment> ... </Comments> <ProductReferences> <ProductReference> ... </ProductReference> ... </ProductReferences> <Badges> <Badge> ... </Badge> ... </Badges> </Review> ... </Reviews>
Les questions
Vous trouverez un exemple à la fin de cette section.
Élément | Description | Type |
---|---|---|
Question |
Contient les informations sur l'une des questions envoyées pour un produit donné. Attributs :
|
Objet complexe (une description de ces champs est fournie dans ce tableau) |
Statut de modération |
Indique le statut actuel d'une question donnée. Ce champ permet d'indiquer si la question est en attente d'une action de la part des modérateurs, du CMS, est approuvée ou rejetée. Valeurs possibles : NONE, SUBMITTED, APPROVED, HOLD, PENDING, REJECTED, REMOVEDBYCLIENT, REMOVEDTEST, AUTOMATEDHOLD, EXPIRED. | Enum |
LastModificationTime |
Contient l'heure à laquelle l'auteur ou les réponses ont modifié cette question pour la dernière fois. Le code temporel le plus récent sera indiqué. | Date (code temporel) |
SubmissionTime |
Heure d'envoi d'une question donnée par son auteur (avant le processus de modération). | Date (code temporel) |
NumFeedbacks |
Nombre de retours sur une question donnée (positifs et négatifs). | Nombre entier (4 octets) |
NumPositiveFeedbacks |
Nombre de retours positifs envoyés sur une question. | Nombre entier (4 octets) |
NumNegativeFeedbacks |
Nombre de retours négatifs envoyés sur une question. | Nombre entier (4 octets) |
NumInappropriateFeedbacks |
Nombre de fois que cette question a été signalée comme inappropriée ou non pertinente par les consommateurs. | Nombre entier (4 octets) |
Pseudo de l'utilisateur |
Pseudo choisi par l'auteur de la question. | Chaîne (255 caractères maximum) |
UserLocation |
Ville de l'auteur de la question. | Chaîne (255 caractères maximum) |
UserEmailAddress |
Il s'agit de l'adresse e-mail de l'utilisateur (auteur de l'avis). Si le client préfère inclure les données PII dans le flux, alors ce champ doit être renseigné. | Chaîne (255 caractères maximum) |
Résumé des questions |
Le résumé d'une question donnée. | Chaîne (255 caractères maximum) |
Détails de la question |
Le corps de la question. | Chaîne de texte |
Nombre de réponses |
Nombre de réponses soumises et approuvées pour cette question. | Nombre entier (4 octets) |
AuthenticationType |
Indique le type d'authentification utilisé par un utilisateur donné (auteur de la question). Valeurs possibles : SITE, FACEBOOK ou EMAIL. | Enum |
SendEmailAlertWhenPublished |
Valeur booléenne qui indique si l'utilisateur choisit d'être informé par e-mail lorsque sa question est publiée. | Booléen |
SendEmailAlertWhenAnswered |
Valeur booléenne qui indique si l'utilisateur choisit d'être informé par e-mail lorsque sa question reçoit des commentaires. | Booléen |
SendEmailAlertWhenAnsweredOptOutURL |
Contient l'URL OptOut qui peut être envoyée à un utilisateur pour qu'il puisse se désabonner des communications par e-mail. Remarque : si l'URL contient un caractère réservé (spécial), vous devez encoder en URL le caractère. Ainsi, utilisez
& pour remplacer une esperluette, %20 pour un espace ou encore %5B et %5D pour les crochets ([ ]). |
URL / chaîne (255 caractères max) |
SubjectQuestionsUrl |
URL qui redirige vers la page de questions d'un produit et met en surbrillance la question donnée. Remarque : si l'URL contient un caractère réservé (spécial), vous devez encoder en URL le caractère. Ainsi, utilisez
& pour remplacer une esperluette, %20 pour un espace ou encore %5B et %5D pour les crochets ([ ]). |
URL / chaîne (255 caractères max) |
SubjectQuestionsDeepLinkedUrl |
URL qui redirige directement vers la question. Remarque : si l'URL contient un caractère réservé (spécial), vous devez encoder en URL le caractère. Ainsi, utilisez
& pour remplacer une esperluette, %20 pour un espace ou encore %5B et %5D pour les crochets ([ ]). |
URL / chaîne (255 caractères max) |
IpAddress |
Contient l'adresse IP d'un auteur. Ce champ est un champ de données PII, qui peut être activé ou non. | Chaîne (255 caractères maximum) |
DisplayLocale |
Identifie la langue dans laquelle l'avis a été envoyé. | Chaîne (25 caractères maximum) |
ContentCodes |
Contient une chaîne de codes de contenu, séparés par des espaces. Chaque code est attribué pendant la modération et transmet des informations sur le contenu, comme par exemple s'il fait référence à un concurrent ou le motif de l'approbation ou du rejet de la question. | Chaîne de texte |
campaignId |
Indique l'origine de la question, comme la plateforme par exemple, ou les origines. Reportez-vous à cette liste d'identifiants de campagne fournis avec Ratings & Reviews. | Chaîne (255 caractères maximum) |
OriginatingDisplayCode |
Identifie la configuration d'affichage du client utilisée pour l'envoi d'une question donnée. | Chaîne (25 caractères maximum) |
FirstPublishTime |
Date et heure de la première publication de cette question (il arrive qu'une réponse soit publiée plusieurs fois en raison du processus de modération). | Date (code temporel) |
LastPublishTime |
Date et heure de la dernière publication de cette question (il arrive qu'une réponse soit publiée plusieurs fois en raison du processus de modération). | Date (code temporel) |
UserProfileReference / Reviewer / User |
Contient les informations sur le profil d'un utilisateur (voir l'extrait de code pour découvrir tous les champs possibles de ce bloc). En fonction de la version du modèle, le nom du bloc peut varier (soit Reviewer soit User / UserProfileReference). Reportez-vous à la section Les profils d'utilisateur et leurs éléments pour en savoir plus. Attributs :
|
Objet complexe (une description de ses champs est fournie dans ce document) |
Answers |
Contient les réponses à la question. Reportez-vous à la section Type de réponse pour en savoir plus. | Objet complexe (séquence d'éléments Answer ) |
ContextDataValues |
Contient plusieurs valeurs de contexte choisies par l'utilisateur (comme son âge, ses habitudes de consommation, son expérience du produit). Reportez-vous à la section Objets contextuels complexes (parties de types de contenu) pour en savoir plus. | Objet complexe (séquence d'éléments ContextDataValue ) |
Photos |
Un ensemble de références photo dotées de légendes. Reportez-vous à la section Objets contextuels complexes (parties de types de contenu) pour en savoir plus. | Objet complexe (séquence d'éléments Photo ) |
Videos |
Un ensemble de références vidéo dotées de légendes. Reportez-vous à la section Objets contextuels complexes (parties de types de contenu) pour en savoir plus. | Objet complexe (séquence d'éléments Video ) |
tags |
Contient une liste de dimensions de balises. Reportez-vous à la section Objets contextuels complexes (parties de types de contenu) pour en savoir plus. | Objet complexe (séquence d'éléments TagDimension ) |
AdditionalFields |
Contient une liste de champs supplémentaires éventuellement présents dans la question. Reportez-vous à la section Objets contextuels complexes (parties de types de contenu) pour en savoir plus. | Objet complexe (séquence d'éléments AdditionalField ) |
ProductReferences |
Contient la liste des références produits associées à une question. Reportez-vous à la section Objets contextuels complexes (parties de types de contenu) pour en savoir plus. | Objet complexe (séquence d'éléments ProductReference ) |
Badges |
Contient une liste de badges attribués à une question ou à son auteur. Reportez-vous à la section Objets contextuels complexes (parties de types de contenu) pour en savoir plus. | Objet complexe (séquence d'éléments Badge ) |
Exemple
<Question id="313672"> <ModerationStatus>APPROVED</ModerationStatus> <LastModificationTime>2015-10-11T02:18:18.000-05:00</LastModificationTime> <SubmissionTime>2011-09-30T11:35:41.000-05:00</SubmissionTime> <NumFeedbacks>3</NumFeedbacks> <NumPositiveFeedbacks>2</NumPositiveFeedbacks> <NumNegativeFeedbacks>1</NumNegativeFeedbacks> <NumInappropriateFeedbacks>0</NumInappropriateFeedbacks> <UserNickname>CertainSomeone</UserNickname> <UserLocation>Southern California</UserLocation> <UserEmailAddress>email@emailprovider.com</UserEmailAddress> <QuestionSummary>Would someone compare this model to previous years ones? I'm trying to figure out which one makes the most sense for business</QuestionSummary> <QuestionDetails>from a comfort or classy look point of view.</QuestionDetails> <NumAnswers>3</NumAnswers> <AuthenticationType>SITE</AuthenticationType> <SendEmailAlertWhenPublished>true</SendEmailAlertWhenPublished> <SendEmailAlertWhenAnswered>true</SendEmailAlertWhenAnswered> <SendEmailAlertWhenAnsweredOptOutURL> http://answers.<clientName>.com/answers/<displayCode>/product/<productId>/question/<questionId>/startunsubscribeansweredquestion.htm?signature=<encryptedId> </SendEmailAlertWhenAnsweredOptOutURL> <SubjectQuestionsUrl>http://answers.<clientName>.com/answers/<displayCode>/product/>productId>/questions.htm</SubjectQuestionsUrl> <IpAddress>172.0.0.1</IpAddress> <DisplayLocale>en_US</DisplayLocale> <CampaignId>BV_QA_BROWSE</CampaignId> <ContentCodes>ABC DEF GHI</ContentCodes> <OriginatingDisplayCode>1234-displayCode</OriginatingDisplayCode> <FirstPublishTime>2011-09-30T15:45:09.000-05:00</FirstPublishTime> <LastPublishTime>2011-09-30T15:45:09.000-05:00</LastPublishTime> <!-- Following elements are described in other sections of this doc. Refer to the Answer type section for more details. --> <UserProfileReference id="z3hwgfu60z8tg9qwybfhv9qg1g"> ... </UserProfileReference> <Answers> <Answer id="466688"> ... </Answer> </Answers> <ContextDataValues> <ContextDataValue id="25to34"> ... </ContextDataValue> ... </ContextDataValues> <Photos> <Photo id="104358"> ... </Photo> ... </Photos> <Videos> <Video> ... </Video> ... </Videos> <Tags> <TagDimension id="Pros"> ... </TagDimension> ... </Tags> <AdditionalFields> <AdditionalField id="SpringDealer"> ... </AdditionalField> ... </AdditionalFields> <ProductReferences> <ProductReference> ... </ProductReference> ... </ProductReferences> <Badges> <Badge> ... </Badge> ... </Badges> </Question>
Les réponses
Vous trouverez un exemple à la fin de cette section.
Élément | Description | Type |
---|---|---|
Réponse |
Contient les informations sur l'une des réponses envoyées pour une question donnée. Attributs :
|
Objet complexe (une description de ces champs est fournie dans ce tableau) |
Statut de modération |
Contient les informations sur le statut actuel d'une réponse donnée. Ce champ permet d'indiquer si une réponse est en attente d'une action de la part des modérateurs, du CMS, est approuvée ou rejetée. Valeurs possibles : NONE, SUBMITTED, APPROVED, HOLD, PENDING, REJECTED, REMOVEDBYCLIENT, REMOVEDTEST, AUTOMATEDHOLD, EXPIRED. | Enum |
LastModificationTime |
Cet élément contient l'heure à laquelle l'auteur a modifié son commentaire pour la dernière fois. Le code temporel le plus récent sera indiqué. | Date (code temporel) |
SubmissionTime |
Heure d'envoi d'une réponse par son auteur (avant le processus de modération). | Date (code temporel) |
NumFeedbacks |
Nombre de retours sur une réponse donnée (positifs et négatifs). | Nombre entier (4 octets) |
NumPositiveFeedbacks |
Nombre de retours positifs envoyés sur une réponse. | Nombre entier (4 octets) |
NumNegativeFeedbacks |
Nombre de retours négatifs envoyés sur une réponse. | Nombre entier (4 octets) |
NumInappropriateFeedbacks |
Nombre de fois qu'une réponse a été signalée comme inappropriée ou non pertinente par les consommateurs. | Nombre entier (4 octets) |
Pseudo de l'utilisateur |
Pseudo choisi par l'auteur d'une réponse. | Chaîne (255 caractères maximum) |
UserLocation |
Ville de l'auteur de la réponse. | Chaîne (255 caractères maximum) |
UserEmailAddress |
Il s'agit de l'adresse e-mail de l'utilisateur (auteur de l'avis). Si le client préfère inclure les données PII dans le flux, alors ce champ doit être renseigné. | Chaîne (255 caractères maximum) |
Texte de réponse |
Le texte de la réponse à une question. | Chaîne de texte |
AuthenticationType |
Spécifie le type d'authentification de l'auteur de la réponse. Valeurs possibles : SITE, FACEBOOK ou EMAIL. | Enum |
SendEmailAlertWhenPublished |
Indique si l'utilisateur a choisi d'être informé par e-mail lorsque sa réponse est publiée. | Booléen |
SubjectAnswersDeepLinkedUrl |
URL qui redirige directement vers une réponse donnée. Remarque : si l'URL contient un caractère réservé (spécial), vous devez encoder en URL le caractère. Ainsi, utilisez
& pour remplacer une esperluette, %20 pour un espace ou encore %5B et %5D pour les crochets ([ ]). |
URL / chaîne (255 caractères max) |
IpAddress |
Contient l'adresse IP d'un auteur. Ce champ est un champ de données PII, qui peut être activé ou non. | Chaîne (255 caractères maximum) |
DisplayLocale |
Contient la langue dans laquelle la réponse a été envoyée. | Chaîne (25 caractères maximum) |
ContentCodes |
Contient une chaîne de codes de contenu, séparés par des espaces. Chaque code est attribué pendant la modération et transmet des informations sur le contenu, comme par exemple s'il fait référence à un concurrent ou le motif de l'approbation ou du rejet de la question. | Chaîne de texte |
campaignId |
Indique l'origine de la réponse, comme la plateforme par exemple, ou les origines Consultez cette liste d'identifiants de campagne pour en savoir plus. | Chaîne (255 caractères maximum) |
OriginatingDisplayCode |
Identifie la configuration d'affichage du client utilisée pour l'envoi d'une réponse donnée. | Chaîne (25 caractères maximum) |
FirstPublishTime |
Date et heure de la première publication de cette réponse (il arrive qu'une réponse soit publiée plusieurs fois en raison du processus de modération). | Date (code temporel) |
LastPublishTime |
Date et heure de la dernière publication de cette réponse (il arrive qu'une réponse soit publiée plusieurs fois en raison du processus de modération). | Date (code temporel) |
UserProfileReference / Reviewer / User |
Contient les informations sur le profil d'un utilisateur (se référer à l'extrait de code pour découvrir tous les champs possibles de ce bloc). En fonction de la version du modèle, le nom du bloc peut varier (soit Reviewer soit User / UserProfileReference). Reportez-vous à la section Les profils d'utilisateur et leurs éléments pour en savoir plus. Attributs :
|
Objet complexe (une description de ses champs est fournie dans ce document) |
ContextDataValues |
Contient plusieurs valeurs de contexte choisies par l'utilisateur ayant rédigé l'avis (comme son âge, ses habitudes de consommation, son expérience du produit). Reportez-vous à la section Objets contextuels complexes (parties de types de contenu) pour en savoir plus. | Objet complexe (séquence d'éléments ContextDataValue ) |
Photos |
Un ensemble de références photo dotées de légendes. Reportez-vous à la section Objets contextuels complexes (parties de types de contenu) pour en savoir plus. | Objet complexe (séquence d'éléments Photo ) |
Videos |
Un ensemble de références vidéo dotées de légendes. Reportez-vous à la section Objets contextuels complexes (parties de types de contenu) pour en savoir plus. | Objet complexe (séquence d'éléments Video ) |
AdditionalFields |
Contient une liste de champs supplémentaires éventuellement présents dans la réponse. Reportez-vous à la section Objets contextuels complexes (parties de types de contenu) pour en savoir plus. | Objet complexe (séquence d'éléments AdditionalField ) |
ProductReferences |
Contient la liste des références produits associées à une réponse. Reportez-vous à la section Objets contextuels complexes (parties de types de contenu) pour en savoir plus. | Objet complexe (séquence d'éléments ProductReference ) |
Badges |
Contient une liste de badges attribués à une réponse ou à son auteur. Reportez-vous à la section Objets contextuels complexes (parties de types de contenu) pour en savoir plus. | Objet complexe (séquence d'éléments Badge ) |
Exemple
<Answer id="466688"> <ModerationStatus>APPROVED</ModerationStatus> <LastModificationTime>2015-10-11T02:18:18.000-05:00</LastModificationTime> <SubmissionTime>2011-09-30T11:35:41.000-05:00</SubmissionTime> <NumFeedbacks>3</NumFeedbacks> <NumPositiveFeedbacks>2</NumPositiveFeedbacks> <NumNegativeFeedbacks>1</NumNegativeFeedbacks> <NumInappropriateFeedbacks>0</NumInappropriateFeedbacks> <UserNickname>CertainSomeone</UserNickname> <UserLocation>Southern California</UserLocation> <UserEmailAddress>email@emailprovider.com</UserEmailAddress> <AnswerText> A huge answer for a given question goes here. Yadda yadda yadda. </AnswerText> <AuthenticationType>SITE</AuthenticationType> <SendEmailAlertWhenPublished>true</SendEmailAlertWhenPublished> <IpAddress>172.0.0.1</IpAddress> <DisplayLocale>en_US</DisplayLocale> <CampaignId>BV_QA_BROWSE</CampaignId> <ContentCodes>ABC DEF GHI</ContentCodes> <OriginatingDisplayCode>1234-displayCode</OriginatingDisplayCode> <FirstPublishTime>2011-09-30T15:45:09.000-05:00</FirstPublishTime> <LastPublishTime>2011-09-30T15:45:09.000-05:00</LastPublishTime> <!-- Following elements are described in other sections of this doc. Refer to the Comment type section for more details. --> <UserProfileReference id="z3hwgfu60z8tg9qwybfhv9qg1g"> ... </UserProfileReference> <ContextDataValues> <ContextDataValue id="25to34"> ... </ContextDataValue> ... </ContextDataValues> <Photos> <Photo id="104358"> ... </Photo> ... </Photos> <Videos> <Video> ... </Video> ... </Videos> <AdditionalFields> <AdditionalField id="SpringDealer"> ... </AdditionalField> ... </AdditionalFields> <ProductReferences> <ProductReference> ... </ProductReference> ... </ProductReferences> <Badges> <Badge> ... </Badge> ... </Badges> </Answer>
Les commentaires
Vous trouverez un exemple à la fin de cette section.
Élément | Description | Type |
---|---|---|
Comment |
Contient des informations sur le commentaire envoyé sur un avis. Attributs :
|
Objet complexe (une description de ces champs est fournie dans ce tableau) |
Statut de modération |
Indique le statut actuel d'un commentaire donné. Ce champ permet d'indiquer si le commentaire est en attente d'une action de la part des modérateurs, du CMS, est approuvé ou rejeté. Valeurs possibles : NONE, SUBMITTED, APPROVED, HOLD, PENDING, REJECTED, REMOVEDBYCLIENT, REMOVEDTEST, AUTOMATEDHOLD, EXPIRED. | Enum |
LastModificationTime |
Contient l'heure à laquelle l'auteur a modifié son commentaire pour la dernière fois. Le code temporel le plus récent sera indiqué. | Date (code temporel) |
SubmissionTime |
Heure d'envoi d'un commentaire donné par son auteur (avant le processus de modération). | Date (code temporel) |
NumFeedbacks |
Nombre de retours sur un commentaire donné (positifs et négatifs). | Nombre entier (4 octets) |
NumPositiveFeedbacks |
Nombre de retours positifs sur un commentaire donné. | Nombre entier (4 octets) |
NumNegativeFeedbacks |
Nombre de retours négatifs sur un commentaire donné. | Nombre entier (4 octets) |
NumInappropriateFeedbacks |
Nombre de fois qu'un commentaire a été signalé comme inapproprié ou non pertinent par les consommateurs. | Nombre entier (4 octets) |
Pseudo de l'utilisateur |
Pseudo choisi par l'auteur d'un commentaire. | Chaîne (255 caractères maximum) |
UserLocation |
Ville de l'auteur du commentaire. | Chaîne (255 caractères maximum) |
UserEmailAddress |
Il s'agit de l'adresse e-mail de l'utilisateur (auteur de l'avis). Si le client préfère inclure les données PII dans le flux, alors ce champ doit être renseigné. | Chaîne (255 caractères maximum) |
Titre |
Titre du commentaire. | Chaîne (255 caractères maximum) |
Texte de commentaire |
Le texte du commentaire. | Chaîne de texte |
AuthenticationType |
Spécifie le type d'authentification de l'auteur du commentaire. Valeurs possibles : SITE, FACEBOOK ou EMAIL. | Enum |
SendEmailAlertWhenPublished |
Indique si l'utilisateur a choisi d'être informé par e-mail lorsque son commentaire est publié. | Booléen |
SubjectCommentsDeepLinkedUrl |
URL qui redirige directement vers un commentaire donné. Remarque : si l'URL contient un caractère réservé (spécial), vous devez encoder en URL le caractère. Ainsi, utilisez
& pour remplacer une esperluette, %20 pour un espace ou encore %5B et %5D pour les crochets ([ ]). |
URL / chaîne (255 caractères max) |
IpAddress |
Contient l'adresse IP d'un auteur. Ce champ est un champ de données PII, qui peut être activé ou non. | Chaîne (255 caractères maximum) |
DisplayLocale |
Identifie la langue dans laquelle le commentaire a été envoyé. | Chaîne (25 caractères maximum) |
ContentCodes |
Contient une chaîne de codes de contenu, séparés par des espaces. Chaque code est attribué pendant la modération et transmet des informations sur le contenu, comme par exemple s'il fait référence à un concurrent ou le motif de l'approbation ou du rejet du commentaire. | Chaîne de texte |
campaignId |
Indique l'origine d'un commentaire, comme la plateforme par exemple, ou les origines Consultez cette liste d'identifiants de campagne pour en savoir plus. | Chaîne (255 caractères maximum) |
OriginatingDisplayCode |
Identifie la configuration d'affichage du client utilisée pour l'envoi d'un commentaire donné. | Chaîne (25 caractères maximum) |
FirstPublishTime |
Date et heure de la première publication du commentaire en question (il arrive qu'un commentaire soit publié plusieurs fois en raison du processus de modération). | Date (code temporel) |
LastPublishTime |
Date et heure de la dernière publication du commentaire en question (il arrive qu'un commentaire soit publié plusieurs fois en raison du processus de modération). | Date (code temporel) |
UserProfileReference / Reviewer / User |
Contient les informations sur le profil d'un utilisateur (voir les extraits de code pour découvrir tous les champs possibles de ce bloc). En fonction de la version du modèle, le nom du bloc peut varier (soit Reviewer soit User / UserProfileReference). Reportez-vous à la section Les profils d'utilisateur et leurs éléments pour en savoir plus. Attributs :
|
Objet complexe (une description de ses champs est fournie dans ce document) |
Photos |
Un ensemble de références photo dotées de légendes. Reportez-vous à la section Objets contextuels complexes (parties de types de contenu) pour en savoir plus. | Objet complexe (séquence d'éléments Photo) |
Videos |
Un ensemble de références vidéo dotées de légendes. Reportez-vous à la section Objets contextuels complexes (parties de types de contenu) pour en savoir plus. | Objet complexe (séquence d'éléments Video) |
ProductReferences |
Contient la liste des références produits associées à un commentaire. Reportez-vous à la section Objets contextuels complexes (parties de types de contenu) pour en savoir plus. | Objet complexe (séquence d'éléments ProductReference) |
Badges |
Contient une liste de badges attribués à un commentaire ou à son auteur. Reportez-vous à la section Objets contextuels complexes (parties de types de contenu) pour en savoir plus. | Objet complexe (séquence d'éléments Badge) |
Exemple
<Comment id="57"> <ModerationStatus>REMOVEDBYCLIENT</ModerationStatus> <LastModificationTime>2010-03-11T10:15:04.000-06:00</LastModificationTime> <SubmissionTime>2009-11-06T09:09:07.000-06:00</SubmissionTime> <NumFeedbacks>3</NumFeedbacks> <NumPositiveFeedbacks>0</NumPositiveFeedbacks> <NumNegativeFeedbacks>3</NumNegativeFeedbacks> <NumInappropriateFeedbacks>0</NumInappropriateFeedbacks> <UserNickname>wife4life</UserNickname> <UserLocation>North Carolina</UserLocation> <UserEmailAddress>some@email.com</UserEmailAddress> <Title>Nice stuff</Title> <CommentText>Why do men do this? My husband is the same way. Yadda yadda yadda.</CommentText> <SendEmailAlertWhenPublished>false</SendEmailAlertWhenPublished> <IpAddress>172.0.0.1</IpAddress> <DisplayLocale>en_US</DisplayLocale> <OriginatingDisplayCode>1234-code</OriginatingDisplayCode> <FirstPublishTime>2010-03-11T10:15:04.000-06:00</FirstPublishTime> <LastPublishTime>2010-03-11T10:15:04.000-06:00</LastPublishTime> <!-- Following elements are described in other sections of this doc. Refer to the Complex contextual objects (content types parts) section for more details. --> <UserProfileReference id="z3hwgfu60z8tg9qwybfhv9qg1g"> ... </UserProfileReference> <Photos> <Photo id="104358"> ... </Photo> ... </Photos> <Videos> <Video> ... </Video> ... </Videos> <ProductReferences> <ProductReference> ... </ProductReference> ... </ProductReferences> <Badges> <Badge> ... </Badge> ... </Badges> </Comment>
Objets contextuels complexes (parties de types de contenu)
Ce bloc contient des informations sur les éléments suivants :
- tags
- Badges
- Champs supplémentaires
- Valeurs de données sur le contexte
- Valeurs des notes
- Réponses du client
- Commentaires du client
- Photos
- Videos
- Avatar
- Références du produit
Vous trouverez un exemple à la fin de cette section.
Élément | Description | Type |
---|---|---|
tags |
Contient une liste des dimensions ou des balises (en fonction de leur place). | Objet complexe (séquence d'éléments Tag ou TagDimension ) |
TagDimension |
Une dimension permettant d'identifier un avis par un mot-clé, comme les points forts, les points faibles ou les qualités d'un produit. Attributs :
|
Objet complexe |
ExternalId |
Identifiant d'un objet donné (comme le contenu, le sujet, la dimension ou la balise), unique parmi tous les objets du même type. | Chaîne (255 caractères maximum) |
Label / Label1 |
Décrit une note, une balise ou une dimension. La valeur est reprise dans la configuration du client ou la configuration par défaut (le cas échéant). | Chaîne (255 caractères maximum) |
Ajouter ou supprimer une balise |
Contient un libellé ou une balise que l'auteur a attaché(e) au contenu durant la soumission. | Objet complexe (entoure un élément Label ) |
Badges |
Contient une liste de badges attribués à un contenu ou son auteur. | Objet complexe (séquence d'éléments Badge ) |
Badge |
Un badge attribué à un contenu soit par le client soit par le CMS. | Objet complexe |
Nom |
Nom du badge. Le badge peut être accompagné d'une image sur le site du client à l'aide de cette valeur. | Chaîne (255 caractères maximum) |
Content
type |
Type de contenu auquel appartient le badge. Valeurs possibles : REVIEW, REVIEWER, QUESTION, ANSWER, COMMENT. | Enum |
BadgeType |
Type de badge (des catégories existent). Valeurs possibles : AffiliationBadge, RankBadge, BestAnswerBadge, FeaturedBadge, TopContributorBadge, ReviewerBadge. | Chaîne (255 caractères maximum) |
AdditionalFields |
Contient la liste des champs personnalisés configurés sur la page de soumission d'un avis. | Objet complexe (séquence d'éléments AdditionalField ) |
AdditionalField |
Contient des informations sur un champ supplémentaire et la valeur choisie par l'utilisateur ou l'auteur. | Objet complexe (une description de ces champs est fournie dans ce tableau) |
Libellé affiché |
Contient un libellé qui décrit la signification d'un champ supplémentaire. | Chaîne (255 caractères maximum) |
Valeur |
Valeur choisie par un utilisateur (auteur) pour un champ supplémentaire. | Chaîne (255 caractères maximum) |
ContextDataValues |
Contient plusieurs valeurs de données sur le contexte. | Objet complexe (séquence d'éléments ContextDataValue ) |
ContextDataValue |
Une seule valeur contextuelle choisie par l'utilisateur (comme son âge, ses habitudes de consommation, son expérience du produit). Ce bloc contient une dimension et la valeur choisie par l'utilisateur. Attributs :
|
Objet complexe (une description de ces champs est fournie dans ce tableau) |
ContextDataDimension |
Dimension d'une valeur de données sur le contexte donnée. Il s'agit d'une description de ce qui a été évalué. Contient un identifiant externe et un libellé. | Objet complexe (une description de ces champs est fournie dans ce tableau) |
RatingValues |
Contient la liste des statistiques de notes secondaires (notes attribuées par l'auteur à des dimensions ou qualités d'un produit). | Objet complexe (séquence d'éléments RatingValue ) |
RatingValue |
Contient les statistiques d'un barème de notation du produit (quelques qualités selon lesquelles le produit peut être évalué). | Objet complexe (une description de ces champs est fournie dans ce tableau) |
Note |
Note choisie par l'utilisateur pour une dimension spécifique (par exemple la qualité du produit). | Nombre entier (11 octets) |
RatingDimension |
Spécifie des informations sur des caractéristiques alternatives telles que la facilité d'utilisation, le prix, le matériau ou le confort. Attributs :
|
Objet complexe (une description de ces champs est fournie dans ce tableau) |
RatingRange |
Tout comme l'élément OverallRatingRange, cet élément affiche la valeur maximale d'une note secondaire. Les notes vont de 1 à la valeur spécifiée ici. La valeur par défaut est de 5, mais certains clients préfèrent utiliser des échelles différentes pour les fonctions d'évaluation secondaires des produits ou services. Cette valeur est configurée dans la configuration des affichages ou des soumissions des clients. | Nombre entier (11 octets) |
ClientResponses |
Contient la liste des réponses du client à ce contenu. Celles-ci sont généralement envoyées via le Workbench. | Objet complexe (séquence d'éléments ClientResponse ) |
ClientResponse |
Contient des données sur la réponse laissée par un client et destinée à l'auteur. | Objet complexe (une description de ces champs est fournie dans ce tableau) |
Department |
Identification ou ville d'une boutique physique ou en ligne à partir de laquelle vous recevez la réponse. | Chaîne (255 caractères maximum) |
Response |
Texte de la réponse. | Chaîne de texte |
ResponseMarkup |
Entoure des options de balisage possibles. | Objet complexe (une description de ces champs est fournie dans ce tableau) |
PlainText |
Version en texte brut d'une réponse. | Chaîne de texte |
LinkText |
Version sous forme de lien d'une réponse. | Chaîne de texte |
HighlightText |
Une version mise en surbrillance d'une réponse. | Chaîne de texte |
ResponseSource |
Source de l'envoi d'une réponse (comme le workbench). | Chaîne (255 caractères maximum) |
date |
Date de soumission. Les réponses et les commentaires du client ne sont pas modérés. | Date (code temporel) |
ClientComments |
Contient la liste des commentaires soumis par le personnel du client par rapport à un avis donné. | Objet complexe (séquence d'éléments ClientComment ) |
ClientComment |
Entoure un commentaire rédigé par le personnel du client sur un avis. | Objet complexe (une description de ces champs est fournie dans ce tableau) |
Nom |
Nom de la personne membre de l'équipe du client, ayant laissé le commentaire. | Chaîne (255 caractères maximum) |
Comment |
Texte de commentaire. | Chaîne de texte |
Photos |
Ensemble de photos et légendes ajoutées par l'auteur (de tout type de contenu). | Objet complexe (séquence d'éléments Photo ) |
Photo |
Références photo dotées de quelques légendes. Attributs :
|
Objet complexe (une description de ces champs est fournie dans ce tableau) |
Caption |
Description d'un élément de média (tel que des photos ou des vidéos) laissé par un auteur. | Chaîne de texte |
Sizes |
Liste d'images en différentes tailles (si disponibles). | Objet complexe (séquence d'éléments Size ) |
Size |
Contient l'URL d'une image d'une certaine taille identifiée par son attribut id. Attributs :
|
Objet vide (données dans les attributs XML) |
Avatar |
Contient l'avatar de l'utilisateur, y compris les URL et les tailles. Attributs :
|
Objet complexe (une description de ces champs est fournie dans ce tableau) |
Videos |
Un ensemble de références vidéo dotées de légendes. | Objet complexe (séquence d'éléments Video ) |
vidéo |
Contient l'URL, l'ID et la légende d'une vidéo laissée par l'auteur. | Objet complexe (une description de ces champs est fournie dans ce tableau) |
VideoHost |
Service d'hébergement vidéo (par ex. YouTube). Remarque : si l'URL contient un caractère réservé (spécial), vous devez encoder en URL le caractère. Ainsi, utilisez
& pour remplacer une esperluette, %20 pour un espace ou encore %5B et %5D pour les crochets ([ ]). |
URL / chaîne (255 caractères max) |
VideoId |
Identifie une vidéo d'un service d'hébergement vidéo en particulier (par ex. YouTube). | Chaîne (255 caractères maximum) |
RawUrlInput |
URL vers une vidéo d'un service d'hébergement vidéo particulier (par ex. YouTube). Remarque : si l'URL contient un caractère réservé (spécial), vous devez encoder en URL le caractère. Ainsi, utilisez
& pour remplacer une esperluette, %20 pour un espace ou encore %5B et %5D pour les crochets ([ ]). |
URL / chaîne (255 caractères max) |
ProductReferences |
Contient la liste des références produits associées à un avis. | Objet complexe (séquence d'éléments ProductReference ) |
ProductReference |
Contient un élément de produit avec quelques champs (voir l'exemple précédent) et une légende laissée par l'auteur du contenu. | Objet complexe (une description de ces champs est fournie dans ce tableau) |
Produit |
Produit référencé dans le corps du contenu par son auteur. Reportez-vous à la section Les produits et leurs éléments pour en savoir plus. Attributs :
|
Complex Object (une description de ses champs est fournie dans la section Les produits et leurs éléments) |
Exemple
<Review id="123456"> ... <Tags> <TagDimension id="Pro"> <ExternalId>Pro</ExternalId> <Label>Pros</Label> <Tags> <Tag> <Label>Divertir ses amis</Label> </Tag> <Tag> <Label>Répétitions quotidiennes</Label> </Tag> <Tag> <Label>Bon son</Label> </Tag> </Tags> </TagDimension> </Tags> <Badges> <Badge> <Name>contributeurdansletop25</Name> <ContentType>AVIS</ContentType> <BadgeType>Badgedumeilleurcontributeur</BadgeType> </Badge> ... </Badges> <AdditionalFields> <AdditionalField id="HomeDecor"> <DisplayLabel>Le design intérieur de ma maison est :</DisplayLabel> <Value>Moderne</Value> </AdditionalField> </AdditionalFields> <ContextDataValues> <ContextDataValue id="25to34"> <ExternalId>25à34</ExternalId> <Label>25-34</Label> <ContextDataDimension id="Age"> <ExternalId>Âge</ExternalId> <Label>Âge</Label> </ContextDataDimension> </ContextDataValue> <ContextDataValue id="Monthly"> <ExternalId>Mensuel</ExternalId> <Label>Mensuel</Label> <ContextDataDimension id="Frequency"> <ExternalId>Fréquence</ExternalId> <Label>Fréquence</Label> </ContextDataDimension> </ContextDataValue> ... </ContextDataValues> <RatingValues> <RatingValue> <Rating>5</Rating> <RatingDimension id="Quality" displayType="NORMAL" selectedValueInDisplayEnabled="false"> <ExternalId>Qualité</ExternalId> <RatingRange>5</RatingRange> <Label>Qualité</Label> <Label1>Qualité</Label1> </RatingDimension> </RatingValue> <RatingValue> <Rating>5</Rating> <RatingDimension id="Comfort" displayType="NORMAL" selectedValueInDisplayEnabled="false"> <ExternalId>Confort</ExternalId> <RatingRange>5</RatingRange> <Label>Confort</Label> <Label1>Confort</Label1> </RatingDimension> </RatingValue> ... </RatingValues> <ClientResponses> <ClientResponse> <Department>Quelque chose quelque chose Guitar Corp</Department> <Response>Fournir chaque jour des services exceptionnels à nos clients est notre priorité. Nous vous contacterons directement pour déterminer comment nous pouvons améliorer vos résultats.</Response> <ResponseMarkup> <PlainText>Fournir chaque jour des services exceptionnels à nos clients est notre priorité. Nous vous contacterons directement pour déterminer comment nous pouvons améliorer vos résultats.</PlainText> </ResponseMarkup> <ResponseSource>Workbench</ResponseSource> <Date>2013-04-12T13:21:43.000-06:00</Date> </ClientResponse> ... </ClientResponses> <ClientComments> <ClientComment> <Date>2013-07-11T12:26:51.000-05:00</Date> <Name>client_dude</Name> <Comment>Approuvé par le client.</Comment> </ClientComment> ... </ClientComments> <Photos> <Photo id="104358"> <Caption>Moi et ma nouvelle guitare</Caption> </Photo> ... </Photos> <Videos> <Video> <Caption>La vidéo de mon soundcheck</Caption> <VideoHost>www.youtube.com</VideoHost> <VideoId>abcd123</VideoId> <RawUrlInput>http://www.youtube.com/watch?v=abcd123</RawUrlInput> </Video> ... </Videos> <Avatar id="466578" photo="true"> <Sizes> <Size id="thumbnail" url="https://reviews.clientName.com/profiles/displayCode/466578/photoThumb.jpg"/> <Size id="normal" url="https://reviews.clientName.com/profiles/displayCode/466578/photo.jpg"/> ... </Sizes> </Avatar> <ProductReferences> <ProductReference> <Product id="SF6105" disabled="false" removed="true"> ... </Product> <Caption> ... </Caption> </ProductReference> ... </ProductReferences> ... </Review>
Les profils d'utilisateur et leurs éléments
Vous trouverez un exemple à la fin de cette section.
Élément | Description | Type |
---|---|---|
ExternalId |
Identifiant d'un objet donné (comme le contenu, le sujet, la dimension ou la balise), unique parmi tous les objets du même type. | Chaîne (255 caractères maximum) |
Nom d'affichage |
Nom de l'auteur de l'avis qui s'affiche avec le contenu qu'il a publié. | Chaîne (255 caractères maximum) |
Anonymous |
Valeur booléenne qui spécifie si un utilisateur a choisi de rester anonyme ou non. Lorsqu'elle est définie sur « true » (vrai), la plupart des informations et des champs sont masqués. | Booléen |
HyperlinkingEnabled |
Indique si les hyperliens dans les réponses de l'utilisateur sont automatiquement encodés. | Booléen |
ContributorRank |
Le classement de contributeur assigné à un auteur. Valeurs possibles : TOP_1, TOP_10, TOP_25, TOP_50, TOP_100, TOP_250, TOP_500, TOP_1000, NONE. | Enum |
SubmissionTime |
Heure à laquelle un avis a été envoyé vers le CMS de Bazaarvoice. | Date (code temporel) |
DisplayLocale |
Identifie la langue dans laquelle un avis a été envoyé. | Chaîne (25 caractères maximum) |
Statut de modération |
Indique le statut actuel d'un auteur. Ce champ permet d'indiquer si l'utilisateur attend une action de la part des modérateurs ou du CMS, ou bien s'il est approuvé ou rejeté. Valeurs possibles : NONE, SUBMITTED, APPROVED, HOLD, PENDING, REJECTED, REMOVEDBYCLIENT, REMOVEDTEST, AUTOMATEDHOLD, EXPIRED. | Enum |
Lieu |
Contient des informations sur la ville d'un utilisateur. | Chaîne (255 caractères maximum) |
LastPublishTime |
Heure à laquelle un avis a été modéré puis publié via le CMS. | Date (code temporel) |
Avatar |
Référence vers l'avatar d'un utilisateur dans différentes tailles. Reportez-vous à la section Objets contextuels complexes pour en savoir plus. | Objet complexe (séquence d'éléments Photo ) |
ReviewStatistics |
Contient les informations sur tous les avis et les notes attribués par un utilisateur. Reportez-vous à la section Blocs ReviewStatistics, QAStatistics et CommentStatistics pour en savoir plus. | Objet complexe (une description de ses champs est fournie dans ce document) |
QAStatistics |
Contient les statistiques de toutes les questions et réponses d'un utilisateur. Reportez-vous à la section Blocs ReviewStatistics, QAStatistics et CommentStatistics pour en savoir plus. | Objet complexe (une description de ses champs est fournie dans ce document) |
ReviewCommentStatistics |
Contient les statistiques sur les commentaires qu'un utilisateur a publiés sur des avis. Reportez-vous à la section Blocs ReviewStatistics, QAStatistics et CommentStatistics pour en savoir plus. | Objet complexe (une description de ses champs est fournie dans ce document) |
Badges |
Contient une liste de badges attribués à un auteur. Reportez-vous à la section Objets contextuels complexes (parties de types de contenu) pour en savoir plus. | Objet complexe (séquence d'éléments Badge ) |
AdditionalFields |
Contient une liste de champs supplémentaires éventuellement présents dans l'enregistrement d'un auteur. Reportez-vous à la section Objets contextuels complexes (parties de types de contenu) pour en savoir plus. | Objet complexe (séquence d'éléments AdditionalField ) |
ContextDataValues |
Contient plusieurs valeurs de contexte choisies par l'utilisateur (comme son âge, ses habitudes de consommation, son expérience du produit). Reportez-vous à la section Objets contextuels complexes (parties de types de contenu) pour en savoir plus. | Objet complexe (séquence d'éléments ContextDataValue ) |
RatingValues |
Contient la liste des notes secondaires (notes attribuées par l'auteur à des dimensions ou qualités d'un produit ou d'un service). Reportez-vous à la section Objets contextuels complexes (parties de types de contenu) pour en savoir plus. | Objet complexe (séquence d'éléments RatingValue ) |
Photos |
Un ensemble de références photo dotées de légendes. Reportez-vous à la section Objets contextuels complexes (parties de types de contenu) pour en savoir plus. | Objet complexe (séquence d'éléments Photo ) |
Videos |
Un ensemble de références vidéo dotées de légendes. Reportez-vous à la section Objets contextuels complexes (parties de types de contenu) pour en savoir plus. | Objet complexe (séquence d'éléments Video ) |
Exemple
<UserProfile id="5dd667303d40625232cb5d5aaa409247"> <ExternalId>5dd667303d40625232cb5d5aaa409247</ExternalId> <DisplayName>Doc Brown</DisplayName> <Anonymous>false</Anonymous> <HyperlinkingEnabled>false</HyperlinkingEnabled> <ContributorRank>TOP_25</ContributorRank> <SubmissionTime>2016-01-25T16:55:31.000-06:00</SubmissionTime> <DisplayLocale>en_US</DisplayLocale> <ModerationStatus>APPROVED</ModerationStatus> <Location>East Coast</Location> <LastPublishTime>2016-01-25T19:30:38.000-06:00</LastPublishTime> <!-- Following elements are described in other sections of this doc. Refer to the Example standard client feed table. --> <Avatar id="466578" photo="true"> ... </Avatar> <ReviewStatistics> ... </ReviewStatistics> <QAStatistics> ... </QAStatistics> <ReviewCommentStatistics> ... </ReviewCommentStatistics> <Badges> ... </Badges> <RatingValues> ... </RatingValues> <ContextDataValues> ... </ContextDataValues> <AdditionalFields> ... </AdditionalFields> <Photos> ... </Photos> <Videos> ... </Videos> </UserProfile>
Exemple de flux client standard
L'exemple suivant est un flux client standard qui comprend des avis pour deux produits :
<?xml version="1.0" encoding="UTF-8"?> <Feed xmlns="http://www.bazaarvoice.com/xs/PRR/StandardClientFeed/14.8" name="client_name" extractDate="2016-10-29T00:00:00.000Z"> <Product disabled="false" removed="true" id="01"> <Reviews> <Review id="10505050"> <UserProfileReference id="1000"> <Anonymous>false</Anonymous> <DisplayName>CertainSomeone</DisplayName> <ExternalId>6000</ExternalId> <HyperlinkingEnabled>false</HyperlinkingEnabled> </UserProfileReference> <ContentCodes>IMP STP</ContentCodes> <DisplayLocale>de_DE</DisplayLocale> <Featured>false</Featured> <FirstPublishTime>2019-04-04T17:26:57.000-06:00</FirstPublishTime> <LastModificationTime>2020-10-20T14:15:43.375-05:00</LastModificationTime> <LastPublishTime>2021-05-03T16:30:16.000-06:00</LastPublishTime> <ModerationStatus>APPROVED</ModerationStatus> <NumComments>0</NumComments> <NumFeedbacks>0</NumFeedbacks> <NumNegativeFeedbacks>0</NumNegativeFeedbacks> <NumPositiveFeedbacks>0</NumPositiveFeedbacks> <ProductReviewsDeepLinkedUrl>http://c1.ugc.bazaarvoice.com/10000/02/review/10505050/redirect.htm</ProductReviewsDeepLinkedUrl> <ProductReviewsUrl>http://c1.ugc.bazaarvoice.com/10000/02/reviews.htm?reviewID=20505050</ProductReviewsUrl> <Rating>5</Rating> <RatingRange>5</RatingRange> <RatingsOnly>false</RatingsOnly> <ReviewText>Generic Review Text. Love the product, can't speak highly enough of it.</ReviewText> <ReviewerNickname>CertainSomeone</ReviewerNickname> <SendEmailAlertWhenCommented>false</SendEmailAlertWhenCommented> <SendEmailAlertWhenPublished>false</SendEmailAlertWhenPublished> <Source> <Name>generic</Name> <ExternalContentId>40000</ExternalContentId> </Source> <SubmissionTime>2019-05-03T15:40:57.000-06:00</SubmissionTime> <Title>good</Title> <Videos/> </Review> <Review id="59837721"> <UserProfileReference id="202752"> <Anonymous>false</Anonymous> <DisplayName>CertainSomeone</DisplayName> <ExternalId>2101992</ExternalId> <HyperlinkingEnabled>false</HyperlinkingEnabled> </UserProfileReference> <ContentCodes>GEN PRO</ContentCodes> <DisplayLocale>fr_FR</DisplayLocale> <Featured>false</Featured> <FirstPublishTime>2015-02-09T16:26:57.000-06:00</FirstPublishTime> <LastModificationTime>2019-10-20T12:10:47.584-05:00</LastModificationTime> <LastPublishTime>2020-04-02T10:40:57.000-08:00</LastPublishTime> <ModerationStatus>APPROVED</ModerationStatus> <NumComments>0</NumComments> <NumFeedbacks>0</NumFeedbacks> <NumNegativeFeedbacks>0</NumNegativeFeedbacks> <NumPositiveFeedbacks>0</NumPositiveFeedbacks> <ProductReviewsDeepLinkedUrl>http://c1.ugc.bazaarvoice.com/5000/02/review/10505050/redirect.htm</ProductReviewsDeepLinkedUrl> <ProductReviewsUrl>http://c1.ugc.bazaarvoice.com/50590/02/reviews.htm?reviewID=10505050</ProductReviewsUrl> <Rating>5</Rating> <RatingRange>5</RatingRange> <RatingsOnly>false</RatingsOnly> <ReviewText>Superb product that does the job required. Thank you so much! </ReviewText> <ReviewerNickname>CertainSomeone</ReviewerNickname> <SendEmailAlertWhenCommented>false</SendEmailAlertWhenCommented> <SendEmailAlertWhenPublished>false</SendEmailAlertWhenPublished> <Source> <Name>snapav</Name> <ExternalContentId>500000</ExternalContentId> </Source> <SubmissionTime>2019-03-02T16:26:57.000-06:00</SubmissionTime> <Title>fantastic product</Title> <Videos/> </Review> </Reviews> <ExternalId>01</ExternalId> <Source>genericshop</Source> <NativeReviewStatistics> <AverageOverallRating>5.0</AverageOverallRating> <NotRecommendedCount>0</NotRecommendedCount> <OverallRatingRange>5</OverallRatingRange> <RatingsOnlyReviewCount>0</RatingsOnlyReviewCount> <RecommendedCount>0</RecommendedCount> <TotalReviewCount>2</TotalReviewCount> <AverageRatingValues/> <RatingDistribution> <RatingDistributionItem> <RatingValue>5</RatingValue> <Count>2</Count> </RatingDistributionItem> </RatingDistribution> </NativeReviewStatistics> <NumAnswers>0</NumAnswers> <NumNativeAnswers>0</NumNativeAnswers> <NumNativeQuestions>0</NumNativeQuestions> <NumQuestions>0</NumQuestions> <NumReviews>2</NumReviews> <ReviewStatistics> <AverageOverallRating>5.0</AverageOverallRating> <NotRecommendedCount>0</NotRecommendedCount> <OverallRatingRange>5</OverallRatingRange> <RatingsOnlyReviewCount>0</RatingsOnlyReviewCount> <RecommendedCount>0</RecommendedCount> <TotalReviewCount>2</TotalReviewCount> <AverageRatingValues/> <RatingDistribution> <RatingDistributionItem> <RatingValue>5</RatingValue> <Count>2</Count> </RatingDistributionItem> </RatingDistribution> </ReviewStatistics> <CategoryItems> <CategoryItem id="BV_MISCELLANEOUS_CATEGORY"> <ExternalId>BV_MISCELLANEOUS_CATEGORY</ExternalId> <CategoryName>Miscellaneous</CategoryName> <CategoryId>900000000</CategoryId> </CategoryItem> </CategoryItems> <UPCs> <UPC>5749575749</UPC> </UPCs> <EANs> <EAN>1234567890123</EAN> </EANs> </Product> <Product disabled="false" removed="false" id="1529-A"> <Reviews> <Review id="75874633"> <UserProfileReference id="506978"> <Anonymous>false</Anonymous> <DisplayName>CertainSomeone</DisplayName> <ExternalId>506978</ExternalId> <HyperlinkingEnabled>false</HyperlinkingEnabled> </UserProfileReference> <ContentCodes>GEN STU SHO</ContentCodes> <DisplayLocale>en_US</DisplayLocale> <Featured>false</Featured> <FirstPublishTime>2020-11-26T17:19:09.000-05:00</FirstPublishTime> <LastModificationTime>2015-05-21T20:10:07.236-05:00</LastModificationTime> <LastPublishTime>2019-10-16T10:20:04.000-05:00</LastPublishTime> <ModerationStatus>APPROVED</ModerationStatus> <NumComments>0</NumComments> <NumFeedbacks>0</NumFeedbacks> <NumNegativeFeedbacks>0</NumNegativeFeedbacks> <NumPositiveFeedbacks>0</NumPositiveFeedbacks> <ProductReviewsDeepLinkedUrl>http://c1.ugc.bazaarvoice.com/50000/7777-A/review/19586790/redirect.htm</ProductReviewsDeepLinkedUrl> <ProductReviewsUrl>http://c1.ugc.bazaarvoice.com/60000/6666-A/reviews.htm?reviewID=12345678</ProductReviewsUrl> <Rating>4</Rating> <RatingRange>5</RatingRange> <RatingsOnly>false</RatingsOnly> <ReviewText>Generic Review of a good product</ReviewText> <ReviewerNickname>CertainSomeone</ReviewerNickname> <SendEmailAlertWhenCommented>false</SendEmailAlertWhenCommented> <SendEmailAlertWhenPublished>false</SendEmailAlertWhenPublished> <Source> <Name>generic</Name> <ExternalContentId>500000</ExternalContentId> </Source> <SubmissionTime>2019-01-15T20:10:16.000-05:00</SubmissionTime> <Title>Bag</Title> <Videos/> </Review> </Reviews> <ImageUrl>http://www.genericstore.com/shop/images/genericitem.jpg</ImageUrl> <Name>CLC ToolWorks Center Tray Tool Bag</Name> <ExternalId>1529-A</ExternalId> <Description>CLC ToolWorks Center Tray Tool Bag</Description> <Source>snapav</Source> <ProductPageUrl>http://www.genericstore.com/shop/de/item</ProductPageUrl> <NativeReviewStatistics> <AverageOverallRating>4.0</AverageOverallRating> <NotRecommendedCount>0</NotRecommendedCount> <OverallRatingRange>5</OverallRatingRange> <RatingsOnlyReviewCount>0</RatingsOnlyReviewCount> <RecommendedCount>0</RecommendedCount> <TotalReviewCount>1</TotalReviewCount> <AverageRatingValues/> <RatingDistribution> <RatingDistributionItem> <RatingValue>4</RatingValue> <Count>1</Count> </RatingDistributionItem> </RatingDistribution> </NativeReviewStatistics> <NumAnswers>0</NumAnswers> <NumNativeAnswers>0</NumNativeAnswers> <NumNativeQuestions>0</NumNativeQuestions> <NumQuestions>0</NumQuestions> <NumReviews>1</NumReviews> <ProductReviewsUrl>http://c1.ugc.bazaarvoice.com/99999/2000-A/reviews.htm</ProductReviewsUrl> <ReviewStatistics> <AverageOverallRating>4.0</AverageOverallRating> <NotRecommendedCount>0</NotRecommendedCount> <OverallRatingRange>5</OverallRatingRange> <RatingsOnlyReviewCount>0</RatingsOnlyReviewCount> <RecommendedCount>0</RecommendedCount> <TotalReviewCount>1</TotalReviewCount> <AverageRatingValues/> <RatingDistribution> <RatingDistributionItem> <RatingValue>4</RatingValue> <Count>1</Count> </RatingDistributionItem> </RatingDistribution> </ReviewStatistics> <CategoryItems> <CategoryItem id="Purchased_Item"> <ExternalId>Purchased Item</ExternalId> <CategoryName>Stuff</CategoryName> <CategoryId>73596056</CategoryId> </CategoryItem> <CategoryItem id="Purchased_Item_2"> <ExternalId>Purchased Item 2</ExternalId> <CategoryName>Stuff 2</CategoryName> <CategoryId>65657687</CategoryId> </CategoryItem> </CategoryItems> <UPCs> <UPC>11223344556</UPC> </UPCs> <EANs> <EAN>09876543210</EAN> </EANs> <ManufacturerPartNumbers> <ManufacturerPartNumber>6565-B</ManufacturerPartNumber> </ManufacturerPartNumbers> </Product> </Feed>
Flux exporté de notes seules
Un flux de notes seules est un fichier XML exporté quotidiennement depuis Bazaarvoice qui contient du contenu lié aux notes sur les produits, notamment les valeurs telles que :
- ID des produits
- Nombre d'avis
- Nombre total d'avis
- Nombre d'avis qui ne contiennent que des notes
- Nombre d’utilisateurs qui recommandent ce produit
- Notes moyennes
- Notes maximales
Les données provenant de ces flux sont utiles pour réaliser les tâches suivantes :
- Activer l’affichage des notes en étoiles sur les pages catégories de votre site
- Améliorer la recherche et la navigation sur votre site
- Proposer des aperçus, des moyennes et d'autres valeurs utiles pour le classement
Les valeurs suivantes représentent la configuration par défaut d'un flux de notes seules :
- Frequency – Daily
- History – Full
- Format – XML
- Compression – GZIP
- Delivery location – Bazaarvoice SFTP Server
- Content type - Avis ou questions/réponses
- Moderation Status – Approved
- Inactive / Disabled – n'inclut pas les produits inactifs
Récupérer un flux de notes seules
Récupérez régulièrement vos flux exportés de notes seules à partir de l'emplacement SFTP où ils sont stockés après avoir été générés par Bazaarvoice. Téléchargez et traitez quotidiennement ce flux pour mettre à jour les zones de votre site qui utilisent ces informations. Fournissez une clé SSH publique si vous souhaitez automatiser ce processus grâce aux entrées SSH sans mot de passe.
Téléchargez le fichier du flux depuis le répertoire /feeds
de l'emplacement SFTP de Bazaarvoice :
- 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.
Schéma XML
Le schéma XML de vos flux de notes seules est basé sur le schéma de flux de Syndication, qui se trouve à l’endroit suivant :
http://www.bazaarvoice.com/xs/PRR/SyndicationFeed/version
où version est le numéro de version Bazaarvoice approprié. Par exemple, le schéma XML du flux de syndication associé à la version 14.7 se trouve à l’endroit suivant :
http://www.bazaarvoice.com/xs/PRR/SyndicationFeed/14.7
Procédez comme suit pour sélectionner la version du schéma XML que vous souhaitez utiliser.
- Connectez-vous au portail Bazaarvoice .
- Dans le portail du menu, sélectionnez Configuration.
- Sélectionnez l'instance Bazaarvoice.
- 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.
- Sous Implementations (Implémentations), sélectionnez Edit (Modifier) en regard de l'implémentation dont vous souhaitez modifier le schéma du flux (exporté) de notes seules.
- Sous Getting Started (Démarrer), sélectionnez Technical Setup (Configuration technique).
- Sélectionnez l'onglet Export Feeds (Exporter les flux) et faites défiler jusqu'à la section UGC Statistics (Ratings) Feed (Flux des statistiques CGU (notes)).
- Dans la liste Version du schéma XML, sélectionnez la version que vous souhaitez utiliser.
Remarque : sélectionnez 14.9 (dernier) pour utiliser le schéma qui inclut des statistiques sur les avis récompensés. Reportez-vous à la section Exemple Schema.org version 14.9 pour plus d'informations sur le nombre d'avis récompensés dans les flux de notes seules.
- Déployez vos modifications.
Exemple Schema.org version 14.7
Voici un exemple simple de flux (exporté) de notes seules basé sur Schema.org version 14.7. Pour plus d’informations sur les éléments de ce schéma, reportez-vous aux tableaux de la section des blocs ReviewStatistics, QAStatistics et CommentStatistics.
<?xml version="1.0" encoding="UTF-8"?> <Feed xmlns="http://www.bazaarvoice.com/xs/PRR/SyndicationFeed/14.7" name="client_name" extractDate="2023-10-05T00:00:00.000Z"> <Product removed="false" id="Product11"> <ImageUrl>http://display.ugc.bazaarvoice.com/common/test/images/white_evening_primrose.jpg</ImageUrl> <Name>Oenothera speciosa</Name> <ExternalId>Product11</ExternalId> <Description>Pink evening primrose features fragrant, bowl-shaped, four-petaled, pink flowers (to 2-3" diameter) with yellow anthers that bloom from the upper leaf axils in late spring.</Description> <Brand> <ExternalId>sampleBrand</ExternalId> <Name>Flowers</Name> <Attributes> <Attribute id="NAME"> <Value>Flowers</Value> </Attribute> </Attributes> </Brand> <Source>testcustomer-bulk-client-1</Source> <ProductPageUrl>http://en.wikipedia.org/wiki/Oenothera_speciosa</ProductPageUrl> <NativeReviewStatistics> <AverageOverallRating>4.8</AverageOverallRating> <OverallRatingRange>5</OverallRatingRange> <RatingsOnlyReviewCount>3</RatingsOnlyReviewCount> <RecommendedCount>5</RecommendedCount> <TotalReviewCount>5</TotalReviewCount> <AverageRatingValues> <AverageRatingValue id="Quality"> <AverageRating>4.0</AverageRating> <RatingDimension displayType="NORMAL" selectedValueInDisplayEnabled="false" id="Quality"> <ExternalId>Quality</ExternalId> <Label>Quality of Product</Label> <Label1>How would you rate the quality of this product?</Label1> <RatingRange>5</RatingRange> </RatingDimension> </AverageRatingValue> <AverageRatingValue id="Value"> <AverageRating>5.0</AverageRating> <RatingDimension displayType="NORMAL" selectedValueInDisplayEnabled="false" id="Value"> <ExternalId>Value</ExternalId> <Label>Value of Product</Label> <Label1>How would you rate the value of this product?</Label1> <RatingRange>5</RatingRange> </RatingDimension> </AverageRatingValue> </AverageRatingValues> <LocaleDistribution> <LocaleDistributionItem> <DisplayLocale>en_US</DisplayLocale> <ReviewStatistics> <AverageOverallRating>4.8</AverageOverallRating> <OverallRatingRange>5</OverallRatingRange> <RatingsOnlyReviewCount>3</RatingsOnlyReviewCount> <RecommendedCount>5</RecommendedCount> <TotalReviewCount>5</TotalReviewCount> <AverageRatingValues> <AverageRatingValue id="Quality"> <AverageRating>4.0</AverageRating> <RatingDimension displayType="NORMAL" selectedValueInDisplayEnabled="false" id="Quality"> <ExternalId>Quality</ExternalId> <Label>Quality of Product</Label> <Label1>How would you rate the quality of this product?</Label1> <RatingRange>5</RatingRange> </RatingDimension> </AverageRatingValue> <AverageRatingValue id="Value"> <AverageRating>5.0</AverageRating> <RatingDimension displayType="NORMAL" selectedValueInDisplayEnabled="false" id="Value"> <ExternalId>Value</ExternalId> <Label>Value of Product</Label> <Label1>How would you rate the value of this product?</Label1> <RatingRange>5</RatingRange> </RatingDimension> </AverageRatingValue> </AverageRatingValues> <RatingDistribution> <RatingDistributionItem> <RatingValue>4</RatingValue> <Count>1</Count> </RatingDistributionItem> <RatingDistributionItem> <RatingValue>5</RatingValue> <Count>4</Count> </RatingDistributionItem> </RatingDistribution> </ReviewStatistics> </LocaleDistributionItem> </LocaleDistribution> <RatingDistribution> <RatingDistributionItem> <RatingValue>4</RatingValue> <Count>1</Count> </RatingDistributionItem> <RatingDistributionItem> <RatingValue>5</RatingValue> <Count>4</Count> </RatingDistributionItem> </RatingDistribution> </NativeReviewStatistics> <NumAnswers>11</NumAnswers> <NumNativeAnswers>11</NumNativeAnswers> <NumNativeQuestions>5</NumNativeQuestions> <NumQuestions>5</NumQuestions> <NumReviews>7</NumReviews> <ReviewStatistics> <AverageOverallRating>4.8571</AverageOverallRating> <OverallRatingRange>5</OverallRatingRange> <RatingsOnlyReviewCount>3</RatingsOnlyReviewCount> <RecommendedCount>7</RecommendedCount> <TotalReviewCount>7</TotalReviewCount> <AverageRatingValues> <AverageRatingValue id="Quality"> <AverageRating>4.0</AverageRating> <RatingDimension displayType="NORMAL" selectedValueInDisplayEnabled="false" id="Quality"> <ExternalId>Quality</ExternalId> <Label>Quality of Product</Label> <Label1>How would you rate the quality of this product?</Label1> <RatingRange>5</RatingRange> </RatingDimension> </AverageRatingValue> <AverageRatingValue id="Value"> <AverageRating>5.0</AverageRating> <RatingDimension displayType="NORMAL" selectedValueInDisplayEnabled="false" id="Value"> <ExternalId>Value</ExternalId> <Label>Value of Product</Label> <Label1>How would you rate the value of this product?</Label1> <RatingRange>5</RatingRange> </RatingDimension> </AverageRatingValue> </AverageRatingValues> <LocaleDistribution> <LocaleDistributionItem> <DisplayLocale>en_US</DisplayLocale> <ReviewStatistics> <AverageOverallRating>4.8571</AverageOverallRating> <OverallRatingRange>5</OverallRatingRange> <RatingsOnlyReviewCount>3</RatingsOnlyReviewCount> <RecommendedCount>7</RecommendedCount> <TotalReviewCount>7</TotalReviewCount> <AverageRatingValues> <AverageRatingValue id="Quality"> <AverageRating>4.0</AverageRating> <RatingDimension displayType="NORMAL" selectedValueInDisplayEnabled="false" id="Quality"> <ExternalId>Quality</ExternalId> <Label>Quality of Product</Label> <Label1>How would you rate the quality of this product?</Label1> <RatingRange>5</RatingRange> </RatingDimension> </AverageRatingValue> <AverageRatingValue id="Value"> <AverageRating>5.0</AverageRating> <RatingDimension displayType="NORMAL" selectedValueInDisplayEnabled="false" id="Value"> <ExternalId>Value</ExternalId> <Label>Value of Product</Label> <Label1>How would you rate the value of this product?</Label1> <RatingRange>5</RatingRange> </RatingDimension> </AverageRatingValue> </AverageRatingValues> <RatingDistribution> <RatingDistributionItem> <RatingValue>4</RatingValue> <Count>1</Count> </RatingDistributionItem> <RatingDistributionItem> <RatingValue>5</RatingValue> <Count>6</Count> </RatingDistributionItem> </RatingDistribution> </ReviewStatistics> </LocaleDistributionItem> </LocaleDistribution> <RatingDistribution> <RatingDistributionItem> <RatingValue>4</RatingValue> <Count>1</Count> </RatingDistributionItem> <RatingDistributionItem> <RatingValue>5</RatingValue> <Count>6</Count> </RatingDistributionItem> </RatingDistribution> </ReviewStatistics> <CategoryItems> <CategoryItem id="sampleCategory"> <ExternalId>sampleCategory</ExternalId> <CategoryName>Flowers Category</CategoryName> <CategoryId>707703608</CategoryId> </CategoryItem> </CategoryItems> </Product> </Feed>
Exemple Schema.org version 14.9
La version 14.9 de Schema.org comprend des statistiques sur le nombre d'avis récompensés dont vous disposez. L'élément IncentivizedReviewCount
fait partie du bloc ReviewStatistics
. Les statistiques d'avis sont incluses aux niveaux suivants :
Product
>ReviewStatistics
: statistiques sur les avis produits natifs, famille et syndiqués.Product
>NativeReviewStatistics
: statistiques sur les avis produits natifs.Product
>LocaleDistribution
>LocaleDistributionItem
>ReviewStatistics
—Statistiques sur les produits de chaque région.LocaleDistribution
est à la fois dansProduct
>ReviewStatistics
et dansNativeReviewStatistics
.
L'exemple suivant montre le bloc Schema.org 14.9 ReviewStatistics
contenant IncentivizedReviewCount
.
<?xml version="1.0" encoding="UTF-8"?> <Feed xmlns="http://www.bazaarvoice.com/xs/PRR/SyndicationFeed/14.9" name="client_name" extractDate="2023-09-29T00:00:00.000Z"> <Product removed="false" id="Product11"> <!-- ... Content within the Product element ... --> <NativeReviewStatistics> <AverageOverallRating>4.8</AverageOverallRating> <OverallRatingRange>5</OverallRatingRange> <RatingsOnlyReviewCount>3</RatingsOnlyReviewCount> <RecommendedCount>5</RecommendedCount> <IncentivizedReviewCount>1</IncentivizedReviewCount> <TotalReviewCount>5</TotalReviewCount> <AverageRatingValues> <AverageRatingValue id="Quality"> <AverageRating>4.0</AverageRating> <RatingDimension displayType="NORMAL" selectedValueInDisplayEnabled="false" id="Quality"> <ExternalId>Quality</ExternalId> <Label>Quality of Product</Label> <Label1>How would you rate the quality of this product?</Label1> <RatingRange>5</RatingRange> </RatingDimension> </AverageRatingValue> <AverageRatingValue id="Value"> <AverageRating>5.0</AverageRating> <RatingDimension displayType="NORMAL" selectedValueInDisplayEnabled="false" id="Value"> <ExternalId>Value</ExternalId> <Label>Value of Product</Label> <Label1>How would you rate the value of this product?</Label1> <RatingRange>5</RatingRange> </RatingDimension> </AverageRatingValue> </AverageRatingValues> <LocaleDistribution> <LocaleDistributionItem> <DisplayLocale>en_US</DisplayLocale> <ReviewStatistics> <AverageOverallRating>4.8</AverageOverallRating> <OverallRatingRange>5</OverallRatingRange> <RatingsOnlyReviewCount>3</RatingsOnlyReviewCount> <RecommendedCount>5</RecommendedCount> <IncentivizedReviewCount>1</IncentivizedReviewCount> <TotalReviewCount>5</TotalReviewCount> <AverageRatingValues> <AverageRatingValue id="Quality"> <AverageRating>4.0</AverageRating> <RatingDimension displayType="NORMAL" selectedValueInDisplayEnabled="false" id="Quality"> <ExternalId>Quality</ExternalId> <Label>Quality of Product</Label> <Label1>How would you rate the quality of this product?</Label1> <RatingRange>5</RatingRange> </RatingDimension> </AverageRatingValue> <AverageRatingValue id="Value"> <AverageRating>5.0</AverageRating> <RatingDimension displayType="NORMAL" selectedValueInDisplayEnabled="false" id="Value"> <ExternalId>Value</ExternalId> <Label>Value of Product</Label> <Label1>How would you rate the value of this product?</Label1> <RatingRange>5</RatingRange> </RatingDimension> </AverageRatingValue> </AverageRatingValues> <RatingDistribution> <RatingDistributionItem> <RatingValue>4</RatingValue> <Count>1</Count> </RatingDistributionItem> <RatingDistributionItem> <RatingValue>5</RatingValue> <Count>4</Count> </RatingDistributionItem> </RatingDistribution> </ReviewStatistics> </LocaleDistributionItem> </LocaleDistribution> <RatingDistribution> <RatingDistributionItem> <RatingValue>4</RatingValue> <Count>1</Count> </RatingDistributionItem> <RatingDistributionItem> <RatingValue>5</RatingValue> <Count>4</Count> </RatingDistributionItem> </RatingDistribution> </NativeReviewStatistics> <NumAnswers>11</NumAnswers> <NumNativeAnswers>11</NumNativeAnswers> <NumNativeQuestions>5</NumNativeQuestions> <NumQuestions>5</NumQuestions> <NumReviews>7</NumReviews> <ReviewStatistics> <AverageOverallRating>4.8571</AverageOverallRating> <OverallRatingRange>5</OverallRatingRange> <RatingsOnlyReviewCount>3</RatingsOnlyReviewCount> <RecommendedCount>7</RecommendedCount> <IncentivizedReviewCount>1</IncentivizedReviewCount> <TotalReviewCount>7</TotalReviewCount> <AverageRatingValues> <AverageRatingValue id="Quality"> <AverageRating>4.0</AverageRating> <RatingDimension displayType="NORMAL" selectedValueInDisplayEnabled="false" id="Quality"> <ExternalId>Quality</ExternalId> <Label>Quality of Product</Label> <Label1>How would you rate the quality of this product?</Label1> <RatingRange>5</RatingRange> </RatingDimension> </AverageRatingValue> <AverageRatingValue id="Value"> <AverageRating>5.0</AverageRating> <RatingDimension displayType="NORMAL" selectedValueInDisplayEnabled="false" id="Value"> <ExternalId>Value</ExternalId> <Label>Value of Product</Label> <Label1>How would you rate the value of this product?</Label1> <RatingRange>5</RatingRange> </RatingDimension> </AverageRatingValue> </AverageRatingValues> <LocaleDistribution> <LocaleDistributionItem> <DisplayLocale>en_US</DisplayLocale> <ReviewStatistics> <AverageOverallRating>4.8571</AverageOverallRating> <OverallRatingRange>5</OverallRatingRange> <RatingsOnlyReviewCount>3</RatingsOnlyReviewCount> <RecommendedCount>7</RecommendedCount> <IncentivizedReviewCount>1</IncentivizedReviewCount> <TotalReviewCount>7</TotalReviewCount> <AverageRatingValues> <AverageRatingValue id="Quality"> <AverageRating>4.0</AverageRating> <RatingDimension displayType="NORMAL" selectedValueInDisplayEnabled="false" id="Quality"> <ExternalId>Quality</ExternalId> <Label>Quality of Product</Label> <Label1>How would you rate the quality of this product?</Label1> <RatingRange>5</RatingRange> </RatingDimension> </AverageRatingValue> <AverageRatingValue id="Value"> <AverageRating>5.0</AverageRating> <RatingDimension displayType="NORMAL" selectedValueInDisplayEnabled="false" id="Value"> <ExternalId>Value</ExternalId> <Label>Value of Product</Label> <Label1>How would you rate the value of this product?</Label1> <RatingRange>5</RatingRange> </RatingDimension> </AverageRatingValue> </AverageRatingValues> <RatingDistribution> <RatingDistributionItem> <RatingValue>4</RatingValue> <Count>1</Count> </RatingDistributionItem> <RatingDistributionItem> <RatingValue>5</RatingValue> <Count>6</Count> </RatingDistributionItem> </RatingDistribution> </ReviewStatistics> </LocaleDistributionItem> </LocaleDistribution> <RatingDistribution> <RatingDistributionItem> <RatingValue>4</RatingValue> <Count>1</Count> </RatingDistributionItem> <RatingDistributionItem> <RatingValue>5</RatingValue> <Count>6</Count> </RatingDistributionItem> </RatingDistribution> </ReviewStatistics> <!-- ... More content within the Product element ... --> </Product> </Feed>
IncentivizedReviewCount
est disponible uniquement avec le flux (exporté) de notes seules, et non avec le flux client standard ou DCE.Displayable Content Export
Pour des raisons de performances, de flexibilité ou de sécurité, votre entreprise peut avoir besoin de limiter les dépendances vis-à-vis des services tiers alimentant vos sites Web. Le fichier « Displayable content export » (DCE) de Bazaarvoice fournit un moyen de stocker le CGU au niveau local et d'afficher ce contenu sans faire appel à l'infrastructure d'affichage Ratings & Reviews de Bazaarvoice.
Ce fichier DCE est conçu pour être utilisé en une fois régulièrement. Le CGU peut ensuite être affiché sur un site Web ou d'autres applications. N'utilisez pas ce fichier en interne, comme dans des applications de CRM ou des dashboards d'analyse, car il ne contient pas tout le contenu pertinent par rapport à ces applications. Vous pouvez obtenir ce fichier via une interface HTTPS en autorisant d'abord l'envoi de la requête, puis en transférant les fichiers de contenu.
Avantages du fichier DCE
Le fichier DCE offre les avantages suivants :
- Un service optimisé pour télécharger du contenu affichable en une fois
- Une source unique de CGU, natif ou provenant de la syndication, du réseau Bazaarvoice, qui n'inclut pas de données à caractère personnel (PII)
- Indépendance vis-à-vis de l'interface d'affichage en temps réel de Bazaarvoice (API et affichage hébergé)
- Identification facile des éléments configurables, comme les dimensions de notes
- Standardisation des données pour faciliter la transmission et l'import dans une base de données relationnelle
Le fichier DCE comprend du contenu standardisé, comme le contenu natif et provenant de la syndication, les données de configuration et les données sur les produits. Il ne comprend pas les données suivantes :
- CGU en attente
- CGU rejeté
- Le CGC approuvé qui n'a pas été syndiqué pour d'autres raisons (ex. : codes de contenu).
Comment utiliser le fichier DCE
Pour récupérer et importer le fichier DCE, vous devez utiliser l'interface HTTPS DCE pour envoyer la requête de manière sécurisée et transférer les fichiers de contenu et le manifeste. Le fichier DCE fournit le contenu dans un format lisible par une machine (JSON), que vous pourrez ensuite utiliser dans une application que vous devez créer, héberger et entretenir. Votre équipe doit donc avoir les compétences suivantes :
- Développement d'application Web
- Interaction client/serveur basée sur HTTPS
- Capacité à traiter le JSON
- Stockage, récupération et manipulation de données
Workflow
Le diagramme suivant illustre les contenus du fichier DCE et la manière d'importer et d'afficher le contenu :
Le contenu natif et provenant de la syndication est agrégé et standardisé pour créer le fichier DCE. Un fichier de manifeste est également créé ; il fournit une cartographie des données et comprend une URL pour chaque fichier du DCE.
Pour importer et afficher le contenu inclus dans le fichier DCE, vous devez suivre les étapes suivantes :
- Demander le fichier du manifeste.
- Demander les fichiers de contenu listés dans le manifeste, qui contiennent le CGU, les données de configuration et les données sur les produits.
- Importer le CGU, les données de configuration et des produits dans votre base de données.
- Regrouper les données pertinentes au produit affiché et publier le CGU sur votre site Web ou application.
Reportez-vous au site de Bazaarvoice pour les développeurs pour des informations complètes et instructions sur l'interface HTTPS.