Dynamische Katalogerfassung

Dynamic Catalog Collection (DCC) ermöglicht Bazaarvoice Produktkatalogdaten zu sammeln und zu verwenden. Wenn Käufer eine Produktdetailseite besuchen, werden Katalogdaten an Bazaarvoice zur Verwendung mit JavaScript weitergeleitet. DCC unterstützt das Sammeln sowohl neuer Produktkatalogdaten als auch Aktualisierungen von zuvor bereitgestellter Katalogdaten.

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.length; 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-Standort in Ihrem Produktkatalogbereitstellen. Wenn Sie das nicht tun, erhalten die Kunden einen Warnhinweis 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.

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.

Das folgende Video illustriert die Verwendung von benutzerdefinierten Produktattributen.

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.

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 Produktfamilien entweder in Ihrem DCC JavaScript auf Produktdetailseiten, Ihrem Produkt-Feed oder über die Workbench konfigurieren. Mit diesen Methoden können Sie ein Produkt gleichzeitig einer oder mehreren Familien zuweisen.

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: Produktfamilien funktionieren nur für native Bewertungen. Syndizierung ignoriert Produktfamilienbeziehungen. Wenn Sie eine Syndizierung planen oder implementiert haben, wenden Sie sich an den 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.

Ä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

        add-code-to-product-display-pages">Bazaarvoice-gehostete Anzeige</a> oder <a href="bvpixel.html#steps-to-implement-bv-pixel">BV Pixel</a>, fügen Sie es nicht erneut hinzu. Fügen Sie den BV-Lader nur einmal auf jeder Seite hinzu.</div> <a id="add-dcc-javascript"></a>

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) { // Verwenden Sie eine Schleife für mehrere Produkte für(var i=0; len=window.bvDCC.catalogData.catalogProducts.length; 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-Standort in Ihrem Produktkatalogbereitstellen. Wenn Sie das nicht tun, erhalten die Kunden einen Warnhinweis 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 lokalisierten 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.

        <b>Codebeispiele< /b>< p> Beispiel für die Bereitstellung von nur < code> brandName</code>:</ p>< pre class ="prettyprint" xml:space="preserve">... catalogProducts: [{... "brandName":"MyBrand",...}}]};... </pre>< p> Beispiel für die Bereitstellung von <code>< brandID</code> und< code> brandName</ code>:< /p>< pre class="prettyprint" xml:space="preserve">... catalogProducts: [{... "brandID":"789","brandName":" myBrand",...}]};... </pre>

Kategorien

Ein Produkt kann nur einer übergeordneten Kategorie-Entität in Ihrem Produktkatalog zugeordnet werden. Eine Kategorie-Entität hat eine einzelne eindeutige Kategorie-id mit lokalisierten Kategorie-Name-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.