Import nativer Inhalte
Um Bewertungen, Fragen und Antworten zu importieren, die vor der Implementierung von Bazaarvoice Ratings & Reviews erfasst wurden, können Sie einen Import-Feed mit nativen Inhalten an Bazaarvoice hochladen. Der native Import-Feed für Inhalte ist ein XML-Dokument, das die Produkte und benutzergenerierten Inhalte (UGC) definiert, die durch Ihre eigene Lösung oder Ihren externen Anbieter erfasst wurden. Wenn Sie nicht über die erforderlichen Ressourcen zur Erstellung eines Import-Feeds im XML-Format verfügen, kann Bazaarvoice die Daten für Sie gegen Gebühr umwandeln.
Bazaarvoice importiert den Feed zuerst in Ihre Staging-Umgebung, um zu verifizieren, dass dieser korrekt dargestellt wird. Nachdem Sie die Inhalte in der Staging-Phase genehmigt haben, importiert Bazaarvoice sie in die Produktionsphase. Dies kann bis zu zwei Wochen in Anspruch nehmen.
Die folgenden Beispiele zeigen die allgemeine Struktur eines vereinfachten Import-Feeds für native Inhalte:
-
Zum Importieren von Ratings & Reviews:
<?xml version="1.0" encoding="UTF-8"?> <Feed> <Product> <ExternalId>...</ExternalId> <Reviews>...</Reviews> </Product> ... </Feed>
-
Zum Importieren von Questions & Answers:
<?xml version="1.0" encoding="UTF-8"?> <Feed> <Product> <ExternalId>...</ExternalId> <Questions>...</Questions> </Product> ... </Feed>
Voraussetzungen
Um native Inhalte oder Inhalte von Drittparteien in Ihre Live-Website zu importieren, sollten folgende Voraussetzungen erfüllt sein:
Checkliste vor dem Import
Native Inhaltsimporte müssen in Ihren Arbeitsverweis miteinbezogen werden. Die Moderation importierter Inhalte kann zu zusätzlichen Kosten führen, je nach Inhaltsmenge. Kontaktieren Sie bei Bedarf Ihren Kundenbetreuer.
Nehmen Sie außerdem bitte Folgendes zur Kenntnis:
- Benutzerprofile
- Den Standort des Benutzers.
10-Punkteskala |
5-Punkteskala |
Halbpunkt-Skala |
5-Punkteskala |
|
---|---|---|---|---|
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 |
Voraussetzungen für die Athentifizierung
Um native Inhalte oder Inhalte von Dritten zu importieren, müssen Sie verifizieren, dass diese die Authentizitätsrichtlinie von Bazaarvoice einhalten. Beachten Sie außerdem Folgendes:
- Neue Kunden können ältere Inhalte einmalig ohne Beschränkung in Bazaarvoice importieren. Um den Text älterer Inhalte zu importieren oder zu syndizieren, muss die Bazaarvoice-Moderation die Inhalte verarbeiten. Bei der Moderation fallen zusätzliche Gebühren an.
- Bestehende Kunden können Inhalte importieren, wenn für diese Inhalte die IP-Adresse des Einreichenden, die ursprüngliche Einreichungszeit sowie der Anzeigename des Einreichenden angegeben werden. Inhalte sind nicht zum Import zugelassen, wenn die Inhalte käuflich erworben sind, von Drittparteien erfasst werden, vom Sampling oder von einem Bot stammen. Ausnahmen gelten für das Content Acquisition Partner Program (CAPP).
- Importierte Inhalte können nicht syndiziert werden, wenn sie nicht von Bazaarvoice moderiert wurden.
- Importierte Inhalte können nur syndiziert werden, wenn es sich um ältere Inhalte eines neuen Bazaarvoice-Kunden handeln.
- Das Bazaarvoice-Vertrauenssiegel kann nicht mit importierten Inhalten dargestellt werden.
- Bazaarvoice kann keine Bewertungen akzeptieren oder anzeigen, die Ihnen auf Papier oder im Rahmen einer Umfrage eingereicht wurden. Die Bewertungen müssen sich auf ein bestimmtes Produkt oder Service beziehen.
Moderationsrichtlinien
Um sicherzustellen, dass Ihre importierten Inhalte gemäß Ihrer geschäftlichen Voraussetzungen moderiert werden, müssen Sie Ihre Richtlinien überprüfen und genehmigen. Kontaktieren Sie Bazaarvoice, wenn Sie sich nicht sicher sind, ob dies bereits erledigt wurde. In dieser Beschreibung unseres Moderationsvorgangs finden Sie weitere Informationen.
Zusätzliche Informationen anzeigen
Wenn Sie native Inhalte oder Inhalte von Drittparteien importieren, werden diese automatisch den Standardfunktionen von Ratings & Reviews zugeordnet, die für jedes Ihrer Produkte angezeigt werden. Mit anderen Worten: Sie müssen lediglich einen Import-Feed für native Inhalte erstellen und ihn dann in Bazaarvoice hochladen, wenn Ihre Inhalte nur Folgendes enthalten:
- Bewertungen
- Bewertungstitel und -text
- Benutzerinformationen
- Frage
- Answers
Wenn Ihre Inhalte jedoch zusätzliche Informationen enthalten, wie sekundäre Bewertungen, zusätzliche Produktinformationen, wie Nutzen oder Wert oder hilfreiche Vote-Funktionen, müssen Sie Ratings & Reviews anweisen, wie diese Informationen angezeigt werden sollen. Dies muss mithilfe des Konfigurationshubs für Ratings & Reviews erfolgen, bevor Sie den Feed importieren. Andernfalls werden die importierten Inhalte nicht angezeigt.
Zusätzliche Bewertungen, Eingabeformularfragen und Tags einrichten
Führen Sie für jede zusätzliche Bewertung, Eingabeformularfrage oder zusätzliches Tag, die Sie importieren möchten, folgende Schritte aus:
- Melden Sie sich im Bazaarvoice-Portal an.
- Wählen Sie Konfiguration aus dem Portal-Menü , das sich in der oberen linken Ecke befindet.
- Wählen Sie eine Instanz.
- Wählen Sie Go to Configuration (Zur Konfiguration gehen). Der Site Manager wird angezeigt und listet die verfügbaren Implementierungszonen und Implementierungen auf.
Hinweis: Sie können auf diesem Bildschirm auch neue Implementierungszonen und Implementierungen hinzufügen.
- Finden Sie unter Implementations (Implementierungen) mit Hilfe der Filterfunktion die von Ihnen benötigte Implementierung.
- Wählen Sie neben der Implementation (Implementierung), zu der Sie die Bewertungen, Fragen oder Tags hinzufügen möchten, die Option Edit (Bearbeiten) aus.
- Wählen Sie im Menü links auf der Seite Eingabeformular-Editor unter Benutzererlebnis aus.
- Wählen Sie in der oberen linken Ecke der Seite, um den Namen der Produktkategorie oder die ID des Eingabeformulars zu finden, das Sie ändern möchten.
Hinweis: Der Editor zeigt automatisch das Eingabeformular All Products (Alle Produkte) an. Wenn Sie in diesem Formular Fragen hinzufügen, bearbeiten oder löschen, übernimmt der Editor Ihre Änderungen für alle verknüpften Formulare.
- Fügen Sie eine neue Frage zu dem Eingabeformular hinzu, in dem Sie die importierten Inhalte anzeigen möchten:
- Um eine zusätzliche (sekundäre) Bewertung zu einem Produkt oder dessen Wirksamkeit, Wert o. ä. hinzuzufügen, wählen Sie + New Question (+ Neue Frage) im Abschnitt Ratings (Bewertungen) und anschließend Add a Custom Question (Benutzerdefinierte Frage hinzufügen) aus. (Diese Frage wird im Feed dem Element
<RatingValues>
zugeordnet). - Um eine Drop-down-Frage zu einem Produkt hinzuzufügen, wählen Sie + New Question (+ Neue Frage) im Abschnitt Product (Produkt) und anschließend Add a Custom Question (Benutzerdefinierte Frage hinzufügen) aus. Legen Sie Dropdown Select (Drop-down-Auswahl) als den Fragetyp fest. (Diese Frage wird im Feed dem Element
<ContextDataValues>
zugeordnet). - Um eine Drop-down-Frage zu einem Benutzer hinzuzufügen, wählen Sie + New Question (+ Neue Frage) im Abschnitt People (Personen) und anschließend Add a Custom Question (Benutzerdefinierte Frage hinzufügen) aus. Legen Sie Dropdown Select (Drop-down-Auswahl) als den Fragetyp fest. (Diese Frage wird im Feed dem Element
<ContextDataValues>
zugeordnet). - Um eine Freitext-Frage zu einem Produkt hinzuzufügen, wählen Sie + New Question (+ Neue Frage) im Abschnitt Product (Produkt) und anschließend Add a Custom Question (Benutzerdefinierte Frage hinzufügen) aus. Legen Sie Free Text (Freitext) als den Fragetyp fest. (Diese Frage wird im Feed dem Element
<AdditionalFields>
zugeordnet). - Um zusätzliche Informationen in Freitextform zu einem Benutzer hinzuzufügen, wählen Sie + New Question (+ Neue Frage) im Abschnitt People (Personen) und anschließend Add a Custom Question (Benutzerdefinierte Frage hinzufügen) aus. Legen Sie Free Text (Freitext) als den Fragetyp fest. (Diese Frage wird im Feed dem Element
<AdditionalFields>
zugeordnet). - Um zur Beschreibung eines Produkts ein Tag hinzuzufügen, wählen Sie + New Question (+ Neue Frage) im Abschnitt Product (Produkt) und anschließend Add a Custom Question (Benutzerdefinierte Frage hinzufügen) aus. Legen Sie Tag Groups (Tag-Gruppen) als den Fragetyp fest. (Diese Frage wird im Feed dem Element
<Tags>
zugeordnet).
Weitere Informationen zu Fragen bezüglich Eingabeformularen finden Sie unter Referenz von Eingabeformular-Fragen.
- Um eine zusätzliche (sekundäre) Bewertung zu einem Produkt oder dessen Wirksamkeit, Wert o. ä. hinzuzufügen, wählen Sie + New Question (+ Neue Frage) im Abschnitt Ratings (Bewertungen) und anschließend Add a Custom Question (Benutzerdefinierte Frage hinzufügen) aus. (Diese Frage wird im Feed dem Element
- Notieren Sie die Frage-ID und den von Ihnen ausgewählten Fragetyp. Sie benötigen diese Informationen bei der Erstellung des Feeds.
- Übernehmen Sie die Änderungen für die Implementierung.
„Hilfreich“-Stimmen einrichten
Führen Sie die folgenden Schritte aus, wenn Sie vorhaben, „Hilfreich“-Stimmen zu importieren. Bei der Erstellung der Import-Feeddatei werden die „Hilfreich“-Stimmen dem Element <ReviewStatistics>
zugeordnet.
- Melden Sie sich im Portal an.
- Wählen Sie Konfiguration aus dem Portal-Menü , das sich in der oberen linken Ecke befindet.
- Wählen Sie eine Instanz.
- Wählen Sie Go to Configuration (Zur Konfiguration gehen). Der Site Manager wird angezeigt und listet die verfügbaren Implementierungszonen und Implementierungen auf.
Hinweis: Sie können auf diesem Bildschirm auch neue Implementierungszonen und Implementierungen hinzufügen.
- Finden Sie unter Implementations (Implementierungen) mit Hilfe der Filterfunktion die von Ihnen benötigte Implementierung.
- Wählen Sie neben der Implementation (Implementierung), für die Sie „Hilfreich“-Stimmen aktivieren möchten, Edit (Bearbeiten) aus.
- Wählen Sie im Menü links auf der Seite Anzeigeoptionen unter Benutzererlebnis aus.
- Wählen Sie den Tab Ratings & Reviews.
- Wählen Sie im Abschnitt Review Helpfulness Voting („Hilfreich“-Stimmen für Bewertungen) die Option Enabled (Aktiviert) aus.
- Übernehmen Sie die Änderungen für die Implementierung.
Erstellung und Hochladen der XML-Feed-Datei
Bevor Ihre Webseite native Inhalte oder Inhalte von Drittparteien anzeigen kann, müssen Sie einen Import-Feed für native Inhalte erstellen, damit Bazaarvoice diese Inhalte importieren kann. Hierbei handelt es sich um ein XML-Dokument, das die Produkte und benutzergenerierten Inhalte (UGC) definiert, die durch Ihre eigene Lösung oder Ihren externen Anbieter erfasst wurden.
Beachten Sie folgende Empfehlungen, bevor Sie loslegen:
- Ziehen Sie in Erwägung, Bewertung mit 0 Sternen auszuschließen. Sie beeinflussen die durchschnittliche Gesamtbewertung negativ.
- Wandeln Sie Bewertungen um, die eine 10-Punkteskala oder Halbpunkt-Skala verwenden.
Führen Sie folgende Schritte aus, um Ihren Import-Feed für native Inhalte zu erstellen und diesen bei Bazaarvoice hochzuladen.
Schritt 1: XML-Feed-Datei erstellen
Die Generierung eines Feeds hängt von Ihrem System und Ihren Prozessen ab. Unabhängig davon muss jeder Feed jedoch eine XML-Datei sein und der gleichen Struktur folgen.
Richten Sie sich nach dem Schema , das die Struktur und den Inhalt des Feeds festlegt, um Ihren Produktkatalog zu strukturieren. Unter Beispiele finden Sie vollständige Feeds.
Bazaarvoice empfiehlt die folgenden optimalen Verfahren für das Erstellen einer Feed-Datei:
-
Stellen Sie sicher, dass die erste Linie Ihres Feeds folgendem Format entspricht:
<?xml version="1.0" encoding="utf-8"?>
- Das Standard-Verschlüsselungsschema wie UTF-8 oder Windows-1252 muss mit dem Schema übereinstimmen, das Sie für eventuell im Feed enthaltene Sonderzeichen verwenden.
- Wenn Sie für ein bestimmtes Feld keinen Wert haben, lassen Sie dieses Feld in Ihrem Feed weg. Nehmen Sie keine Felder auf, bei denen der Wert leer bleibt.
Schritt 2: Elemente und Attribute überprüfen
Sie müssen die entsprechenden Elemente und Attribute zur Beschreibung der Produkte und UGC-Informationen verwenden. In den folgenden Tabellen finden Sie die Variantenelemente und Attribute für die <Feed>
-, <Product>
-, <Reviews>
-, <Questions>
-, <ReviewStatistics>
- und <QAStatistics>
-Elemente.
Feed-Element
In der folgenden Tabelle werden die erforderlichen Attribute für das <Feed>
-Element aufgelistet.
Attribut | Beschreibung |
---|---|
xmlns | Schema-Referenz. Setzen Sie diesen Wert auf https://www.bazaarvoice.com/xs/PRR/StandardClientFeed/14.8. |
name | Die Kurzversion Ihres Kundennamens bei Bazaarvoice. |
extractDate | Ein Zeitstempel, der automatisch im Format DateTime für XML eingepflegt werden sollte. |
<Feed xmlns="http://www.bazaarvoice.com/xs/PRR/StandardClientFeed/14.8" name="ABCCompany" extractDate="2016-11-21T22:44:33.179+01:00">
Produkt-Element
Das <Product>
-Element definiert ein Produkt in Ihrem Feed und kann die untergeordneten Elemente <Reviews>
und <Questions>
enthalten. Sie können mehrere <Product>
-Elemente in Ihren Feed miteinbeziehen; für jedes Produkt eines.
Dieses Element muss Folgendes enthalten:
- Id Attribut – Dessen Wert muss mit dem Wert der
ExternalId
des Produkts in Ihrem Produktkatalog übereinstimmen. - Untergeordnetes
<ExternalId>
-Element – Dessen Wert muss mit dem Wert des id-Attributs übereinstimmen.
Im Feed-Schema oder in der Struktur von Standard-Kunden-Feeds finden Sie eine vollständige Liste aller verfügbaren Elemente.
<Product id="1010"> <ExternalId>1010</ExternalId> <Reviews>...</Reviews> <Questions>...</Questions> </Product>
Bewertungen und Bewertungselemente
Dieses Element enthält untergeordnete <Review>
-Elemente; eins für jeden Inhalt, den Sie importieren und mit Ihrem Produkt anzeigen möchten.
Jedes <Review>
-Element muss das id-Attribut enthalten, wobei es sich um einen einzigartigen Wert (Integer) handeln muss. Geben Sie dann für jedes <Review>
-Element untergeordnete Elemente an. Die folgende Tabelle stellt die Elemente vor, die am häufigsten verwendet werden. Im Feed-Schema oder in der Struktur von Standard-Kunden-Feeds finden Sie eine vollständige Liste aller verfügbaren Elemente.
Element | Wert |
---|---|
Erforderlich |
Der aktuelle Status einer bestimmten Bewertung, z. B. ob eine Bewertung auf eine bestimmte Aktion durch das Moderationsteam oder CMS wartet oder ob sie genehmigt oder abgelehnt ist. Mögliche Werte: GENEHMIGT und ABGELEHNT. Art: Enum Betrifft: Anzeige, Berichte |
Erforderlich |
Informationen zum Profil eines Benutzers. Wird dieses Element ausgelassen, wird der Verfasser der Bewertung als „Anonym“ angezeigt. Dieses Element ist erforderlich, wenn die Bewertung syndiziert werden soll. Geben Sie für jedes
|
Bewährte Praktiken |
Bewertungstitel in einer durch den Verfasser festgelegten Form. Art: String (varchar(255)) Betrifft: Anzeige |
Bewährte Praktiken |
Vollständiger Text der Bewertung in einer durch den Verfasser festgelegten Form. Art: String (Text) Betrifft: Anzeige |
Erforderlich |
Ein durch den Rezensent einer Bewertung gewählter Beurteilungswert (für gewöhnlich in Form einer Sternebewertung). Art: Int (int(11)) Betrifft: Anzeige, Berichte |
Erforderlich |
Die IP-Adresse eines Rezensenten. Dieses Element ist erforderlich, wenn ein bestehender Bazaarvoice-Kunde Inhalte importieren möchte. Art: String (varchar(255)) Betrifft: Authentizität |
Optional |
Ob die Bewertung als „Empfohlen“ gekennzeichnet ist. Das bedeutet, Benutzer haben während der Einreichung einer Bewertung bestätigt, dass sie das Produkt einem Freund empfehlen würden. Art: boolescher Wert Betrifft: Anzeige, Berichte |
Bewährte Praktiken |
Die E-Mail-Adresse des Benutzers. Dieses Element ist optional, aber es ist eine bewährte Praktik es miteinzubeziehen. Art: String (varchar(255)) Betrifft: Berichte, Authentizität, Plattform-Funktionalität |
Optional |
Der Standort des Benutzers. Art: String (varchar(255)) Betrifft: Anzeige |
Erforderlich |
Der Zeitpunkt, zu dem eine bestimmte Bewertung durch ihren Verfasser eingereicht wurde (vor dem Moderationsvorgang). Muss im Format DateTime für XML angegeben werden. Dieses Element ist erforderlich, wenn ein bestehender Bazaarvoice-Kunde Inhalte importieren möchte. Art: Datum (Zeitstempel) Betrifft: Authentizität, Anzeige, Berichte |
Optional |
Ob dieser Inhalt besonders interessant und gut geschrieben ist. Dieser Wert wird bei der Moderation zugewiesen. Dies ist ein Pflichtelement. Art: boolescher Wert Betrifft: Anzeige, Berichte |
Bewährte Praktiken |
Standort, von dem die Bewertung eingereicht wurde. Dieses Element ist erforderlich, wenn Sie Inhalte mit verschiedenen Standorten oder Sprachen importieren. Art: String (varchar(25)) Betrifft: Anzeige, Berichte |
Optional |
Anzahl der Feedback-Einträge für eine bestimmte Bewertung (positiv und negativ). Art: Int (4-Byte-Integer) Betrifft: Anzeige, Berichte |
Optional |
Anzahl der positiven Feedback-Einträge für eine bestimmte Bewertung. Art: Int (4-Byte-Integer) Betrifft: Anzeige, Berichte |
Optional |
Anzahl der negativen Feedback-Einträge für eine bestimmte Bewertung. Art: Int (4-Byte-Integer) Betrifft: Anzeige, Berichte |
Optional |
Anzahl, wie oft Kunden angaben, dass diese Bewertung unangemessene oder irrelevante Inhalte aufweist. Art: Int (4-Byte-Integer) Betrifft: Anzeige, Berichte |
Optional |
Eine Liste an etwaigen zusätzlichen (nicht standardmäßigen) Freitext-Fragen der Bewertung. Geben Sie dieses Element sowie dessen untergeordnete Elemente an, wenn Sie eine Freitext-Bewertung für ein Produkt oder einen Benutzer anzeigen möchten. Jedes
Betrifft: Anzeige, Berichte |
Optional |
Eine Liste an Antworten von einem Mitarbeiter Ihres Unternehmens auf Kundenfragen zu einem Produkt. Geben Sie für jedes
Betrifft: Anzeige |
Optional |
Eine Liste an Tag-Dimensionen. Geben Sie dieses Element sowie dessen untergeordnete Elemente an, wenn Sie Produkt-Tags anzeigen möchten. Jedes
Betrifft: Anzeige |
Optional |
Ein Satz an Foto-Referenzen mit Beschriftungen, die vom Rezensenten hinterlassen wurden. Jedes untergeordnete
Betrifft: Anzeige |
Optional |
Ein Satz an Video-Referenzen mit Beschriftungen, die vom Rezensenten hinterlassen wurden. Geben Sie für jedes untergeordnete
Betrifft: Anzeige |
Optional |
Eine Liste etwaiger Drop-down-Fragen für eine Bewertung. Geben Sie dieses Element sowie dessen untergeordneten Elemente an, wenn Sie Informationen für ein Produkt oder einen Benutzer anzeigen möchten, die über eine Drop-down-Frage erfasst wurden. Jedes untergeordnete
Betrifft: Anzeige |
Optional |
Eine Liste an Sekundärbewertungen für verschiedene Dimensionen oder Produktqualitäten. Geben Sie dieses Element sowie dessen untergeordnete Elemente an, wenn Sie eine zusätzliche (Sekundär-) Bewertung für ein Produkt anzeigen möchten. Geben Sie für jedes
Betrifft: Anzeige |
<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- und Question-Elemente
Dieses Element enthält untergeordnete <Question>
-Elemente; eins für jeden Inhalt, den Sie importieren und mit Ihrem Produkt anzeigen möchten.
Jedes <Question>
-Element muss das id-Attribut enthalten, wobei es sich um einen einzigartigen Wert (Integer) handeln muss. Geben Sie dann für jedes <Question>
-Element untergeordnete Elemente an. Die folgende Tabelle stellt die Elemente vor, die am häufigsten verwendet werden. Im Feed-Schema oder in der Struktur von Standard-Kunden-Feeds finden Sie eine vollständige Liste aller verfügbaren Elemente.
Element | Wert | |
---|---|---|
SubmissionTime |
Der Zeitpunkt, zu dem die Frage durch ihren Verfasser eingereicht wurde (vor dem Moderationsvorgang). Muss im Format DateTime für XML angegeben werden. Art: Datum (Zeitstempel) |
|
Spitzname des Benutzers |
Der vom Verfasser einer Frage ausgewählte Benutzername. Muss für alle im Feed spezifizierten Benutzer eindeutig sein, es sei denn, doppelte Benutzernamen sind erlaubt. Art: String (varchar(255)) |
|
UserLocation |
Der Standort des Verfassers einer Frage. Art: String (varchar(255)) |
|
Zusammenfassung der Frage |
Die Hauptzeile der Frage. Art: String (varchar(255)) |
|
Einzelheiten der Frage |
Der Hauptteil der Frage. Art: String (Text) |
|
DisplayLocale |
Standort, von dem die Frage eingereicht wurde. Dies ist erforderlich, wenn Sie Inhalte mit verschiedenen Standorten oder Sprachen importieren. Art: String (varchar(25)) |
|
Answers und Answer |
Eine Liste von Antworten auf die Frage. Geben Sie für jedes |
|
<SubmissionTime> |
Zeitpunkt, zu dem die Antwort durch ihren Verfasser eingereicht wurde (vor dem Moderationsvorgang). Art: Datum (Zeitstempel) |
|
<UserProfileReference> |
Informationen zum Profil eines Benutzers. Wird dieses Element ausgelassen, wird der Verfasser der Antwort als „Anonym“ angezeigt. Geben Sie für jedes <UserProfileReference> -Element diese untergeordneten Elemente an. |
|
<UserNickname> |
Der vom Verfasser einer Antwort ausgewählte Benutzername. Muss für alle im Feed spezifizierten Benutzer eindeutig sein, es sei denn, doppelte Benutzernamen sind erlaubt. Art: String (varchar(255)) |
|
<UserLocation> |
Der Standort des Verfassers einer Antwort. Art: String (varchar(255)) |
|
<AnswerText> |
Der Antworttext auf die Frage. Art: String (Text) |
|
<DisplayLocale> |
Standort, von dem eine Antwort eingereicht wurde. Art: String (varchar(25)) |
<Questions> <Question id="44135"> <SubmissionTime>2008-11-21T22:44:33.179+01:00</SubmissionTime> <UserNickname>Dave</UserNickname> <UserLocation>London</UserLocation> <QuestionSummary>Can we import Q&A questions?</QuestionSummary> <QuestionDetails>The reason I ask is that I'm really curious</QuestionDetails> <DisplayLocale>en_GB</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>Edinburgh</UserLocation> <AnswerText>I think so</AnswerText> <DisplayLocale>en_GB</DisplayLocale> </Answer> ... </Answers> </Question> ... </Questions>
ReviewStatistics- und QAStatistics-Elemente
Wenn Sie vorhaben, „Hilfreich“-Stimmen zu importieren, müssen Sie dies im Konfigurations-Hub aktivieren. Beziehen Sie dann eines oder beide dieser Elemente in Ihren Feed mit ein. <ReviewStatistics>
zeigt Statistiken für Ratings & Reviews an. <QAStatistics>
zeigt Statistiken zu Questions & Answers an.
Die folgende Tabelle listet die untergeordneten Elemente auf, die in Verbindung zu „Hilfreich“-Stimmen stehen. Im Feed-Schema oder in der Struktur von Standard-Kunden-Feeds finden Sie eine vollständige Liste aller verfügbaren Elemente.
Element | Wert |
---|---|
QuestionHelpfulVoteCount |
Anzahl der „Hilfreich“-Stimmen, die für die genehmigten Fragen des Benutzers eingereicht wurden. Art: Int (4-Byte-Integer) |
QuestionNotHelpfulVoteCount |
Anzahl der „Nicht hilfreich“-Stimmen, die für die genehmigten Fragen des Benutzers eingereicht wurden. Art: Int (4-Byte-Integer) |
AnswerHelpfulVoteCount |
Anzahl der „Hilfreich“-Markierungen, die für die genehmigten Antworten des Benutzers eingereicht wurden. Art: Int (4-Byte-Integer) |
AnswerNotHelpfulVoteCount |
Anzahl der „Nicht hilfreich“-Stimmen, die für die genehmigten Antworten des Benutzers eingereicht wurden. Art: Int (4-Byte-Integer) |
HelpfulVoteCount |
Gesamtanzahl der „Hilfreich“-Stimmen, die für die des Benutzers gesamten genehmigten Inhalte eines bestimmten Typs eingereicht wurden. Art: Int (4-Byte-Integer) |
NotHelpfulVoteCount |
Gesamtanzahl der „Nicht hilfreich“-Stimmen, die für die des Benutzers gesamten genehmigten Inhalte eines bestimmten Typs eingereicht wurden. Art: Int (4-Byte-Integer) |
<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>
Schritt 3: Feed validieren und vorbereiten
Ihr Feed muss in gut formatiertem XML vorliegen, das mit dem Bazaarvoice-XML-Schema übereinstimmt. Führen Sie folgende Schritte aus, um den Feed zu validieren und für Bazaarvoice vorzubereiten.
- Vergleichen und bestätigen Sie Ihren Feed mit diesem Bazaarvoice XML-Schema , bevor Sie ihn auf Bazaarvoice hochladen. Zur Bestätigung Ihres Feeds können Sie ein XML-Validierungs-Tool nutzen.
- Sollten Fehler oder Warnungen angezeigt werden, beheben Sie diese und validieren Sie den Feed erneut.
- Teilen Sie den Feed in mehrere Dateien auf, wenn die Datei größer als 150 MB ist (normalerweise bei mehr als 100.000 Bewertungen). Dies können Sie mithilfe eines einfachen Text-Editors manuell erledigen oder ein Kommandozeilen-Tool wie xmlsplit verwenden.
- Stellen Sie sicher, dass der XML-Feed die richtige Sprache und das richtige Standort-Tag aufweist, wenn die Inhalte nicht auf Englisch verfasst wurden.
Schritt 4: Feed hochladen
Sie müssen den Import-Feed mit den nativen Inhalten auf den Produktionsserver hochladen. Bazaarvoice empfiehlt jedoch, die Auswirkung des Feeds vorher auf dem Staging-Server anzusehen und zu testen.
- Laden Sie die XML-Datei in das Verzeichnis
/native
des SFTP-Staging und Produktionsservers hoch.- Verwenden Sie folgende URLs, wenn Ihre Daten in den USA gehostet werden:
- Staging-Server – sftp-stg.bazaarvoice.com
- Produktionsserver – sftp.bazaarvoice.com
- Verwenden Sie folgende URLs, wenn Ihre Daten in Europa gehostet werden:
- Staging-Server – sftp7-stg.bazaarvoice.com
- Produktions-Server – sftp7.bazaarvoice.com
Stellen Sie sicher, dass Sie über Port 22 eine Verbindung zu SFTP herstellen. Wenden Sie sich an Bazaarvoice-Support, wenn Sie Ihre SFTP Anmeldedaten nicht kennen oder nicht wissen, wo Ihre Daten gehostet werden.
- Verwenden Sie folgende URLs, wenn Ihre Daten in den USA gehostet werden:
- Teilen Sie Bazaarvoice mit, dass Sie den Feed validiert und hochgeladen haben. Die Inhalte werden erst importiert, nachdem Sie Bazaarvoice benachrichtigt haben.
Beispiele vollständiger Feeds
Nachfolgend sehen Sie ein Beispiel eines vollständigen Feeds für 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>
Nachfolgend sehen Sie ein Beispiel eines vollständigen Feeds für 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>
Verifizierung importierter Inhalte
Nachdem Bazaarvoice Ihren Import in Staging abgeschlossen hat, sollten Sie die neu importierten Inhalte auf ihren Staging-Produktseiten überprüfen und mit ihrer aktuellen Webseite vergleichen. Nehmen Sie die Überprüfung anhand der folgenden Checkliste vor:
Importierte Bewertungen mit einer 0-Sterne-Bewertung beeinflussen die durchschnittliche Gesamtbewertung negativ. Entfernen Sie das <Rating>
-Element aus der Importdatei, wenn eine Bewertung keine Sternebewertung aufweist.
Wenn mehrere Verfasser denselben Anzeigenamen verwenden, wird ab dem zweiten Verfasser nur noch „Anonym“ angezeigt. Passen Sie Anzeigenamen also an, damit diese einmalig sind. Wenn es Benutzern erlaubt ist, mehrere Bewertungen für ein einzelnes Produkt zu verfassen, kontaktieren Sie Bazaarvoice, um sicherzustellen, dass Ihre Konfiguration aktualisiert wird.
Die maximale Standardlänge für Bewertungen liegt bei 50 Zeichen. Werden Titel abgeschnitten, kontaktieren Sie Bazaarvoice, um die maximale Länge hochzusetzen.
Zum Beispiel, sind irgendwelche Bewertungen mit Datumsangaben versehen die viele Jahre zurückliegen oder sich in der Zukunft befinden? Wenn ja, stellen Sie sicher, dass die Datumsangaben in Ihrer Importdatei richtig eingestellt sind.
Wird ein falscher Standort angezeigt, wie z. B. „FalscherStandort, BaWü“? Wenn ja, stellen Sie sicher, dass Standorte im ReviewerLocation-Element Ihrer Importdatei korrekt definiert sind.
Stellen Sie sicher, dass die External IDs in der Importdatei mit den External IDs in Ihrem Produktkatalog und mit den Produkt-IDs im JavaScript-Integrationscode auf der Produktseite übereinstimmen.
Denken Sie daran, dass Bewertungen unter 50 Zeichen als „Ratings-only“-Bewertungen nicht angezeigt werden könnten. Kontaktieren Sie Bazaarvoice, um diesen Grenzwert anzupassen.
Wurde zum Beispiel für mehrere positive Bewertungen „Nein“ ausgewählt? Wenn die Empfehlungsfrage bei der ursprünglichen Erfassung der Bewertungen nicht gestellt wurde, beziehen Sie diese in die Importdatei nicht mit ein.
Wenn nicht, kontaktieren Sie Bazaarvoice, um sicherzustellen, dass in Ihrer Importdatei die richtigen IDs zugeordnet wurden.
Wenn nicht, stellen Sie sicher, dass die Fotos oder Videos gültige URLs aufweisen und dass sie in Ihrer Importdatei der richtigen Bewertung zugeordnet sind.
Alternative Methode: CSV-Datei
Wenn Sie keinen XML-Feed mit nativen Inhalten bereitstellen können, haben Sie die Möglichkeit, wichtige Bewertungsdaten in einer CSV-Datei (Comma-Separated Value) anzubieten. Bazaarvoice kann das Arbeitsblatt anschließend in ein XML-Format konvertieren und importieren.
Bewertungsdaten lassen sich mit dem Content Import Worksheet (Arbeitsblatt zum Import von Inhalten) erfassen. Es müssen Überschriften (Elemente) markiert mit * (Asterisk) angegeben werden.
Unter Bewertungen und Bewertungselemente erfahren Sie Genaueres zu den einzelnen Pflichtelementen.