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.

Remarque : Si vous utilisez le flux de contenu standard pour établir votre entrepôt de données, vous devriez pouvoir importer un flux de contenu complet en plus des flux incrémentaux. Bazaarvoice vous recommande d'adopter cette meilleure pratique particulièrement pour réinitialiser les entrepôts de données dans le cas de contenus non traités ou perdus.

Activer et programmer les flux client standard

Conseil : Bazaarvoice vous recommande de patienter jusqu'à lundi minuit CST (UTC-6 en hiver et UTC-5 en été) pour utiliser le flux client standard. Le fait d'attendre jusqu'à lundi améliore les chances de générer un flux complet.

Pour recevoir un flux client standard de Bazaarvoice, vous devez l'activer et le programmer comme suit :

  1. Connectez-vous au portail Bazaarvoice .
  2. Dans le menu du portail , sélectionnez Configuration.
  3. 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.
  4. Modifiez l'implémentation principale installée sur la zone de déploiement du site principal.
  5. Sélectionnez Technical Setup (Configuration technique) à gauche de la page puis l'onglet Export Feeds (Exporter les flux).
  6. 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.
  7. 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.
  8. 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.
  9. 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.

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.

Remarque : Certains éléments XML, tels que <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 :

  • xmlns — Contient la version de schéma d'un fichier XML donné. Chaîne (255 caractères maximum)
  • name — Nom du client. Chaîne (255 caractères maximum)
  • extractDate — Contient la date de génération du flux. Date (code temporel)

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 :

  • id— Identifiant (tel qu’il a été fourni par le client dans le catalogue produits). Chaîne (255 caractères maximum)
  • disabled — Identifie les sujets qui ont été spécifiquement marqués comme désactivés par le client (dans le catalogue produits). Booléen
  • removed — Identifie les sujets qui ont été supprimés du catalogue d'un client (qui sont absents du catalogue produits et marqués comme inactifs dans la base de données de Bazaarvoice).

    Remarque : les sujets supprimés ou désactivés et le CGU qui leur est associé ne figurent pas dans le flux par défaut. Cependant, si le client confirme qu'il a besoin de ces données dans son flux quotidien, celui-ci peut être configuré afin de les inclure.

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 :

  • disabled — Identifie les sujets qui ont été spécifiquement marqués comme désactivés par le client (dans le catalogue produits). Booléen

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 :

  • id— Identifiant (tel qu’il a été fourni par le client dans le catalogue produits). Chaîne (255 caractères maximum)

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 :

  • locale — Utilisé dans un ensemble de champs (éléments) qui varient selon la langue dans le flux. Chaîne (25 caractères maximum)

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 :

  • locale — Utilisé dans un ensemble de champs (éléments) qui varient selon la langue dans le flux. Chaîne (25 caractères maximum)

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 &amp pour remplacer une esperluette, %20 pour un espace ou encore %5B et %5D pour les crochets ([ ]).

Attributs :

  • locale — Utilisé dans un ensemble de champs (éléments) qui varient selon la langue dans le flux. Chaîne (25 caractères maximum)

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 :

  • locale — Utilisé dans un ensemble de champs (éléments) qui varient selon la langue dans le flux. Chaîne (25 caractères maximum)

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 :

  • locale — Utilisé dans un ensemble de champs (éléments) qui varient selon la langue dans le flux. Chaîne (25 caractères maximum)

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 &amp pour remplacer une esperluette, %20 pour un espace ou encore %5B et %5D pour des crochets ([ ]).

Attributs :

  • locale — Utilisé dans un ensemble de champs (éléments) qui varient selon la langue dans le flux. Chaîne (25 caractères maximum)

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 &amp 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 &amp 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.

Remarque : La partie Catégorie est similaire à l'élément Produit de par sa structure. En revanche, les catégories sont conçues différemment et se trouvent à un niveau différent du flux.
É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 :

  • locale — Utilisé dans un ensemble de champs (éléments) qui varient selon la langue dans le flux. Chaîne (25 caractères maximum)

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 &amp pour remplacer une esperluette, %20 pour un espace ou encore %5B et %5D pour les crochets ([ ]).

Attributs :

  • locale — Utilisé dans un ensemble de champs (éléments) qui varient selon la langue dans le flux. Chaîne (25 caractères maximum)

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 &amp pour remplacer une esperluette, %20 pour un espace ou encore %5B et %5D pour des crochets ([ ]).

Attributs :

  • locale — Utilisé dans un ensemble de champs (éléments) qui varient selon la langue dans le flux. Chaîne (25 caractères maximum)

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 :

  • locale — Utilisé dans un ensemble de champs (éléments) qui varient selon la langue dans le flux. Chaîne (25 caractères maximum)

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 :

  • locale — Utilisé dans un ensemble de champs (éléments) qui varient selon la langue dans le flux. Chaîne (25 caractères maximum)

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 :

  • disabled — Tout comme les produits et les catégories, les marques peuvent être désactivées via l’import d’un catalogue produits (fourni par le client). Cet attribut est alors appliqué à ces marques. Booléen

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 :

  • locale — Utilisé dans un ensemble de champs (éléments) qui varient selon la langue dans le flux. Chaîne (25 caractères maximum)

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 :

  • id— Identifiant unique d’un élément de contenu dans le réseau de Bazaarvoice. Chaîne (255 caractères maximum)

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 :

  • id— Identifiant unique d’un élément de contenu dans le réseau de Bazaarvoice. Chaîne (255 caractères maximum)

Complex Object (contient un seul élément Value)

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 :

  • id — Identifiant d'un objet donné (comme le contenu, le sujet, la dimension ou la balise) et unique parmi tous les objets du même type. Chaîne (255 caractères maximum)

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 :

  • id — Identifiant d'un objet donné (comme le contenu, le sujet, la dimension ou la balise) et unique parmi tous les objets du même type. Chaîne (255 caractères maximum)
  • displayType — Spécifie l'option d'envoi choisie pour un barème de notation spécifique (l'utilisateur a le choix entre CURSEUR, RADIO ou NORMAL). Cette propriété est liée à l'affichage uniquement. Enum
  • selectedValueInDisplayEnabled — Valeur booléenne qui indique si la valeur sélectionnée par le curseur ou le bouton radio doit être affichée. Cette propriété est liée à l'affichage uniquement. Booléen

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 :

  • id — Identifiant d'un objet donné (comme le contenu, le sujet, la dimension ou la balise) et unique parmi tous les objets du même type. Chaîne (255 caractères maximum)

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 :

  • id — Identifiant d'un objet donné (comme le contenu, le sujet, la dimension ou la balise) et unique parmi tous les objets du même type. Chaîne (255 caractères maximum)

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 :

  • id — Identifiant d'un objet donné (comme le contenu, le sujet, la dimension ou la balise) et unique parmi tous les objets du même type. Chaîne (255 caractères maximum)

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 &amp 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 &amp 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 &amp 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 :

  • id — Identifiant d'un objet donné (comme le contenu, le sujet, la dimension ou la balise) et unique parmi tous les objets du même type. Chaîne (255 caractères maximum)

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 &amp 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 &amp 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 &amp 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 :

  • id — Identifiant d'un objet donné (comme le contenu, le sujet, la dimension ou la balise) et unique parmi tous les objets du même type. Chaîne (255 caractères maximum)

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 :

  • id — Identifiant d'un objet donné (comme le contenu, le sujet, la dimension ou la balise) et unique parmi tous les objets du même type. Chaîne (255 caractères maximum)

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 &amp 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 :

  • id — Identifiant d'un objet donné (comme le contenu, le sujet, la dimension ou la balise) et unique parmi tous les objets du même type. Chaîne (255 caractères maximum)

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 :

  • id — Identifiant d'un objet donné (comme le contenu, le sujet, la dimension ou la balise) et unique parmi tous les objets du même type. Chaîne (255 caractères maximum)

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 &amp 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 :

  • id — Identifiant d'un objet donné (comme le contenu, le sujet, la dimension ou la balise) et unique parmi tous les objets du même type. Chaîne (255 caractères maximum)

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 :

  • id — Identifiant d'un objet donné (comme le contenu, le sujet, la dimension ou la balise) et unique parmi tous les objets du même type. Chaîne (255 caractères maximum)

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 :

  • id — Identifiant d'un objet donné (comme le contenu, le sujet, la dimension ou la balise) et unique parmi tous les objets du même type. Chaîne (255 caractères maximum)

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 :

  • id — Identifiant d'un objet donné (comme le contenu, le sujet, la dimension ou la balise) et unique parmi tous les objets du même type. Chaîne (255 caractères maximum)
  • displayType — Spécifie l'option d'envoi choisie pour un barème de notation spécifique (l'utilisateur a le choix entre CURSEUR, RADIO ou NORMAL). Cette propriété est liée à l'affichage uniquement. Enum
  • selectedValueInDisplayEnabled — Valeur booléenne qui indique si la valeur sélectionnée par le curseur ou le bouton radio doit être affichée. Cette propriété est liée à l'affichage uniquement. Booléen

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 :

  • id — Identifiant d'un objet donné (comme le contenu, le sujet, la dimension ou la balise) et unique parmi tous les objets du même type. Chaîne (255 caractères maximum)

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 :

  • id — Identifiant d'un objet donné (comme le contenu, le sujet, la dimension ou la balise) et unique parmi tous les objets du même type. Chaîne (255 caractères maximum)
  • url — URL vers une image donnée dans une taille spécifique. URL / chaîne (255 caractères max)

    Remarque : si l'URL contient un caractère réservé (spécial), vous devez encoder en URL le caractère. Ainsi, utilisez &amp pour remplacer une esperluette, %20 pour un espace ou encore %5B et %5D pour les crochets ([ ]).

Objet vide (données dans les attributs XML)

Avatar

Contient l'avatar de l'utilisateur, y compris les URL et les tailles.

Attributs :

  • id — Identifiant d'un objet donné (comme le contenu, le sujet, la dimension ou la balise) et unique parmi tous les objets du même type. Chaîne (255 caractères maximum)
  • photo — Attribut d'un élément Avatar qui spécifie si l'URL fournie est une photo ou non. Booléen

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 &amp 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 &amp 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 :

  • id — Identifiant d'un objet donné (comme le contenu, le sujet, la dimension ou la balise) et unique parmi tous les objets du même type. Chaîne (255 caractères maximum)
  • disabled — Identifie les sujets qui ont été spécifiquement marqués comme désactivés par le client (dans le catalogue produits). Booléen
  • removed — Identifie les sujets qui ont été supprimés du catalogue du client (qui sont absents du catalogue produits et marqués comme inactifs dans la base de données de Bazaarvoice). Booléen

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
Remarque : Vos processus vitaux et pages de détails des produits (PDP) ne devraient pas dépendre des flux exportés. Bazaarvoice s'efforce de générer ces flux de manière constante, mais le chargement des serveurs et d'autres variables peuvent retarder l'export. N'utilisez ces flux que pour des processus non vitaux, pour qu'un retard de mise à jour n'ait pas d'impact sur vos systèmes, processus, PDP ou services. De plus, veuillez ne pas utiliser de flux exporté à des fins d'affichage. Utilisez plutôt les notes récapitulatives pour créer des détails au niveau de l'affichage comme des étoiles de résumé.

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

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.

  1. Connectez-vous au portail Bazaarvoice .
  2. Dans le portail du menu, sélectionnez Configuration.
  3. Sélectionnez l'instance Bazaarvoice.
  4. 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.
  5. 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.
  6. Sous Getting Started (Démarrer), sélectionnez Technical Setup (Configuration technique).
  7. 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)).
  8. 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.
  9. 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 dans Product > ReviewStatistics et dans NativeReviewStatistics.

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>
Remarque : 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.

Remarque : Bazaarvoice génère un flux DCE hebdomadaire complet le lundi, mais il n'y a pas de temps défini lorsque le flux est disponible pour les utilisateurs.

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 :

  1. Demander le fichier du manifeste.
  2. 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.
  3. Importer le CGU, les données de configuration et des produits dans votre base de données.
  4. 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.