BV Pixel

• Was ist BV Pixel?
• Voraussetzungen
• Implementierung von BV-Pixel (bv.js)
  • Fügen Sie den BV-Lader hinzu
  • Transaktion-Event hinzufügen (E-Commerce-Webseiten)
  • Fügen Sie den Conversion-Event hinzu (Nicht-Commerce-Webseiten)
  • Fügen Sie Parameter für personenbezogene Daten (PII) hinzu
  • PII-Beispielcode (Transaktions- und Conversion-Events)
• Testen Sie Ihre BV Pixel-Implementierung
• Probleme mit Transaktion-Events beheben
• Häufige Fragen

Hinweis: Dieser Artikel gilt für den optimierten BV Pixel Loader (bv.js). Wenn Sie die ältere BV Pixel-Scout-Datei (bvapi.js) implementiert haben, sehen Sie sich die BV Pixel-Dokumentation (Ältere) an.

Was ist BV Pixel?

BV Pixel funktioniert ähnlich wie Analytics-Tracking-Services wie Google Analytics, sammelt jedoch umfassendere und tiefere Einblicke in benutzergenerierte Inhalte (UGC), damit Sie den Wert Ihres UGC-Programms besser verstehen können.

In diesem Video erfahren Sie mehr über BV Pixel.

 

Nach der Implementierung von BV Pixel:

Wertvolle Einblicke generieren	Der Tracking-Code erfasst wichtige Transaktionsinformationen zu Produktkäufen, wie Bestellungen und Bestellsummen.
Kennzahlen zu Kundenengagement sammeln	Sammeln Sie wertvolle Daten über Verbraucherinteraktionen, beispielsweise wie Verbraucher Ihre Produktbewertungen anklicken, anzeigen, sortieren oder filtern.
Dashboard-Berichte ausführen	Erstellen Sie Return-on-Investment-Berichte (ROI)-Berichte. Zum Beispiel der Conversion Impact-Bericht E-Commerce.
Bewertungen sammeln	Verbraucherinformationen (wie E-Mail-Adresse und Produkt-ID), die auf einer Bestätigungsseite erfasst wurden, können verwendet werden, um Produktbewertungen anzufordern und Ihr UGC-Volumen zu erhöhen.

Von BV Pixel erfasste Verbraucherereignisse

Ereignis	Beschreibung
Produktkäufe (Transaktion-Event-Tags)	Fügen Sie das BV Pixel-Transaktion-Event-Tag auf Ihrer Seite Bestellbestätigung hinzu, um diese Daten zu erfassen.
Datei-Downloads (Conversion-Event-Tags)	Beispiele hierfür sind: Handbücher, Gutscheine, Software oder Rückerstattungs-Ansprüche. Fügen Sie den BV-Pixel-Konversionsrate-Tag-Code auf den betreffenden Seiten hinzu, um diese Daten zu erfassen.
Registrierungen (Conversion-Event-Tags)	Beispiele: Newsletter-Abonnements oder Produktgarantieregistrierungen. Fügen Sie den BV-Pixel-Konversionsrate-Tag-Code auf Ihrer Danke-Seite hinzu.
Seitenaufrufe (automatisch erfasst)	Wird jedes Mal ausgelöst, wenn eine Seite mit Bazaarvoice-Inhalten geladen wird.
Impressionen und Funktion-Ereignisse (automatisch erfasst)	Wird ausgelöst, wenn ein Verbraucher Bazaarvoice-Inhalte auf einer Webseite mindestens fünf Sekunden lang bewertet oder wenn ein Verbraucher Bazaarvoice-Inhalte bewertet, filtert, sortiert oder durchblättert.

Voraussetzungen

Sie müssen BV Pixel auf einer genehmigten Whitelist-Domain implementieren. Bazaarvoice verwaltet Domainnamen intern.

• If you’re at the Bazaarvoice implementation stage, contact your Bazaarvoice implementation team to request allowlist (sometimes called a “whitelist”) updates.
• Wenn Sie die Implementierung abgeschlossen haben, wenden Sie sich an den Bazaarvoice-Support, um Änderungen anzufordern.

Hinweis: Wenn Sie ein API-Client sind, folgen Sie den Anweisungen in unserer API-Dokumentation zur Implementierung von BV Pixel. Wenn Sie ein nativer App-Client sind, folgen Sie unseren Implementierungsanweisungen für Mobile SDK.

Implementierung von BV Pixel (bv.js)

BV Pixel verwendet die Loader-Datei <bv.js>, eine kleine, asynchrone JavaScript-Anwendung, die Ereignisse auf Ihrer Website verfolgt. Nachdem Sie die Loader-Datei <bv.js> zu einer Seite hinzugefügt haben, wird der Ereignis-Tracking-Code automatisch ausgelöst und erfasst Seitenaufrufe, Impressionen und Funktion-Ereignisse.

BV Pixel meldet Bazaarvoice, wenn ein Verbraucher auf Ihrer Webseite konvertiert. Es gibt zwei Arten von BV Pixel-Tags:

• Transaktion-Events– Transaktions-Tags sammeln Kaufdaten von Ihrer Bestellbestätigungsseite.
• Conversion-Event– Conversion-Event-Tags werden durch Gutschein-Downloads, Newsletter-Registrierungen oder Produktgarantieregistrierungen ausgelöst.

Transaktionsereignis für E-Commerce-Webseiten

1. Fügen Sie den BV-Lader hinzu.
2. Fügen Sie das Transaction-Event hinzu.
3. (Optional) Fügen Sie PII-Parameter hinzu, um Bewertungsanfragen zu senden (ehemals Anschluss-E-Mail oder AE).
4. Testen Sie Ihre Implementierung.

Conversion-Event für Nicht-E-Commerce-Webseiten

1. Fügen Sie den BV-Lader hinzu.
2. Fügen Sie das Conversion-Event hinzu.
3. (Optional) Fügen Sie PII-Parameter hinzu, um Informationen über den Verbraucher zu sammeln.
4. Testen Sie Ihre Implementierung.

Fügen Sie den BV-Lader hinzu

Der BV-Loader <bv.js> lädt die JavaScript-Bibliothek von Bazaarvoice. Diese Bibliothek enthält Ereignis-Tracking-Code, der die Verbraucheraktivitäten auf Ihrer Webseite erfasst.

Fügen Sie den BV-Loader Code zur Überschrift Ihrer Seite hinzu:

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

Erforderliche Parameter werden in der folgenden Tabelle beschrieben.

Parameter	Beschreibung
client_name	Der von Bazaarvoice bereitgestellte Name des Kunden. Verwenden Sie Kleinbuchstaben.
site_ID	ID der Implementierungszone, die Sie verwenden möchten. Dies ist in der Bazaarvoice-Konfiguration eingerichtet. Die Standard-Implementierungszone ist 'main_site'. Um sicherzustellen, dass Sie die korrekt ID haben, wählen Sie auf der Seite rechts von der Implementierungszone der Konfiguration Webseiten- Manager aus.
environment	Implementierungsumgebung, in der Sie BV Pixel implementieren möchten. 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 Staging in den Pfad ein.
locale	Standort, der von Ihrer BV Pixel-Implementierung verwendet wird. Wenn Sie nicht US-Englisch (en_US) verwenden, stellen Sie sicher, dass Sie den korrekten Standort-Code verwenden.

Beispiel-URL: Hauptseite-Implementierungszone der Staging-Umgebung von Endurance Cycle https://apps.bazaarvoice.com/deployments/endurancecycles/main_site/staging/en_US/bv.js

Beispiel-URL: Implementierung der Produktionsumgebung von Endurance Cycle https://apps.bazaarvoice.com/deployments/endurancecycles/mobile/production/en_US/bv.js

Wichtig: Möglicherweise haben Sie den BV-Loader hinzugefügt, während Sie von Bazaarvoice-gehostete Anzeige oder DCC implementiert haben. Fügen Sie ihn nicht erneut hinzu. Er muss nur einmal hinzugefügt werden.

Das Transaktion-Event hinzufügen (E-Commerce-Webseiten)

Das Transaktionsereignis-Tag erfasst Kaufdaten und speist den Conversion Impact-Bericht E-Commerce ein. Wir empfehlen Ihnen, dieses Event-Tag einer Seite Danke oder Zahlungsbestätigung hinzuzufügen.

Fügen Sie das Transaktionsereignis und die erforderlichen Parameter unter dem BV-Loader-Code hinzu, wie das folgende Codebeispiel zeigt.

<!-- load bv.js --> <script async src="https://apps.bazaarvoice.com/deployments/<client_name>/<site_ID>/<environment>/<locale>/bv.js"></script> <!--load Transaction event and parameters--> <script> window.bvCallback = function (BV) { BV.pixel.trackTransaction({ "currency" : "value", "orderId" : "value", "total" : "value", "items" : [ { "price" : "value", "quantity" : "value", "productId" : "value", "optional_item_parameter" : "value" }, ... ], "optional_order_parameter" : "value", ... "optional_PII_parameter" : "value", ... }); }; </script>

Hinweis: Parameternamen müssen wie unten gezeigt angegeben werden. Groß- und Kleinschreibung wird berücksichtigt.

Pflichtparameter für eine Bestellung

Hinweis: Kein Währungsparameter erforderlich. Umsatz aus Währungen, die nicht USD sind, wird jede Nacht in USD umgerechnet wobei der Schlusskurs des jeweiligen Tages herangezogen wird. Wenn kein Währungswert im Transaktion-Event angegeben ist, wird die Währung standardmäßig auf USD gesetzt und es erfolgt keine Währungsumrechnung.

Parameter	Beschreibung	Beispielwert
orderId	Die von einer Webseite generierte eindeutige ID einer Bestellung. Effekt: Erforderlich, um individuelle Bestellungen voneinander zu unterscheiden. Ein wichtiger Faktor bei der Ermittlung der Investitionsrendite (ROI).	55555
total	Gesamtkosten der Produktbestellung einschließlich sämtlicher Rabatte und Gutscheine aber ausschließlich Steuern und Versandkosten. Geben Sie den Wert für total im englischen Format mit zwei Dezimalstellen ein. Verwenden Sie keine Währungssymbole wie beispielsweise $ für USD. Verwenden Sie, wenn der Gesamtbetrag über 1000 liegt, kein Komma wie , als Tausendertrennzeichen. Effekt: Beeinflusst den Umsatz im CIR. Ein wichtiger Faktor bei der Ermittlung der Investitionsrendite (ROI).	1178.07
items	Eine Reihe einzelner Artikel in der Transaktion. In den folgenden Abschnitten finden Sie die erforderlichen und optionalen Array-Parameter.

Pflichtparameter für einen Artikel

Die folgenden Artikelparameter sind wichtige Faktoren bei der Ermittlung der Investitionsrendite (ROI).

Parameter	Beschreibung	Beispiel
price	Einzelpreis des Artikels, nicht price (Preis) X quantity (Anzahl). Geben Sie den Wert für price im englischen Format mit zwei Dezimalstellen ein. Verwenden Sie keine Währungssymbole wie $ für USD.	12.95
quantity	Anzahl der gekauften Artikel.	3
productId	Muss mit der <ExternalId> in Ihrem Bazaarvoice-Produktkatalog übereinstimmen. Legen Sie hierfür nicht die Standard-SKU fest, außer Sie verwenden SKU, um Produkte in Ihrem Bazaarvoice-Katalog zu identifizieren.	908736

Optionale Bestell- und Artikelparameter

Hinweis: Falls Sie keinen optionalen Parameter benötigen, fügen Sie keinen zu dem Ereignis hinzu. Wenn der Parameter tax beispielsweise keine Daten enthält, fügen Sie "tax" : "" (eine leere Zeichenfolge) nicht hinzu. Verzichten Sie auf den Parameter.

Parameter	Beschreibung	Beispiel
name	Name des Artikels.	Serena Boots
category	(Empfohlen) Artikelparameter, der die Produktkategorie auf der Webseite erfasst. Folge: Ermöglicht es Ihnen, den ROI nach Kategorie zu messen.	Freizeitschuhe für Herren
shipping	(Empfohlen) Bestellparameter, der die Versandkosten der Bestellung erfasst. Geben Sie den Wert für shipping im englischen Format mit zwei Dezimalstellen ein. Verwenden Sie keine Währungssymbole wie beispielsweise $ für USD. Folge: Ermöglicht es Ihnen, zu verifizieren, dass total korrekt ist, und hilft Ihnen dabei, die tatsächlichen Kosten der gesamten Produktbestellung zu erfassen.	10.00
shippingDate	Wird anstelle des Transaktionsdatums verwendet, um zu bestimmen, wann Bazaarvoice die Bewertungsanfragen sendet. Das Datum muss dem folgenden Format entsprechen: JJJJ-MM-TT. Wenn ein Aufschub der ersten Bewertungsanfrage konfiguriert ist, wird dieser Aufschub dem hier angegebenen Datum hinzugefügt. Wenn Sie beispielsweise „shippingDate“ : "2016-12-21" angeben und der Aufschub der Bewertungsanfrage auf 10 Tage festgelegt ist, wird die Bewertungsanfrage am 31. Dezember 2016 ( 2016-12-31 ) gesendet. Sie können entweder shippingDate oder shippingDelay, aber nicht beides zusammen verwenden.	2016-12-21
tax	(Empfohlen) Bestellparameter, der die Steuern für die Bestellung erfasst. Geben Sie den Wert für tax im englischen Format mit zwei Dezimalstellen ein. Verwenden Sie keine Währungssymbole wie beispielsweise $ für USD. Folge: Ermöglicht es Ihnen, zu verifizieren, dass total korrekt ist, und hilft Ihnen dabei, die tatsächlichen Kosten der gesamten Produktbestellung zu erfassen.	11.44
discount	(Empfohlener) Rabattbetrag für die gesamte Bestellung oder für jeden Artikel. Geben Sie den Wert für Rabatt im englischen Format mit zwei Dezimalstellen an. Fügen Sie kein Währungssymbol ein, wie $ für USD. Dieser Wert muss eine negative Zahl sein. Wenden Sie diesen Parameter auf die gesamte Bestellung oder auf einzelne Artikel an, um die entsprechenden Rabatte zu erfassen. Folge: Ermöglicht es Ihnen, zu verifizieren, dass total korrekt ist, und hilft Ihnen dabei, die tatsächlichen Kosten der gesamten Produktbestellung zu erfassen.	5.00
city	Bestellparameter, der erfasst, welche Stadt der Endnutzer bei der Bestellung angibt.	Detroit
state	Bestellparameter, der das Bundesland/den Kanton erfasst, das/der von dem Endnutzer bei der Bestellung angegeben wird.	Utah
country	Bestellparameter, der erfasst, welches Land der Endnutzer bei der Bestellung angibt.	CA
deploymentZone	Wenn Sie mehrere Implementierungszonen haben, verwenden Sie diesen Bestellung-Parameter, um die ID für die Implementierungszone anzugeben, in der Ihre Implementierung bereitgestellt wird. Dieser Parameter stellt sicher, dass Bazaarvoice die E-Mail-Vorlagen der Implementierung zum Senden von Bewertungsanfragen verwendet. Bevor Sie auf die Implementierungszone im Interaktion-Feed verweisen, vergewissern Sie sich, dass die Implementierung mit den konfigurierten E-Mail-Vorlagen in dieser spezifischen Implementierungszone veröffentlicht wird. Wenn Sie diesen Parameter nicht angeben, wird die Implementierungszone verwendet, die durch Umgebung im Pfad des BV-Loader-Pfads angegeben ist.	secondary_site

Hinweis: Wenn Sie BV Pixel zum Senden von Bewertungsanfragen eingerichtet haben, müssen Sie personenbezogene Daten (PII)-Parameter zu einem Transaktionsereignis auf Ihrer Produktkaufseite hinzufügen.

Fügen Sie das Conversion-Event hinzu (Nicht-Commerce-Webseiten)

Das Conversion-Event erfasst nicht transaktionsbezogene Kundeninteraktionen (oder Verhalten) auf Seiten, die Links zu Wo kaufen oder AddToCart anzeigen.

• Conversion-Events akzeptieren drei übergeordnete Parameter, um die Art der Konversionsrate zu beschreiben, die stattfindet.

• Das Conversion-Event speist den Conversion Impact-Bericht Nicht-Commerce-Bereich.

Hinweis: Die vom Conversion-Event erfassten Daten können nicht zum Senden von Bewertungsanfragen verwendet werden. Um Bewertungsanfragen zu senden, verwenden Sie das Transaktion-Event.

Fügen Sie das Conversion-Event und seine Parameter der Seite unter dem BV-Loader hinzu, wie im Beispielcode gezeigt.

<!-- load BV loader --> <script async type="text/javascript" src="https://apps.bazaarvoice.com/deployments/<client_name>/<site_ID>/<environment>/<locale>/bv.js"></script> <!--load Conversion event and parameters--> <script> window.bvCallback = function (BV) { BV.pixel.trackConversion({ "type" : "value", "label" : "value", "value" : "value" }); }; </script>

Hinweis: Parameternamen müssen wie unten gezeigt angegeben werden. Groß- und Kleinschreibung wird berücksichtigt.

Pflichtparameter

Das Conversion-Event hat nur einen erforderlichen Parameter – Typ. Er wird verwendet, um:

• Die Art der Konversionsrate zu beschreiben, die stattfindet. Zum Beispiel ein Verbraucher, der sich für einen Gutschein registriert, Testsoftware herunterlädt oder sich für einen Newsletter registriert.
• Ordnen Sie jedes Ziel direkt zu, das im Nicht-E-Commerce-CIR gemessen wird.

Hinweis: Bazaarvoice kann jeden Wert für den Parameter Typ unterstützen, aber wir empfehlen die Werte in der folgenden Tabelle für bestimmte Typen von Konversionsraten.

Parameter	Art	Beschreibung	Permutationen
Art	StoreLocator	Wird verwendet, um einen Shop zu finden oder herauszufinden, wo man Produkte offline kaufen kann. Verwenden Sie den Permutationswert, wenn er Ihren Bedürfnissen besser entspricht.	DealerLocator, FindStore
	WhereToBuy	Wo man Produkte online oder im Shop kaufen kann.
	BuyNow	Ermöglicht es dem Verbraucher, jetzt einen Kauf zu tätigen. Verwenden Sie den Permutationswert, wenn er Ihren Bedürfnissen besser entspricht.	BuyOnline, ClickToBuy
	Compare	Ermöglicht dem Verbraucher den Vergleich von zwei oder mehreren Produkten.
	ProductDetail	Liefert zusätzliche Produktdetails.
	AddToCart	Fügt das Produkt einem Warenkorb hinzu.
	Quote	Ermöglicht dem Verbraucher die Anforderung eines Preisangebots.

Optionale Parameter

Parameter	Beschreibung	Beispiel
Wert	Wert, welcher der Conversion zugeordnet wird. Dieser Wert wird nicht im CIR für nicht kommerzielle Conversions angezeigt.	55781
Label	Beschreibendes Label, das auf die Konversionsrate angewendet wird. Dieser Wert wird nicht Nicht-Commerce-CIR angezeigt.	ClickToBuy

Fügen Sie Parameter für personenbezogene Daten (PII) hinzu

E-Mail-Adressen und Telefonnummern gelten als personenbezogene Daten (PII), das heißt, private Inhalte, die potenziell eine bestimmte Person identifizieren könnten. Mit PII können Sie:

• Personalisierte Nachrichten senden, in denen Sie Verbraucher bitten, eine Produkt- Bewertung einzureichen.
• Antworten auf Produktfragen anfordern, wenn Sie die Funktion Frage an Produktbesitzer aktiviert haben.
• Verbrauchern Erinnerungen zu Bewertungen oder Fragen senden.

Personenbezogene Verbraucherdaten erfassen, indem Sie PII-Parameter entweder einer Transaktion oder einem Conversion-Event hinzufügen.

Hinweis: Nur Transaktionsereignisse können automatisierte Bewertungsanfragen auslösen. Wenn Sie eine nicht kommerzielle Webseite haben und Bewertungsanfragen oder andere automatisierte Nachrichten auslösen möchten, müssen Sie das Transaktionsereignis hinzufügen.

Schutz von PII

Mit BV Pixel erfasste personenbezogene Daten sind:

• niemals mit dem permanenten Bazaarvoice-Cookie verbunden
• immer über HTTPS übertragen worden
• Verschlüsselt und getrennt gespeichert von Nicht-PII-Daten
• niemals durch Bazaarvoice Analytics verarbeitet worden

Pflichtparameter

Hinweis: Alle Parameter berücksichtigen Groß- und Kleinschreibung und müssen korrekt formatiert werden. Zum Beispiel sollten Sie „userId“ nicht als „UserID“ angeben.

Parameter	Beschreibung	Beispiel
email	Die E-Mail-Adresse des Verbrauchers. Hinweis: Wenn Sie BV Pixel zur Unterstützung von Bewertungsanfrage-Nachrichten verwenden, verwenden Sie Verschlüsselung, um die Sicherheit der Kunden-E-Mail-Adressen beim Senden von Benachrichtigungen oder Anfragen zu gewährleisten. Erfahren Sie mehr über Verschlüsseln von BV Pixel PII.	benutzername@beispiel.com
locale	Der Standort, auf dessen Grundlage die zu verwendende sprachspezifische E-Mail-Vorlage ausgewählt wird. Die Liste der unterstützten Werte finden Sie unter Unterstützte Standorte und Sprachen. Dies ist ein Pflichtparameter, falls Sie individuelle Vorlagen für mehrere Standorte versenden.	fr_CA
nickname	Der Spitzname des Verbrauchers, der erfasst wurde, als der Verbraucher ein Konto erstellt. Wird verwendet, um E-Mails mit Bewertungsanfragen zu personalisieren. Dies ist ein Pflichtparameter, falls Ihre Website Spitznamen einspeist. Anderenfalls wird dieser Parameter lediglich empfohlen.	MaryO
userId	Die Benutzer-ID des Verbrauchers, die mit dem userToken (Benutzer-ID) übereinstimmen muss, das während des Bewertungseinreichung-Prozesses an Ratings & Reviews gesendet wird. Dies ist ein Pflichtparameter, wenn Sie Website-Authentifizierung verwenden. Er kann ausgelassen werden, wenn keine ID erstellt wird, beispielsweise im Fall von Gastbestellern. Hinweis: Wenn Sie Ratings & Reviews ältere (PRR) verwenden, vergewissern Sie sich, dass Ihr Arbeitsblatt zur Konfiguration der Review-Anfrage diesen Parameterwert korrekt wiedergibt.	7448dc2

Optionale Parameter

• Wenn Sie PII-Parameter in einem Transaktionsereignis hinzufügen, können Sie Parameter für die Bestellung oder den Artikel angeben.
• Wenn Sie PII-Parameter in einem Conversion-Event hinzufügen, sind nur Parameter auf Bestellebene verfügbar.

Hinweis: Bei Namen und Werten von Parametern wird die Groß- und Kleinschreibung berücksichtigt. Wenn Sie keinen optionalen Parameter benötigen, fügen Sie ihn nicht hinzu. Wenn der Parameter orderID beispielsweise keine Daten enthält, fügen Sie " orderID": "" (eine leere Zeichenkette) nicht hinzu.

Parameter	Beschreibung	Beispiel
shippingDelay	Wird verwendet, um die Zeit (in Tagen) zu verlängern, die zwischen dem Transaktionsdatum und dem Datum liegt, an dem Bazaarvoice die Bewertungsanfrage sendet. Dies kann nützlich sein, wenn Sie damit rechnen, dass sich die Abwicklung der Produkte verzögert. Dieser Aufschub wird dem ersten Aufschub der Bewertungsanfrage hinzugefügt. Wenn beispielsweise der Aufschub der Bewertungsanfrage auf 10 Tage eingestellt ist und Sie " shippingDelay": "10" angeben, wird die Bewertungsanfrage am 25. Mai gesendet, wenn das Transaktionsdatum der 5. Mai ist. Sie können entweder shippingDelay oder shippingDate, aber nicht beides zusammen verwenden.	25

Parameter	Beschreibung	Beispiel
imageURL	Die vollständige, endgültige URL zum Produktbild (kein relativer Pfad). Wird dieser Parameter ausgelassen, ruft Bazaarvoice den Wert aus unserer Datenbank ab, indem der productId‑Parameter mit der externalId des Produkts (wie in Ihrem Produkt-Feed angegeben) abgeglichen wird. Dieser Parameter ist sinnvoll, falls Sie ein bestimmtes Bild verwenden möchten. Falls Ihr Produkt-Feed beispielsweise das Bild eines weißen Hemds enthält, der Kunde jedoch ein blaues Hemd kauft, kann in der E-Mail-Nachricht das blaue Hemd angezeigt werden.	http://www.test.com/1.jpg
shippingDate	Wird anstelle des Transaktionsdatums verwendet, um zu bestimmen, wann Bazaarvoice die Bewertungsanfrage sendet. Das Datum muss dem folgenden Format entsprechen: JJJJ-MM-TT. Wenn ein Aufschub der ersten Bewertungsanfrage konfiguriert ist, wird dieser Aufschub dem hier angegebenen Datum hinzugefügt. Wenn Sie beispielsweise „shippingDate“ : "2016-12-21" angeben und der Aufschub der Bewertungsanfrage auf 10 Tage festgelegt ist, wird die Bewertungsanfrage am 31. Dezember 2016 ( 2016-12-31 ) gesendet. Sie können entweder shippingDate oder shippingDelay, aber nicht beides zusammen verwenden. Zudem gilt: Falls shippingDate als Parameter eines Elements festgelegt wird, überschreibt dieser den im Bestellungsparameter angegeben shippingDate-Wert.	2016-12-21
shippingDelay	Wird verwendet, um die Zeit (in Tagen) zu verlängern, die zwischen dem Transaktionsdatum und dem Datum liegt, an dem Bazaarvoice die Bewertungsanfrage sendet. Dies kann nützlich sein, wenn Sie mit einer verzögerten Erfüllung rechnen. Dieser Aufschub wird dem ersten Aufschub der Bewertungsanfrage hinzugefügt. Wenn beispielsweise der Aufschub der Bewertungsanfrage auf 10 Tage eingestellt ist und Sie " shippingDelay": "10" angeben, wird die Bewertungsanfrage am 25. Mai gesendet, wenn das Transaktionsdatum der 5. Mai ist. Sie können entweder shippingDelay oder shippingDate, aber nicht beides zusammen verwenden. Zudem gilt: Falls shippingDelay als Parameter eines Elements festgelegt wird, überschreibt dieser den im Bestellungsparameter angegeben shippingDelay -Wert.	25
Telefonnummer	Gibt die Telefonnummer des Kunden an. Muss ein gültiges Format aufweisen (E164 ).
Vorlieben	Gibt an, was der Kunde für das Senden von Bewertungsanfragen wählt – E-Mail oder Text.

PII-Beispielcode (Transaktion und Konversionsrate)

Stellen Sie sich vor, ein Verbraucher bestellt die folgenden Produkte von der Webseite StuffForSale.com:

Produkt 1	Produkt 2
Kategorie: Freizeitschuhe für Herren Preis: 140 $ Rabatt: 9,99 $ Menge: 1 Name: Leder-Chukka Produkt-ID (External ID): 156278	Kategorie: Wohnaccessoires Preis: 12,69 $ Menge: 3 Name: Kerze, polarweiß Produkt-ID (External ID): 908736

Szenario: Dieser Event-Code sammelt Bestell- und Artikelinformationen, zusätzlich zu personenbezogenen Daten wie E-Mail-Adresse, Spitzname und Standort des Verbrauchers.

<!-- load bv.js --> <script async type="text/javascript" src="https://apps.bazaarvoice.com/deployments/stuffforsale/main_site/staging/en_US/bv.js"></script> <!--load Transaction event and parameters--> <script> window.bvCallback = function (BV) { BV.pixel.trackTransaction({ "orderId" : "55552", "total" : "168.08", //(sum of all products' items * price with discounts applied, without the $ sign) "currency" : "USD", "tax" : "11.44", //(tax amount without the $ sign) "shipping" : "10.00", //(shipping amount without the $ sign) "items" : [ { "name" : "Leather Chukka", "price" : "140.00", //(individual price of item, not price X quantity, without the $ sign) "quantity" : "1", "productId" : "156278", //(ExternalId in product feed) "category" : "Mens Casual Boots", "discount" : "9.99" //(discount applied to this item, without the $ sign) }, { "name" : "Polar White Candle", "price" : "12.69", //(individual price of item, not price X quantity, without the $ sign) "quantity" : "3", "productId" : "908736", //(ExternalId in product feed) "category" : "Home Decor" } ], "email" : "drew@example.com", //Optional PII parameters "locale" : "en_US", "nickname" : "Drew" }); }; </script>

Szenario: Dieser Event-Code sammelt Bestell- und Artikelinformationen und die personenbezogenen Daten des Verbrauchers, beispielsweise unverschlüsselte E-Mail-Adresse, Spitzname und Standort.

<!-- load BV loader --> <script async type="text/javascript" src="https://apps.bazaarvoice.com/deployments/stuffforsale/main_site/staging/en_CA/bv.js"></script> <!--load Transaction event and parameters--> <script> window.bvCallback = function (BV) { BV.pixel.trackTransaction({ "orderId" : "69872", "total" : "64.95", //(Summe aller Elemente des Produkts * Preis, ohne das $-Zeichen) "currency" : "USD", "tax" : "5,89", //(Steuerbetrag, ohne das $-Zeichen) "shipping" : "10,00", //(Versandbetrag ohne das $-Zeichen) "discount" : "5.00", //(Rabatt für die gesamte Transaktion , ohne das $-Zeichen ) "items" : [ { "name" : "Ivory Throw", "price" : "69.95", //(Einzelpreis des Artikels, nicht Preis X Anzahl, ohne das $-Zeichen) "quantity" : "1", "productId" : "100598", //(ExternalId im Produkt-Feed) "category" : "Home Decor" }, ], "email" : "cheryllynne@example.com", "locale" : "en_CA", "nickname" : "Cheryl" }); }: </script>

Szenario: Dieser Event-Code verfolgt Verbraucher, die auf die Funktion StoreLocator auf Ihrer Webseite klicken. Der Wertparameter erfasst die Postleitzahl. Darüber hinaus identifiziert StoreLocator_ProductPage, dass die Suche nach dem Shop auf der Produktseite verwendet wurde.

<!-- load BV loader --> <script async type="text/javascript" src="https://apps.bazaarvoice.com/deployments/stuffforsale/main_site/staging/en_US/bv.js"></script> <!--load Conversion event and parameters--> <script> window.bvCallback = function (BV) { BV.pixel.trackConversion({ "type" : "StoreLocator", "label" : "StoreLocator_ProductPage", "value" : "78701" //(value attributed to conversion, the zip code) }); }; 

Szenario: Dieser Code verfolgt Verbraucher, die auf Ihrer Website auf die Download-Funktion klicken. Der Label-Parameter gibt an, dass der Verbraucher ein Benutzerhandbuch heruntergeladen hat. Der Typ-Parameter wird in Bazaarvoice-Berichten angezeigt.

<!-- load bv.js --> <script async type="text/javascript" src="https://apps.bazaarvoice.com/deployments/stuffforsale/main_site/staging/en_US/bv.js"></script> <!--load Conversion event and parameters--> <script> window.bvCallback = function (BV) { BV.pixel.trackConversion({ "type" : "Download", "label" : "OwnersManual_ProductDetails", "value" : "Product78493_OwnerManual" }); }; 

BV Pixel‑Implementierung testen

Verwenden Sie die folgenden Tools, um Ihre BV Pixel-Implementierung zu testen und zu debuggen:

• Bazaarvoice Analytics Inspector (Google Chrome-Erweiterung)
• Tool zur Überwachung von Transaktionen im Bazaarvoice-Portal

Bazaarvoice Analytics Inspektor

Mit diesem Tool können Sie die erfassten Daten auf jeder Seite, die den BV Pixel-Code enthält, anzeigen und analysieren. Sie können Fehler in Transaktionsereignisse, Conversion-Events und Produktdetailseite-Events beheben.

1. Installieren Sie die Bazaarvoice Analytics Inspector-Erweiterung auf Chrome.
2. Um zu testen, ob das Tool richtig funktioniert, laden Sie eine Beispieltransaktion oder eine Produktdetailseite (PDP).
3. Wählen Sie Bazaarvoice Analytics Inspector aus Ihrem Chrome-Erweiterungsmenü aus. Das Analytics-Inspector-Modal wird oben auf Ihrer Webseite angezeigt.
4. Interagieren mit der Beispielseite. Filtern Sie beispielsweise die Bewertungen oder klicken Sie auf Bewertung schreiben. Das Tool zeigt Ereigniswerte in Echtzeit an und hebt fehlende (erforderliche) Parameter hervor.
5. Verifizieren Sie als Nächstes, ob Ihre BV-Pixel-Lösung Daten für Ihre Webseite-Seiten erfasst.

Produktdetailseite (PDP) testen

Hinweis: Für jedes Ihrer Bazaarvoice-Produkte wird ein Funktions-Event erfasst.

1. Laden Sie Ihre PDP-Seite. Das sollte dazu führen, dass das PageView-Ereignis automatisch ausgelöst wird.
2. Wählen Sie Bazaarvoice Analytics Inspector aus Ihrem Chrome-Erweiterungsmenü aus. Das Analytics-Inspector-Modal wird oben auf Ihrer Seite angezeigt.
3. Wählen Sie unter Ereignis Anzahl > PageView die Option Details anzeigen aus, um Details darüber zu sehen, was erfasst wurde.
4. Scrollen Sie auf der Seite nach unten zu benutzergenerierte Inhalte. Ein InView-Ereignis sollte ausgelöst werden. Wählen Sie unter „Ereignisanzahl>Funktion“ die Option Details anzeigen aus, um die übergebenen Parameter und Werte anzuzeigen.
5. Sehen Sie sich UGC mindestens fünf Sekunden lang an. Ein ViewedCGC-Ereignis sollte ausgelöst werden. Wählen Sie unter Ereignisanzahl > Funktion die Option Details anzeigen aus, um Details anzuzeigen.
6. Interagieren Sie mit UGC, indem Sie beispielsweise das Symbol „Hilfreich“ auswählen. Ein FeatureUsed-Ereignis sollte ausgelöst werden.
7. Wählen Sie unter Ereignisanzahl>Funktion die Option Details anzeigen aus, um Details anzuzeigen.
8. Beheben Sie die Fehler im Zusammenhang mit Ihrer BV Pixel-Implementierung, indem Sie Ihre Transaktionsseite testen.

Im folgenden Beispiel beträgt die InView-Anzahl 2, da der Benutzer auf der Seite nach unten zu Ratings & Reviews und Questions & Answers gescrollt hat. Das ViewedUGC-Ereignis wird zweimal gezählt, weil der Benutzer die Bazaarvoice-Inhalte auf dieser Seite mindestens fünf Sekunden lang angezeigt hat. Schließlich hat der Benutzer mit den Inhalten interagiert, so dass zusätzliche Ereignisse erfasst wurden: Der Benutzer wählte Fragenaus, um eine Frage zu stellen, wählte Schreiben aus, um eine Bewertung zu verfassen, schloss das Eingabeformular Schließen und verwendete einen Filter Filter.

Transaktionsseite testen

Tip: Use a fake product or sample credit card number to place an order.

1. Laden Sie eine Bestätigungsseite.
2. Wählen Sie Bazaarvoice Analytics Inspector aus Ihrem Chrome-Erweiterungsmenü aus. Das Analytics-Inspector-Modal wird oben auf Ihrer Seite angezeigt.
3. Schließen Sie einen Kauf mit einer Beispiel-Kreditkarte ab. Das Ereignis trackTransaction sollte ausgelöst werden.
4. Wählen Sie unter Ereignisanzahl > Konversionsrate Details anzeigen aus. Der Typ ist Transaktion.
5. Verifizieren Sie, dass alle erforderlichen Bestellparameter in jeder Bestellzeile aufgeführt sind. Untersuchen Sie die übergebenen Werte.
6. Stellen Sie sicher, dass alle erforderlichen Elementparameter in der Artikelzeile aufgeführt sind. Untersuchen Sie die übergebenen Werte.
7. Beheben Sie die Fehler im Zusammenhang mit Ihrer BV-Pixel-Implementierung.

Die Seite „Konversionsrate“ testen

1. Wählen Sie Bazaarvoice Analytics Inspector aus Ihrem Chrome-Erweiterungsmenü aus. Das Analytics-Inspector-Modal wird oben auf Ihrer Seite angezeigt.
2. Testen Sie eine Seite mit einem Conversion-Event (nicht transaktionsbezogen), registrieren Sie sich beispielsweise für einen Newsletter oder laden Sie einen Gutschein herunter. Das Ereignis trackConversion sollte ausgelöst werden.
3. Wählen Sie unter Ereignisanzahl>Konversionsrate Details anzeigen aus. Der Typ ist Konversionsrate
4. Verifizieren Sie, dass alle erforderlichen Parameter für den Konversionsrate-Typ (StoreLocator, Download, Gutschein) in jeder Zeile aufgeführt sind.
5. Beheben Sie die Fehler im Zusammenhang mit Ihrer BV-Pixel-Implementierung.

Tool zur Überwachung von Transaktionen

Hinweis: Verwenden Sie dieses Tool, um nur Transaktion-Events zu testen.

Verwenden Sie es, um Probleme mit Live-Transaktionsdaten zu beheben, die von BV Pixel für Tracking- und Berichtszwecke gesammelt wurden. Prüfen Sie, ob es Probleme mit Ihrer BV-Pixel-Implementierung gibt und validieren Sie Korrekturen anhand eingehender Daten.

Die ersten Schritte:

1. Melden Sie sich im Bazaarvoice Portal an.
2. Wählen Sie das Menü oben links und anschließend Monitoring Tools (Tools zur Überwachung). Die Seite Transactions (Transaktionen) wird geöffnet.
3. Wenden Sie Filter an, um die Liste der Transaktionen auf die für Sie relevanten Transaktionen einzugrenzen.
   Hinweis: Das Tool zeigt nur Transaktionsdaten an, die in den letzten 30 Tagen erhalten wurden, einschließlich des aktuellen Datums. Wenn Sie nach Datum filtern, werden Transaktionen, die in dem angegebenen Zeitraum stattgefunden haben, aber vor mehr als 30 Tagen erhalten wurden, nicht in der Transaktionen-Liste angezeigt.
4. Wählen Sie eine Bestell-ID, um wichtige Transaktionsdetails zur Bestellung anzuzeigen.
5. Achten Sie auf Fehler in den Abschnitten Transaktionsdetails und Bestelldetails.
6. Wählen Sie Alle Transaktionsdetails anzeigen aus, um eine JSON-Datei mit allen Informationen zu sehen, die BV Pixel über die Transaktion erfasst hat. Notieren Sie sich alle bv_pixel_violations.
   Hinweis: Wählen Sie Download as file (Als Datei herunterladen) aus, um die Transaction Details (Transaktionsdetails) zu exportieren.
7. Beheben Sie die Fehler im Zusammenhang mit Ihrer BV Pixel-Implementierung.

Probleme mit Transaktionsereignissen beheben

Schritt 1: Verifizieren Sie den Ort des Transaktion-Events

Das Transaktionsereignis wird meistens entweder einer Seite Danke oder Zahlungsbestätigung hinzugefügt. Fügen Sie das JavaScript-Transaktionsereignis unter dem BV-Loader auf der Seite <head> hinzu, wie im folgenden Beispiel gezeigt:

<!-- load bv.js --> <script async src="https://apps.bazaarvoice.com/deployments/<client_name>/<site_ID>/<environment>/<locale>/bv.js"></script> <!--load Transaction event and parameters--> <script> window.bvCallback = function (BV) { BV.pixel.trackTransaction({ "currency" : "value", "orderId" : "value", "total" : "value", "items" : [ { "price" : "value", "quantity" : "value", "productId" : "value", "optional_item_parameter" : "value" }, ... ], "optional_order_parameter" : "value", ... "optional_PII_parameter" : "value", ... }); }; </script>

Schritt 2: Überprüfen Sie, ob alle Werte als Zeichenketten übergeben werden.

Stellen Sie sicher, dass alle Werte im Transaktionsereignis, einschließlich der Zahlen, in doppelte Anführungszeichen gesetzt sind.

Schritt 3: Beheben Sie Fehler im Transaktionsereignis

Das Tool zur Transaktionsüberwachung zeigt Fehler und Warnungen zu Implementierung Ihres Transaktionsereignisses. Erfahren Sie mehr darüber, wie Sie Transaktionsereignis-Fehler beheben können.

Zum Verständnis der JSON-Datei

Die JSON-Datei enthält alle Informationen, die BV Pixel über Ihre Transaktionsereignisse erfasst.

JSON-Feld	Beschreibung
partnerSource	Quelle einer unterstützten E-Commerce-Plugin-Integration, falls zutreffend.
total	Gesamtbetrag der Produktbestellung einschließlich sämtlicher Rabatte und Gutscheine aber ohne Steuern und Versandkosten.
hadPII	Ein wahrer oder falscher Wert, der angibt, ob das Ereignis personenbezogene Daten (PII) enthielt. Dieser Wert ist auf wahr gesetzt, wenn das Ereignis ein Feld aufweist, das nicht den folgenden Feldern entspricht: orderID, affiliation, total, tax, shipping, city, state, country, items, locale, discount type, label, value, proxy, partnerSource oder deploymentZone.
UA_Platform	Die Betriebssystemfamilie des Hostrechners des Agenten des Verbrauchers.
host	Hostname der Seite, die das Ereignis gesendet hat, wie es durch window.location.host erhalten wurde.
cl	BV Pixel-Ereignisklasse, wie beispielsweise Conversion, Impression und PageView. Das Tool zur Überwachung von Transaktionen zeigt nur Conversion-Events.
orderId	Die von einer Webseite generierte eindeutige ID einer Bestellung.
UA_Device	Name des Mobilgeräts, von dem aus die Transaktion durchgeführt wurde. Dies ist null, wenn der User Agent kein Mobilgerät ist.
IpState	Das Bundesland, von dem aus die Transaktion durchgeführt wurde. Dies wird durch eine Suche nach der Geo-IP auf der Teil-IP ermittelt.
tax	Auf die Bestellung angewendeter Steuerbetrag.
client	Der von Bazaarvoice bereitgestellte Name des Kunden.
UA	Vollständiger User-Agent-String aus der HTTP-Header-Anfrage, der Informationen über den Browser, das Betriebssystem und die Plattform des Verbrauchers enthält.
shipping	Versandkosten der Bestellung.
shippingDate	Wird anstelle des Transaktionsdatums verwendet, um zu bestimmen, wann Bazaarvoice die Bewertungsanfrage sendet. Das Datum muss dem folgenden Format entsprechen: JJJJ-MM-TT.
shippingDelay	Wird verwendet, um die Anzahl der Tage zwischen dem Transaktionsdatum und dem Datum des Versands der Bewertungsanfrage durch Bazaarvoice zu erhöhen. Der Wert sollte ein numerisches Format haben wie 10.
IpCountry	Der ISO-3166 -Code für das Land, von dem aus die Transaktion durchgeführt wurde.
Page	Die Seite auf der Kunden-Webseite, auf der das Transaktionsereignis ausgelöst wurde.
Dt	Zeitstempel, wann Bazaarvoice das Ereignis erhalten hat.
deploymentZone	ID der Implementierungszone, in der die mit der Transaktion verbundene BV Pixel-Implementierung enthalten ist. Dies wird in der Konfiguration festgelegt. Die Standardimplementierungszone ist main_site. Um zu verifizieren, dass der Wert von DeploymentZone korrekt ist, gehen Sie in der Konfiguration zu der Seite Webseite-Manager und wählen Sie neben dem in der JSON-Datei aufgeführten Namen der Implementierungszone aus. Wenden Sie sich an Bazaarvoice-Support, um weitere Hilfe zu erhalten.
currency	Der alphabetische Währungscode der Transaktion gemäß ISO 4217 .
IpCity	Die Stadt, von der aus die Transaktion durchgeführt wurde. Wird durch eine Suche nach der Geo-IP auf der Teil-IP ermittelt.
bv_pixel_violations	Probleme bei der Implementierung von BV Pixel, die Sie beheben sollte, um genauere Transaktionsdaten zu erfassen.
environment	Die Umgebung, in der Sie BV Pixel implementiert haben. Gültige Optionen sind production und staging.
Label	Beschreibendes Label, das auf die Conversion angewendet wird.
UA_Browser	Der Browser, mit dem die Transaktion durchgeführt wurde.
UA_Mobile	Gibt an, ob die Transaktion auf einem Mobilgerät durchgeführt wurde.
Country	Gültiger ISO-Ländercode mit zwei oder drei Buchstaben, der vom Kunden festgelegt wurde.
locale	Durch BV Pixel erfasste Variante. Falls die Transaktion nicht in US-Englisch (en_US) stattfand, setzen Sie den korrekten, vierstelligen Sprachregionscode ein.
Art	Art der Conversion, die stattgefunden hat. Nutzen Sie Empfohlene Werte für den Typ-Parameter, um die Werte dieses erforderlichen Parameters zu definieren.
Source	Gibt an, ob die BV Pixel-Implementierung den BV-Lader (bv.js) oder bvapi.js verwendet.
dc	Anzeige-Code oder andere Kennung der Benutzeroberflächen-Variante.
IpPostalCode	Die Postleitzahl, von der aus die Transaktion durchgeführt wurde. Wird durch eine Suche nach der Geo-IP auf der Teil-IP ermittelt.
UA_platformVersion	Version des Betriebssystems des Geräts, von dem aus die Transaktion durchgeführt wurde.

Häufige Fragen

Die folgenden häufig gestellten Fragen liefern Informationen zu Sicherheits- und Performance‑Auswirkungen beim Einsatz von BV Pixel.

Nein. BV Pixel hat keine wahrgenommenen Auswirkungen auf die Leistung. Die Loader-Datei namens bv.js, die Aktivitäten auf Ihrer Webseite verfolgt, enthält in der Regel zwischen 7 und 14 KB. Die Datei bv.js blockiert eine Seite nicht länger als 15 Millisekunden, während die Bazaarvoice-Anwendungen asynchron heruntergeladen werden, darunter das Tool Bazaarvoice Analytics Inspector-(optionaler Download). Das Analytics-Tag für BV Pixel ist 11 KB. Wir komprimieren alle referenzierten Daten, um die Verarbeitung zu beschleunigen.

Die auf Amazon Web Services (AWS) gehostete Bazaarvoice-Plattform speichert Ihre Transaktionsdaten. Wir senden Ihre Daten über HTTPS und speichern sie in sicheren, von AWS geschützten Datenspeichern .

Die auf Amazon Web Services (AWS) gehostete Bazaarvoice-Plattform speichert personenbezogene Daten wie E-Mail-Adresse, Name und IP-Adresse. AWS verschlüsselt E-Mail-Adressen und kürzt oder anonymisiert IP-Adressen. Wir senden Ihre Daten über HTTPS und speichern sie in sicheren, von AWS geschützten Datenspeichern .

Nein, sie werden nicht separat gespeichert.

Interne Mitarbeiter von Bazaarvoice müssen möglicherweise auf die mit BV Pixel gesammelten Daten zugreifen, um Ihre Pixel-Integration auf optimale Funktionalität zu verifizieren.

Ja. Sofern Ihre Vertragsbedingungen es zulassen, können alle Bazaarvoice-Kunden Ihre aggregierten oder anonymisierten BV Pixel-Daten zur Unterstützung von Lösungen verwenden.

Ja. Sie können BV Pixel implementieren, um nicht transaktionsbezogene Ereignisinformationen auf einer nicht E-Commerce-Webseite zu erfassen, beispielsweise um sich für einen Newsletter zu registrieren, ein Produkt zu registrieren, eine PDF-Datei herunterzuladen, einen Shop zu finden oder weitere Informationen zu einem Produkt anzufordern. Personenbezogene Daten, die durch nicht transaktionsbezogene Ereignisse erfasst werden, können jedoch nicht zum Senden von Bewertungsanfragen verwendet werden.

Ja. Sie können BV Pixel-Ereignisse so einrichten, dass E-Mail-Adressen erfasst werden, ohne die Funktion für Bewertungsanfragen zu aktivieren. Diese Option hat jedoch keinen praktischen Wert. Bazaarvoice verwendet nur E-Mail-Adressen (PII), um Bewertungsanfragen zu senden.

Ja. Sie haben über die passwortgeschützte Bazaarvoice Workbench Zugriff auf diese Informationen. Die Passwörter, die für den Zugriff auf Workbench verwendet werden, sind mit einem 128-Bit-Schlüssel und einem Einweg-Hash gesichert.

Das CIR berücksichtigt nur Transaktionen, bei denen Kunden mit Bazaarvoice-Komponenten (wie Bewertungen, Rezensionen, Fragen oder Antworten) interagiert haben, bevor sie ihre Einkäufe getätigt haben. Das Tool zur Überwachung von Transaktionen bezieht alle Transaktionen ein, unabhängig davon, ob die Verbraucher mit einer Komponente von Bazaarvoice interagiert haben, bevor sie ihre Käufe abgeschlossen haben.

Nein. Sie können das BV-Pixel-Transaktion-Event nur zum Generieren einer Bewertungsanfrage verwenden.