Produktkatalog

Um das Optimum aus der Bazaarvoice-Plattform herauszuholen, müssen Sie Daten über Ihren Produktkatalog an Bazaarvoice übermitteln. Dazu gehören Daten über die Marken, die Produktkategorien und die Produkte, die Sie anbieten. Ein vollständiger Einblick in Ihren Produktkatalog ist entscheidend für eine erfolgreiche Implementierung.

Warum ist der Produktkatalog wichtig?

Warum ist der Produktkatalog so wichtig? Der Produktkatalog ermöglicht die Nutzung folgender Funktionen:

• Syndizierung. Weil Einzelhändler und Marken oft unterschiedliche Identifikatoren und Metadaten verwenden, um das gleiche Produkt zu beschreiben, ermöglicht ein vollständiger, akkurater Produktkatalog Bazaarvoice die Zuordnung von Produkten, die von Marken und Einzelhändlern angeboten werden, und das anschließende Teilen (Syndizieren) von benutzergenerierten Inhalten (UGC) basierend auf der Zuordnung von Produkten. Insbesondere Markennamen, UPCs, EANs und MPNs sind für die Aktivierung einer Syndizierung unverzichtbar.
• Inhalte in Bewertungsanfragen (ehemals Anschluss-E-Mail oder AE), in Benachrichtigungen in sozialen Medien und auf von Bazaarvoice gehosteten Elementen auf Ihrer Webseite, wie Eingabeseiten von Bewertungen. Datenelemente wie die IDs, Namen und URLs von Marken, Kategorien und Produkten unterstützen diese Inhalte. Datenelemente wie die IDs, Namen und URLs von Marken, Kategorien und Produkten unterstützen diese Inhalte.
• Workbench-Berichte. Produktkatalogdaten erscheinen in Bazaarvoice Workbench sowie als Filteroptionen, wenn Sie Berichts-Dashboards anzeigen.
• Berichte und Insights. Die Qualität der in Ihrem Produktkatalog verfügbaren Datensätze hat einen direkten Einfluss auf die erstellten Berichte und Einblicke. Stellen Sie sicher, dass Ihr Produktkatalog auf dem neuesten Stand ist. Weitere Informationen erhalten Sie unter Integrationsgesundheit.
• Integration mit anderen Bazaarvoice-Produkten. Schlüsselelemente müssen in Ihrem Produktkatalog definiert sein, um die Integration mit Ratings & Reviews, Connections, Werbung und Sampling zu unterstützen. Lieferanten, die Connections abonnieren, sind beispielsweise auf Markennamen und Anbieter-IDs in Produktkatalogen angewiesen.
• Genauigkeit in der Moderation. Halten Sie den Produktkatalog auf dem neuesten Stand, damit Moderatoren vollständigen Einblick und Kontext erhalten. Nur so können sie bewerten, ob das Kundenfeedback zum bewerteten Produkt aussagekräftig und relevant ist.

Produktkatalogdaten bereitstellen

Bazaarvoice unterstützt die folgenden Methoden, mit denen Sie Ihre Produktkatalogdaten bereitstellen können:

• Einzelne XML-Feed-Datei – Geben Sie eine einzelne Feed-Datei an, die alle Ihre Katalogdaten enthält. Wir akzeptieren die Formate XML und Flat (CSV oder TXT). Die Verwendung eines XML-Feeds hat jedoch Vorteile gegenüber Flat-Dateien, wie zum Beispiel Unterstützung für Lokalisierung, umfassende Konfiguration von Kategoriehierarchie und andere zusätzliche Vorteile.
  Hinweis: Ein einzelner XML-Feed sollte täglich hochgeladen werden. Das mehrfache Senden von XML-Feeds pro Tag führt zu einer schlechten Leistung. Falls erforderlich, können Sie einen ergänzenden Feed (mit fehlenden oder aktualisierten Produktdaten) in Form einer Flat-Textdatei hochladen.

• Mehrere Quellen – Geben Sie mehrere Katalog-Feeds an, wenn Ihre Katalogdaten aus unterschiedlichen Systemen stammen oder wenn die Kombination von mehreren Feeds in einen einzigen Feed zu kompliziert ist. Kontaktieren Sie den Support von Bazaarvoice, bevor Sie versuchen, Produktkatalogdaten mithilfe von mehreren Dateien bereitzustellen. Weitere Informationen finden Sie unter Mehrere Katalog-Quellen verwenden.

  Wenn Sie die Dynamic Catalog Collection (DCC, dynamische Katalogerfassung) verwenden, können Sie auch mit einer traditionellen Feed-Datei (XML oder CSV) weitere Datenelemente angeben. Bazaarvoice wird die Daten aus beiden Quellen kombinieren.

• Produktkatalog-Anwendung – Ermöglicht es Ihnen, Ihren Produktkatalog anzuzeigen und zu verwalten. Diese Portal-Anwendung zeigt alle Informationen in Ihrem Bazaarvoice-Produktkatalog, einschließlich Daten, die von Feeds, DCC und der Anwendung selbst bereitgestellt wurden.
  Hinweis: Das Importieren oder Aktualisieren von Daten mit der Produktkatalog-Anwendung hat immer Vorrang und überschreibt Datenaktualisierungen, die von Ihrem XML-Feed oder der Dynamic Catalog Collection (DCC) stammen.
  Weitere Informationen finden Sie unter Priorität der Datenquelle.
• Dynamic Catalog Collection (DCC) (Dynamische Katalogerfassung) – Ermöglicht es Bazaarvoice, Produktkatalogdaten mit JavaScript auf Ihren Produktdetailseiten zu erfassen und zu verbrauchen. Wenn Käufer eine Produktdetailseite besuchen, gibt das JavaScript-Ereignis die Katalogdaten an Bazaarvoice zum Verbrauch weiter. DCC unterstützt die Erfassung sowohl von neuen Produktkatalogdaten als auch von Updates vorher bereitgestellter Katalogdaten.

Bewährte Verfahren für einzelne Feeds

Wenn Sie Feeds verwenden, können Sie Ihre Katalogdaten in den folgenden Formaten hochladen:

Format	Beschreibung	Bewährte Praktiken
XML-Datei	Laden Sie eine einzige XML-Feed-Datei hoch, die Ihren gesamten Katalog enthält. Die Bereitstellung eines gut strukturierten Produkt-Feed ist entscheidend für den Erfolg.	Laden Sie einen einzelnen vollständigen XML-Feed täglich hoch Wir empfehlen Ihnen dringend, diese Methode zu verwenden, um Ihren primären Katalog-Feed bereitzustellen Feeds mehrmals am Tag zu senden, führt zu einer schlechten Leistung
Textdatei	Wenn die Erstellung eines XML-Feeds zu schwierig ist, können Sie Ihre Katalogdaten auch in Form einer durch Trennzeichen getrennten Textdatei bereitstellen. Hinweis: Obwohl Bazaarvoice sowohl XML als auch Flat-Formate (CSV oder TXT) akzeptiert, ist XML das bevorzugte Format. Es unterstützt die Lokalisierung, bietet eine umfangreiche Konfiguration der Kategorienhierarchie und weitere Funktionen.	Verwenden Sie ergänzende Feed-Dateien, um aktualisierte oder fehlende Daten aus dem Haupt-XML-Feed bereitzustellen. Wir empfehlen, dass Sie wöchentlich zusätzliche Flat-Dateien (CSV oder TXT) hochladen Geben Sie Ihre primären Katalogdaten nicht in einer Textdatei an (wegen der Format-Beschränkungen).

Wichtig: Schließen Sie keine Daten mit personenbezogenen Daten (PII) ein. PII sind Daten, die personenbezogen sind und die der jeweilige Verbraucher häufig als privat betrachtet. Durch ihre Verwendung können möglicherweise bestimmte Einzelpersonen in Ihren Produktkatalog-Feeds identifiziert oder voneinander unterschieden werden.

Einen XML-Produktkatalog-Feed erstellen

Wenn Sie Ihren Katalog Bazaarvoice in Form eines XML-Feeds bereitstellen möchten (das ist die bevorzugte, empfohlene Methode), bildet ein gut formatierter Produkt-Feed die Grundlage für eine erfolgreiche Implementierung. Das folgende Beispiel zeigt die allgemeine Struktur eines vereinfachten XML-Produkt-Feeds:

<?xml version="1.0" encoding="UTF-8"?> <Feed> <Brands> <Brand>...</Brand> ... </Brands> <Categories> <Category>...</Category> ... </Categories> <Products> <Product>...</Product> ... </Products> </Feed>

Führen Sie die Schritte in diesem Abschnitt aus, um einen XML-Feed zu erstellen und diesen bei Bazaarvoice hochzuladen.

Erste Schritte

In diesem Abschnitt finden Sie die ersten Schritte für einen schnellen Einstieg in die Erstellung Ihres Produkt-Feeds. Detaillierte Informationen zur Erstellung und Validierung von Produkt-Feeds finden Sie in anderen Abschnitten zu diesem Thema.

1. Erstellen oder aktualisieren Sie den Produkt-XML-Feed wie im XML-Schema beschrieben. Sie können den Produkt-Feed-Generator als Vorlage zur Entwicklung Ihres Produkt-Feeds nutzen.

   Jedes Produkt im Feed muss diese Eigenschaften aufweisen:

   • Marke
   • Produkt-ID
   • Produktname
   • Produkt-URL
   • Bild-URL
   • EAN, UPC oder MPN
   Hinweis: Die Produkt-ID kann über den Aufruf $BV.configure auf Ihrer Produktseite festgelegt werden. Im Produkt-Feed muss der Wert der Produkt-ID unter ExternalId angegeben sein. ExternalId ist innerhalb von Bazaarvoice besonders wichtig. Ohne dieses Element ist die Produktzuordnung über unterschiedliche Funktionen hinweg nicht möglich. Die Produkt-ID ist darüber hinaus Teil von Eingabeformular-Links (productId) und des Integrationscodes von Produktdetailseiten (PDPs). Sie wird darüber hinaus vom sku-Parameter im Rahmen von BV-Pixel-Transaktionen verwendet.

   Beziehen Sie sich bei Bedarf auf diesen XML-Beispielfeed.

2. Validieren Sie den XML-Feed mithilfe dieses Validierungs-Tools anhand des Schemas.
3. Laden Sie den Feed auf den Bazaarvoice-Staging- oder Produktions-SFTP-Server unter /import-inbox hoch. Feeds werden in einer täglichen Warteschlange um 02:00 Uhr CT (CST: UTC-6 oder CDT: UTC-5) verarbeitet und im Ordner /backup abgelegt.
4. Überprüfen Sie die Ergebnisse Ihrer Staging- oder Produktionsserver-Workbench.

Hinweis: Wenn Sie Ihre Katalogdaten Bazaarvoice mithilfe mehrerer Quellen bereitstellen möchten, wird empfohlen, den Großteil der Katalogdaten mit einem XML-Feed bereitzustellen und dann einen Text-Feed für ergänzende Daten zu verwenden.

Schritt 1: Eine 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.

Beginnen Sie mit der Strukturierung Ihres Produkt-Feeds, indem Sie sich an den folgenden Punkten orientieren:

• Produktfeed-Generator: Bietet einen Ausgangspunkt zur Erstellung Ihres Produkt-Feeds.

• Produkt-Feed-XML-Schema : Definiert die Struktur und die Inhalte Ihres Feeds.

  Hinweis: Die Version 14.3+ des Schemas erzwingt keine Längen- oder Zahlenbeschränkungen für UPCs, EANs und ISBNs. Das Produkt-Schema stuft jede Zahlenfolge in einem dieser Felder als gültig ein. Die Werte in den Feldern UPC, EAN und ISBN werden jedoch während des Katalog-Import-Prozesses validiert und nur gültige Werte werden gespeichert. Die vollständige Syntax für alle global eindeutigen Kennungen finden Sie in dieser Beispiel XML- Produkt-Feed-Datei.

Wir empfehlen Ihnen die folgenden optimalen Verfahren für das Erstellen von Produkt-Feeds:

• 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.

Das Beispiel unten zeigt einen XML-Feed mit mehreren Produkten.

Schritt 2: Elemente und Attribute überprüfen

Sie müssen die entsprechenden Elemente und Attribute zur Beschreibung des Feeds, der Marke, Kategorie und Produktinformationen verwenden. In den folgenden Tabellen finden Sie die Variantenelemente und Attribute für die <Feed>-, <Brands>-, <Categories>- und <Products>-Elemente.

Hinweis: Wenn ein Element nicht erforderlich ist, Sie jedoch über die Produktinformation verfügen, beziehen Sie es in den Feed mit ein.

Feed-Element

Dies ist ein Pflichtelement. In der folgenden Tabelle werden die erforderlichen Attribute für das <Feed>-Element aufgelistet.

Attribut	Beschreibung
name	Die Kurzversion Ihres Kundennamens bei Bazaarvoice.
extractDate	Ein Zeitstempel, der automatisch im Format DateTime für XML eingepflegt werden sollte.
incremental	Legt fest, ob der Feed alle Katalogdaten enthält. Wenn Sie einen Daten-Feed hochladen, der Ihren gesamten Produktkatalog enthält, setzen Sie diesen Wert auf false.
supplemental	Legt fest, ob der Feed ergänzende Katalogdaten enthält. Dieser Feed-Typ sollte nur verwendet werden, wenn Sie mehrere Katalogquellen bereitstellen.
xmlns	Schema-Referenz. Setzen Sie diesen Wert auf http://www.bazaarvoice.com/xs/PRR/ProductFeed/14.7.

<Feed xmlns="http://www.bazaarvoice.com/xs/PRR/ProductFeed/15.1" name="ExampleClient" incremental="false" extractDate="2016-01-18T12:00:00">

Marken-Element

Sie können alle Produktmarken im Element <Brands> angeben, indem Sie diese untergeordneten Elemente verwenden:

Element	Wert
Marke	Stellt eine Produktmarke in Ihrem Feed dar und muss die folgenden untergeordneten Elemente <ExternalId> und <Name> oder <Names> enthalten. Sie können das Attribut removed="true" im Element <Brand> einschließen, um die Marke als inaktiv zu markieren.
ExternalId	Eindeutige Marken-ID, die nur alphanumerische Zeichen, Bindestriche (-) und Unterstriche (_) aufweist. Wenn eine Marken-ID ein ungültiges Zeichen enthält, ersetzen Sie dieses durch ein alternatives Zeichen wie z. B. einen Unterstrich. Dieses Format gilt nur für den Daten-Feed und hat keinen Einfluss auf die Endnutzer. Bei der ID gibt es keine Unterscheidung von Groß- und Kleinschreibung. Bitte beachten Sie, dass Sie daher keine übereinstimmenden IDs nutzen können. Stellen Sie sicher, dass die ID stabil ist und sich nicht innerhalb der Marke ändert, auch wenn sich der Name der Marke ändern sollte.
Name oder Names	Name der Marke, wie er auch Endnutzern angezeigt wird. Wenn Sie lokalisierte Markennamen in einer multilingualen Implementierung angeben, fügen Sie ein <Name>-Element für jeden Standort eines übergeordneten <Names>-Elements ein und geben Sie dann das locale-Attribut (des Typs „String“) für jedes untergeordnete <Name>-Element an.

Wenn Sie anschließend Produkte im Element <Products> definieren, können Sie das Element <BrandExternalId> verwenden, um auf die ID einer Marke im Element <Brands> zu verweisen.

Hinweis: Eine weitere Methode, Marken in Ihrem Katalog anzugeben, ist die Verwendung des untergeordneten Elements <Brand> im Element <Product>. Sie können diese Methode anstelle des hier beschriebenen Elements <Brands> verwenden.

<Brands> <Brand> <ExternalId>AAA</ExternalId> <Name>First Brand</Name> </Brand> <Brand> <ExternalId>BBB</ExternalId> <!-- Default brand name --> <Name>Second Brand</Name> <!-- Localized brand names --> <Names> <Name locale="en_CA">Second Brand CA</Name> <Name locale="fr_CA">Deuxième marque CA</Name> </Names> </Brand> </Brands> <Products> <Product> <Name>First Product</Name> <ExternalId>Prod-1234</ExternalId> <BrandExternalId>AAA</BrandExternalId> ... </Product> </Products>

Kategorien-Element

Das Element <Categories> definiert jede Kategorie, die von Produkten in Ihrem Feed durch die folgenden untergeordneten Elemente repräsentiert wird. Es kann auch verwendet werden, um eine Kategorienhierarchie zu definieren. Dies ist ein Pflichtelement.

Element	Wert	Erforderlich
Kategorie	Stellt eine Produktkategorie in Ihrem Feed dar und kann andere in dieser Tabelle aufgelistete Elemente enthalten. Sie können das Attribut removed="true" im Element <Category> einschließen, um die Kategorie als inaktiv zu markieren.	Ja
ExternalId	Eindeutige ID der Kategorie oder Unterkategorie, die nur alphanumerische Zeichen, Bindestriche (-) und Unterstriche (_) aufweist. Wenn eine Kategorie-ID ein ungültiges Zeichen enthält, ersetzen Sie dieses durch ein alternatives Zeichen wie z. B. einen Unterstrich. Dieses Format gilt nur für den Daten-Feed und hat keinen Einfluss auf die Endnutzer. Bei der ID gibt es keine Unterscheidung von Groß- und Kleinschreibung. Bitte beachten Sie, dass Sie daher keine übereinstimmenden IDs nutzen können. Stellen Sie sicher, dass die Kategorie-ID stabil ist und sich nicht anpasst, auch wenn sich der Name der Kategorie ändert.	Ja
ParentExternalId	ID der übergeordneten Kategorie der betreffenden Unterkategorie.	Nein
Name oder Names	Name der Kategorie oder Unterkategorie, wie er auch Endnutzern angezeigt wird. Wenn Sie lokalisierte Kategorien in einer multilingualen Implementierung angeben, fügen Sie ein <Name>-Element für jeden Standort eines übergeordneten <Names>-Elements ein und geben Sie dann das locale-Attribut (des Typs „String“) für jedes untergeordnete <Name>-Element an.	Ja
CategoryPageUrl oder CategoryPageUrls	Eindeutige URL der Kategorie oder Unterkategorie. Beachten Sie bei der Angabe einer URL Folgendes: Fügen Sie keine sachfremden Abfrageparameter ein, die Sie möglicherweise für Tracking- und Partnerschaftscodes verwenden. Sollte die URL ein reserviertes Zeichen (Sonderzeichen) enthalten, müssen Sie das Zeichen URL-kodieren . Verwenden Sie zum Beispiel &amp für ein Und-Zeichen, %20 für ein Leerzeichen oder %5B und %5D für eckige Klammern ([ ]). Wenn Sie lokalisierte Kategorien in einer multilingualen Implementierung angeben, fügen Sie ein <CategoryPageUrl>-Element für jeden Standort eines übergeordneten <CategoryPageUrls>-Elements ein und geben Sie dann das locale-Attribut (des Typs „String“) für jedes untergeordnete <CategoryPageUrl>-Element an.	Nur bei der Erfassung von „Questions & Answers“-Inhalten auf Kategorieebene.
ImageUrl oder ImageUrls	Eindeutige URL des Kategorie- oder Unterkategoriebilds, das normalerweise auf Ihrer Website oder einem Content Delivery Network gehostet wird. Beachten Sie bei der Angabe einer URL Folgendes: Sollte die URL ein reserviertes Zeichen (Sonderzeichen) enthalten, müssen Sie das Zeichen URL-kodieren . Verwenden Sie zum Beispiel &amp für ein Und-Zeichen, %20 für ein Leerzeichen oder %5B und %5D für eckige Klammern ([ ]). Wenn Sie lokalisierte Kategorien in einer multilingualen Implementierung angeben, fügen Sie ein <ImageUrl>-Element für jeden Standort eines übergeordneten <ImageUrls>-Elements ein und geben Sie dann das locale-Attribut (des Typs „String“) für jedes untergeordnete <ImageUrl>-Element an. Hinweis: Wenn Ratings & Reviews auf einer HTTPS-Website bereitgestellt wird, müssen Sie Bild-URLs an einem HTTPS-Ort in Ihrem Produktkatalog bereitstellen. Wenn Sie das nicht tun, erhalten die Kunden eine Warnung wegen gemischter Inhalte.	Nur bei der Erfassung von „Questions & Answers“-Inhalten auf Kategorieebene.

<Categories>
    <Category>
        <ExternalId>1010</ExternalId>
        <!-- Standardmäßiger Kategoriename -->
        <Name>Erste Kategorie</Name>
        <!-- Lokalisierte Kategorienamen -->
        <Names>
            <Name locale="en_CA">First Category CA</Name>
            <Name locale="fr_CA">Première catégorie CA</Name>
        </Names>
        <!-- Standardmäßige Kategorieseiten-URL -->
        <CategoryPageUrl>
            http://www.example.com/category.htm?cat=1010
        </CategoryPageUrl>
        <!-- Lokalisierte Kategorieseiten-URLs -->
        <CategoryPageUrls>
            <CategoryPageUrl locale="en_CA">
                 http://www.example.ca/en_ca/category.htm?cat=1010
            </CategoryPageUrl>
            <CategoryPageUrl locale="fr_CA">
                 http://www.example.ca/fr_ca/category.htm?prod=1010
            </CategoryPageUrl>
        </CategoryPageUrls>
        <!-- Standardmäßige Kategoriebild-URL -->
        <ImageUrl>http://images.example.com/catimages/1010.gif</ImageUrl>
        <!-- Lokalisierte Kategoriebild-URLs -->
        <ImageUrls>
            <ImageUrl locale="en_CA">
                http://images.example.ca/en_ca/catimages/1010.gif
            </ImageUrl>
            <ImageUrl locale="fr_CA">
                http://images.example.ca/fr_ca/catimages/1010.gif
            </ImageUrl>
        </ImageUrls>
    </Category>
    <Category>
        <ExternalId>1020</ExternalId>
        <Name>Zweite Kategorie</Name>
        <CategoryPageUrl>
            http://www.example.com/category.htm?cat=1020
        </CategoryPageUrl>
        <ImageUrl>http://images.example.com/catimages/1020.gif</ImageUrl>
    </Category>
    <Category>
        <ExternalId>1021</ExternalId>
        <ParentExternalId>1020</ParentExternalId>
        <Name>Unterkategorie</Name>
        <CategoryPageUrl>
            http://www.example.com/category.htm?cat=1021
        </CategoryPageUrl>
        <ImageUrl>http://images.example.com/catimages/1021.gif</ImageUrl>
    </Category>
</Categories>

Produkte-Element

<Produkte> ist ein erforderliches übergeordnetes Element, das jedes Produkt in Ihrem Feed anhand der in der folgenden Tabelle aufgeführten gemeinsamen untergeordneten Elemente definiert. Dies ist ein Pflichtelement. Eine vollständige Liste der verfügbaren Elemente finden Sie im Produkt-Feed Schema .

Element	Wert	Erforderlich
Produkt	Stellt ein Produkt in Ihrem Feed dar und kann andere in dieser Tabelle aufgelistete Elemente enthalten. Sie können das Attribut removed="true" im Element <Product> einschließen, um das Produkt als inaktiv zu markieren. Falls sich das Produkt nicht in der Datenbank befindet und es als inaktiv markiert ist, wird es nicht zur Datenbank hinzugefügt.	Ja
ExternalId	Eindeutige Produkt-ID, die nur alphanumerische Zeichen, Bindestriche (-) und Unterstriche (_) aufweist. Wenn die externe Produkt-ID ein ungültiges Zeichen enthält, ersetzen Sie dieses durch ein alternatives Zeichen wie z. B. einen Unterstrich. Bei der ID gibt es keine Unterscheidung von Groß- und Kleinschreibung. Bitte beachten Sie, dass Sie daher keine übereinstimmenden IDs nutzen können. Dieses Format gilt nur für den Daten-Feed und ist für Endnutzer nicht sichtbar.	Ja, eines pro Produkt
Name oder Names	Name oder Namen des Produkts, wie er auch Endnutzern angezeigt wird. Wenn Sie lokalisierte Produktnamen in einer multilingualen Implementierung angeben, fügen Sie ein <Name>-Element für jeden Standort eines übergeordneten <Names>-Elements ein und geben Sie dann das locale-Attribut (des Typs „String“) für jedes untergeordnete <Name>-Element an.	Ja, eines pro Sprachregion
Description oder Descriptions	Die Beschreibung des Produkts. Wir empfehlen Produktbeschreibungen von mindestens drei Sätzen oder 300 Zeichen. Wenn Sie lokalisierte Produktbeschreibungen in einer multilingualen Implementierung angeben, fügen Sie ein <Description>-Element für jeden Standort eines übergeordneten <Descriptions>-Elements ein und geben Sie dann das locale-Attribut (des Typs „String“) für jedes untergeordnete <Description>-Element an.	Ja, eines pro Sprachregion
Marke	Der Name der Marke, zu der das Produkt gehört. Sie müssen ein untergeordnetes Element <Name> einschließen, um den Markennamen anzugeben. Hinweis: Geben Sie entweder <Brand> oder <BrandExternalId> im Element <Product> an, aber nicht beides.	Ja, einer pro Produkt, sofern <BrandExternalId> nicht vorhanden ist
BrandExternalId	Die ID der Marke, zu der das Produkt gehört. Geben Sie dieses Element an, wenn eine Marke als separates Element im Block <Brands> deklariert wurde. Der Wert von <BrandExternalId> muss mit einer im Block <Brands> definierten Marken-ID übereinstimmen. Wenn der Block <Brands> nicht im Produkt-Feed definiert wurde, verwenden Sie stattdessen <Brand> (oben). Hinweis: Geben Sie entweder <BrandExternalId> oder <Brand> im Element <Product> an, aber nicht beides.	Ja, eine pro Produkt, sofern <Brand> nicht vorhanden ist
CategoryExternalId	Kategorie- oder Unterkategorie-ID des Produkts. Geben Sie dieses Element an, wenn eine Kategorie als separates Element im Block <Categories> deklariert wurde. Der Wert von <CategoryExternalId> muss mit einer im Block <Categories> definierten Kategorien-ID übereinstimmen. Wenn der Block <Categories> nicht im Produkt-Feed definiert wurde, verwenden Sie stattdessen <CategoryPath> (oben). Hinweis: Geben Sie entweder <CategoryExternalId> oder <CategoryPath> im Element <Product> an, aber nicht beides.	Ja, eine pro Produkt
CategoryPath	Eine hierarchisch geordnete Liste aller Kategorien. Jede Kategorie muss in einem untergeordneten Element der Art <CategoryName> spezifiziert werden. Sie können mehrere untergeordnete Elemente der Art <CategoryName> spezifizieren, die jeweils eine Subkategorie des Elements <CategoryName> unmittelbar über sich haben. Hinweis: Geben Sie entweder <CategoryPath> oder <CategoryExternalId> im Element <Product> an, aber nicht beides.	Empfohlen, ein Element pro Produkt
ProductPageUrl oder ProductPageUrls	Eindeutige, fehlerfreie URL einer Produktseite. Fügen Sie keine sachfremden Abfrageparameter ein, die Sie möglicherweise für Tracking- und Partnerschaftscodes verwenden. Beachten Sie bei der Angabe einer URL Folgendes: Sollte die URL ein reserviertes Zeichen (Sonderzeichen) enthalten, müssen Sie das Zeichen URL-kodieren . Verwenden Sie zum Beispiel &amp für ein Und-Zeichen, %20 für ein Leerzeichen oder %5B und %5D für eckige Klammern ([ ]). Wenn Sie lokalisierte URLs in einer multilingualen Implementierung angeben, fügen Sie ein <ProductPageUrl>-Element für jeden Standort eines übergeordneten <ProductPageUrls>-Elements ein und geben Sie dann das locale-Attribut (des Typs „String“) für jedes untergeordnete <ProductPageUrl>-Element an.	Ja, einer pro Standort
ImageUrl oder ImageUrls	Eindeutige URL des Produktbilds. Das optimale, leicht flexible Anzeigenformat beträgt 600 x 600 Pixel. Beachten Sie bei der Angabe einer URL Folgendes: Sollte die URL ein reserviertes Zeichen (Sonderzeichen) enthalten, müssen Sie das Zeichen URL-kodieren . Verwenden Sie zum Beispiel &amp für ein Und-Zeichen, %20 für ein Leerzeichen oder %5B und %5D für eckige Klammern ([ ]). Wenn Sie lokalisierte Bilder in einer multilingualen Implementierung angeben, fügen Sie ein <ImageUrl>-Element für jeden Standort eines übergeordneten <ImageUrls>-Elements ein und geben Sie dann das locale-Attribut (des Typs „String“) für jedes untergeordnete <ImageUrl>-Element an. Hinweis: Wenn Ratings & Reviews auf einer HTTPS-Website bereitgestellt wird, müssen Sie Bild-URLs an einem HTTPS-Ort in Ihrem Produktkatalog bereitstellen. Wenn Sie das nicht tun, erhalten die Kunden eine Warnung wegen gemischter Inhalte.	Ja, einer pro Standort
ModelNumbers	Eindeutiger Referenz-Code, mit dem Unternehmen ein branchenspezifisches Teil identifizieren. Geben Sie für jede Modellnummer, die Sie definieren möchten, ein untergeordnetes <ModelNumber>-Element an. Jede Modellnummer kann Buchstaben, Ziffern und andere Zeichen enthalten.	Nein; wenn enthalten, eine pro Produkt
ManufacturerPartNumbers	Herstellerspezifische Teilenummer. Geben Sie für jede Teilenummer, die Sie definieren möchten, ein untergeordnetes <ManufacturerPartNumber>-Element an. Teilenummern können Buchstaben, Ziffern und Zeichen enthalten.	Ja; Sie können eine unbegrenzte Anzahl an untergeordneten Elementen angeben
EANs	Europäische Artikelnummern (EANs), die weltweit für die Kennzeichnung von Handelswaren verwendet werden. Geben Sie für jede EAN, die Sie definieren möchten, ein untergeordnetes <EAN>-Element an. Jede EAN muss ein acht- oder dreizehnstelliger Zahlenwert sein (Buchstaben oder andere Zeichen sind nicht erlaubt). Entfernen Sie Leerzeichen oder Bindestriche, da diese die Syndizierungszuordnung stören. Hinweis: Die Version 14.3+ des Schemas erzwingt keine Längen-oder Zahlenbeschränkungen für UPCs, EANs und ISBNs. Das Produkt-Schema stuft jede Zahlenfolge in einem dieser Felder als gültig ein. Die Werte in den Feldern UPC, EAN und ISBN werden allerdings während des Katalog-Import-Prozesses validiert und nur gültige Werte werden gespeichert. Die vollständige Syntax für alle global eindeutigen Kennungen finden Sie in dieser Beispiel Produkt-Feed-Datei.	Entweder EANs, UPCs oder ISBNs sind erforderlich. Wenn enthalten, können Sie eine unbegrenzte Anzahl an untergeordneten Elementen angeben. Syndizierungszuordnung wird verbessert, wenn Sie mehrere Werte angeben.
UPCs	Universeller Produktcode (UPC), bei dem es sich um einen 6- oder 12-stelligen Barcode handelt, der für die Standard-Handelsverpackungen in den Vereinigten Staaten verwendet wird. Geben Sie für jeden UPC, den Sie definieren möchten, ein untergeordnetes <UPC>-Element an. Der UPC darf ausschließlich Ziffern aufweisen, keine Buchstaben oder andere Zeichen. Entfernen Sie Leerzeichen oder Bindestriche, da diese die Syndizierungszuordnung stören. Hinweis: Die Version 14.3+ des Schemas erzwingt keine Längen-oder Zahlenbeschränkungen für UPCs, EANs und ISBNs. Das Produkt-Schema stuft jede Zahlenfolge in einem dieser Felder als gültig ein. Die Werte in den Feldern UPC, EAN und ISBN werden allerdings während des Katalog-Import-Prozesses validiert und nur gültige Werte werden gespeichert. Die vollständige Syntax für alle global eindeutigen Kennungen finden Sie in dieser Beispiel Produkt-Feed-Datei.	Entweder EANs, UPCs oder ISBNs sind erforderlich. Wenn enthalten, können Sie eine unbegrenzte Anzahl an untergeordneten Elementen angeben. Syndizierungszuordnung wird verbessert, wenn Sie mehrere Werte angeben.
ISBNs	ISBN: 10- oder 13-stelliger Wert, der hauptsächlich für Medienprodukte wie Bücher, Musik und Videos verwendet wird. Geben Sie für jede ISBN, die Sie definieren möchten, ein untergeordnetes <ISBN>-Element an. Die letzte Ziffer ist eine Kontrollziffer, mit der die Produktkennung validiert werden kann. Die meisten ISBNs bestehen ausschließlich aus Ziffern, manche 10-stelligen ISBN-Werte nutzen als Kontrollziffer jedoch ein X.	Entweder EANs, UPCs oder ISBNs sind erforderlich. Wenn enthalten, können Sie eine unbegrenzte Anzahl an untergeordneten Elementen angeben. Syndizierungszuordnung wird verbessert, wenn Sie mehrere Werte angeben.
Attribute	Benutzerdefinierte Attribute, die es Ihnen ermöglichen, zusätzliche produktspezifische Informationen festzulegen, um Berichte zu produktspezifischen Informationen zu erstellen oder um Produktfamilien zu unterstützen. Geben Sie ein untergeordnetes Element der Art <Attribute> für jedes Produktattribut an, das Sie festlegen möchten. Achten Sie darauf, mithilfe des Attributs id des Elements <Attribute> den Namen des Produktattributs anzugeben. Leerzeichen sind in der Attributs-ID nicht zulässig.	Nein; wenn enthalten, können Sie eine unbegrenzte Anzahl an untergeordneten Elementen angeben
Farbe	Farbe des Produkts.	Nein; empfohlen
Size	Größe des Produkts.	Nein; empfohlen
Material	Material des Produkts. Zum Beispiel Stahl, Kunststoff, Seide usw.	Nein; empfohlen
Währung	Währung des Produkts an jedem Standort. Hinweis: Die Währung muss im Format ISO 4217N angegeben werden.	Nein; empfohlen
Price	Preis des Produkts.	Nein; empfohlen
Verfügbarkeit	Gibt an, ob ein Produkt zum Kauf verfügbar ist oder nicht. Es kann ausverkauft oder außerhalb der Saison sein.	Nein; empfohlen

<Products> <Product> <ExternalId>11111111111abc</ExternalId> <Name>First Product Round with Green</Name> <Description>First Product Description Text</Description> <Brand> <Name>brand-123</Name> </Brand> <CategoryPath> <CategoryName>Category</CategoryName> <CategoryName>Sub Category</CategoryName> </CategoryPath> <ProductPageUrl>http://www.example.com/product.htm?prod=2000001</ProductPageUrl> <ImageUrl>http://images.example.com/prodimages/2000001.gif</ImageUrl> <Color>Red</Color> <Size>L</Size> <Material>Denim</Material> <Availability>false</Availability> <Currency Price="12.99" CurrencyCode="GBP"/> <!-- Product details needed for syndication --> <ManufacturerPartNumbers> <ManufacturerPartNumber>26-12345-8Z</ManufacturerPartNumber> </ManufacturerPartNumbers> <EANs> <EAN>0213354752286</EAN> <EAN>0188173724031</EAN> </EANs> <UPCs> <UPC>382157229380</UPC> <UPC>283929327281</UPC> </UPCs> <!-- Custom product attributes --> <Attributes> <Attribute id="SAP_STATUS"> <Value>L</Value> </Attribute> <Attribute id="BUYING_NUMBER"> <Value>Not_Available</Value> </Attribute> <Attribute id="PROD_MGMT_GRP_NUMBER"> <Value>Group56789</Value> </Attribute> </Attributes> </Product> <Product> <ExternalId>22</ExternalId> <Name>Second Product Round and Green</Name> <Description>Second Product Description Text</Description> <BrandExternalId>BBB</BrandExternalId> <CategoryExternalId>1021</CategoryExternalId> <ProductPageUrl>http://www.example.com/product.htm?prod=2000002</ProductPageUrl> <ImageUrl>http://images.example.com/prodimages/2000002.gif</ImageUrl> <ModelNumbers> <ModelNumber>1235832</ModelNumber> <ModelNumber>1235839</ModelNumber> </ModelNumbers> <ManufacturerPartNumbers> <ManufacturerPartNumber>26-12345-8W</ManufacturerPartNumber> </ManufacturerPartNumbers> <EANs> <EAN>0213354752287</EAN> </EANs> <UPCs> <UPC>138313830283</UPC> </UPCs> </Product> </Products>

Schritt 3: Den Feed validieren

Ihr Feed muss in gut formatiertem XML vorliegen, das mit dem Bazaarvoice-XML-Schema übereinstimmt. Prüfen Sie Ihren Feed mit diesem Schema, bevor Sie ihn auf Bazaarvoice hochladen. Zur Validierung Ihres Feeds können Sie ein XML-Tool nutzen oder Ihren Produkt-Feed über SFTP hochladen, indem Sie die unten stehenden Schritte befolgen und einen Import via Staging-Workbench auslösen.

Schritt 4: Den Feed hochladen

Wir empfehlen Ihnen, immer dann einen aktualisierten Produkt-Feed hochzuladen, wenn Änderungen an Ihrem Produktkatalog vorgenommen und auf Ihrer Webseite wiedergegeben werden. Es ist wichtig, dass Sie Bazaarvoice passende Updates zur Verfügung stellen, wenn sich Ihr Produktkatalog auf Ihrer Live-Webseite ändert.

Sie können Ihre Daten mit einer weiteren Sicherheitsvorkehrung schützen, indem Sie über einen passwortfreien SSH-Eintrag einen öffentlichen Secure Socket Shell (SSH) Key bereitstellen. Dieser Prozess basiert auf einem privaten Schlüssel, der bei Ihnen bleibt, und einem öffentlichen Schlüssel, der von einem Bazaarvoice SFTP-Server verwendet wird. Kontaktieren Sie den Bazaarvoice-Support für weitere Informationen und Unterstützung, wenn Sie diese schlüsselbasierte Authentifikations-Methode einrichten möchten.

Laden Sie die XML-Feed-Datei in das Verzeichnis /import-inbox des SFTP-Servers 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.

Nachdem Sie einen Produkt-Feed auf einen SFTP-Server hochgeladen haben, beginnt Bazaarvoice um 2:00 Uhr CT (CST: UTC-6 oder CDT: UTC-5) automatisch mit dem Import des Feeds. Aufgrund des Importvorgangs kann es allerdings sein, dass Bazaarvoice den Import Ihres Feeds erst später am selben Tag abschließt.

Wenn Sie den Feed auf einen Staging-Server hochgeladen haben, können Sie einen Import manuell auslösen. (Ein Import in den Produktionsserver kann nicht manuell ausgelöst werden.) Führen Sie folgende Schritte aus, um den Feed manuell zu importieren:

1. Wählen Sie in der Bazaarvoice-Workbench Ihres Staging-Servers Settings > Validate Product Feed (Einstellungen > Produkt-Feed bestätigen) aus.
2. Wählen Sie Schedule one-time import (Einmaligen Import planen) aus, um den Feed manuell zu importieren.

Schritt 5: Den Feed-Status überprüfen

Nachdem Sie einen Feed auf den Staging- oder Produktions-SFTP-Server hochgeladen haben, können Sie die Importzusammenfassung und möglicherweise aufgetretene Fehler oder Warnungen des Feeds einsehen. Überprüfen Sie die Importzusammenfassung, damit Sie Fehler vor dem nächsten Import korrigieren können. So stellen Sie sicher, dass Sie beim nächsten Import einen gültigen Feed bereitstellen.

Die Importzusammenfassung für Ihren Staging- oder Produktionsserver können Sie anzeigen, indem Sie Settings > Validate Product Feed (Einstellungen > Produkt-Feed bestätigen) wählen. Wenn Ihr Feed einen Fehler oder eine Warnung zurückgibt, wählen Sie sie aus, um mehr Informationen zu erhalten.

Hinweis: Bestätigen Sie den Feed bevor Sie ihn hochladen, wie unter Schritt 3 beschrieben und nutzen Sie das Feed-Bestätigungstool in Workbench. Sie sollten nur funktionstüchtige Feeds auf den Server hochladen und das Feed-Bestätigungstool nutzen, um Fehler abzufangen, die Ihrem eigenen Bestätigungstool möglicherweise entgangen sind.

Beispiel für einen XML-Feed

Auch wenn er höchstwahrscheinlich kürzer und weniger komplex als Ihr Produkt-Feed ist, können Sie anhand dieses Beispiel-Produktfeeds die von Bazaarvoice benötigten grundlegenden Feed-Strukturen kennenlernen.

<?xml version="1.0" encoding="utf-8"?> <Feed xmlns="http://www.bazaarvoice.com/xs/PRR/ProductFeed/15.1" name="ExampleClient" incremental="false" extractDate="2011-10-18T12:00:00.000000"> <!-- Brands --> <Brands> <Brand> <ExternalId>AAA</ExternalId> <Name>First Brand</Name> </Brand> <Brand> <ExternalId>BBB</ExternalId> <!-- Default brand name --> <Name>Second Brand</Name> <!-- Localized brand names --> <Names> <Name locale="en_US">Second Brand US</Name> <Name locale="en_CA">Second Brand CA</Name> <Name locale="fr_CA">Deuxième marque CA</Name> </Names> </Brand> </Brands> <!-- Categories --> <Categories> <Category> <ExternalId>1010</ExternalId> <!-- Default category name --> <Name>First Category</Name> <!-- Localized category names --> <Names> <Name locale="en_US">First Category US</Name> <Name locale="en_CA">First Category CA</Name> <Name locale="fr_CA">Première catégorie CA</Name> </Names> <!-- Default category page URL --> <CategoryPageUrl>http://www.example.com/category.htm?cat=1010</CategoryPageUrl> <!-- Localized category page URLs --> <CategoryPageUrls> <CategoryPageUrl locale="en_US">http://www.example.com/en_us/category.htm?cat=1010</CategoryPageUrl> <CategoryPageUrl locale="en_CA">http://www.example.com/en_ca/category.htm?cat=1010</CategoryPageUrl> <CategoryPageUrl locale="fr_CA">http://www.example.com/fr_ca/category.htm?prod=1010</CategoryPageUrl> </CategoryPageUrls> <!-- Default category image URL --> <ImageUrl>http://images.example.com/catimages/1010.gif</ImageUrl> <!-- Localized category image URLs --> <ImageUrls> <ImageUrl locale="en_US">http://images.example.com/en_us/catimages/1010.gif</ImageUrl> <ImageUrl locale="en_CA">http://images.example.com/en_ca/catimages/1010.gif</ImageUrl> <ImageUrl locale="fr_CA">http://images.example.com/fr_ca/catimages/1010.gif</ImageUrl> </ImageUrls> </Category> <Category> <ExternalId>1020</ExternalId> <Name>Second Category</Name> <CategoryPageUrl>http://www.example.com/category.htm?cat=1020</CategoryPageUrl> <ImageUrl>http://images.example.com/catimages/1020.gif</ImageUrl> </Category> <Category> <ExternalId>1021</ExternalId> <ParentExternalId>1020</ParentExternalId> <Name>Sub Category</Name> <CategoryPageUrl>http://www.example.com/category.htm?cat=1021</CategoryPageUrl> <ImageUrl>http://images.example.com/catimages/1021.gif</ImageUrl> </Category> </Categories> <!-- Products --> <Products> <Product> <ExternalId>11111111111abc</ExternalId> <Name>First Product Round with Green</Name> <Description>First Product Description Text</Description> <BrandExternalId>AAA</BrandExternalId> <CategoryExternalId>1010</CategoryExternalId> <ProductPageUrl>http://www.example.com/product.htm?prod=2000001</ProductPageUrl> <ImageUrl>http://images.example.com/prodimages/2000001.gif</ImageUrl> <!-- Product details needed for syndication --> <ManufacturerPartNumbers> <ManufacturerPartNumber>26-12345-8Z</ManufacturerPartNumber> </ManufacturerPartNumbers> <EANs> <EAN>0213354752286</EAN> <EAN>0188173724031</EAN> <EAN>1833474920123</EAN> </EANs> <UPCs> <UPC>382157229380</UPC> <UPC>283929327281</UPC> <UPC>058227392728</UPC> </UPCs> <!-- Custom product attributes --> <Attributes> <!-- Families the product is a member of --> <Attribute id="BV_FE_FAMILY"> <Value>Green</Value> </Attribute> <Attribute id="BV_FE_FAMILY"> <Value>Round</Value> </Attribute> <!-- Product management group ID --> <Attribute id="ProductManagementGroupId"> <Value>Group56789</Value> </Attribute> </Attributes> </Product> <Product> <ExternalId>22</ExternalId> <Name>Second Product Round and Green</Name> <Description>Second Product Description Text</Description> <BrandExternalId>BBB</BrandExternalId> <CategoryExternalId>1021</CategoryExternalId> <ProductPageUrl>http://www.example.com/product.htm?prod=2000002</ProductPageUrl> <ImageUrl>http://images.example.com/prodimages/2000002.gif</ImageUrl> <ModelNumbers> <ModelNumber>1235832</ModelNumber> <ModelNumber>1235839</ModelNumber> </ModelNumbers> <ManufacturerPartNumbers> <ManufacturerPartNumber>26-12345-8W</ManufacturerPartNumber> </ManufacturerPartNumbers> <EANs> <EAN>0213354752287</EAN> </EANs> <UPCs> <UPC>138313830283</UPC> </UPCs> <!-- Custom product attributes --> <Attributes> <!-- Families the product is a member of --> <Attribute id="BV_FE_FAMILY"> <Value>Round</Value> </Attribute> <Attribute id="BV_FE_FAMILY"> <Value>Green</Value> </Attribute> <!-- Show all content from other products in the Round Family --> <Attribute id="BV_FE_EXPAND"> <Value>BV_FE_FAMILY:Round</Value> </Attribute> <!-- Product management group ID --> <Attribute id="ProductManagementGroupId"> <Value>Group56789</Value> </Attribute> </Attributes> </Product> <!-- Example product with multiple languages --> <Product> <ExternalId>333</ExternalId> <!-- Default product name --> <Name>Third Product Square and Red</Name> <!-- Localized product names --> <Names> <Name locale="en_US">Third Product US</Name> <Name locale="en_CA">Third Product CA</Name> <Name locale="fr_CA">Troisième produit CA</Name> </Names> <!-- Default product description --> <Description>Third Product Description Text</Description> <!-- Localized product descriptions --> <Descriptions> <Description locale="en_US">Third Product Description Text US</Description> <Description locale="en_CA">Third Product Description Text CA</Description> <Description locale="fr_CA">Troisième texte Description du produit</Description> </Descriptions> <BrandExternalId>BBB</BrandExternalId> <CategoryExternalId>1021</CategoryExternalId> <!-- Default product page URL --> <ProductPageUrl>http://www.example.com/product.htm?prod=2000003</ProductPageUrl> <!-- Localized product page URLs --> <ProductPageUrls> <ProductPageUrl locale="en_US">http://www.example.com/en_us/product.htm?prod=2000003</ProductPageUrl> <ProductPageUrl locale="en_CA">http://www.example.com/en_ca/product.htm?prod=2000003</ProductPageUrl> <ProductPageUrl locale="fr_CA">http://www.example.com/fr_ca/product.htm?prod=2000003</ProductPageUrl> </ProductPageUrls> <!-- Default product image URL --> <ImageUrl>http://images.example.com/prodimages/2000003.gif</ImageUrl> <!-- Localized product image URLs --> <ImageUrls> <ImageUrl locale="en_US">http://images.example.com/en_us/prodimages/2000003.gif</ImageUrl> <ImageUrl locale="en_CA">http://images.example.com/en_ca/prodimages/2000003.gif</ImageUrl> <ImageUrl locale="fr_CA">http://images.example.com/fr_ca/prodimages/2000003.gif</ImageUrl> </ImageUrls> <ModelNumbers> <ModelNumber>123523832</ModelNumber> <ModelNumber>123325839</ModelNumber> </ModelNumbers> <ManufacturerPartNumbers> <ManufacturerPartNumber>26-93812-8W</ManufacturerPartNumber> </ManufacturerPartNumbers> <EANs> <EAN>0813354723287</EAN> </EANs> <UPCs> <UPC>138313830999</UPC> </UPCs> <!-- Custom product attributes --> <Attributes> <!-- Families this product is a member of --> <Attribute id="BV_FE_FAMILY"> <Value>Red</Value> </Attribute> <Attribute id="BV_FE_FAMILY"> <Value>Square</Value> </Attribute> <!-- Show all content from other products in the Red Family --> <Attribute id="BV_FE_EXPAND"> <Value>BV_FE_FAMILY:Red</Value> </Attribute> <!-- Show all content from other products in the Square Family --> <Attribute id="BV_FE_EXPAND"> <Value>BV_FE_FAMILY:Square</Value> </Attribute> <!-- Price of this product in USA --> <Attribute id="PriceUs"> <Value>65.30</Value> </Attribute> <!-- Price of this product in Canada --> <Attribute id="PriceCa"> <Value>67.25</Value> </Attribute> <!-- Product management group ID --> <Attribute id="ProductManagementGroupId"> <Value>Group12345</Value> </Attribute> </Attributes> </Product> <Product> <ExternalId>4444</ExternalId> <Name>Fourth Product Round and Black</Name> <Description>Fourth Product Description Text</Description> <BrandExternalId>BBB</BrandExternalId> <CategoryExternalId>1021</CategoryExternalId> <ProductPageUrl>http://www.example.com/product.htm?prod=2000002</ProductPageUrl> <ImageUrl>http://images.example.com/prodimages/2000002.gif</ImageUrl> <ModelNumbers> <ModelNumber>1235832</ModelNumber> <ModelNumber>1235839</ModelNumber> </ModelNumbers> <ManufacturerPartNumbers> <ManufacturerPartNumber>26-12345-8W</ManufacturerPartNumber> </ManufacturerPartNumbers> <EANs> <EAN>0213354752287</EAN> </EANs> <UPCs> <UPC>138313830283</UPC> </UPCs> <!-- Custom product attributes --> <Attributes> <!-- Families this product is a member of --> <Attribute id="BV_FE_FAMILY"> <Value>Round</Value> </Attribute> <!-- Show all content from other products in the Round Family --> <Attribute id="BV_FE_EXPAND"> <Value>BV_FE_FAMILY:Round</Value> </Attribute> <!-- Product management group ID --> <Attribute id="ProductManagementGroupId"> <Value>Group56789</Value> </Attribute> </Attributes> </Product> <Product> <ExternalId>55555</ExternalId> <Name>Fifth Product- Family level</Name> <Description>Use this product to collect reviews at a Family level. This product is also a member of the Green Family. It has the BV_FE_EXPAND Attribute set which will pull all reviews for the family</Description> <BrandExternalId>BBB</BrandExternalId> <CategoryExternalId>1021</CategoryExternalId> <ProductPageUrl>http://www.example.com/product.htm?prod=2000002</ProductPageUrl> <ImageUrl>http://images.example.com/prodimages/2000002.gif</ImageUrl> <ModelNumbers> <ModelNumber>1235832green</ModelNumber> <ModelNumber>1235543green</ModelNumber> <ModelNumber>127654green</ModelNumber> <ModelNumber>123111green</ModelNumber> </ModelNumbers> <UPCs> <UPC>138313830281</UPC> <UPC>138313830282</UPC> <UPC>138313830283</UPC> <UPC>138313830284</UPC> </UPCs> <!-- Custom product attributes --> <Attributes> <!-- Families this product is a member of --> <Attribute id="BV_FE_FAMILY"> <Value>Green</Value> </Attribute> <!-- Show all content from other products in the Green Family --> <Attribute id="BV_FE_EXPAND"> <Value>BV_FE_FAMILY:Green</Value> </Attribute> </Attributes> </Product> </Products> </Feed>

Einen Text-Produktkatalog-Feed erstellen

Bazaarvoice unterstützt die Übermittlung von Katalogdaten in einer Textdatei. Obwohl dieses Format grundsätzlich für die Bereitstellung des Hauptkatalog-Feeds verwendet werden kann, empfehlen wir Ihnen die Nutzung des Textformats für supplemental feed files (ergänzende Feed-Dateien), da das Textformat folgende Einschränkungen aufweist:

• Fehlende Lokalisierung – Sie können keine lokalisierten Katalogattribute wie Produktname, Kategoriename und URLs angeben.
• Einfache Kategorienhierarchie – Obwohl das Textformat Kategorieinformationen unterstützt, können nur nicht lokalisierte Kategorienamen in einer Textdatei bereitgestellt werden. In einer Textdatei können keine eindeutigen Kategoriekennungen an Bazaarvoice übermittelt werden. Falls das doch der Fall ist, können Folgeprobleme auftreten, wenn sich die Kategorienamen aus irgendeinem Grund einmal ändern.

• Strenge Beschränkungen für Feldwerte – Sie müssen sich bei der Erstellung eines Text-Feeds an die folgenden Regeln halten:

  • Schließen Sie keine Instanzen eines Trennzeichens (Komma, senkrechte Striche oder Tabs) in Feldwerte wie Name oder Description ein.
  • Schließen Sie Feldwerte nicht in doppelte Anführungszeichen ein.
  • Vermeiden Sie die Verwendung von führenden und nachfolgenden Leerzeichen in Feldwerten, da diese zusammen mit dem Wert in der Bazaarvoice-Datenbank gespeichert werden.

Schließen Sie die Schritte in diesem Abschnitt ab, um Katalogdaten in Form einer Textdatei an Bazaarvoice zu übermitteln.

Schritt 1: Die Textdatei erstellen und formatieren

Die folgenden Abschnitte zeigen die exakten Spezifikationen der Bazaarvoice-Text-Feed-Datei im Detail.

Dateiattribute

Die Datei muss folgendermaßen formatiert werden:

Dateiattribut	Beschreibung
Überschrift	Muss als erste Zeile in der Datei aufgelistet werden und mit // beginnen. Fügen Sie eine Überschrift für bestimmte Szenarien hinzu, wenn Sie mehrere Katalogquellen nutzen, zum Beispiel, wenn Sie eine Textdatei als Haupt-Feed zusammen mit mehreren Katalog-Feed-Quellen verwenden. Hier ist ein Beispiel: //catalogMode=COMPLETE
Trennzeichen	Verwenden Sie eines der folgenden Trennzeichen, um Spalten zu trennen: Komma Senkrechter Strich (I) Tab
Spaltenkopfzeile	Erforderlich, um die in der Datei bereitgestellten Werte zu beschreiben. Die Datei muss mindestens zwei Spalten enthalten. Unter Spaltendefinitionen finden Sie eine Liste mit Kopfzeilen und Werten, die Sie in die Datei einschließen können.
Dateierweiterung	Sie können für die Benennung des Feeds jede Dateierweiterung verwenden, da Bazaarvoice den Dateityp automatisch erkennt. Wir empfehlen Ihnen jedoch gängige Erweiterungen wie .csv, .tsv oder .txt.

Spaltendefinitionen

Folgende Spalten werden in der Textdatei nicht unterstützt. Bei Spaltennamen muss nicht auf Groß- und Kleinschreibung geachtet werden.

Spaltenname	Wert	Erforderlich
ExternalId	Eindeutige Produkt-ID, die nur alphanumerische Zeichen, Bindestriche (-) und Unterstriche (_) aufweist. Wenn die externe Produkt-ID ein ungültiges Zeichen enthält, ersetzen Sie dieses durch ein alternatives Zeichen wie z. B. einen Unterstrich. Bei der ID gibt es keine Unterscheidung von Groß- und Kleinschreibung. Bitte beachten Sie, dass Sie daher keine übereinstimmenden IDs nutzen können. Dieses Format gilt nur für den Daten-Feed und ist für Endnutzer nicht sichtbar.	Ja
Name	Name des Produkts, wie er auch Endnutzern angezeigt wird.	Nein
Beschreibung	Die Beschreibung des Produkts. Eine Beschreibung wird nur innerhalb der optionalen Facebook-App für Ratings & Reviews oder Questions & Answers verwendet. Wir empfehlen Produktbeschreibungen von mindestens drei Sätzen oder 300 Zeichen.	Nein
Marke	Der Name der Marke, zu der das Produkt gehört. Hinweis: Wenn BrandExternalId nicht zusätzlich zu Brand angegeben wird, wird eine externe ID für die Marke erstellt, auch wenn die External ID einer Marke in einem Feed angegeben oder in der Vergangenheit erstellt wurde.	Empfohlen
BrandExternalId	Die ID der Marke, zu der das Produkt gehört.	Empfohlen
Kategorie	Der Kategoriename des Produkts.	Empfohlen
CategoryExternalId	Kategorie-ID des Produkts. Hinweis: Wenn CategoryExternalId nicht zusätzlich zu Category angegeben wird, wird eine External ID für die Kategorie erstellt, auch wenn eine externe Kategoriekennung in einem Feed angegeben oder in der Vergangenheit erstellt wurde.	Empfohlen
Produkt-URL	Eindeutige, fehlerfreie URL einer Produktseite. Fügen Sie keine sachfremden Abfrageparameter ein, die Sie möglicherweise für Tracking- und Partnerschaftscodes verwenden. Sollte die URL ein reserviertes Zeichen (Sonderzeichen) enthalten, müssen Sie das Zeichen URL-kodieren . Verwenden Sie zum Beispiel &amp für ein Und-Zeichen, %20 für ein Leerzeichen oder %5B und %5D für eckige Klammern ([ ]).	Ja
Bild-URL	Eindeutige URL des Produktbilds. Das optimale, leicht flexible Anzeigenformat beträgt 600 x 600 Pixel. Sollte die URL ein reserviertes Zeichen (Sonderzeichen) enthalten, müssen Sie das Zeichen URL-kodieren . Verwenden Sie zum Beispiel &amp für ein Und-Zeichen, %20 für ein Leerzeichen oder %5B und %5D für eckige Klammern ([ ]). Hinweis: Wenn Ratings & Reviews auf einer HTTPS-Website bereitgestellt wird, müssen Sie Bild-URLs an einem HTTPS-Ort in Ihrem Produktkatalog bereitstellen. Wenn Sie das nicht tun, erhalten die Kunden eine Warnung wegen gemischter Inhalte.	Ja
ModelNumber	Eindeutiger Referenz-Code, mit dem Unternehmen ein branchenspezifisches Teil identifizieren. Jede Modellnummer kann Buchstaben, Ziffern und andere Zeichen enthalten.	Nein; wenn enthalten, eine pro Produkt
ManufacturerPartNumber	Herstellerspezifische Teilenummer (MPN). Teilenummern können Buchstaben, Ziffern und Zeichen enthalten.	Empfohlen
EAN	Europäische Artikelnummern (EANs), die weltweit für die Kennzeichnung von Handelswaren verwendet werden. Jede EAN muss ein acht- oder dreizehnstelliger Zahlenwert sein (Buchstaben oder andere Zeichen sind nicht erlaubt). Entfernen Sie Leerzeichen oder Bindestriche, da diese die Syndizierungszuordnung stören. Hinweis: Bazaarvoice kennt keinerlei zahlen- oder längenmäßige Beschränkungen für EANs. Die Werte werden während des Katalog-Import-Vorgangs validiert, es werden jedoch nur gültige Werte gespeichert.	Entweder EANs, UPCs oder ISBNs sind erforderlich. Wenn enthalten, können Sie eine unbegrenzte Anzahl an untergeordneten Elementen angeben. Syndizierungszuordnung wird verbessert, wenn Sie mehrere Werte angeben.
UPC	Universeller Produktcode (UPC), bei dem es sich um einen 6- oder 12-stelligen Barcode handelt, der für die Standard-Handelsverpackungen in den Vereinigten Staaten verwendet wird. Der UPC darf ausschließlich Ziffern aufweisen, keine Buchstaben oder andere Zeichen. Entfernen Sie Leerzeichen oder Bindestriche, da diese die Syndizierungszuordnung stören. Hinweis: Bazaarvoice kennt keinerlei zahlen- oder längenmäßige Beschränkungen für EANs. Die Werte werden während des Katalog-Import-Vorgangs validiert, es werden jedoch nur gültige Werte gespeichert.	Entweder EANs, UPCs oder ISBNs sind erforderlich. Wenn enthalten, können Sie eine unbegrenzte Anzahl an untergeordneten Elementen angeben. Syndizierungszuordnung wird verbessert, wenn Sie mehrere Werte angeben.
ISBN	ISBN: 10- oder 13-stelliger Wert, der hauptsächlich für Medienprodukte wie Bücher, Musik und Videos verwendet wird. Die letzte Ziffer ist eine Kontrollziffer, mit der die Produktkennung validiert werden kann. Die meisten ISBNs bestehen ausschließlich aus Ziffern, manche 10-stelligen ISBN-Werte nutzen als Kontrollziffer jedoch ein X.	Entweder EANs, UPCs oder ISBNs sind erforderlich. Wenn enthalten, können Sie eine unbegrenzte Anzahl an untergeordneten Elementen angeben. Syndizierungszuordnung wird verbessert, wenn Sie mehrere Werte angeben.
GTIN	Die Global Trade Item Number (GTIN) ist eine global eindeutige 14-stellige Nummer zur Identifikation von Handelswaren, Produkten oder Dienstleistungen. Bazaarvoice erkennt den im Feld „GTIN“ angegebenen Werttyp automatisch und speichert ihn als entsprechenden UPC-, EAN- oder ISBN-Wert in der Bazaarvoice-Datenbank.	Nein
BV_FE_Family	Der Name der Produktreihe, zu der das Produkt gehört. Wir empfehlen Ihnen, im Namen von Produktreihen keine Sonderzeichen zu verwenden.	Nein
BV_FE_Expand	Der Name des Produkt-Bundles, um zu aktivieren, dass für ein Produkt alle Familienkomponenten auf der Seite des Produkt-Bundles angezeigt werden.	Nein
inaktiv	Markiert das Produkt als inaktiv, wenn in dieser Spalte ein ja- oder wahr-Wert angegeben wird. Hinweis: Falls sich das Produkt nicht in der Datenbank befindet und es als inaktiv markiert ist, wird es nicht zur Datenbank hinzugefügt.	Nein

Produktattribute mit mehreren Werten

Wenn ein Produkt mehr als einen Wert für ein Attribut hat, sollten Sie möglichst alle Werte angeben, um das Optimum aus dem Bazaarvoice-Netzwerk herauszuholen. Ein Hemd kann beispielsweise in Ihrem Katalogsystem verschiedene SKUs haben, eine für jede Farb- oder Größenvariante. Bazaarvoice unterstützt mehrere Werte für die folgenden Produktattribute:

• UPC
• EAN
• ISBN
• GTIN
• ManufacturerPartNumber
• ModelNumber

Um mehrere Werte für ein Attribut anzugeben, können Sie

• Werte in einer einzigen Spalte kombinieren und die Werte mithilfe von Leerzeichen trennen. Hier ist ein Beispiel:

  ExternalId | UPC 
  123 | 123000000001 
  456 | 456000000001 456000000002 456000000003
  788 | 789000000001 789000000002

• Das Produkt in der Datei wiederholen und in jeder Zeile einen anderen Wert angeben. Hier ist ein Beispiel:

  ExternalId, UPC
  123,123000000001
  456,456000000001
  456,456000000002
  789,789000000001
  789,789000000002
  789,789000000003

Schritt 2: Feed hochladen

Wir empfehlen Ihnen, immer dann einen aktualisierten Produkt-Feed hochzuladen, wenn Änderungen an Ihrem Produktkatalog vorgenommen und auf Ihrer Webseite wiedergegeben werden. Es ist wichtig, dass Sie Bazaarvoice passende Updates zur Verfügung stellen, wenn sich Ihr Produktkatalog auf Ihrer Live-Webseite ändert.

Hinweis: Wenn Sie versuchen, Produktkatalogdaten über mehrere Quellen anzugeben, kontaktieren Sie Bazaarvoice vor Hochladen der Feed-Datei, um diese Funktionalität zu aktivieren.

Sie können Ihre Daten mit einer weiteren Sicherheitsvorkehrung schützen, indem Sie über einen passwortfreien SSH-Eintrag einen öffentlichen Secure Socket Shell (SSH) Key bereitstellen. Dieser Prozess basiert auf einem privaten Schlüssel, der bei Ihnen bleibt, und einem öffentlichen Schlüssel, der von einem Bazaarvoice SFTP-Server verwendet wird. Kontaktieren Sie den Bazaarvoice-Support für weitere Informationen und Unterstützung, wenn Sie diese schlüsselbasierte Authentifikations-Methode einrichten möchten.

Laden Sie die Feed-Datei in das Verzeichnis /import-inbox des SFTP-Servers 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.

Nachdem Sie einen Produkt-Feed auf einen SFTP-Server hochgeladen haben, beginnt Bazaarvoice um 2:00 Uhr CT (CST: UTC-6 oder CDT: UTC-5) automatisch mit dem Import des Feeds. Aufgrund des Importvorgangs kann es allerdings sein, dass Bazaarvoice den Import Ihres Feeds erst später am selben Tag abschließt.

Wenn Sie den Feed auf einen Staging-Server hochgeladen haben, können Sie einen Import manuell auslösen. (Ein Import in den Produktionsserver kann nicht manuell ausgelöst werden.) Führen Sie folgende Schritte aus, um den Feed manuell zu importieren:

1. Wählen Sie in der Workbench Ihres Staging-Servers Settings > Validate Product Feed (Einstellungen > Produkt-Feed bestätigen) aus.
2. Wählen Sie Schedule one-time import (Einmaligen Import planen) aus, um den Feed manuell zu importieren.

Schritt 3: Den Feed-Status überprüfen

Nachdem Sie einen Feed auf den Staging- oder Produktions-SFTP-Server hochgeladen haben, können Sie die Importzusammenfassung und möglicherweise aufgetretene Fehler oder Warnungen des Feeds einsehen. Überprüfen Sie die Importzusammenfassung, damit Sie Fehler vor dem nächsten Import korrigieren können. So stellen Sie sicher, dass Sie beim nächsten Import einen gültigen Feed bereitstellen.

Die Importzusammenfassung für Ihren Staging- oder Produktionsserver können Sie in der Workbench anzeigen, indem Sie Settings > Validate Product Feed (Einstellungen > Produkt-Feed bestätigen) wählen. Wenn Ihr Feed einen Fehler oder eine Warnung zurückgibt, wählen Sie sie aus, um mehr Informationen zu erhalten.

Beispiele für Text-Feeds

Folgendes Beispiel zeigt eine einfache CSV-Datei (comma-separated value; kommagetrennt), die zusätzliche EAN-Katalogdaten enthält:

ExternalId, EAN 123,0123000000001 456,0456000000001 456,0456000000002 789,0789000000001 789,0789000000002 789,0789000000003

Hier ist ein Beispiel einer CSV-Datei, die als primärer Feed für Produktkatalogdaten verwendet werden kann:

//catalogMode=COMPLETE ExternalId, UPC 123,123000000001 456,456000000001 456,456000000002 789,789000000001 789,789000000002 789,789000000003

Dynamische Katalogerfassung (DCC) verwenen

Dynamische Katalogerfassung ermöglicht es Bazaarvoice, Produktkatalogdaten mit JavaScript auf Ihren Produktdetailseiten zu erfassen und zu verbrauchen.

Warum DCC verwenden?

Die folgenden Vorteile sind nur eine Auswahl der Verwendung von DCC statt Produkt-Feeds:

• Wir unterstützen benutzerdefinierte Produktattribute in DCC.
• Der Zugriff auf URL-Werte ist bei Frontend-Produktdetailseiten oft einfacher als bei der Verwendung von Backoffice-Feed-Skripten.
• Feed-Inhalte müssen nicht aktualisiert werden, wenn Produktdetailseiten online oder offline gehen.

Signierte DCC-Ereignisse

DCC-Ereignisse werden ausgelöst, wenn ein Verbraucher eine Produktdetailseite auf der Webseite eines Kunden aufruft. Dieses Ereignis sendet Produktdaten an Bazaarvoice, die aufgrund des öffentlich einsehbaren Codes der Produktdetailseite anfällig für das Kopieren oder Abfangen von Daten sind.

Herkömmliches DCC enthält eine Funktion Event Callback, die eine Komponente Amazon Web Services-Bazaarvoice auslöst, die dies an die Produktdetailseite signalisiert. Sobald das Callback-Event und die Produktdaten Bazaarvoice erreicht haben, validiert die AWS-Komponente, dass die empfangenen Daten mit den Daten der Produktdetailseite übereinstimmen. Dies schlägt regelmäßig aufgrund von IP-Blockierung, Zeitüberschreitungen oder Weiterleiten fehl, die den Abschluss des Daten-Validierung-Schritts verhindern.

Signierte DCC-Ereignisse signieren jedoch Ereignisse digital mit einem JSON-Web-Token (JWT). Dieses JWT wird zusammen mit den Produktdaten gesendet. In der Konfiguration wird ein öffentlicher Schlüssel aufgezeichnet, mit dem diese Daten auf Bazaarvoice-Servern verifiziert werden. Dadurch entfällt die Notwendigkeit eines Rückrufs und das Risiko fehlgeschlagener Produktaktualisierungen im Katalog wird verringert.

Voraussetzungen

Wenden Sie sich an Bazaarvoice-Support, um DCC zu aktivieren, bevor Sie versuchen, mit den folgenden Schritte Produktkatalogdaten bereitzustellen.

Signierte DCC-Ereignisse einrichten

Führen Sie die folgenden Schritte aus, um signierte DCC-Ereignisse einzurichten.

Schritt 1: Schlüssel generieren

Um die erforderlichen Schlüssel zu generieren, führen Sie die folgenden Befehle unter OSX/Linux aus:

ssh-keygen -t rsa -b 2048 -m PEM -f bvdcc.key openssl rsa -in bvdcc.key -pubout -outform PEM -out bvdcc.key.pub

Hinweis: Das RSA Kodierung-Element muss verwendet werden, damit Bazaarvoice Ihren Code akzeptiert.

Diese Befehle generieren die folgenden beiden Dateien:

• bvdcc.key – Der private Schlüssel des Kunden. Dieser sollte nur zum Signieren von Ereignissen auf dem Server des Kunden verwendet werden.
Wichtig: Er sollte sicher gespeichert und niemals weitergegeben werden.
• bvdcc.key.pub – Der öffentliche Schlüssel des Kunden. Dieser muss nicht sicher gespeichert werden. Er sollte unter der DCC-Schlüsseleinstellung in der Konfiguration hinzugefügt werden:

Schritt 2: Implementierung von serverseitigen Daten

Der empfohlene Ansatz ist:

1. Ändern Sie das Javascript der Produktdaten so, dass es das korrekte Format für DCC hat.
2. Signieren Sie Produktdaten mit dem JWT-Token, indem Sie den folgenden Code als Vorlage zum Signieren von Ereignissen mithilfe eines JWT mit einer Knotenbibliothek verwenden.
Hinweis: Der wichtigste Teil ist die Funktion signCatalogUpdate, die ein Array von Zeichenfolgen zurückgibt.

Installing library; npm install --save jsonwebtoken Usage; /* Resources: jsonwebtoken Module: https://www.npmjs.com/package/jsonwebtoken fs Module: https://nodejs.org/api/fs.html#fs_fs_readfilesync_path_options JSON.stringify method: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify */ //SERVER SIDE PSEUDO CODE //Import required modules (jsonwebtoken and fs) const jwt = require('jsonwebtoken'); const fs = require('fs'); //Assigns previously generated (and secretly stored) private key to a variable const privateKey = fs.readFileSync('PATH TO PRIVATE KEY GOES HERE'); const locale = 'en_US'; const products = [ {productId":"MH02", "inactive": false, "productName":"Teton Pullover Hoodie", "productDescription":"The Teton Hoodie Description", "productImageURL":"https:\\mywebsite.com\pub\media\catalog\product\mh02-black_main.jpg", "productPageURL":"https:\\mywebsite.com\teton-pullover-hoodie.html", "brandName":"MyBrand", "categoryPath" : [ { "id" : "123", "Name" : "Parent Category Name" }, { "id" : "123-1", "Name" : "Mens" }, { "id" : "123-1-9", "Name" : "Pants" }], "upcs":["724742001735","724742006907","077320775406","077320775307"], "manufacturerPartNumbers":["mpn1","mpn2","mpn3","mpn4","mpn5"], "eans":["0724742001735","0724742006907","0077320775406","0077320775307"], "isbns":["9781891830754","9781603090506","9781891830716","9781603090254"], "modelNumbers":["model1","model2","model3","model4"], "family": "F02", "price": "12.99", "currencyCode": "USD", "color": "red", "size": "large", "material": "nylon", "availability": true }, //Example of custom attributes "customAttributes": [ { "id": "CustomAttributeId123", "value": "Custom attribute value 1" }, { "id": "CustomAttributeId456", "value": "Custom attribute value 2", }], //Example of adding multi-products into a single call { "productId": "1_Black", "productName": "Hummingbird printed t-shirt Black", "productPageURL": "http://dcc-test-site.qa.us-east-1.nexus.bazaarvoice.com/men/1-3-hummingbird-printed-t-shirt-6419892469002.html", }, ]; //Passes catalog data and privateKey into the token; encoded as RS256 function signCatalogUpdate(products, privateKey) { return products.map(product => jwt.sign({ locale, catalogProducts: [ product ] }, privateKey, { algorithm: 'RS256' })); } //Assigns the returned output from the signCatalogUpdate function to a variable which is then visible on front-end const bvDCC = signCatalogUpdate(products, privateKey); //Outputs DCC product data in a console log, and enters 2 spaces for any NULL values console.log(JSON.stringify(bvDCC, null, 2));

3. Machen Sie die signierten Daten für das Front-End-Javascript über eine API zugänglich.
4. Machen Sie den Code für das Front-End als window.dccSignedTokens zugänglich.
   Hinweis: Um ein Codebeispiel anzuzeigen, rufen Sie diese Webseite auf und greifen Sie auf das Entwicklerfenster zu, indem Sie mit der rechten Maustaste klicken und „Prüfen“ auswählen.

Schritt 3: Implementierung von Front-End-Daten

Ersetzen Sie das vorhandene DCC-Javascript „CatalogUpdate“ auf der Produktdetailseite durch eine der folgenden Implementierungen:

Mehrprodukt-Produktdetailseite:

<script async type="text/javascript"> window.bvCallback = function (BV) { // Use a loop for multiple products for(var i=0, len=window.dccSignedTokens; i < len; ++i){ BV.pixel.trackEvent("CatalogUpdate", { type: 'Product', token: window.dccSignedTokens[i] }); } }; </script>

Einzelprodukt-Produktdetailseite:

<script async type="text/javascript"> window.bvCallback = function (BV) { BV.pixel.trackEvent("CatalogUpdate", { type: 'Product', token: window.dccSignedToken }); }; </script>

Wichtig: Stellen Sie sicher, dass der dem „Token“ zugewiesene Wert die signierte Version der „catalogProducts“-Daten ist und mit der im Abschnitt DCC-Datenattribute beschriebenen Validierung übereinstimmt

DCC-Datenattribute

Die folgenden Tabellen beschreiben die in DCC-JavaScript verwendeten Attribute.

Attribut	Wert	Erforderlich
productId	Eindeutige Produkt-ID, die nur alphanumerische Zeichen, Bindestriche (-) und Unterstriche (_) aufweist. Wenn die externe Produkt-ID ein ungültiges Zeichen enthält, ersetzen Sie dieses durch ein alternatives Zeichen wie z. B. einen Unterstrich. Bei der ID gibt es keine Unterscheidung von Groß- und Kleinschreibung. Bitte beachten Sie, dass Sie daher keine übereinstimmenden IDs nutzen können. Dieses Format gilt nur für den Daten-Feed und ist für Endnutzer nicht sichtbar. Typ: String	Ja
locale	Gibt den gewünschten Standort an. Wenn dieses Attribut nicht angegeben wird, wird der Standort in der BV-Lader-Referenz verwendet. Typ: String	Ja
productName	Name des Produkts, wie er auch Endnutzern angezeigt wird. Typ: String	Ja
productDescription	Die Beschreibung des Produkts. Wir empfehlen Produktbeschreibungen von mindestens drei Sätzen oder 300 Zeichen. Typ: String	Nein
productPageURL	Eindeutige, fehlerfreie URL einer Produktseite. Fügen Sie keine sachfremden Abfrageparameter ein, die Sie möglicherweise für Tracking- und Partnerschaftscodes verwenden. Beachten Sie bei der Angabe einer URL Folgendes: Sollte die URL ein reserviertes Zeichen (Sonderzeichen) enthalten, müssen Sie das Zeichen URL-kodieren . Verwenden Sie zum Beispiel &amp für ein Und-Zeichen, %20 für ein Leerzeichen oder %5B und %5D für eckige Klammern ([ ]). Typ: URL	Ja
productImageURL	Eindeutige URL des Produktbilds. Das optimale, leicht flexible Anzeigenformat beträgt 600 x 600 Pixel. Beachten Sie bei der Angabe einer URL Folgendes: Sollte die URL ein reserviertes Zeichen (Sonderzeichen) enthalten, müssen Sie das Zeichen URL-kodieren . Verwenden Sie zum Beispiel &amp für ein Und-Zeichen, %20 für ein Leerzeichen oder %5B und %5D für eckige Klammern ([ ]). Hinweis: Wenn Ratings & Reviews auf einer HTTPS-Website bereitgestellt wird, müssen Sie Bild-URLs an einem HTTPS-Ort in Ihrem Produktkatalog bereitstellen. Wenn Sie das nicht tun, erhalten die Kunden eine Warnung wegen gemischter Inhalte. Typ: URL	Ja
Farbe	Farbe des Produkts.	Nein; empfohlen
Size	Größe des Produkts.	Nein; empfohlen
Material	Material des Produkts. Zum Beispiel Stahl, Kunststoff, Seide usw.	Nein; empfohlen
Währung	Währung des Produkts an jedem Standort. Hinweis: Die Währung muss im Format ISO 4217N angegeben werden.	Nein; empfohlen
Price	Preis des Produkts.	Nein; empfohlen
Verfügbarkeit	Gibt an, ob ein Produkt zum Kauf verfügbar ist oder nicht. Es kann ausverkauft oder außerhalb der Saison sein.	Nein; empfohlen
brandId	Eindeutige Marken-ID, die nur alphanumerische Zeichen, Bindestriche (-) und Unterstriche (_) aufweist. Wenn eine Marken-ID ein ungültiges Zeichen enthält, ersetzen Sie dieses durch ein alternatives Zeichen wie z. B. einen Unterstrich. Dieses Format gilt nur für den Daten-Feed und hat keinen Einfluss auf die Endnutzer. Bei der ID gibt es keine Unterscheidung von Groß- und Kleinschreibung. Bitte beachten Sie, dass Sie daher keine übereinstimmenden IDs nutzen können. Stellen Sie sicher, dass die ID stabil ist und sich nicht innerhalb der Marke ändert, auch wenn sich der Name der Marke ändern sollte. Im Abschnitt Marken finden sie Informationen zur Sammlung von Markendaten mit DCC. Typ: String	Nein
brandName	Der Name der Marke, zu der das Produkt gehört. Im Abschnitt Marken finden Sie Informationen zur Sammlung von Markendaten mit DCC. Typ: String	Nein
categoryPath	Eine hierarchisch geordnete Liste aller Kategorien. Im Abschnitt Kategorien finden sie Informationen zur Sammlung von Kategoriedaten mit DCC.	Nein
family	Der Name der Produktfamilie, zu der das Produkt gehört. Wir empfehlen Ihnen, in Namen von Produktfamilien keine Sonderzeichen zu verwenden. In diesem Abschnitt erfahren Sie mehr darüber, wie Sie Produktfamilien mit DCC konfigurieren.	Nein
upcs	Universeller Produktcode (UPC), bei dem es sich um einen 6- oder 12-stelligen Barcode handelt, der für die Standard-Handelsverpackungen in den Vereinigten Staaten verwendet wird. Fügen Sie in einem Array jeden UPC hinzu, den Sie definieren möchten. Der UPC darf ausschließlich Ziffern aufweisen, keine Buchstaben oder andere Zeichen. Entfernen Sie Leerzeichen oder Bindestriche, da diese die Syndizierungszuordnung stören. Hinweis: Bazaarvoice kennt keinerlei zahlen- oder längenmäßige Beschränkungen für UPCs, EANs und ISBNs. Das Produkt-Schema stuft jeden String in einem dieser Felder als gültig ein. Die Werte in den Feldern UPC, EAN und ISBN werden allerdings während des Katalog-Import-Prozesses validiert und es werden nur gültige Werte gespeichert. Typ: Array	Nein, die Syndizierungszuordnung wird verbessert, wenn Sie universelle Produktcodes (UPCs) festlegen.
manufacturerPartNumbers	Herstellerspezifische Teilenummer. Teilenummern können Buchstaben, Ziffern und Zeichen enthalten. Typ: Array	Nein
eans	Europäische Artikelnummern (EANs), die weltweit für die Kennzeichnung von Handelswaren verwendet werden. Jede EAN muss ein acht- oder dreizehnstelliger Zahlenwert sein (Buchstaben oder andere Zeichen sind nicht erlaubt). Entfernen Sie Leerzeichen oder Bindestriche, da diese die Syndizierungszuordnung stören. Hinweis: Bazaarvoice kennt keinerlei zahlen- oder längenmäßige Beschränkungen für EANs. Die Werte werden während des Katalog-Import-Vorgangs validiert, es werden jedoch nur gültige Werte gespeichert. Typ: Array	Nein, die Syndizierungszuordnung wird verbessert, wenn Sie europäische Artikelnummern (EANs) festlegen.
isbns	ISBN: 10- oder 13-stelliger Wert, der hauptsächlich für Medienprodukte wie Bücher, Musik und Videos verwendet wird. Die letzte Ziffer ist eine Kontrollziffer, mit der die Produktkennung validiert werden kann. Die meisten ISBNs bestehen ausschließlich aus Ziffern, manche 10-stelligen ISBN-Werte nutzen als Kontrollziffer jedoch ein X. Typ: Array	Nein
modelNumbers	Eindeutiger Referenz-Code, mit dem Unternehmen ein branchenspezifisches Teil identifizieren. Jede Modellnummer kann Buchstaben, Ziffern und andere Zeichen enthalten. Typ: Array	Nein
inaktiv	Signalisiert, dass das Produkt inaktiv ist. Der Standardwert ist falsch. Im Abschnitt Kontrolle der aktiven Produktreihe finden Sie weitere Informationen. Art: boolescher Wert	Nein
customAttributeId	Ermöglicht es Ihnen, zusätzliche produktspezifische Informationen für die Berichterstattung zu definieren. Legen Sie eine ID und den Wert für jedes Produktattribut an, das Sie festlegen möchten. Verwenden Sie keine Leerzeichen in der Attribut-ID. Typ: Array	Nein. Wenn enthalten, können Sie eine unbegrenzte Anzahl an untergeordneten Elementen angeben.

Erforderliche Feed-Elemente für die Unterstützung von Produkten und Funktionen von Bazaarvoice

Damit Syndizierung, Benachrichtigungen, Berichte, Insights und Integrationen mit anderen Bazaarvoice Solutions oder Funktionen erfolgreich sein können, sind qualitativ hochwertige Feed-Inhalte unabdingbar. Bazaarvoice verwendet hauptsächlich eine automatisierte Zuordnungstechnik, die auf global eindeutige Produktkennungen gestützt ist. Die Vollständigkeit und Genauigkeit Ihres Produkt-Feeds bestimmt also, wie gut die Produkte zugeordnet werden können.

Für die folgenden Bazaarvoice-Lösungen und -Funktionen sind genaue Kennungen in Ihrem Produkt-Feed besonders wichtig, da nur so eine optimale Wertigkeit erzielt werden kann:

Syndizierung Benachrichtigungen Berichte (Workbench) Berichte (Portal)

Einblicke Connections Sampling

Die folgenden Abschnitte bieten Informationen zu den wichtigsten Feed-Komponenten, die für die Unterstützung von Produkten und Funktionen erforderlich sind (Ausnahmen werden unten angeführt). Für XML-Feeds sind dies Elemente. Für Text-Feeds sind es Spaltennamen.

Das Element <Name> sollte aus Attributen und Deskriptoren bestehen, die das Produkt eindeutig kennzeichnen. Beispiel für hilfreiche Produktnamen-Attribute sind z. B. Markennamen, Modellnummern, Größen und Farben.

Das Element <Brand> stellt das wichtigste Datenelement dar, das für die Produkte im Feed bereitgestellt wird. Marken werden für mehr als nur Produktzuordnungen verwendet. Im Bazaarvoice-Reportingsystem helfen sie auch dabei, das Optimum aus Ihrer Syndizierung und dem Connections-Programm herauszuholen.

Verwenden Sie in einem XML Feed den gebräuchlichen Markennamen des Produkts für das Element <Name> anstelle des Markennamens des Lieferanten oder des Herstellers. Das gilt insbesondere für Retailers, die mehrere Marken eines einzelnen Lieferanten im Angebot haben. Produkte ohne Markenangabe sind für Reportingsysteme oftmals „unsichtbar“.

Beispiel:
Der Anbieter BrandOne vertreibt das gleichnamige Bleichmittel der Marke BrandOne. Der Lieferant BrandOne vermarktet außerdem BrandTwo Brand Charcoal und BrandThree Brand Salad Dressing. In diesem Fall empfehlen wir sowohl den Lieferanten BrandOne als auch die Händler, die diese Produkte transportieren, BrandThree, BrandTwo und BrandOne als Marken für die jeweiligen Salatdressing-, Holzkohle- und Reinigungsprodukte. Es wird nicht empfohlen, dass alle Produkte BrandOne im Markenfeld verwenden, auch wenn das Unternehmen alle Produkte liefert.

Category definiert eine Kategorie, die von Produkten in Ihrem Feed durch die folgenden untergeordneten Elemente repräsentiert wird. Sie können dieses Element auch zur Definition einer Kategorienhierarchie verwenden.

UPC, EAN und ISBN sind weltweit eindeutige Kennungen (GTINs). Die Produktkategorie, die Sie herstellen oder verkaufen und Ihre Region bestimmen, welche Kennungen aussagekräftig sind. Wenn mehr als ein Wert auf ein Produkt zutrifft, empfehlen wir, alle aussagekräftigen Werte anzugeben. So können beispielsweise Elektronik- oder Verbrauchsgüterprodukte (CPG) mit einem UPC und einer EAN versehen werden.

Ohne global eindeutige Kennungen kann Bazaarvoice die Produkte den Händlern oder Katalogen nicht so schnell zuordnen, wodurch Diskrepanzen wahrscheinlicher werden. Aufgrund der schlechteren Produktdatenqualität sinkt die Zuordnungssicherheit. Dadurch muss die Zuordnung gehäuft manuell bewertet werden, was den Vorgang verlangsamt. Aufgrund der Verzögerungen durch die fehlende automatische Zuordnung können neu eingeführte Produkte nicht umgehend syndiziert werden.

Hinweis: Die Version 14.3+ des Schemas erzwingt keine Längen-oder Zahlenbeschränkungen für UPCs, EANs und ISBNs. Jede Zeichenfolge in einem dieser Felder wird vom Produktschema als gültig behandelt. Die Werte in den Feldern UPC, EAN und ISBN werden jedoch während des Katalog-Import-Prozesses bestätigt und es werden nur gültige Werte gespeichert. Die vollständige Syntax für alle global eindeutigen Kennungen finden Sie in dieser Beispiel-Produkt-Feed-Datei.

Verwenden Sie keine Platzhalterwerte statt gültiger UPC-, EAN- oder ISBN-Werte. Das kann nämlich dazu führen, dass der Feed nicht validiert werden kann. Insbesondere sollten Sie Folgendes nicht tun:

• Buchstaben verwenden.

• Werte einfügen, die länger oder kürzer sind als die definierten globalen Standards für UPC-, EAN- oder ISBN-Werte.

Je nach Ihren Systemfähigkeiten kann es jedoch sein, dass Sie beim Hinzufügen von Produkten zu Ihrem Katalog Platzhalterwerte angeben müssen. Geben Sie dabei aufeinanderfolgende Nullwerte (0) ein, die dieselbe Ziffernanzahl aufweisen wie die Kennung, für die sie stehen. Bazaarvoice speichert die Nullwerte nicht, sie führen bei der Validierung jedoch nicht zu Fehlern.

Datentyp und -format:

• UPC: 6- oder 12-stelliger Wert, dessen letzte Ziffer eine nachprüfbare Kontrollziffer der Nummer ist. Einige Systeme speichern intern nur die ersten 11 Stellen des Produktcodes – stellen Sie also sicher, dass Sie die Kontrollziffer im Feed bereitstellen. In den USA und in Kanada vertriebene Produkte nutzen hauptsächlich UPCs.
• EAN: 13-stelliger Wert, dessen letzte Ziffer eine nachprüfbare Kontrollziffer der Nummer ist. Außerhalb der USA und Kanada vertriebene Produkte nutzen hauptsächlich EANs.
• ISBN: 10- oder 13-stelliger Wert, der hauptsächlich für Medienprodukte wie Bücher, Musik und Videos verwendet wird. Die letzte Ziffer ist eine Kontrollziffer, mit der die Produktkennung validiert werden kann. Die meisten ISBNs bestehen ausschließlich aus Ziffern, manche 10-stelligen ISBN-Werte nutzen als Kontrollziffer jedoch ein X.

Erforderliche Elemente:

• UPCund EAN: Mindestens eine für alle aussagekräftigen Kategorien. Wir empfehlen, dass globale Unternehmen beide anbieten.
• ISBN: Für Bücher, Filme, Musik und Medien.

Die zweithilfreichste Produktkennung für die Syndizierung ist die Hersteller-Teilenummer (MPN). Verwenden Sie die MPN zusammen mit dem Namen des Herstellers, um Produkte richtig und automatisch zuordnen zu können. Geben Sie in Ihrem Feed MPNs in ManufacturerPartNumber-Elementen an und sorgen Sie dafür, dass das Brand-Element eines jeden Produkts den Namen des für die MPN verantwortlichen Herstellers nutzt. Ihr Feed kann mehrere MPN-Werte für ein Einzelprodukt aufweisen. Geben Sie also alle einem Produkt zugeordneten MPNs an.

Hinweis: Der Unterschied zwischen der „Marke“ und dem „Hersteller“ ist nicht immer eindeutig. Fügen Sie bei der Angabe von MPN-Werten den Namen der Marke oder des Herstellers ein, der dem Produkt den spezifischen MPN-Wert zugeordnet hat.

Description liefert eine detaillierte Beschreibung des Produkts.

ImageUrl ist ein wichtiges Unterscheidungsmerkmal für die manuelle Zuordnung. Stellen Sie ein Bild bereit, welches das Produkt genau und aussagekräftig identifiziert.

Hinweis: Wenn Ratings & Reviews auf einer HTTPS-Website bereitgestellt wird, müssen Sie Bild-URLs an einem HTTPS-Ort in Ihrem Produktkatalog bereitstellen. Wenn Sie das nicht tun, erhalten die Kunden eine Warnung wegen gemischter Inhalte.

Über den Link zur Produktseite auf Ihrer Website, spezifiziert durch das Element ProductPageUrl, kann bei der manuellen Zuordnung auf den Gesamtkontext Ihres Produkts zugegriffen werden. Dies ist die am wenigsten bevorzugte Methode für die manuelle Produktzuordnung, da sie sehr zeitaufwändig ist.

Bazaarvoice verwendet eine Lieferanten- oder Anbieter-ID, um zu bestimmen, welche Fragen und Produktbewertungen an den Lieferanten gesendet werden. Diese Daten sind für die gesamte Funktions- und Produktintegration erforderlich, für Retailer sind sie jedoch nur für die Integration von Ratings & Reviews Sammeln/Verteilen) und Connections erforderlich.

Verwenden Sie ein benutzerdefiniertes Attribut, um eine Anbieter- oder Lieferanten-ID im Feed anzugeben, indem Sie ein id="VendorID"-Attribut für das Element <Attribute> spezifizieren. Beispiel:

<Attributes>
	<Attribute id="VendorID"> 
		<Value>2598</Value>
	</Attribute>
	<Attribute id="VendorName">
		<Value>RAWLINGS CANADA INC.</Value>
	</Attribute>
</Attributes>

Wenn Sie ein Händler sind und Connections verwenden, bietet Bazaarvoice Ihnen als Händler (auch „Marken“ oder „Anbieter“ genannt) zwei Optionen , um sich bei Connections Basic und Connections Premium zu registrieren:

• Anbieter- oder Lieferanten-ID – Bietet garantierte Zuordnung zum Anbieter und vermeidet Verwirrung bei größeren Anbietern, die möglicherweise Produkte für verschiedene Kategorien anbieten. Um eine Anbieter- oder Lieferanten-ID anzugeben, fügen Sie das Attribut VendorID zu bestehenden <Attribute>-Elementen eines Produkt-Feeds hinzu. Diese Option hat sich auch bei privaten Labels bewährt, die von verschiedenen Herstellern beliefert werden. Es wird empfohlen, diese Option zu nutzen.
• Markenname– Stellt den Marken- oder Anbieternamen mithilfe des Elements <Brand> bereit. Der Nachteil dieser Option ist, dass alle Händler, die Produkte der angegebenen Marke anbieten, Fragen zu allen Produkten erhalten, auch wenn sie diese gar nicht anbieten.

Nach der Anmeldung nutzt Bazaarvoice diesen Wert, um festzulegen, welche Fragen und Produktbewertungen an den Händler gesendet werden.

Beispiel für Anbieter mit mehreren Kategorien

Händler A bietet Produkte von Anbieter V in drei Kategorien an: Kleingeräte, Fernsehgeräte und Mobiltelefone. Jedes Produkt wird von einer anderen Abteilung des Anbieters hergestellt und vermarktet. Händler A stellt Bazaarvoice die Anbieter-ID für jedes Produkt bereit und verwendet dann die ID, um sich bei Connections anzumelden. Bazaarvoice kann nun Fragen zu Kleingeräten ausschließlich an die entsprechende Abteilung von Anbieter V senden. So kann Anbieter V leichter und schneller reagieren. Ohne die Anbieter- oder Lieferanten-ID würden die Abteilungen für Fernsehgeräte und Mobiltelefone die Frage zu den Kleingeräten auch erhalten.

Beispiel für ein privates Label

Händler A hat ein privates Label mit dem Namen Marke XYZ. Dieser Händler verkauft verpackte Lebensmittel, Pflegeprodukte und Reinigungsmittel unter dem Markennamen XYZ, jeder Produkttyp hat jedoch seinen eigenen Anbieter. Enthält der Produkt-Feed von Händler A Lieferanten-IDs, kann Bazaarvoice ermitteln, welche Fragen an welchen Anbieter gesendet werden. Wenn der Produkt-Feed keine Lieferanten-IDs enthält, kann Bazaarvoice nur über das Element <Brand> ermitteln, wohin die Fragen weitergeleitet werden sollen. Ohne Lieferanten-IDs erhalten alle Lieferanten der Produkte der Marke XYZ Fragen zu allen Produkten der Marke XYZ, auch wenn sie diese gar nicht anbieten.

Inkrementelle Feed-Dateien

Ein vollständiger Produktkatalog-Feed enthält alle Produkte, die in Ihrem Katalog verfügbar sind und für die Sie Inhalte erfassen möchten. Ein inkrementeller Feed enthält Daten für eine Untergruppe Ihrer Produkte.

Betrachten Sie die folgenden Strategien, wenn Sie sich zwischen vollständigen und inkrementellen Feeds entscheiden:

• Nur vollständige Feeds

  Sie können einen vollständigen, periodischen XML-Katalog-Feed bei Bazaarvoice hochladen, der alle aktuellen Daten für alle aktiven Produkte und Kategorien enthält. Das ist die empfohlene Strategie.

• Vollständige und inkrementelle Feeds

  Sie können eine Mischung aus vollständigen und inkrementellen Katalog-Feeds bereitstellen. Wir empfehlen, dass Sie zunächst einen vollständigen Katalog-Feed bereitstellen, gefolgt von regelmäßigen, inkrementellen Feeds, die nur Änderungen an Ihren Katalogdaten enthalten. Erwägen Sie die Verwendung vollständiger und inkrementeller Produkt-Feed, wenn:

  • Sie verändern Ihren Produktkatalog so oft, dass tägliche Produkt-Feed-Updates notwendig sind
  • Sie nehmen unregelmäßige oder geringfügige Updates für Ihren Produkt-Feed vor

  Um jedoch Lücken im Datensatz zu vermeiden, die durch das Versäumnis entstehen können, einen bestimmten inkrementellen Feed hochzuladen und zu verarbeiten, empfehlen wir Ihnen, regelmäßig einen vollständigen Feed (mit aktuellen Daten für Ihren gesamten Katalog) bereitzustellen, um sicherzustellen, dass keine Datenlücken vorhanden sind.

• Nur inkrementelle Feeds

  Wenn Sie nicht alle Produkte in einem einzigen vollständigen Katalog-Feed bereitstellen können, können Sie auch nur inkrementelle Feeds bereitstellen. Achten Sie darauf, dass Sie das Attribut removed=”true” zu verwenden, wenn Sie nur inkrementelle Feeds bereitstellen. Weitere Informationen zu diesem Ansatz finden Sie unter Kontrolle der aktiven Produktsätze.

  Achtung: Wenn Sie nur inkrementelle Feeds verwenden und Sie Bazaarvoice nie einen vollständigen Feed bereitstellen, kann es passieren, dass Katalogdaten nicht mehr im Einklang mit Ihrem Quellenproduktkatalog stehen, sobald ein inkrementeller Feed-Upload nicht vorgenommen wird oder in irgendeiner Form fehlschlägt.

Jede Feed-Datei gibt an, ob sie vollständig oder inkrementell ist, obwohl die Handhabung sich je nach Feed-Format unterschiedlich gestaltet:

• XML-Feed-Dateien: Verwenden Sie das Attribut incremental im Element <Feed>
• Text-Feed-Dateien: Geben Sie eine Dateikopfzeile an

Katalogdaten anhand benutzerdefinierter Produktattribute filtern

Um Ihren Produkt-Feed nach benutzerdefinierten Produktattributen zu filtern, müssen Sie diese zu Ihrer Feed-Konfiguration hinzufügen. So können Sie im Dashboard für Inhalte und in Berichten nach Attributen in Workbench filtern. Benutzerdefinierte Produktattribute ermöglichen es Ihnen, Berichte mit produktspezifischen Informationen zu erstellen, jedoch nicht über mehrere Kategorien in einem Feed. Sie können zum Beispiel das Attribut „Region“ definieren, um Berichte über Hotels in einer bestimmten Region des Landes zu erstellen. Alternativ können Sie auch das Attribut „Abteilung“ definieren, um zu verfolgen, wie die Produkte unterschiedlicher Abteilungen von Ihren Kunden aufgenommen werden.

Hinweis: Wenn Sie benutzerdefinierte Produktattribute in einen Text-Feed einfügen möchten, wenden Sie sich an Bazaarvoice Support für Unterstützung.

Führen Sie die folgenden Schritte durch, um ein benutzerdefiniertes Produktattribut zu Ihrer Implementierung hinzuzufügen, und aktivieren Sie anschließend benutzerdefinierte Produktattribute in Workbench:

1. Schließen Sie benutzerdefinierte Produktattribute im Feed ein, indem Sie den Block <Attributes> zum Element <Products> hinzufügen. Jedes <Attribute>-Element im Block <Attribute> kennzeichnet ein benutzerdefiniertes Attribut. Hier ist ein Beispiel für drei benutzerdefinierte Attribute:

   <Products>
    <Product> ... <Attributes> <Attribute id="CHANNEL_VISIBILITY">
    <Value>Beliebig</Value>
    </Attribute>
    <Attribute id="SAP_STATUS">
    <Value>L</Value>
    </Attribute>
    <Attribute id="BUYING_NUMBER">
    <Value>Nicht verfügbar</Value>
    </Attribute>
    </Attributes> </Product>
   </Products>

2. Melden Sie sich im Bazaarvoice-Portal an.
   Hinweis: Sie können Attribute auf Ihrem Produktionsserver erstellen, sollten diese jedoch zuerst auf dem Staging-Server testen und als Vorschau ansehen.
3. Wählen Sie im Portal-Menü in der oberen linken Ecke Configuration (Konfiguration) aus.
4. Wählen Sie eine Instanz.
5. 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.

6. Finden Sie unter Implementierung mit Hilfe der Filterfunktion die von Ihnen benötigte Implementierung.
7. Wählen Sie neben der Implementierung, die Sie konfigurieren möchten, die Option Edit (Bearbeiten).
   Hinweis: Sie können keine benutzerdefinierten Produktattribute in einzelnen Implementierungzonen aktivieren. Wenn Sie sie nicht in der Implementierungszone der Hauptseite aktiviert haben, werden sie in der Workbench nicht angezeigt.
8. Wählen Sie im Menü auf der linken Seite unter Technische Einrichtung die Option Erste Schritte aus.
9. Wählen Sie den Tab Produktkatalog aus.

10. Geben Sie im Abschnitt Feed-Attribute einen Attributnamen in das Feld Benutzerdefinierte Produktattribute ein und wählen Sie dann Hinzufügen aus. Der Attributname muss mit dem id-Attribut des Elements <Attribute> im Produkt-Feed übereinstimmen. Wiederholen Sie diesen Schritt für jedes Attribut, das Sie hinzufügen möchten.

    Dieses Beispiel zeigt Attribute, die mit den IDs im vorigen XML-Beispiel übereinstimmen:

    

Sie können diese benutzerdefinierten Produktattribute nutzen, um nach Inhalten in Analystenberichten, Dashboards und anderen Anzeigen von Workbench zu filtern.

Hinweis: Sie können Daten nicht auf der Basis von benutzerdefinierten Produktattributen im Bereich „Berichte“ von Workbench filtern. Nur Legacy-Dashboards ermöglichen Ihnen die Anzeige von Produktattributdaten.

Sie können die Ansicht Inhalte > Inhalte verwalten: Beurteilungen & Bewertungen zum Beispiel filtern, indem Sie Produktattribute aus der Dropdown-Liste Produkt auswählen. Sie können einen oder mehrere Attributnamen festlegen und es werden nur Inhalte auf der Seite Inhalte verwalten: Bewertungen & Beurteilungen angezeigt, die diese Attribute enthalten, wie im folgenden Beispiel dargestellt.

Bewertungen mithilfe von Produktfamilien teilen

Die Funktion „Produktfamilien“ in Ratings & Reviews ermöglicht es Ihnen, verbrauchergenerierte Inhalte mit mehreren verwandten Produkten zu teilen. Indem Sie Produkte in Familien gruppieren, können Sie verbrauchergenerierte Inhalte, die zu einem Familienmitglied verfasst wurden, auf den Produktdetailseiten aller Familienmitglieder anzeigen. Das Teilen von Bewertungen zwischen Produktfamilie-Mitgliedern steigert die folgenden Key Performance Indikatoren Ihrer Bazaarvoice-Implementierung:

• Prozentsatz der Produkte, für die Bewertungen angezeigt werden
• Anzahl der Produkte, für die Bewertungen angezeigt werden
• Durchschnittliche Bewertungen für jedes Produkt
• Anzahl der insgesamt angezeigten Bewertungen

Arten von Produktfamilien

Welche Art von Produktfamilie Sie verwenden sollten, hängt davon ab, inwiefern sich Produkte voneinander unterscheiden:

• Produktvarianten – Produkte, die in Bezug auf das Benutzererlebnis nahezu identisch mit anderen Produkten sind, jedoch unterschiedliche SKUs oder Teilenummern aufweisen. Produkte, die zum Beispiel in mehreren Farben und Größen erhältlich oder je nach Verkaufsgewicht/-menge unterschiedlich verpackt sind, können in einem Variantenverhältnis zueinander stehen. Inhalte aus Produktvarianten werden normalerweise in allen Richtungen geteilt. Alle Produkte einer Familie zeigen die Inhalte an, die über die anderen Familienmitglieder geschrieben wurden.

  Das Erstellen einer Produktfamilie aus Produktvarianten funktioniert am besten, wenn jede Produktvariante über ihre jeweils eigene Produktdetailseite verfügt. Wenn alle Produktvarianten dieselbe Seite auf Ihrer Webseite teilen, kann es einfacher und praktischer sein, die Varianten bei der Integration mit Bazaarvoice als ein Produkt zu behandeln, als für diese Produkte eine Produktfamilie zu erstellen.

• Produkt-Bundles – Gruppen von Produkten, die normalerweise einzeln, hier jedoch zusammen verkauft werden. Inhalte über Produkt-Bundles werden in der Regel nur in eine Richtung geteilt: von den einzelnen Komponenten zum Produkt-Bundle. Die Produktdetailseite eines Bundle zeigt normalerweise alle Bewertungen an, die über die einzelnen Komponenten verfasst wurden. Die Produktdetailseite der einzelnen Komponenten zeigt jedoch nur Bewertungen der jeweiligen Komponente an.

Produktfamilien konfigurieren

Sie können Produktreihen entweder in Ihrem DCC JavaScript auf Produktdetailseiten, Ihrem Produkt-Feed oder über die Workbench konfigurieren. Mit all diesen Methoden können Sie ein Produkt gleichzeitig einer oder mehreren Familien zuordnen.

Berücksichtigen Sie bei der Konfiguration von Produktfamilien bitte Folgendes:

• Konfigurierte Produktfamilien werden von der Staging- nicht in die Produktionsumgebung übertragen.
• Anpassungen, die Sie in Workbench an Produktfamilien vornehmen, können nur über Workbench wieder rückgängig gemacht werden.
• Familiendefinitionen im Produkt-Feed überschreiben keine Eingriffe an Produktfamilien in der Workbench.

Hinweis: Syndizierung ignoriert Produktfamilienbeziehungen. Wenn Sie eine Syndizierung planen oder implementiert haben, wenden Sie sich an Bazaarvoice-Support, bevor Sie Produktfamilien in Ihrem Produkt-Feed konfigurieren.

DCC verwenden

Für die Angabe von Produktreihendaten mittels DCC gibt es zwei Ansätze:

• Einfacher Ansatz – Für den häufigsten Fall, in dem ein bestimmtes Produkt Mitglied einer einzigen Reihe ist, mit gemeinsamen Bewertungen.
• Komplexer Ansatz – Gilt für alle anderen Reihenszenarien, einschließlich Produkten in mehreren Produktreihen.

Einfacher Produktreihenansatz

In das DCC JavaScript Ihrer Produktdetailseite können Sie das Attribut family aufnehmen. Der Wert von family sollte die ID der Produktreihe sein, zu der Sie ein bestimmtes Produkt hinzufügen möchten. Angabe des Attributs family zieht Folgendes nach sich:

• Das Produkt wird zu der Reihe mit der angegebenen ID hinzugefügt.
• Das Attribut expand wird auf Wahr gesetzt. Dies legt fest, dass ein Produkt alle Inhalte der anderen Reihenmitglieder anzeigt.
• Wenn das Produkt bereits in anderen Reihen existiert, wird das Produkt aus diesen Reihen entfernt.

Beispiel für die Angabe eines einzigen families-Attributs:

... catalogProducts: [{ "productId":"MH02", ... "family": "123", ... }] }; ...

Komplexer Produktreihenansatz

Um ein bestimmtes Produkt zu mehreren Familien hinzuzufügen oder explizit jede Familiendefinition zu steuern, beziehen Sie das families-Array mit ein. Es enthält zusätzliche Attribute (id, expand, members).

Beispiel für die Bereitstellung eines families-Attributs:

catalogProducts: [{ "productId":"MH02", ... "families": [{ "id": "123", "expand": true, "members": ["MH02","MH01","MH03"] }], ... }]

Den Produkt-Feed verwenden

Wir empfehlen Ihnen, Produktfamilien über den Produkt-Feed zu erstellen, wenn Sie eine klare Vorstellung davon haben, welche Produkte in Familien gruppiert werden können. Eine Automatisierung dieser Beziehungen über den Produkt-Feed ist unkomplizierter und schneller, als diese über die Workbench herzustellen.

Sie können Produktfamilien in Ihrem Produkt-Feed konfigurieren, indem Sie eines oder beide der folgenden Attribute miteinbeziehen:

• BV_FE_FAMILY – Fügt ein Produkt zu einer bestimmten Familie hinzu.
• BV_FE_EXPAND – Legt fest, dass ein Produkt alle Inhalte der anderen Familienmitglieder anzeigt.

Tipp: Wir empfehlen Ihnen, keine Sonderzeichen, wie zum Beispiel Kommas, in Produktfamiliennamen zu verwenden.

In diesem XML-Beispiel zeigen alle Produkte einer Familie die Inhalte aller anderen Familienmitglieder an:

<Product>
     <ExternalId>...</ExternalId>
     <Name>Green iPod Nano</Name>
     <Description>...</Description>
     <BrandExternalId>...</BrandExternalId>
     <CategoryExternalId>...</CategoryExternalId>
     <ProductPageUrl>...</ProductPageUrl>
     <ImageUrl>...</ImageUrl>
     <Attributes>
          <Attribute id="BV_FE_FAMILY">
               <Value>iPod_Nanos</Value>
          </Attribute>
          <Attribute id="BV_FE_EXPAND">
               <Value>BV_FE_FAMILY:iPod_Nanos</Value>
          </Attribute>
     </Attributes>
</Product>
<Product>					
     <ExternalId>...</ExternalId>
     <Name>Pink iPod Nano</Name>
     <Description>...</Description>
     <BrandExternalId>...</BrandExternalId>
     <CategoryExternalId>...</CategoryExternalId>
     <ProductPageUrl>...</ProductPageUrl>
     <ImageUrl>...</ImageUrl>
     <Attributes>
	   <Attribute id="BV_FE_FAMILY">
		<Value>iPod_Nanos</Value>
		</Attribute>
		<Attribute id="BV_FE_EXPAND">
		     <Value>BV_FE_FAMILY:iPod_Nanos</Value>
	   </Attribute>
     </Attributes>
</Product>

Im folgenden XML-Beispiel enthält das Produkt-Bundle den Parameter BV_FE_EXPAND, sodass alle Bewertungen der Familienkomponenten auf der Bundle-Seite angezeigt werden. BV_FE_EXPAND wurde jedoch aus den Produkt-<Attribute>-Definitionen der einzelnen Komponenten ausgelassen, damit Bewertungen des Bundles nicht auf den Produktdetailseiten der Komponenten angezeigt werden.

<Product> <ExternalId>...</ExternalId> <Name>Value Bundle</Name> <Description>...</Description> <BrandExternalId>...</BrandExternalId> <CategoryExternalId>...</CategoryExternalId> <ProductPageUrl>...</ProductPageUrl> <ImageUrl>...</ImageUrl>  <Attributes> <Attribute id="BV_FE_FAMILY"> <Value>Value_Bundle</Value> </Attribute> <!-- Including BV_FE_EXPAND displays content from all components on the bundle page --> <Attribute id="BV_FE_EXPAND"> <Value>BV_FE_FAMILY:Value_Bundle</Value> </Attribute> </Attributes> </Product> <Product> <ExternalId>...</ExternalId> <Name>Standalone Component</Name> <Description>...</Description> <BrandExternalId>...</BrandExternalId><CategoryExternalId>...</CategoryExternalId> <ProductPageUrl>...</ProductPageUrl> <ImageUrl>...</ImageUrl> <Attributes> <Attribute id="BV_FE_FAMILY"> <Value>Value_Bundle</Value> </Attribute> </Attributes> <!-- Omitting BV_FE_EXPAND prevents content from the bundle from being displayed on the component page --> </Product>

Workbench benutzen

Nutzen Sie die Workbench auf manuelle Weise, um in den folgenden Situationen Familien zu erstellen:

• Sie sind nicht mit XML vertraut.
• Sie können nicht mit dem Produkt-Feed arbeiten.
• Sie müssen eine Familie erstellen, deren benutzergenerierte Inhalte Beziehungen teilen, die nicht geradlinig sind oder nicht über den Produkt-Feed konfiguriert werden können.

  Die folgenden beiden Beispiele beschreiben Szenarien, in denen eine Produktfamilie mithilfe der Workbench erstellt werden sollte:

  • Ein Kategorie-Manager für MP3-Player möchte, dass Bewertungen für alle Farben und sowohl für die 32 MB- als auch für die 64 MB-Version angezeigt werden. Separate Familien für das 32 MB- und das 64 MB-Gerät einzurichten, lässt sich über den Feed leicht erledigen. Da die beiden Geräte jedoch unterschiedliche SKUs aufweisen, können sie möglicherweise nicht zusammen über den Feed in eine Familie integriert werden. Deshalb sollte der Kategorie-Manager die Familie in Workbench konfigurieren.
  • Ein Brand Manager für Körperpflegeprodukte möchte während der Sommermonate Lippenbalsam und Sonnenschutzmittel als Aktionsbundle anbieten. Er möchte eine Produktfamilie konfigurieren, die sowohl das Lippenbalsam als auch das Sonnenschutzmittel enthält, sodass die Bewertungen der einzelnen Familienmitglieder auch auf der Produktdetailseite des Bundles angezeigt werden. Die beiden Einzelprodukte verfügen jedoch über kein gemeinsames Produkt-Feedelement, das sie verbindet. Der Brand Manager sollte die Produktfamilie in diesem Fall über die Workbench konfigurieren. Am Ende der Sommersaison, wenn der Brand Manager die Produkte nicht mehr gemeinsam verkaufen will, kann er das Produktfamilien-Bundle in der Workbench löschen.

Befolgen Sie diese Schritte, um Produktfamilien über die Workbench zu konfigurieren:

1. Melden Sie sich in der Workbench an und navigieren Sie zu Inhalt > Familien verwalten.
2. Wählen Sie Neue Familie hinzufügen aus, und geben Sie einen Namen für die Produktfamilie ein.
3. Geben Sie die Produkt-ID wie in Ihrem XML-Produkt-Feed aufgeführt für jedes Produkt ein, das Sie der Familie hinzufügen möchten und wählen Sie Produkt hinzufügen aus.
4. Deaktivieren Sie Erweitern, wenn Sie nicht möchten, dass für das entsprechende Produkt Inhalte von Familienmitgliedern angezeigt werden.
5. Wählen Sie x, um zur Seite Familien verwalten zurückzukehren.

Aktive Produktsätze steuern

Bazaarvoice vergibt einen Status für jede Marke, jede Kategorie und jedes Produkt, die in einer Feed-Datei bereitgestellt wurden. Eine Marke, eine Kategorie oder ein Produkt mit dem Status aktiv steht für den Kauf und die Bewertung zur Verfügung. Eine Marke, eine Kategorie oder ein Produkt mit dem Status inaktiv wird als veraltet, nicht mehr produziert und nicht mehr für den Kauf verfügbar betrachtet.

Inaktive Marken, Kategorien und Produkte werden aus folgenden Bereichen ausgeschlossen:

• Syndizierung, wenn Sie Produkte manuell abgleichen
• „Ratings-only“-Feeds (nur für Bewertungen)
• SEO
• Connections-Portal

Inaktive Marken, Kategorien und Produkte werden weiterhin in den folgenden Bereichen eingeschlossen:

• Anzeige
• Syndizierung, wenn Produkte automatisch abgeglichen werden
• Submission (Einsendung)
• Standard-Kunden-Feed

Schließlich können Sie Workbench Inhalte und Berichte auf der Grundlage des Status filtern und Inhalte mit der Funktion API abrufen.

Aktive Produktsätze mit Feeds steuern

Wenn Sie Produkt-Feed-Dateien hochladen, verarbeitet Bazaarvoice die Feeds unterschiedlich, je nachdem, ob es sich um vollständige oder inkrementelle Feeds handelt:

Vollständige Feeds

Inkrementelle Feeds

Produkte, Kategorien und Marken, die im vollständigen Feed eingeschlossen sind, werden zur Bazaarvoice-Datenbank hinzugefügt Der Status der eingeschlossenen Produkte, Kategorien und Marken wird auf „aktiv“ gesetzt (es sein denn, das Attribut removed="true" wird gesetzt). Der Status der Produkte, Kategorien und Marken, die sich bereits in der Bazaarvoice-Datenbank aber nicht im vollständigen Feed befinden, wird auf „inaktiv“ gesetzt.

Neu hinzugefügte und aktualisierte Produkte, Kategorien und Marken im inkrementellen Feed werden zur Bazaarvoice-Datenbank hinzugefügt. Der Status der eingeschlossenen Produkte, Kategorien und Marken wird auf „aktiv“ gesetzt (es sein denn, das Attribut removed="true" wird gesetzt). Wenn Sie das Attribut removed="true" nicht angeben können, kann Bazaarvoice eine Funktion aktivieren, die anhand der Aktualität der Katalogdaten, die inkrementell übermittelt werden, schlussfolgert, welche Produkte den Status „aktiv“ haben. Kontaktieren Sie Bazaarvoice, um weitere Informationen zu dieser Funktion zu erhalten. Der Status von Produkten, Kategorien und Marken, die sich bereits in der Bazaarvoice-Datenbank aber nicht im inkrementellen Feed befinden, ändert sich nicht (der aktive Status wird nicht aktualisiert).

Kategorienhierarchie eines Produkts definieren

Wenn Sie eine XML-Feed-Datei erstellen, können Sie die Kategorienhierarchie eines Produkts angeben. Sie können jedes Produkt einer bestimmten Kategorie innerhalb der Hierarchie zuweisen, indem Sie das Element <CategoryExternalId> verwenden. Außerdem können Sie das übergeordnete Element einer Kategorie definieren und dadurch die Kategorienhierarchie definieren, indem Sie das Element <ParentExternalId> verwenden.

Achten Sie auf die folgenden Punkte, wenn Sie mehrere Feeds für Ihre Katalogdaten bereitstellen:

• Ein Produkt, das in mehreren Feeds vorhanden ist, muss in allen Feeds derselben Kategorie angehören. Deshalb gilt: Wenn Produkt A in Feed A der Kategorie X angehört, kann das Produkt A in Feed B nicht der Kategorie Y angehören.
• Eine Kategorie, die in mehreren Feeds vorhanden ist, muss in allen Feeds derselben übergeordneten Kategorie angehören. Deshalb gilt: Wenn Kategorie A in Feed A der übergeordneten Kategorie X angehört, kann Kategorie A in Feed B nicht der übergeordneten Kategorie Y angehören.

Der folgende Auszug aus einer XML-Datei definierte eine <CategoryExternalId> für eine Kategorie, die dann als Referenz für ein <ParentExternalId>-Element gilt.

<Categories> <Category> <ExternalId>food-1123</ExternalId> <Name>Food</Name> <= no parent category; this is a top-level hierarchy element ... </Category> <Category> <ExternalId>fruit-1789</ExternalId> <Name>Fruit</Name> <ParentExternalId>food-1123</ParentExternalId> <= "Fruit" category is a child of category “Food” ... </Category> </Categories> <Products> <Product> <ExternalId>123</ExternalId> <Name>Apple</Name> <CategoryExternalId>fruit-1789</CategoryExternalId> <= belongs to category “Fruit” ... </Product> ... </Products>

Mehrere Katalogquellen verwenden

Bazaarvoice kann Produktkatalogdaten aus mehreren Quellen verarbeiten. Deshalb müssen Kunden, die ihre Daten in separaten Systemen speichern, nicht alle Produktkatalogdaten zu einer einzigen Quelle (wie z. B. einer einzigen Feed-Datei) zusammenführen, bevor sie diese einzige Quelle Bazaarvoice bereitstellen.

Hinweis: Da es so viele mögliche Szenarien für die Bereitstellung von Daten aus mehreren Quellen gibt, ist es wichtig, dass Sie sich bezüglich Ihrer speziellen Bedürfnisse an Bazaarvoice wenden. Es sollte berücksichtigt werden, wie die Daten bereitgestellt werden und ein Mitarbeiter von Bazaarvoice muss diese Funktion aktivieren, um sicherzustellen ist, dass Daten aus mehreren Quellen ordnungsgemäß zusammengeführt werden. Kontaktieren Sie deshalb bitte den Bazaarvoice-Support, bevor Sie versuchen, Produktkatalogdaten mithilfe von mehreren Dateien bereitzustellen.

Beispielszenarien

Betrachten Sie die folgenden Beispielszenarien:

• Primärer XML-Feed plus ergänzender Feed für fehlende Datenelemente
  

  Alle Produktkatalogdaten werden in einem System gespeichert, zum Beispiel in einem Webshop-System, aber die für die Syndizierung benötigten Datenlemente (wie UPC- und EAN-Codes, ISBN, Marke, Herstellerartikelnummer) sind in einem separaten Auftragsverwaltungssystem oder Produktinformationsmanagementsystem (PIM) hinterlegt. Sie können einen XML-Feed verwenden, um Bazaarvoice die Katalogdaten zur Verfügung zu stellen. Mithilfe einer einfachen, ergänzenden XML- oder Text-Datei können Sie die die Daten, die im XML-Feed fehlen, für Bazaarvoice zur Verfügung stellen.

  Diese Methode eignet sich, um alle Datenelemente bereitzustellen, die im Haupt-XML-Feed fehlen. Bazaarvoice empfiehlt, dass Sie alle Daten für ein bestimmtes Datenelement entweder im Haupt-XML-Feed oder im ergänzenden Feed angeben, anstelle die Daten für ein bestimmtes Element in beiden Feed-Dateien bereitzustellen.

• Produkte und Kategorien umfassen mehrere Feeds
  

  Der vollständige Produktkatalog wird über separate Systeme bereitgestellt. Wenn ein Kunde beispielsweise Obst und Autos verkauft, dann stammen die Produktkatalogdaten für das Obst aus einem anderen System als die Produktkatalogdaten für Automobilprodukte. Anstatt nun einen einzigen vereinheitlichten Produkt-Feed zu generieren, ist es leichter, einen Feed für alle aktuellen Obstprodukte und einen anderen Feed für alle aktuellen Automobilprodukte bereitzustellen.

• Lokalisierte Produktkatalog-Feeds
  Wenn Sie Bazaarvoice für mehrere Regionen implementieren, können Sie die Produktkatalogdaten für jede Region in einer separaten Feed-Datei speichern.

Mehrere Feed-Dateien hochladen

Wenn Sie mehrere Quellen verwenden, um Katalogdaten für Bazaarvoice bereitzustellen, müssen Sie die Dateien aus jeder Katalogquelle regelmäßig immer wieder hochladen, um sicherzustellen, dass die Katalogdaten in der Bazaarvoice-Datenbank aktuell und vollständig sind. Feed-Dateien aus verschiedenen Quellen müssen hingegen nicht nach demselben Zeit- oder Upload-Plan bereitgestellt werden. Zum Beispiel kann der Haupt-XML-Feed täglich bereitgestellt werden, während die ergänzenden Text-Datei auf wöchentlicher Basis bereitgestellt wird.

Obwohl sich diese Strategie durchaus eignet, um einmalig einen ergänzenden Feed bereitzustellen und auf diese Weise Probleme aufgrund unvollständiger Katalogdaten zu lösen, sollten Sie einen automatisierten Prozess in Erwägung ziehen, um die ergänzenden Daten regelmäßig auf wiederkehrender Basis bereitzustellen. So können Sie gewährleisten, dass Ihre Katalogdaten auch in Zukunft vollständig sind.

Hinweis: Es wird empfohlen, dass Sie mindestens alle 30 Tage eine Feed-Datei hochladen.

Beispiele

Primärer XML-Feed plus ergänzender Feed, welche Inhalte für die Syndizierung enthalten.

In diesem Szenario bezieht ein Kunde alle Produktkatalogdaten aus einem Webshop-System in einer XML-Feed-Datei ein und stellt die Marken-, EAN und UPC-Daten, sowie die Herstellerartikelnummern in Form einer Text-Feed-Datei zur Verfügung. Der primäre XML-Feed enthält hierbei keine Marken-, EAN und UPC-Daten, oder die Herstellerartikelnummern.

Hier ist die XML-Datei. Beachten Sie, dass es sich bei dieser Datei um einen „vollständigen“ Feed handelt (incremental=”false” im <Feed>-Header). Alle Produkte im Feed sollten innerhalb von Bazaarvoice als „aktiv“ betrachtet werden, nachdem sie eingesetzt werden.

<?xml version="1.0" encoding="utf-8"?>
<Feed name="Apples_n_Bananas" extractDate="2015-10-13T13:56:25" incremental="false" xmlns="http://www.bazaarvoice.com/xs/PRR/ProductFeed/15.1">
 <Categories>
 <Category>...</Category>
 </Categories> <Products> <Product> <ExternalId>123</ExternalId> <Name>Apple</Name> ... </Product> <Product> <ExternalId>456</ExternalId> <Name>Banana</Name> ... </Product> <Product> <ExternalId>789</ExternalId> <Name>Orange</Name> ... </Product> </Products> </Feed>

Hier ist der ergänzende CSV-Feed, der die Marken-, EAN und UPC-Werte, sowie die Herstellerartikelnummern enthält. Beachten Sie, dass die Datei auch den ExternalId-Wert eines jeden Produkts enthält, der von Bazaarvoice verwendet wird, um die ergänzenden Daten mit den Produktkatalogdaten aus dem Haupt-XML-Feed zusammenzufügen.

ExternalId,Brand,UPC,EAN,ManufacturerPartNumber 123,Brand-123,123000000001,12300001,APL123 456,Brand-456,456000000001,45600001,BAN456 BAN-456-2 789,Brand-789,789000000001,78900001,ORG789 ORG-789-2 ORG789-YA-GLAD

Wenn sie ein ergänzendes CSV Feed erstellen, verwenden Sie für jedes Datenelement die folgenden Überschriften in ihrer CSV-Datei. Die Syndizierungszuordnung wird verbessert, wenn Sie mehrere Werte festlegen.

Spalte	Wert
Marke	Name der Marke, wie er auch Endnutzern angezeigt wird.
EAN	Europäische Artikelnummern (EANs), die weltweit für die Kennzeichnung von Handelswaren verwendet werden. Geben Sie für jede EAN, die Sie definieren möchten, ein untergeordnetes <EAN>-Element an. Jede EAN muss ein acht- oder dreizehnstelliger Zahlenwert sein (Buchstaben oder andere Zeichen sind nicht erlaubt). Entfernen Sie Leerzeichen oder Bindestriche, da diese die Syndizierungszuordnung stören. Das TXT Feed Format bietet keine Längen- oder numerische Beschränkungen für EANs. Das Produkt-Schema stuft jeden String in diesem Feld als gültig ein. Die Werte werden während des Katalog-Import-Vorgangs validiert, es werden jedoch nur gültige Werte gespeichert. Die Spalte kann einen einzelnen Wert oder mehrere, durch Leerzeichen getrennte, Werte enthalten (z.B. "EAN1 EAN2 EAN3").
UPC	Universeller Produktcode (UPC), bei dem es sich um einen 6- oder 12-stelligen Barcode handelt, der für die Standard-Handelsverpackungen in den Vereinigten Staaten verwendet wird. Geben Sie für jeden UPC, den Sie definieren möchten, ein untergeordnetes <UPC>-Element an. Der UPC darf ausschließlich Ziffern aufweisen, keine Buchstaben oder andere Zeichen. Entfernen Sie Leerzeichen oder Bindestriche, da diese die Syndizierungszuordnung stören. Das TXT Feed Format bietet keine Längen- oder numerische Beschränkungen für UPCs. Das Produkt-Schema stuft jeden String in diesem Feld als gültig ein. Die Werte werden während des Katalog-Import-Vorgangs validiert, es werden jedoch nur gültige Werte gespeichert. Die Spalte kann einen einzelnen Wert oder mehrere, durch Leerzeichen getrennte, Werte enthalten (z.B. "UPCVALUE1 UPCVALUE2 UPCVALUE3").
ManufacturerPartNumber	Herstellerspezifische Teilenummer. Teilenummern können Buchstaben, Ziffern und Zeichen enthalten. Die Spalte kann einen einzelnen Wert oder mehrere, durch Leerzeichen getrennte, Werte enthalten (z.B. "MPN1 MPN2 MPN3").

Alternativ kann eine XML-Feed-Datei dazu verwendet werden, ergänzende Daten zur Verfügung zu stellen. Beachten Sie die Verwendung von incremental="true" supplemental="true" in der <Feed>-Überschrift.

<?xml version="1.0" encoding="utf-8"?>
<Feed name="Apples_n_Bananas" extractDate="2015-10-13T13:56:25" incremental="true" supplemental="true" xmlns="http://www.bazaarvoice.com/xs/PRR/ProductFeed/15.1"> <Products> <Product> <ExternalId>123</ExternalId> <!-- Product details needed for syndication --> <Brand> <Name>Brand 123</Name> </Brand> <UPCs> <UPC>123000000001</UPC> </UPCs> <EANs> <EAN>12300001</EAN> </EANs> <ManufacturerPartNumbers> <ManufacturerPartNumber>APL123</ManufacturerPartNumber> </ManufacturerPartNumbers> </Product> <Product> <ExternalId>456</ExternalId> <Brand> <Name>Brand 456</Name> </Brand> <UPCs> <UPC>456000000001</UPC> <UPC>456000000002</UPC> </UPCs> <EANs> <EAN>45600001</EAN> <EAN>45600002</EAN> </EANs> <ManufacturerPartNumbers> <ManufacturerPartNumber>BAN456</ManufacturerPartNumber> <ManufacturerPartNumber>BAN-456-2</ManufacturerPartNumber> </ManufacturerPartNumbers> </Product> <Product> <ExternalId>789</ExternalId> <Brand> <Name>Brand 789</Name> </Brand> <UPCs> <UPC>789000000001</UPC> <UPC>789000000002</UPC> <UPC>789000000003</UPC> </UPCs> <EANs> <EAN>78900001</EAN> <EAN>78900002</EAN> <EAN>78900003</EAN> </EANs> <ManufacturerPartNumbers> <ManufacturerPartNumber>ORG789</ManufacturerPartNumber> <ManufacturerPartNumber>ORG-789-2</ManufacturerPartNumber> <ManufacturerPartNumber>ORG789-YA-GLAD</ManufacturerPartNumber> </ManufacturerPartNumbers> </Product> </Products> </Feed>

Produkte und Kategorien umfassen mehrere Feeds

In diesem Szenario stellt ein Kunde zwei separate Feeds bereit:

• Einen XML-Feed mit Produkt-, Marken- und Kategoriedaten für Obstprodukte
• Einen XML-Feed mit Produkt-, Marken- und Kategoriedaten für Automobilprodukte

Im Folgenden sehen Sie ein Beispiel für den XML-Feed für Obstprodukte. Achten Sie auf das Attribut incremental="true" im <Feed>-Header.

<?xml version="1.0" encoding="utf-8"?>
<Feed name="Apples_n_Bananas" extractDate="2015-10-13T13:56:25" incremental="true" xmlns="http://www.bazaarvoice.com/xs/PRR/ProductFeed/15.1">
 <Categories>
 <Category>...</Category>
 </Categories> <Products> <Product> <ExternalId>123</ExternalId> <Name>Apple</Name> ... </Product> <Product> <ExternalId>456</ExternalId> <Name>Banana</Name> ... </Product> <Product> <ExternalId>789</ExternalId> <Name>Orange</Name> ... </Product> </Products> </Feed>

Dies ist der XML-Feed für Automobilprodukte. Achten Sie auch hier wieder auf das Attribut incremental="true" im <Feed>-Header.

<?xml version="1.0" encoding="utf-8"?>
<Feed name="Apples_n_Bananas" extractDate="2015-10-13T13:56:25" incremental="true" xmlns="http://www.bazaarvoice.com/xs/PRR/ProductFeed/15.1">
 <Categories>
 <Category>...</Category>
 </Categories> <Products> <Product> <ExternalId>9876547</ExternalId> <Name>Ferrari</Name> ... </Product> <Product> <ExternalId>7736208</ExternalId> <Name>Aston Martin</Name> ... </Product> <Product> <ExternalId>789632528</ExternalId> <Name>BMW</Name> ... </Product> </Products> </Feed>

Lokalisierte Produktkatalog-Feeds

In diesem Szenario möchte ein Kunde Bazaarvoice für zwei Sprachvarianten implementieren: en_CA und fr_CA. Der Kunde speichert seinen Produktkatalog für die Sprachvariante en_CA in einem anderen System als die Produktkatalogdaten für die Sprachvariante fr_CA. Damit der Kunde ein einziges Bazaarvoice-Konto verwenden kann, hat er die Möglichkeit, einen Feed mit den en_CA-Daten und einen anderen Feed mit den fr_CA-Daten bereitzustellen.

Das folgende Beispiel zeigt den Produktkatalog-Feed, der nur die lokalisierten Katalogdaten für die Sprachvariante en_CA enthält. Achten Sie auf das Attribut incremental="false" im <Feed>-Header.

<?xml version="1.0" encoding="utf-8"?>
<Feed name="Apples_n_Bananas" extractDate="2015-10-13T13:56:25" incremental="false" xmlns="http://www.bazaarvoice.com/xs/PRR/ProductFeed/15.1">
 <Categories>
 <Category>...</Category>
 </Categories> <Products> <Product> <ExternalId>123</ExternalId> <Name>Apple</Name> <Names> <Name locale="en_CA">Apple EN</Name> </Names> <ProductPageUrls> <ProductPageUrl locale=”en_CA”>http://www.example.com/en_CA/apple.htm</ProductPageUrl> </ProductPageUrls> ... </Product> <Product> <ExternalId>456</ExternalId> <Name>Banana</Name> <Names> <Name locale="en_CA">Banana EN</Name> </Names> <ProductPageUrls> <ProductPageUrl locale=”en_CA”>http://www.example.com/en_CA/banana.htm</ProductPageUrl> </ProductPageUrls> ... </Product> </Products> </Feed>

Das folgende Beispiel zeigt den Produktkatalog-Feed, der nur die lokalisierten Katalogdaten für die Sprachvariante fr_CA enthält. Achten Sie auf das Attribut incremental="false" im <Feed>-Header.

<?xml version="1.0" encoding="utf-8"?>
<Feed name="Apples_n_Bananas" extractDate="2015-10-13T13:56:25" incremental="false" xmlns="http://www.bazaarvoice.com/xs/PRR/ProductFeed/15.1">
 <Categories>
 <Category>...</Category>
 </Categories> <Products> <Product> <ExternalId>123</ExternalId> <Name>Apple</Name> <Names> <Name locale="fr_CA">Apple FR</Name> </Names> <ProductPageUrls> <ProductPageUrl locale=”fr_CA”>http://www.example.com/fr_CA/apple.htm</ProductPageUrl> </ProductPageUrls> ... </Product> <Product> <ExternalId>456</ExternalId> <Name>Banana</Name> <Names> <Name locale="fr_CA">Banana FR</Name> </Names> <ProductPageUrls> <ProductPageUrl locale=”fr_CA”>http://www.example.com/fr_CA/banana.htm</ProductPageUrl> </ProductPageUrls> ... </Product> </Products> </Feed>

Ältere DCC

Hinweis: DCC wurde kürzlich auf Signierte DCC-Ereignisse aktualisiert. So ist kein Rückruf mehr erforderlich und das Risiko fehlgeschlagener Produktaktualisierungen im Katalog wird verringert wird. Weitere Informationen zur Implementierung finden Sie im Abschnitt Signierte DCC-Ereignisse.

Schritt 1: BV-Lader hinzufügen

Der BV-Lader ist eine kleine, asynchrone JavaScript-Anwendung zur Verwaltung und Anzeige von konfigurierten Funktionen sowie benutzergenerierten Inhalten auf Ihren Webseiten. Der BV-Lader lädt nur die erforderlichen Anwendungen, die auf einer bestimmten Seite notwendig sind.

Um den BV-Lader zu integrieren, fügen Sie folgenden Code zu Ihrem HTML-Code im <head>-Tag jeder Produktdetailseite hinzu:

<!-- load BV loader --> <script async src="https://apps.bazaarvoice.com/deployments/<client_name>/<site_ID>/<environment>/<locale>/bv.js"></script>

Dabei gilt Folgendes:

• async – asynchroner Download des BV-Laders. Dieses Attribut ist optional, wird jedoch empfohlen.
• src – gibt den Pfad zum BV-Lader an. Ersetzen Sie folgende Elemente Ihres HTML-Codes:
  • <client_name> – der von Bazaarvoice bereitgestellte Namen des Kunden. Der Wert muss in Kleinschreibung angegeben werden.
  • <site_ID> – Die ID der Implementierungszone, die Sie verwenden möchten. Dies wird in der Konfiguration des Bazaarvoice-Portals festgelegt. Die Standardimplementierungszone ist „main_site“. Vergewissern Sie sich bei Ihrem Bazaarvoice-Ansprechpartner, dass die ID korrekt ist oder wählen rechts neben der Hauptseite auf der Konfigurationsseite im Bazaarvoice-Portal aus.
  • <environment> – die Umgebung, in der Sie Bazaarvoice-Funktionen implementieren wollen. Für eine Produktionsumgebung fügen Sie den Begriff production in den Pfad ein. Falls Sie auf eine Staging-Umgebung verweisen, fügen Sie den Begriff staging in den Pfad ein.
  • <locale> – die von der Implementierung verwendete Sprachregion (zum Beispiel de_DE für Deutsch).

Dies ist eine Beispiel-URL des Kunden Endurance Cycle für die Staging-Umgebung der Implementierungszone Main Site:

https://apps.bazaarvoice.com/deployments/endurancecycles/main_site/staging/en_US/bv.js

Dies ist eine Beispiel-URL des Kunden Endurance Cycle für die Produktions-Umgebung der Implementierung. Der Name der Implementierungszone (SiteID) lautet „Mobile“:

https://apps.bazaarvoice.com/deployments/endurancecycles/Mobile/production/en_US/bv.js

Wichtig: Wenn Sie den BV-Lader bereits bei der Implementierung einer Bazaarvoice-gehosteten Anzeige oder BV Pixel hinzugefügt haben, fügen Sie ihn nicht erneut zu. Fügen Sie den BV-Lader pro Seite nur einmal hinzu.

Schritt 2: DCC zu Produktdetailseiten hinzufügen

Um Kataloginformationen von Ihren Produktdetailseiten zu sammeln, fügen Sie das folgende JavaScript unmittelbar vor dem schließenden </body>-Tag zu jedem Ihrer PDPs hinzu.

Tipp: Um sicherzustellen, dass Ihr JavaScript gültig ist, „escape“ alle String-Werte, um Sonderzeichen in Feldern wie Produktname zu vermeiden.

JavaScript-Beispiel für eine Produktdetailseite mit einem Produkt

<script async type="text/javascript"> window.bvDCC = { catalogData: { locale: "en_US", catalogProducts: [{ "productId":"MH02", "productName":"Teton Pullover Hoodie", "productDescription":"The Teton Hoodie Description", "productImageURL":"https:\\mywebsite.com\pub\media\catalog\product\mh02-black_main.jpg", "productPageURL":"https:\\mywebsite.com\teton-pullover-hoodie.html", "brandName":"MyBrand", "categoryPath" : [ { "id" : "123", "Name" : "Parent Category Name" }, { "id" : "123-1", "Name" : "Mens" }, { "id" : "123-1-9", "Name" : "Pants" }], "upcs":["724742001735","724742006907","077320775406","077320775307"], "manufacturerPartNumbers":["mpn1","mpn2","mpn3","mpn4","mpn5"], "eans":["0724742001735","0724742006907","0077320775406","0077320775307"], "isbns":["9781891830754","9781603090506","9781891830716","9781603090254"], "modelNumbers":["model1","model2","model3","model4"], "family": "F02", "inactive": false, "price": "12.99", "currencyCode": "USD", "color": "red", "size": "large", "material": "nylon", "availability": true }] } }; window.bvCallback = function (BV) { BV.pixel.trackEvent("CatalogUpdate", { type: 'Product', locale: window.bvDCC.catalogData.locale, catalogProducts: window.bvDCC.catalogData.catalogProducts }); }; </script>

JavaScript-Beispiel für eine Produktdetailseite mit mehreren Produkten

Wenn Sie eine Produktseite haben, die auf mehrere Produkte verweist (oft Varianten in Größe, Farbe usw.), fügen Sie JavaScript ähnlich wie im folgenden Beispiel hinzu. Der Bazaarvoice-Katalog benötigt IDs für jedes dieser Unterprodukte.

<script async type="text/javascript"> window.bvDCC = { catalogData: { locale: "en_US", catalogProducts: [{ "productId":"MH02", "productName":"Red Teton Pullover Hoodie", ... }, { "productId":"MH03", "productName":"Blue Teton Pullover Hoodie", ... }, { "productId":"MH04", "productName":"Green Teton Pullover Hoodie", ... }] } }; window.bvCallback = function (BV) { // Use a loop for multiple products const len = window.bvDCC.catalogData.catalogProducts.length; for (var i = 0; i < len; i++) { BV.pixel.trackEvent("CatalogUpdate", { type: "Product", locale: window.bvDCC.catalogData.locale, catalogProducts: [window.bvDCC.catalogData.catalogProducts[i]], }); } }; </script>

JavaScript-Beispiel für eine Produktdetailseite für Produkte mit benutzerdefinierten Attributen

Falls Sie Produkte mit Attributen führen, die nicht in unserer Standard-Kollektion der DCC-Datenattribute enthalten sind, können Sie diese dennoch wie im folgenden Beispiel als benutzerdefinierte Attribute zu Ihrem JavaScript hinzufügen.

<script async type="text/javascript"> window.bvDCC = { catalogData: { locale: "en_US", catalogProducts: [{ "productId":"MH02", "productName":"Red Teton Pullover Hoodie", "productDescription":"The Teton Hoodie Description", "productImageURL":"https:\\mywebsite.com\pub\media\catalog\product\mh02-black_main.jpg", "productPageURL":"https:\\mywebsite.com\teton-pullover-hoodie.html", "brandName":"MyBrand", "categoryPath" : [ { "id" : "123", "Name" : "Parent Category Name" }, { "id" : "123-1", "Name" : "Mens" }, { "id" : "123-1-9", "Name" : "Pants" }], "customAttributes": [ { "id": "CustomAttributeId123", "value": "Custom attribute value 1" }, { "id": "CustomAttributeId456", "value": "Custom attribute value 2", }], "upcs":["724742001735","724742006907","077320775406","077320775307"], "manufacturerPartNumbers":["mpn1","mpn2","mpn3","mpn4","mpn5"], "eans":["0724742001735","0724742006907","0077320775406","0077320775307"], "isbns":["9781891830754","9781603090506","9781891830716","9781603090254"], "modelNumbers":["model1","model2","model3","model4"], // "family": "F02", "families": [{ "id": "123", "expand": true, "members": ["MH02", "MH01", "MH03"] }], "inactive": false, "price": "12.99", "currencyCode": "USD", "color": "red", "size": "large", "material": "nylon", "availability": true }] } }; window.bvCallback = function (BV) { BV.pixel.trackEvent("CatalogUpdate", { type: 'Product', locale: window.bvDCC.catalogData.locale, catalogProducts: [ window.bvDCC.catalogData ] }); } </script>

DCC-Datenattribute

Die folgenden Tabellen beschreiben die in DCC-JavaScript verwendeten Attribute.

Attribut	Wert	Erforderlich
productId	Eindeutige Produkt-ID, die nur alphanumerische Zeichen, Bindestriche (-) und Unterstriche (_) aufweist. Wenn die externe Produkt-ID ein ungültiges Zeichen enthält, ersetzen Sie dieses durch ein alternatives Zeichen wie z. B. einen Unterstrich. Bei der ID gibt es keine Unterscheidung von Groß- und Kleinschreibung. Bitte beachten Sie, dass Sie daher keine übereinstimmenden IDs nutzen können. Dieses Format gilt nur für den Daten-Feed und ist für Endnutzer nicht sichtbar. Typ: String	Ja
locale	Gibt den gewünschten Standort an. Wenn dieses Attribut nicht angegeben wird, wird der Standort in der BV-Lader-Referenz verwendet. Typ: String	Ja
productName	Name des Produkts, wie er auch Endnutzern angezeigt wird. Typ: String	Ja
productDescription	Die Beschreibung des Produkts. Wir empfehlen Produktbeschreibungen von mindestens drei Sätzen oder 300 Zeichen. Typ: String	Nein
productPageURL	Eindeutige, fehlerfreie URL einer Produktseite. Fügen Sie keine sachfremden Abfrageparameter ein, die Sie möglicherweise für Tracking- und Partnerschaftscodes verwenden. Beachten Sie bei der Angabe einer URL Folgendes: Sollte die URL ein reserviertes Zeichen (Sonderzeichen) enthalten, müssen Sie das Zeichen URL-kodieren . Verwenden Sie zum Beispiel &amp für ein Und-Zeichen, %20 für ein Leerzeichen oder %5B und %5D für eckige Klammern ([ ]). Typ: URL	Ja
productImageURL	Eindeutige URL des Produktbilds. Das optimale, leicht flexible Anzeigenformat beträgt 600 x 600 Pixel. Beachten Sie bei der Angabe einer URL Folgendes: Sollte die URL ein reserviertes Zeichen (Sonderzeichen) enthalten, müssen Sie das Zeichen URL-kodieren . Verwenden Sie zum Beispiel &amp für ein Und-Zeichen, %20 für ein Leerzeichen oder %5B und %5D für eckige Klammern ([ ]). Hinweis: Wenn Ratings & Reviews auf einer HTTPS-Website bereitgestellt wird, müssen Sie Bild-URLs an einem HTTPS-Ort in Ihrem Produktkatalog bereitstellen. Wenn Sie das nicht tun, erhalten die Kunden eine Warnung wegen gemischter Inhalte. Typ: URL	Ja
Farbe	Farbe des Produkts.	Nein; empfohlen
Size	Größe des Produkts.	Nein; empfohlen
Material	Material des Produkts. Zum Beispiel Stahl, Kunststoff, Seide usw.	Nein; empfohlen
Währung	Währung des Produkts an jedem Standort. Hinweis: Die Währung muss im Format ISO 4217N angegeben werden.	Nein; empfohlen
Price	Preis des Produkts.	Nein; empfohlen
Verfügbarkeit	Gibt an, ob ein Produkt zum Kauf verfügbar ist oder nicht. Es kann ausverkauft oder außerhalb der Saison sein.	Nein; empfohlen
brandId	Eindeutige Marken-ID, die nur alphanumerische Zeichen, Bindestriche (-) und Unterstriche (_) aufweist. Wenn eine Marken-ID ein ungültiges Zeichen enthält, ersetzen Sie dieses durch ein alternatives Zeichen wie z. B. einen Unterstrich. Dieses Format gilt nur für den Daten-Feed und hat keinen Einfluss auf die Endnutzer. Bei der ID gibt es keine Unterscheidung von Groß- und Kleinschreibung. Bitte beachten Sie, dass Sie daher keine übereinstimmenden IDs nutzen können. Stellen Sie sicher, dass die ID stabil ist und sich nicht innerhalb der Marke ändert, auch wenn sich der Name der Marke ändern sollte. Im Abschnitt Marken finden sie Informationen zur Sammlung von Markendaten mit DCC. Typ: String	Nein
brandName	Der Name der Marke, zu der das Produkt gehört. Im Abschnitt Marken finden Sie Informationen zur Sammlung von Markendaten mit DCC. Typ: String	Nein
categoryPath	Eine hierarchisch geordnete Liste aller Kategorien. Im Abschnitt Kategorien finden sie Informationen zur Sammlung von Kategoriedaten mit DCC.	Nein
family	Der Name der Produktfamilie, zu der das Produkt gehört. Wir empfehlen Ihnen, in Namen von Produktfamilien keine Sonderzeichen zu verwenden. In diesem Abschnitt erfahren Sie mehr darüber, wie Sie Produktfamilien mit DCC konfigurieren.	Nein
upcs	Universeller Produktcode (UPC), bei dem es sich um einen 6- oder 12-stelligen Barcode handelt, der für die Standard-Handelsverpackungen in den Vereinigten Staaten verwendet wird. Fügen Sie in einem Array jeden UPC hinzu, den Sie definieren möchten. Der UPC darf ausschließlich Ziffern aufweisen, keine Buchstaben oder andere Zeichen. Entfernen Sie Leerzeichen oder Bindestriche, da diese die Syndizierungszuordnung stören. Hinweis: Bazaarvoice kennt keinerlei zahlen- oder längenmäßige Beschränkungen für UPCs, EANs und ISBNs. Das Produkt-Schema stuft jeden String in einem dieser Felder als gültig ein. Die Werte in den Feldern UPC, EAN und ISBN werden allerdings während des Katalog-Import-Prozesses validiert und es werden nur gültige Werte gespeichert. Typ: Array	Nein, die Syndizierungszuordnung wird verbessert, wenn Sie universelle Produktcodes (UPCs) festlegen.
manufacturerPartNumbers	Herstellerspezifische Teilenummer. Teilenummern können Buchstaben, Ziffern und Zeichen enthalten. Typ: Array	Nein
eans	Europäische Artikelnummern (EANs), die weltweit für die Kennzeichnung von Handelswaren verwendet werden. Jede EAN muss ein acht- oder dreizehnstelliger Zahlenwert sein (Buchstaben oder andere Zeichen sind nicht erlaubt). Entfernen Sie Leerzeichen oder Bindestriche, da diese die Syndizierungszuordnung stören. Hinweis: Bazaarvoice kennt keinerlei zahlen- oder längenmäßige Beschränkungen für EANs. Die Werte werden während des Katalog-Import-Vorgangs validiert, es werden jedoch nur gültige Werte gespeichert. Typ: Array	Nein, die Syndizierungszuordnung wird verbessert, wenn Sie europäische Artikelnummern (EANs) festlegen.
isbns	ISBN: 10- oder 13-stelliger Wert, der hauptsächlich für Medienprodukte wie Bücher, Musik und Videos verwendet wird. Die letzte Ziffer ist eine Kontrollziffer, mit der die Produktkennung validiert werden kann. Die meisten ISBNs bestehen ausschließlich aus Ziffern, manche 10-stelligen ISBN-Werte nutzen als Kontrollziffer jedoch ein X. Typ: Array	Nein
modelNumbers	Eindeutiger Referenz-Code, mit dem Unternehmen ein branchenspezifisches Teil identifizieren. Jede Modellnummer kann Buchstaben, Ziffern und andere Zeichen enthalten. Typ: Array	Nein
inaktiv	Signalisiert, dass das Produkt inaktiv ist. Der Standardwert ist falsch. Im Abschnitt Kontrolle der aktiven Produktreihe finden Sie weitere Informationen. Art: boolescher Wert	Nein
customAttributeId	Ermöglicht es Ihnen, zusätzliche produktspezifische Informationen für die Berichterstattung zu definieren. Legen Sie eine ID und den Wert für jedes Produktattribut an, das Sie festlegen möchten. Verwenden Sie keine Leerzeichen in der Attribut-ID. Typ: Array	Nein. Wenn enthalten, können Sie eine unbegrenzte Anzahl an untergeordneten Elementen angeben.

Marken

Ein Produkt kann nur einer Markenentität in Ihrem Produktkatalog zugeordnet werden. Eine Markenentität hat eine einzelne eindeutige Marken-ID mit lokalisiertem Markenname-Werten (falls in Ihren Katalogdaten angegeben). Es gibt zwei weitere Wege, um Markendaten über DCC anzugeben, je nach Anzahl der in Ihrer Implementierung spezifizierten Standorte.

Implementierung mit einem Standort

Wenn ihre Implementierung nur einen Standort verwendet, ist nur brandName erforderlich. Bazaarvoice wird aus dem angegebenen Markennamen automatisch brandId-Werte generieren.

Hinweis: Sie können Ihre eigenen brandId-Werte angeben, wenn Sie diese bereits definiert haben und möchten, dass Bazaarvoice Sie stattdessen in Ihrem Produktkatalog verwendet.

Implementierung mit mehreren Standorten

Wenn Ihre Implementierung mehrere Standorte verwendet, hängt die Art und Weise, wie Sie Markendaten angeben, davon ab, ob sich die Werte von brandName je nach Standort unterscheiden.

Wenn Ihre brandName-Werte von Standort zu Standort variieren, müssen Sie einen konsistenten brandId-Wert und einen lokalisierten brandName-Wert für jede Marke in allen Standorten weitergeben. Wenn Sie in diesen Szenarien keine brandId-Werte angeben, generiert Bazaarvoice die Marken-ID automatisch anhand der lokalisierten Felder brandName. Dadurch entsteht Verwirrung im Bazaarvoice-Katalogsystem, welche Marke dem gegebenen Produkt zugeordnet werden soll.

Code-Beispiele

Beispiel für die Angabe von brandName:

... catalogProducts: [{ ... "brandName":"MyBrand", ... }] }; ...

Beispiel für die Angabe von brandId and brandName:

... catalogProducts: [{ ... "brandId":"789", "brandName":"MyBrand", ... }] }; ...

Kategorien

Ein Produkt kann nur einer übergeordneten Kategorie-Entität in Ihrem Produktkatalog zugeordnet werden. Eine Kategorieentität hat eine einzelne eindeutige id mit lokalisiertenName-Werten (falls in Ihren Katalogdaten angegeben). Es gibt zwei weitere Wege, um Kategoriedaten über DCC anzugeben, je nach Anzahl der in Ihrer Implementierung spezifizierten Standorte.

Implementierung mit einem Standort

Wenn ihre Implementierung nur einen Standort verwendet, ist nur Name erforderlich. Bazaarvoice wird aus dem angegebenen Kategorienamen automatisch id-Werte generieren.

Hinweis: Sie können Ihre eigenen id-Werte angeben, wenn Sie diese bereits definiert haben und möchten, dass Bazaarvoice Sie stattdessen in Ihrem Produktkatalog verwendet.

Implementierung mit mehreren Standorten

Wenn Ihre Implementierung mehrere Standorte verwendet, hängt die Art und Weise, wie Sie Kategoriedaten angeben, davon ab, ob sich die Werte von Name je nach Standort unterscheiden.

Wenn Ihre Name-Werte von Standort zu Standort variieren, müssen Sie einen konsistenten id-Wert und einen lokalisierten brandName-Wert für jede Kategorie in allen Standorten weitergeben. Wenn Sie in diesen Szenarien keine id-Werte angeben, generiert Bazaarvoice die Kategorie-ID automatisch anhand der lokalisierten Felder Name. Dadurch entsteht Verwirrung im Bazaarvoice-Katalogsystem, welche Kategorie dem gegebenen Produkt zugeordnet werden soll.

Code-Beispiele

Beispiele für Angabe der Werte Kategorie id und Kategorie Name:

... "categoryPath" : [ { "id" : "123", "Name" : "Parent Category Name" // Parent }, { "id" : "123-1", // Child1 "Name" : "Mens" }, { "id" : "123-1-9", // Child2 "Name" : "Pants" } ] }, ...

Beispiele für Angabe der Werte Kategorie Name:

... "categoryPath" : [ { "Name" : "Parent Category Name" // Parent }, { "Name" : "Mens" // Child1 }, { "Name" : "Pants" // Child2 } ] }, ...

Schritt 3: Ausführung des DCC Accelerator anfordern

Um zu verhindern, dass Bazaarvoice darauf wartet, dass jede Produktdetailseite einmal aufgerufen wird, um Katalogdaten für alle Ihre Produkte zu sammeln, hat Bazaarvoice den DCC Accelerator entwickelt. Der DCC Accelerator ist ein einmaliges Tool, das während der Implementierung verwendet wird, um Ihre Webseite zu „betreten“ (verschiedene Seiten zu durchlaufen) und dabei jede Produktdetailseite zu besuchen. Jede Seiten-„Ansicht“ löst eine DCC für diese Seite aus. Nachdem der „Betreten“-Prozess abgeschlossen ist, sollte Bazaarvoice Produktkatalogdaten für alle Produkte (mit Produktdetailseiten) auf Ihrer Webseite haben.

Hinweis: Wenn Sie das Hinzufügen von DCC-JavaScript zu Ihren Produktdetailseiten beendet haben, wenden Sie sich an den Bazaarvoice-Support, um den DCC Accelerator auszuführen.

Kombinieren von DCC mit Produktkatalog-Feeds

DCC kann mit Produktkatalog-Feeds kombiniert werden. Dieser hybride Ansatz ist nützlich, wenn nicht alle erforderlichen Katalogdaten im DCC JavaScript verfügbar sind. Typischerweise würden Ihren JavaScript-Daten GTINs (UPC, EAN und ISBN) fehlen. Sie können diese fehlenden Daten mit einfachen CSV-Dateien zur Verfügung stellen. Weitere Informationen zur Verwendung mehrerer Quellen zur Bereitstellung von Katalogdaten für Bazaarvoice finden Sie unter Mehrere Katalog-Quellen verwenden.

Aktiver und inaktiver Status

DCC kann sich auf einen oder beide der folgenden Mechanismen zur Steuerung verlassen, wenn ein Produkt, eine Marke oder eine Kategorie aktiv oder inaktiv ist:

• Datenelement Inaktiv im JavaScript der Produktdetailseite.
• Von Bazaarvoice gesteuerte Inaktivität-Fähigkeit. Weitere Einzelheiten finden Sie unter Kontrolle der aktiven Produktreihe .

Wir empfehlen Ihnen die Verwendung der gesteuerten Inaktivitätsfähigkeit. Verwenden Sie das Datenelement inactive, wenn Sie möchten, dass der aktive/inaktive Status eines Produkts mit dem Status von etwas anderem als der Existenz der Produktdetailseite des Produkts verknüpft wird. Dies kann beispielsweise nützlich sein, wenn Sie möchten, dass der aktive/inaktive Status eines Produkts mit dem Status „auf Lager/nicht auf Lager“ verbunden wird.