Importation du contenu natif
Pour importer des notes, des avis, des questions et des réponses recueillis avant l'implémentation de Ratings & Reviews de Bazaarvoice sur votre site Web, vous pouvez transférer un flux d'importation de contenu natif vers Bazaarvoice. Le flux d'importation de contenu natif est un document XML qui définit les produits et le contenu généré par les utilisateurs (CGU) recueilli par votre propre solution ou un fournisseur tiers. Si vous ne disposez pas des ressources nécessaires pour produire un flux d'importation dans le format requis, Bazaarvoice peut convertir ces données pour vous (service payant).
Bazaarvoice commence par importer le flux dans votre environnement de pré-production afin de vérifier s'il s'affiche correctement. Ensuite, une fois que vous avez approuvé le contenu en pré-production, Bazaarvoice importe le contenu en production. Prévoyez jusqu'à deux semaines pour terminer ce processus.
Les exemples suivants illustrent la structure générale d'un flux simplifié d'importation de contenu natif :
-
Pour importer du contenu Ratings & Reviews :
<?xml version="1.0" encoding="UTF-8"?> <Feed> <Product> <ExternalId>...</ExternalId> <Reviews>...</Reviews> </Product> ... </Feed>
-
Pour importer du contenu Questions & Answers :
<?xml version="1.0" encoding="UTF-8"?> <Feed> <Product> <ExternalId>...</ExternalId> <Questions>...</Questions> </Product> ... </Feed>
Pré-requis
Pour importer du contenu natif ou tiers dans votre site, assurez-vous que vous disposez des pré-requis suivants.
Liste de contrôle avant importation
L'importation de contenu natif doit être incluse dans votre énoncé de travail, et la modération du contenu importé peut entraîner des coûts supplémentaires, qui dépendent de la quantité de contenu. Si nécessaire, contactez votre chargé de compte Bazaarvoice pour connaître les tarifs.
De plus, assurez-vous d'avoir accompli les tâches suivantes ou d'en avoir pris connaissance :
- UserProfile (profil utilisateur)
- UserLocation (localisation utilisateur)
Échelle à 10 points |
Échelle à 5 points |
Échelle à demi-points |
Échelle à 5 points |
|
---|---|---|---|---|
1,0-1,9 |
1 |
0,0 à 1,4 |
1 |
|
2,0-4,0 | 2 | 1,5-2,4 | 2 | |
4,1 à 6,9 | 3 | 2,5-3,4 | 3 | |
7,0-9,0 | 4 | 3,5-4,4 | 4 | |
9,1-10,0 | 5 | 4,5-5,0 | 5 |
Respect de la politique d'authenticité
Pour importer du contenu natif ou tiers, vérifiez que le contenu est conforme à la Politique d'authenticité de Bazaarvoice . De plus, veuillez prêter une attention toute particulière aux points suivants :
- Les nouveaux clients ont la possibilité d'importer du contenu hérité sur Bazaarvoice, sans limite et en une seule fois. Lors de l'importation et de la syndication du contenu hérité, la modération textuelle de Bazaarvoice est requise pour le traitement des données. La modération entraîne des frais supplémentaires.
- Les clients existants ont la possibilité d'importer du contenu si celui-ci est accompagné de l'adresse IP, de la date de soumission originale du contenu ainsi que du nom d'utilisateur de l'émetteur. Le contenu ne peut être importé s'il est acheté, collecté par un tiers, à partir d'un échantillonnage ou d'un robot — à l'exception du programme de partenariat pour l'acquisition de contenu (CAPP).
- Le contenu importé ne peut pas être syndiqué s'il n'a pas été modéré par Bazaarvoice.
- Le contenu importé ne peut pas syndiqué que s'il s'agit du contenu hérité d'un nouveau client Bazaarvoice.
- Le label de confiance de Bazaarvoice ne peut pas être affiché avec un contenu importé.
- Bazaarvoice ne peut ni accepter ni afficher les commentaires qui vous ont été soumis sur papier ou par l'intermédiaire d'un sondage. Les avis doivent correspondre à un produit ou service spécifique.
Directives de modération
Afin que votre contenu importé puisse être modéré en fonction des besoins spécifiques à votre activité, veuillez lire et approuver vos directives. Si vous n'êtes pas sûr d'avoir terminé cette étape, veuillez contacter Bazaarvoice. Consultez notre procédure de modération pour plus d'informations.
Afficher des informations supplémentaires
Lorsque vous importez du contenu natif ou tiers, celui-ci est automatiquement mis en correspondance avec les fonctionnalités standard de Ratings & Reviews affichées pour chacun de vos produits. En d'autres termes, il vous suffit de créer un flux d'importation de contenu natif, puis de le transférer vers Bazaarvoice si votre contenu ne comprend que les éléments suivants :
- Notes
- Les titres et le texte des avis
- Les informations sur l'utilisateur
- Questions
- Answers
Cependant, si votre contenu comprend des informations supplémentaires (des notes secondaires, des informations produit telles que l'utilité ou la valeur du produit, ou des votes sur l'utilité des commentaires), vous devez préciser à Ratings & Reviews la façon dont vous voulez faire apparaître ces informations supplémentaires. Pour ce faire, vous devez utiliser la plateforme de configuration Ratings & Reviews avant d'importer le flux. Si vous ne le faites pas, le contenu importé ne sera pas affiché.
Configurer des notes supplémentaires, des questions pour le formulaire de soumission et des balises
Effectuez les étapes suivantes pour chaque note supplémentaire, question de formulaire de soumission ou balise que vous importerez :
- Connectez-vous au portail Bazaarvoice .
- Sélectionnez Configuration dans le menu du portail situé dans le coin supérieur gauche de l'écran.
- Sélectionnez une instance.
- Sélectionnez Go to Configuration (Aller à Configuration). Le Site Manager (gestionnaire de site) apparaît et liste les zones de déploiement et les implémentations disponibles.
Remarque : vous pouvez également ajouter de nouvelles zones de déploiement et des implémentations sur cet écran.
- Dans Implementations (Implémentations), trouvez le nom de l'implémentation dont vous avez besoin à l'aide du filtre.
- Sélectionnez Edit (Modifier) à côté de l'implémentation où vous souhaitez ajouter les notes, questions ou balises.
- Dans le menu à gauche de la page, sélectionnez Submission Form Editor (Éditeur du formulaire de soumission) sous User Experience (Expérience utilisateur).
- Sélectionnez l'icône située dans le coin supérieur gauche de la page pour trouver le nom de la catégorie de produit ou l'identifiant du formulaire de soumission que vous souhaitez modifier.
Remarque : l'éditeur affiche automatiquement le formulaire de soumission All Products (Tous les produits). Si vous ajoutez, modifiez ou supprimez des questions dans ce formulaire, l'éditeur applique ces modifications à tous les formulaires liés.
- Ajoutez une nouvelle question au formulaire de soumission dans lequel vous souhaitez afficher le contenu importé :
- Pour ajouter une note supplémentaire (secondaire) concernant le produit, son efficacité ou sa valeur, sélectionnez + New Question (+ Nouvelle question) dans la section Ratings (Notes), puis sélectionnez Add a Custom Question (Ajouter une question personnalisée). (Cette question correspond à l'élément
<RatingValues>
dans le flux.) - Pour ajouter une question déroulante pour un produit, sélectionnez + New Question (+ Nouvelle question) dans la section Product (Produit), puis sélectionnez Add a Custom Question (Ajouter une question personnalisée). Sélectionnez Dropdown Select (Sélection par menu déroulant) comme type de question. (Cette question correspond à l'élément
<ContextDataValues>
dans le flux.) - Pour ajouter une question déroulante pour un utilisateur, sélectionnez + New Question (+ Nouvelle question) dans la section People (Personnes), puis sélectionnez Add a Custom Question (Ajouter une question personnalisée). Sélectionnez Dropdown Select (Sélection par menu déroulant) comme type de question. (Cette question correspond à l'élément
<ContextDataValues>
dans le flux.) - Pour ajouter un texte libre à propos d'un produit, sélectionnez + New Question (+ Nouvelle question) dans la section Product (Produit), puis sélectionnez Add a Custom Question (Ajouter une question personnalisée). Sélectionnez Free Text (Texte libre) comme type de question. (Cette question correspond à l'élément
<AdditionalFields>
dans le flux.) - Pour afficher des informations supplémentaires sur les utilisateurs sous forme de texte libre, sélectionnez + New Question (+ Nouvelle question) dans la section People (Personnes), puis sélectionnez Add a Custom Question (Ajouter une question personnalisée). Sélectionnez Free Text (Texte libre) comme type de question. (Cette question correspond à l'élément
<AdditionalFields>
dans le flux.) - Pour ajouter une balise de description d'un produit, sélectionnez + New Question (+ Nouvelle question) dans la section Product (Produit), puis sélectionnez Add a Custom Question (Ajouter une question personnalisée). Sélectionnez Tag Groups (Groupes de balises) comme type de question. (Cette question correspond à l'élément
<Tags>
dans le flux.)
Pour plus d'informations sur les questions du formulaire de soumission, consultez le Guide des questions pour le formulaire d'évaluation.
- Pour ajouter une note supplémentaire (secondaire) concernant le produit, son efficacité ou sa valeur, sélectionnez + New Question (+ Nouvelle question) dans la section Ratings (Notes), puis sélectionnez Add a Custom Question (Ajouter une question personnalisée). (Cette question correspond à l'élément
- Enregistrez l'identifiant et le type de question sélectionnés. Vous aurez besoin de ces informations pour créer le flux.
- Déployez les changements dans l'implémentation.
Configurer le vote d’évaluation de l'utilité des avis
Effectuez les étapes suivantes pour importer des votes d'évaluation de l'utilité des avis. Lorsque vous créez un fichier d'importation, ces informations de vote d'utilité sont mises en correspondance avec l'élément <ReviewStatistics>
.
- Connectez-vous au portail .
- Sélectionnez Configuration dans le menu du portail situé dans le coin supérieur gauche de l'écran.
- Sélectionnez une instance.
- Sélectionnez Go to Configuration (Aller à Configuration). Le Site Manager (gestionnaire de site) apparaît et liste les zones de déploiement et les implémentations disponibles.
Remarque : vous pouvez également ajouter de nouvelles zones de déploiement et des implémentations sur cet écran.
- Dans Implementations (Implémentations), trouvez le nom de l'implémentation dont vous avez besoin à l'aide du filtre.
- Sélectionnez Edit (Modifier) à côté de l'implémentation pour laquelle vous voulez activer la fonction d'évaluation de l'utilité.
- Dans le menu à gauche de la page, sélectionnez Display Options (Options d'affichage) sous User Experience (Expérience utilisateur).
- Sélectionnez l'onglet Ratings & Reviews (Notes et avis).
- Dans la section Review Helpfulness Voting (Votes d'évaluation de l'utilité d'un avis), sélectionnez Enabled (Activés).
- Déployez les changements dans l'implémentation.
Créer et charger le fichier de flux XML
Pour que votre site Web puisse afficher du contenu natif ou tiers, vous devez créer un flux d'importation de contenu natif afin que Bazaarvoice puisse importer ce contenu. Le flux d'importation est un document XML qui définit les produits et le CGU recueilli par votre propre solution ou votre fournisseur tiers.
Avant de commencer, prenez connaissance des recommandations suivantes :
- Réfléchissez à exclure les avis contenant une note de 0. Ces avis auront un impact négatif sur la note moyenne globale d'un produit.
- Convertissez les avis qui utilisent une échelle à 10 points ou comprenant les demi-points.
Effectuez les étapes suivantes pour créer votre flux d'importation de contenu natif et l'envoyer à Bazaarvoice.
Étape 1 : Créez le fichier XML du flux.
Générez votre flux comme vous l'entendez en fonction de votre système et de vos processus. Quelle que soit la situation, chaque flux doit être un fichier XML suivant la même structure.
Commencez à structurer votre catalogue de produits en vous reportant au schéma qui définit la structure et les contenus du flux. Consultez les exemples pour visualiser des flux en intégralité.
Bazaarvoice vous recommande de respecter les meilleures pratiques suivantes lorsque vous créez un flux de fichiers :
-
Vérifiez que la première ligne de votre flux correspond au format suivant :
<?xml version="1.0" encoding="utf-8"?>
- Tout caractère spécial que vous utilisez dans le flux doit correspondre au schéma standard pour l'encodage des caractères, tel que UTF-8 ou Windows-1252.
- Si vous ne disposez d'aucune valeur pour un champ particulier, omettez-le. N'incluez pas de champs vides dans votre flux.
Étape 2 : Vérifiez les éléments et les attributs.
Vous devez utiliser les éléments et attributs appropriés pour décrire les informations sur les produits et le CGU. Reportez-vous aux tableaux suivants pour prendre connaissance des éléments enfants et des attributs des éléments <Feed>
, <Product>
, <Reviews>
, <Questions>
, <ReviewStatistics>
et <QAStatistics>
.
Élément du flux
Le tableau suivant répertorie les attributs obligatoires de l'élément <Feed>.
Attribut | Description |
---|---|
xmlns | Référence du schéma. Définissez cette valeur sur http://www.bazaarvoice.com/xs/PRR/StandardClientFeed/14.8. |
name | La version courte de votre nom de client Bazaarvoice. |
extractDate | Horodatage renseigné automatiquement au format XML DateTime . |
<Feed xmlns="http://www.bazaarvoice.com/xs/PRR/StandardClientFeed/14.8" name="ABCCompany" extractDate="2016-11-21T22:44:33.179+01:00">
Élément Produit
L'élément <Product>
définit un produit dans votre flux et peut contenir les éléments enfants <Reviews>
et <Questions>
. Vous pouvez inclure de nombreux éléments <Product>
dans votre flux, à savoir un pour chaque produit.
Cet élément doit inclure :
- L'attribut id — sa valeur doit correspondre à la valeur
ExternalId
du produit dans votre catalogue de produits. - L'élément enfant
<ExternalId>
— sa valeur doit correspondre à la valeur de l'attribut id.
Reportez-vous au schéma du flux ou à la structure du flux client standard pour obtenir une liste complète des éléments disponibles.
<Product id="1010"> <ExternalId>1010</ExternalId> <Reviews>...</Reviews> <Questions>...</Questions> </Product>
Éléments Ratings and Reviews
Cet élément contient les éléments enfants <Review>
, à savoir un élément pour chaque contenu que vous souhaitez importer et afficher avec votre produit.
Chaque élément <Review>
doit inclure l'attribut id, qui doit être une valeur unique (nombre entier). Ensuite, précisez les éléments enfants dans chaque élément <Review>
. Le tableau suivant fournit les éléments les plus courants. Reportez-vous au schéma du flux ou à la structure du flux client standard pour obtenir une liste complète des éléments disponibles.
Élément | Valeur |
---|---|
Obligatoire |
Le statut actuel d'un avis donné, à savoir si cet avis est en attente d'une action de la part des modérateurs ou du CMS, ou bien s'il est approuvé ou rejeté. Valeurs possibles : APPROUVÉ et REJETÉ. Type : enum Affecte: l'affichage, les rapports |
Obligatoire |
Informations sur le profil de l'utilisateur. Si cet élément est ignoré, l'avis est importé en tant qu'« Anonyme ». Cet élément est requis si l'avis est destiné à la syndication. Pour chaque élément
|
Meilleures pratiques |
Titre d'un avis au format spécifié par son auteur. Type : chaîne (varchar (255)) Affecte: l'affichage |
Meilleures pratiques |
Texte complet de l'avis au format spécifié par son auteur. Type : chaîne (texte) Affecte: l'affichage |
Obligatoire |
Une valeur d'évaluation choisie par l'auteur d'un avis (reflète généralement le nombre d'« étoiles »). Type : nombre entier (int (11)) Affecte: l'affichage, les rapports |
Obligatoire |
L'adresse IP de l'auteur de l'avis. Cet élément est requis si un client Bazaarvoice existant souhaite importer du contenu. Type : chaîne (varchar (255)) Affecte: l'authenticité |
Facultatif |
Indique si l'avis porte un indicateur « Recommandé ». Cela signifie que durant la soumission de l'avis, l'utilisateur a confirmé qu'il recommanderait le produit à un ami. Type : booléen Affecte: l'affichage, les rapports |
Meilleures pratiques |
Adresse e-mail de l'utilisateur. Cet élément est facultatif, mais il est recommandé de l’inclure. Type : chaîne (varchar (255)) Affecte: les rapports, l'authenticité, la fonctionnalité plateforme |
Facultatif |
Localisation de l'utilisateur. Type : chaîne (varchar (255)) Affecte: l'affichage |
Obligatoire |
Heure d'envoi d'un avis par son auteur (avant le processus de modération). Doit correspondre au format XML DateTime . Cet élément est requis si un client Bazaarvoice existant souhaite importer du contenu. Type : date (Timestamp) Affecte:l'authenticité, l'affichage, les rapports |
Facultatif |
Indique si ce contenu est particulièrement intéressant et bien écrit. Cette valeur est attribuée pendant la modération. Cet élément est requis. Type : booléen Affecte: l'affichage, les rapports |
Meilleures pratiques |
Langue dans laquelle l'avis a été envoyé. Cet élément est requis si vous importez du contenu de différentes langues ou zones géographiques. Type : chaîne (varchar (25)) Affecte: l'affichage, les rapports |
Facultatif |
Nombre de retours sur un avis donné (positifs et négatifs). Type : nombre entier (4 octets) Affecte: l'affichage, les rapports |
Facultatif |
Nombre de retours positifs sur un avis donné. Type : nombre entier (4 octets) Affecte: l'affichage, les rapports |
Facultatif |
Nombre de retours négatifs sur un avis donné. Type : nombre entier (4 octets) Affecte: l'affichage, les rapports |
Facultatif |
Nombre de fois qu'un avis a été signalé comme inapproprié ou non pertinent par les consommateurs. Type : nombre entier (4 octets) Affecte: l'affichage, les rapports |
Facultatif |
Une liste des questions supplémentaires (non posées par défaut) sous forme de texte libre qui peuvent figurer dans l'avis. Spécifiez cet élément et ses éléments enfants si vous souhaitez afficher un avis sous forme de texte libre pour un produit ou un utilisateur. Chaque élément
Affecte: l'affichage, les rapports |
Facultatif |
Une liste des réponses de clients obtenues par un représentant de votre entreprise concernant un commentaire laissé par un consommateur sur un produit. Pour chaque élément
Affecte: l'affichage |
Facultatif |
Une liste de dimensions de balises. Spécifiez cet élément et ses éléments enfants si vous souhaitez afficher des balises produit. Chaque élément
Affecte: l'affichage |
Facultatif |
Ensemble de photos et légendes ajoutées par l'auteur. Chaque élément enfant
Affecte: l'affichage |
Facultatif |
Ensemble de vidéos et légendes ajoutées par l'auteur. Pour chaque élément
Affecte: l'affichage |
Facultatif |
Liste des questions déroulantes qui peuvent figurer dans un avis. Spécifiez cet élément et ses enfants si vous souhaitez afficher des informations recueillies via une question déroulante pour un produit ou un utilisateur. Chaque élément enfant
Affecte: l'affichage |
Facultatif |
Une liste des notes secondaires pour différentes dimensions ou qualités d'un produit. Spécifiez cet élément et ses éléments enfants si vous souhaitez afficher une note supplémentaire (secondaire) pour un produit. Pour chaque élément
Affecte: l'affichage |
<Reviews> <Review id="12" removed="false"> <ModerationStatus>APPROVED</ModerationStatus> <UserProfileReference id="jimbob101"> <ExternalId>jimbob101</ExternalId> <DisplayName>JimBob</DisplayName> <Anonymous>false</Anonymous> <HyperlinkingEnabled>false</HyperlinkingEnabled> </UserProfileReference> <Title>What an amazing product!</Title> <ReviewText>This product is great and I'll definitely recommend it to my friends!</ReviewText> <Rating>4</Rating> <IpAddress>198.51.100.0</IpAddress> <Recommended>true</Recommended> <UserEmailAddress>jimbob101@example.com</UserEmailAddress> <ReviewerLocation>Austin, TX</ReviewerLocation> <SubmissionTime>2012-01-23T04:26:14.000-06:00</SubmissionTime> <Featured>false</Featured> <DisplayLocale>en_US</DisplayLocale> <Photos> <Photo id="104358"> <Caption>Thumbs and some Normal</Caption> <Sizes> <Size id="thumbnail" url="https://ABCCompany.com/commons/5/50/Emoji_Grinning_Face.svg"/> <Size id="normal" url="https://ABCCompany.com/commons/thumb/5/50/Emoji_Grinning_Face.svg/2000px-Emoji_Grinning_Face.svg.png"/> </Sizes> </Photo> </Photos> </Review> ... </Reviews>
Questions et éléments de questions
Cet élément contient les éléments enfants <Question>
, à savoir un élément pour chaque contenu que vous souhaitez importer et afficher avec votre produit.
Chaque élément <Question>
doit inclure l'attribut id, qui doit être une valeur unique (nombre entier). Ensuite, précisez les éléments enfants dans chaque élément <Question>
. Le tableau suivant fournit les éléments les plus courants. Reportez-vous au schéma du flux ou à la structure du flux client standard pour obtenir une liste complète des éléments disponibles.
Élément | Valeur | |
---|---|---|
SubmissionTime |
Heure d'envoi de la question par son auteur (avant le processus de modération). Doit correspondre au format XML DateTime . Type : date (Timestamp) |
|
Pseudo de l'utilisateur |
Pseudo choisi par l'auteur de la question.Il doit être unique parmi tous les utilisateurs spécifiés dans le flux, sauf si les doublons de pseudos sont autorisés. Type : chaîne (varchar (255)) |
|
UserLocation |
Ville de l'auteur de la question. Type : chaîne (varchar (255)) |
|
Résumé des questions |
La ligne de résumé de la question. Type : chaîne (varchar (255)) |
|
Détails de la question |
Le corps de la question. Type : chaîne (texte) |
|
DisplayLocale |
Langue dans laquelle la question a été envoyée. Cet élément est obligatoire si vous importez du contenu de différentes langues ou zones géographiques. Type : chaîne (varchar (25)) |
|
Answers et Answer |
Une liste de réponses à la question. Pour chaque élément |
|
<SubmissionTime> |
Heure d'envoi de la réponse par son auteur (avant le processus de modération). Type : date (Timestamp) |
|
<UserProfileReference> |
Informations sur le profil de l'utilisateur. Si cet élément est ignoré, la réponse est importée en tant qu'« Anonyme ». Pour chaque élément <UserProfileReference> spécifiez ces éléments enfants. |
|
<UserNickname> |
Pseudo choisi par l'auteur d'une réponse. Il doit être unique parmi tous les utilisateurs spécifiés dans le flux, sauf si les doublons de pseudos sont autorisés. Type : chaîne (varchar (255)) |
|
<UserLocation> |
Ville de l'auteur de la réponse. Type : chaîne (varchar (255)) |
|
<AnswerText> |
Texte de la réponse à la question. Type : chaîne (texte) |
|
<DisplayLocale> |
Langue dans laquelle la réponse a été envoyée. Type : chaîne (varchar (25)) |
<Questions> <Question id="44135"> <SubmissionTime>2008-11-21T22:44:33.179+01:00</SubmissionTime> <UserNickname>Dave</UserNickname> <UserLocation>Paris</UserLocation> <QuestionSummary>Peut-on importer les questions Q&A ?</QuestionSummary> <QuestionDetails>Je demande simplement par curiosité</QuestionDetails> <DisplayLocale>fr_FR</DisplayLocale> <Answers> <Answer id="1"> <SubmissionTime>2008-11-22T22:44:33.179+01:00</SubmissionTime> <UserProfileReference id="Tim"> <ExternalId>Tim</ExternalId> <Anonymous>false</Anonymous> <HyperlinkingEnabled>false</HyperlinkingEnabled> </UserProfileReference> <UserNickname>Tim</UserNickname> <UserLocation>Lyon</UserLocation> <AnswerText>Je pense, oui</AnswerText> <DisplayLocale>fr_FR</DisplayLocale> </Answer>...</Answers></Question>...</Questions>
Éléments ReviewStatistics and QAStatistics
Si vous souhaitez importer des évaluations quant à l'utilité d'un avis, veillez à activer la fonction d'évaluation de l'utilité dans la plateforme de configuration. Vous devrez ensuite inclure au moins un de ces éléments dans votre flux. <ReviewStatistics>
affiche les statistiques issues de Ratings & Reviews. <QAStatistics>
affiche les statistiques issues de Questions & Answers.
Le tableau suivant regroupe les éléments enfants qui sont associés à la fonction d'évaluation de l'utilité des avis. Reportez-vous au schéma du flux ou à la structure du flux client standard pour obtenir une liste complète des éléments disponibles.
Élément | Valeur |
---|---|
QuestionHelpfulVoteCount |
Nombre de votes « Utile » récoltés par toutes les questions approuvées d'un utilisateur. Type : nombre entier (4 octets) |
QuestionNotHelpfulVoteCount |
Nombre de votes « Inutile » récoltés par toutes les questions approuvées d'un utilisateur. Type : nombre entier (4 octets) |
AnswerHelpfulVoteCount |
Nombre de votes « Utile » récoltés par toutes les réponses approuvées d'un utilisateur. Type : nombre entier (4 octets) |
AnswerNotHelpfulVoteCount |
Nombre de votes « Inutile » récoltés par toutes les réponses approuvées d'un utilisateur. Type : 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. Type : 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. Type : nombre entier (4 octets) |
<ReviewStatistics> <HelpfulVoteCount>0</HelpfulVoteCount> <NotHelpfulVoteCount>1</NotHelpfulVoteCount> </ReviewStatistics> <QAStatistics> <QuestionHelpfulVoteCount>26</QuestionHelpfulVoteCount> <QuestionNotHelpfulVoteCount>5</QuestionNotHelpfulVoteCount> <AnswerHelpfulVoteCount>145</AnswerHelpfulVoteCount> <AnswerNotHelpfulVoteCount>2</AnswerNotHelpfulVoteCount> <HelpfulVoteCount>178</HelpfulVoteCount> </QAStatistics>
Étape 3 : valider et préparer le flux
Votre flux doit bénéficier d'une syntaxe XML correcte et compatible avec le schéma XML de Bazaarvoice . Effectuez les étapes suivantes pour créer votre flux de produits et l'envoyer à Bazaarvoice :
- Validez votre flux avec le schéma XML de Bazaarvoice avant de le charger sur Bazaarvoice. Vous pouvez utiliser un outil de validation XML pour valider votre flux.
- Si vous rencontrez des messages d'erreur ou d'avertissement, veuillez régler le problème puis valider à nouveau le flux.
- Si la taille du fichier est supérieure à 150 Mo (ce qui correspond environ à plus de 100 000 avis), vous devrez séparer le flux en plusieurs fichiers distincts. Vous pouvez réaliser cette opération manuellement avec un éditeur de texte, ou utiliser un outil de ligne de commande tel que xmlsplit .
- Si le contenu n'est pas en anglais, assurez-vous que le flux XML intègre bien la bonne balise de langue et de zone géographique.
Étape 4 : Chargez le flux.
Vous devez charger le flux d'importation de contenu natif sur le serveur de production. Au préalable, Bazaarvoice vous conseille de prévisualiser et tester l'impact du flux sur le serveur de pré-production.
- Chargez le fichier XML dans le répertoire
/native
du serveur SFTP de pré-production et de production.- Si vos données sont hébergées aux États-Unis, utilisez les URL suivantes :
- Serveur de test – sftp-stg.bazaarvoice.com
- Serveur de production – sftp.bazaarvoice.com
- Si vos données sont hébergées en Europe, utilisez les URL suivantes :
- Serveur de test – sftp7-stg.bazaarvoice.com
- Serveur de production – sftp7.bazaarvoice.com
Veillez à vous connecter au serveur SFTP via le port 22. Si vous ne connaissez pas vos identifiants SFTP ou si vous ne savez pas où sont hébergées vos données, veuillez contacter l'assistance client Bazaarvoice.
- Si vos données sont hébergées aux États-Unis, utilisez les URL suivantes :
- Contactez Bazaarvoice pour confirmer que vous avez bien validé et chargé le flux. Le contenu ne sera pas importé tant que vous n'aurez pas contacté Bazaarvoice.
Exemples de flux complet
Voici un exemple de flux complet pour Ratings & Reviews :
<?xml version="1.0" encoding="utf-8"?> <Feed xmlns="http://www.bazaarvoice.com/xs/PRR/StandardClientFeed/14.8" name="ExampleClient" extractDate="2016-02-12T05:17:33.945-06:00"> <Product id="1010"> <ExternalId>1010</ExternalId> <Reviews> <!-- The following is an example of a basic review - it features the most common elements included in import feeds. These elements are required for syndication: - <IpAddress> - <DisplayName> - <SubmissionTime> --> <Review id="12" removed="false"> <ModerationStatus>APPROVED</ModerationStatus> <UserProfileReference id="jimbob101"> <ExternalId>jimbob101</ExternalId> <DisplayName>JimBob</DisplayName> <Anonymous>false</Anonymous> <HyperlinkingEnabled>false</HyperlinkingEnabled> </UserProfileReference> <Title>What an amazing product!</Title> <ReviewText>This product is great and I'll definitely recommend it to my friends!</ReviewText> <Rating>4</Rating> <IpAddress>198.51.100.0</IpAddress> <Recommended>true</Recommended> <UserEmailAddress>jimbob101@example.com</UserEmailAddress> <ReviewerLocation>Austin, TX</ReviewerLocation> <SubmissionTime>2012-01-23T04:26:14.000-06:00</SubmissionTime> <Featured>false</Featured> <DisplayLocale>en_US</DisplayLocale> </Review> <!-- This following is a sample review featuring additional attributes that can be included in this file. --> <Review id="11" removed="false"> <ModerationStatus>APPROVED</ModerationStatus> <UserProfileReference id="miketester112"> <ExternalId>miketester112</ExternalId> <DisplayName>supermike</DisplayName> <Anonymous>false</Anonymous> <HyperlinkingEnabled>false</HyperlinkingEnabled> </UserProfileReference> <Title>Best product ever!</Title> <ReviewText>This product truly changed my life; I don't know what I'd do without it.</ReviewText> <Rating>5</Rating> <IpAddress>198.51.100.1</IpAddress> <Recommended>true</Recommended> <UserEmailAddress>supermike@example.com</UserEmailAddress> <ReviewerLocation>Austin, TX</ReviewerLocation> <SubmissionTime>2012-01-23T12:59:25.000-06:00</SubmissionTime> <Featured>false</Featured> <DisplayLocale>en_US</DisplayLocale> <!-- See below for the different types of review feedback. - <NumFeedbacks> is the number of any feedbacks on a given review (positive + negative). - <NumPositiveFeedbacks> is the number of positive feedbacks on a given review. - <NumNegativeFeedbacks> is the number of negative feedbacks on a given review. - <NumInappropriateFeedbacks> is the number of times consumers reported that this review has inappropriate content. --> <NumFeedbacks>3</NumFeedbacks> <NumPositiveFeedbacks>2</NumPositiveFeedbacks> <NumNegativeFeedbacks>1</NumNegativeFeedbacks> <NumInappropriateFeedbacks>1</NumInappropriateFeedbacks> <!-- The following field allows you to add a custom question with a free-text response. All listed elements are required. - <DisplayLabel> represents the consumer-facing label of the question - <Value> is where the reviewer's free-text answer is included. --> <AdditionalFields> <AdditionalField id="CustomQuestion"> <DisplayLabel>Custom Question:</DisplayLabel> <Value>This is my custom answer</Value> </AdditionalField> </AdditionalFields> <!-- The following field allows you to add company responses to reviews. All elements listed are required unless otherwise noted. - <ClientResponse> is the field where a representative of your company has responded up to a consumer comment left on a product. - <Department> is not required, but recommended if the responding party's department is available. - <Name> is not required, but recommended if the responding party's name is available. - <Response> is where you include your company's response to a review. This field is required. - <ResponseSource> is not required, but recommended if you have data on where the response from your company's representative was generated. In this example, the response came from 'Workbench', which is where Bazaarvoices' clients generally generate responses to consumer reviews. - <Date> is required in datetime format. --> <ClientResponses> <ClientResponse> <Department>Responding Department's Name</Department> <Name>Respondant's Name</Name> <Response>Our number one priority is to deliver exceptional value to our fantastic customers every day. We will contact you straight away to see how we can improve the outcome for you. </Response> <ResponseSource>Workbench</ResponseSource> <Date>2016-11-12T13:21:43.000-06:00</Date> </ClientResponse> </ClientResponses> <!-- The Tags field allows you to add tags and tag dimensions to the review. All listed elements are required. - <TagDimension><Label> is the client-facing label that the tags live within. - <Tag><Label> are the different tag names that fall underneath <TagDimension><Label> (in the example below, these labels live within the "Pro" or "Con" master label). --> <Tags> <TagDimension id="Pro"> <ExternalId>Pro</ExternalId> <Label>Pros</Label> <Tags> <Tag> <Label>Entertaining Friends</Label> </Tag> <Tag> <Label>Daily practicing</Label> </Tag> <Tag> <Label>Nice sound</Label> </Tag> </Tags> </TagDimension> <TagDimension id="Con"> <ExternalId>Con</ExternalId> <Label>Cons</Label> <Tags> <Tag> <Label>Very loud</Label> </Tag> <Tag> <Label>Requires practice</Label> </Tag> </Tags> </TagDimension> </Tags> <!-- The following fields allow you to add add photos or videos included in a review. All elements listed are required unless otherwise noted. - <Photo id="___"> and <VideoId> are both required. You can include any alpha-numeric ID you'd like here, ensuring that each ID is unique. - <Caption> is an optional field. --> <Photos> <Photo id="104358"> <Caption>Thumbs and some Normal</Caption> <Sizes> <Size id="thumbnail" url="https://upload.wikimedia.org/wikipedia/commons/5/50/Emoji_Grinning_Face.svg"/> <Size id="normal" url="https://upload.wikimedia.org/wikipedia/commons/thumb/5/50/Emoji_Grinning_Face.svg/2000px-Emoji_Grinning_Face.svg.png"/> </Sizes> </Photo> </Photos> <Videos> <Video> <Caption>Burgers and Fries</Caption> <VideoHost>www.youtube.com</VideoHost> <VideoId>burgersandfries</VideoId> <RawUrlInput>https://www.youtube.com/watch?v=DcJFdCmN98s</RawUrlInput> </Video> </Videos> <!-- Context data values are custom fields with pre-defined answers that a user can choose from. All listed fields are required. - <ContextDataValue> is the response to the ContextDataDimension. - <ContextDataDimension> is the label/question being responded to. - <Label> is the client-facing label. --> <ContextDataValues> <ContextDataValue id="35to44"> <ContextDataDimension id="Age"> <ExternalId>Age</ExternalId> <Label>Age</Label> </ContextDataDimension> <ExternalId>35to44</ExternalId> <Label>35 to 44</Label> </ContextDataValue> <ContextDataValue id="Female"> <ContextDataDimension id="Gender"> <ExternalId>Gender</ExternalId> <Label>Gender</Label> </ContextDataDimension> <ExternalId>Female</ExternalId> <Label>Female</Label> </ContextDataValue> <ContextDataValue id="InStore"> <ContextDataDimension id="ROBO"> <ExternalId>ROBO</ExternalId> <Label>Where Purchased:</Label> </ContextDataDimension> <ExternalId>InStore</ExternalId> <Label>In-Store</Label> </ContextDataValue> <ContextDataValue id="True"> <ExternalId>True</ExternalId> <Label>Yes</Label> <ContextDataDimension id="VerifiedPurchaser"> <ExternalId>VerifiedPurchaser</ExternalId> <Label>Verified Purchaser</Label> </ContextDataDimension> </ContextDataValue> <ContextDataValue id="False"> <ExternalId>False</ExternalId> <Label>No</Label> <ContextDataDimension id="IncentivizedReview"> <ExternalId>IncentivizedReview</ExternalId> <Label>Incentivized Review</Label> </ContextDataDimension> </ContextDataValue> </ContextDataValues> <!-- The following fields add rating values to reviews. - The <Rating> field is the rating given to value listed below. - The <RatingDimension> field contains the following: - The displayType indicates the type of tool used to provide the rating value (see below for additional examples.) - The selectedValueInDisplayEnabled indicates whether the value should be shown in display or hidden. - <ExternalId> represents the value being rated. - <Label> is the client-facing label of value being rated. - <RatingRange> represents the total rating-range available. --> <RatingValues> <RatingValue> <Rating>5</Rating> <RatingDimension displayType="NORMAL" id="Quality" selectedValueInDisplayEnabled="false"> <ExternalId>Quality</ExternalId> <Label>Quality</Label> <RatingRange>5</RatingRange> </RatingDimension> </RatingValue> <RatingValue> <Rating>5</Rating> <RatingDimension displayType="SLIDER" id="Fragrance" selectedValueInDisplayEnabled="false"> <ExternalId>Fragrance</ExternalId> <Label>Fragrance</Label> <RatingRange>5</RatingRange> </RatingDimension> </RatingValue> <RatingValue> <Rating>5</Rating> <RatingDimension displayType="RADIO" id="Effectiveness" selectedValueInDisplayEnabled="false"> <ExternalId>Effectiveness</ExternalId> <Label>Effectiveness</Label> <RatingRange>5</RatingRange> </RatingDimension> </RatingValue> </RatingValues> </Review> </Reviews> </Product> </Feed>
Voici un exemple de flux complet pour Questions & Answers :
<?xml version="1.0" encoding="UTF-8"?> <Feed xmlns="http://www.bazaarvoice.com/xs/PRR/StandardClientFeed/14.8" name="ExampleClient" extractDate="2016-11-21T22:44:33.179+01:00"> <Product id="1010"> <ExternalId>1010</ExternalId> <Questions> <!-- The following is an example of basic questions and answers. These elements are required for syndication: - <IpAddress> - <DisplayName> - <SubmissionTime> --> <Question id="44135"> <SubmissionTime>2016-11-21T22:44:33.179+01:00</SubmissionTime> <UserProfileReference id="jimbob101"> <ExternalId>jimbob101</ExternalId> <DisplayName>JimBob</DisplayName> <Anonymous>false</Anonymous> <HyperlinkingEnabled>false</HyperlinkingEnabled> </UserProfileReference> <UserLocation>Austin, TX</UserLocation> <QuestionSummary>Can we import Q&A questions?</QuestionSummary> <QuestionDetails>The reason I ask is that I'm really curious</QuestionDetails> <IpAddress>198.51.100.0</IpAddress> <DisplayLocale>en_US</DisplayLocale> <Answers> <Answer id="1"> <SubmissionTime>2016-11-22T22:44:33.179+01:00</SubmissionTime> <UserProfileReference id="Tim"> <ExternalId>Tim</ExternalId> <DisplayName>Tim</DisplayName> <Anonymous>false</Anonymous> <HyperlinkingEnabled>false</HyperlinkingEnabled> </UserProfileReference> <UserLocation>Houston, TX</UserLocation> <AnswerText>I think so</AnswerText> <IpAddress>198.51.100.2</IpAddress> <DisplayLocale>en_US</DisplayLocale> </Answer> <Answer id="5"> <SubmissionTime>2016-11-23T22:44:33.179+01:00</SubmissionTime> <UserProfileReference id="becker"> <ExternalId>becker</ExternalId> <DisplayName>Becker</DisplayName> <Anonymous>false</Anonymous> <HyperlinkingEnabled>false</HyperlinkingEnabled> </UserProfileReference> <UserLocation>New York, NY, USA</UserLocation> <AnswerText>A guy I know has done it</AnswerText> <IpAddress>198.51.100.3</IpAddress> <DisplayLocale>en_US</DisplayLocale> </Answer> </Answers> </Question> </Questions> </Product> </Feed>
Vérifier le contenu importé
Une fois que Bazaarvoice a terminé votre importation dans pré-production, vérifiez le contenu nouvellement importé sur les pages de votre produit de pré-production et comparez-le à votre site internet en direct, en vérifiant soigneusement la liste suivante:
Les avis importés avec une note de zéro ont un impact négatif sur la note moyenne globale. Si un avis n'a aucune note, omettez l'élément <Rating>
du fichier d'importation.
Si plusieurs contributeurs utilisent le même nom affiché, celui-ci devient « Anonyme » pour tous les contributeurs qui utilisent ce nom par la suite. Dès lors, modifiez les noms affichés afin de les rendre uniques. Si les utilisateurs sont autorisés à écrire plusieurs avis sur un produit, contactez Bazaarvoice pour vous assurer que votre configuration est à jour.
Par défaut, les titres des avis sont limités à 50 caractères. Si les titres sont tronqués, vous pouvez contacter Bazaarvoice pour mettre à jour le nombre maximal de caractères.
Par exemple, y a-t-il des commentaires qui apparaissent avec les dates qui sont plusieurs années dans le passé ou le futur? Dans l’affirmative, vérifier que les dates soient définies correctement dans votre fichier d’importation.
Par exemple, voyez-vous avec les avis des localisations incorrectes telles que « FakeLocation, WY » ? Dans ce cas, vérifiez que les localisations sont correctement définies dans l'élément ReviewerLocation de votre fichier d'importation.
Assurez-vous que les ID externes du fichier d'importation correspondent aux ID externes de votre catalogue de produits et aux ID produit du code d'intégration JavaScript de la page produit.
N'oubliez pas que les avis de moins de 50 caractères peuvent être considérés comme des avis avec notes uniquement, et peuvent être masqués. Contactez Bazaarvoice si vous souhaitez modifier ce seuil.
Par exemple, avez-vous plusieurs avis positifs pour lesquels « Non » a été sélectionné ? Si la question de recommandation n'a pas été posée lorsque vous avez collecté les avis à l'origine, omettez cette question du fichier d'importation.
Si ce n'est pas le cas, contactez Bazaarvoice pour confirmer que les ID mappés dans votre fichier d'importation sont corrects.
Si ce n'est pas le cas, vérifiez que les URL des photos et des vidéos sont valides et correctes, et qu'elles sont associées avec l'avis correspondant dans votre fichier d'importation.
Méthode alternative : fichier .csv
Si vous n'êtes pas en mesure de fournir de flux XML de contenu natif, vous pouvez fournir les données principales concernant les avis dans un fichier .csv. Bazaarvoice peut ensuite convertir la feuille de calcul au format d'importation XML.
Utilisez la feuille de calcul d'importation de contenu pour enregistrer les données concernant les avis. Les en-têtes (éléments représentatifs) marqués du symbole * (astérisque) sont requis.
Référez-vous à la section Éléments Ratings and Reviews pour en savoir plus sur chaque élément requis.