Tag-Management von Signal
Führen Sie folgende Schritte aus, um die Signal-Tags und -Vorlagen zu konfigurieren:
- Fügen Sie Ereignisse hinzu, um Tags auszulösen.
Bazaarvoice hat diese Ereignisse getestet und genehmigt. Deshalb wird deren Verwendung dringend empfohlen. Die Verwendung dieser empfohlenen Ereignisse ist zwar nicht verpflichtend vorgeschrieben, ihre Konfigurationen sind jedoch spezifisch. Falls Sie Änderungen vornehmen möchten, ist Vorsicht geboten.
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.Auf der Signal-Benutzeroberfläche sind Ereignisse bedingte Ereignisse, die für die Auslöseregeln eines Tags verwendet werden.
Ereignis-Name
Definition
Verwendung durch
bvConversion
Auslöser: Klick Auswahlfilter: .bvConversion Conversion (nicht kommerziell) Mehrere Conversions erfordern unterschiedliche Auswahlfilter und Ereignis-Namen für jeden Funktionstyp.
Beispiel: bvConversionCatalog (Auswahlfilter .bvConversionCatalog),
bvConversionLocator (Auswahlfilter .bvConversionLocator).bvFeature
Auslöser: Klick Auswahlfilter: .bvFeature FeatureUsed Werden mehrere Funktionen verwendet, sind unterschiedliche Auswahlfilter und Ereignis-Namen für jeden Funktionstyp erforderlich.
Beispiel: bvFeatureSort (Auswahlfilter .bvFeatureSort), bvFeaturePaginate (Auswahlfilter .bvFeaturePaginate)
bvViewRawEvent
Auslöser: Laden, Scrollen, Größenanpassung Auswahlfilter: Fenster FeatureUsedInView bvTransaction
Auslöser: Klick Auswahlfilter: .bvTransaction ConversionTransaction und PIIConversionTransaction bvViewedUGC
Auslöser: bvViewedUGC Auswahlfilter: Fenster FeatureUsedViewedUGC onLoad
Auslöser: Laden Auswahlfilter: Fenster PageViewProduct und PageViewCategory HTML- und Benutzeroberflächenelemente in Signal leiten durch Klicks ausgelöste Ereignisse ein, die dann das zugehörige Tag auslösen. In einigen Fällen, wie zum Beispiel ConversionTransaction und PIIConversionTransaction, löst das Tag beim Laden einer Seite aus, anstatt beim Auswählen einer Schaltfläche.
- Führen Sie eine Datenzuordnung durch, welche relevante Pflichtinformationen für die Tags enthält.
Die bei der Datenzuordnung verwendeten Datennamen können an Ihren individuellen Anwendungsfall angepasst werden. Die Verknüpfung zu Daten auf Ihren Produktseiten wird von der Anordnung der Daten auf der jeweiligen Seite bestimmt.
Datenname
Datenbeschreibung
Durchschnittliche Bewertung
Die durchschnittliche Sternbeurteilung dieses Produkts.
Tag-Support:
- PageViewProduct (optional)
Markenname
Kundenorientierter Markenname, dem das Produkt zugeordnet ist (soweit vorhanden).
Tag-Support:
- FeatureUsed (optional)
- FeatureUserdInView (optional)
- FeatureUsedViewedUGC (optional)
- PageViewProduct (optional)
Kategorie (Schlüssel)
Kategorieschlüssel für Artikel im JSON-Objekt, der genau dem Schlüsselnamen innerhalb des JSON-Objekts entsprechen sollte.
Tag-Support:
- ConversionTransaction (optional)
- PIIConversionTransaction (optional)
Kategorie-ID
Kundenorientierte ID der angesehenen Kategorie. Diese ID ist innerhalb Ihres Produktkatalogs einzigartig.
Tag-Support:
- FeatureUsed (optional)
- FeatureUsedInView (optional)
- FeatureUsedViewedUGC (optional)
- PageViewCategory (erforderlich)
- PageViewProduct (optional)
Stadt
Die dem Ereignis zugeordnete Stadt.
Tag-Support:
- Conversion (optional)
- ConversionTransaction (optional)
- PIIConversionTransaction (optional)
Kunden-ID
Ihre Bazaarvoice-Kunden-ID. Typischerweise eine Konstante in der Vorlage.
Tag-Support:
- Conversion (erforderlich)
- ConversionTransaction (erforderlich)
- FeatureUsed (erforderlich)
- FeatureUsedInView (erforderlich)
- FeatureUsedViewedUGC (erforderlich)
- PageViewCategory (erforderlich)
- PageViewProduct (erforderlich)
- PIIConversionTransaction (erforderlich)
Conversion-Typ
Die Art der stattfindenden Conversion. Für jeden Conversion-Typ muss ein separater Conversion-Tag erstellt werden.
Tag-Support:
- Conversion (erforderlich)
Conversion-Wert
Der numerische Wert, welcher der Conversion zugeschrieben ist.
Tag-Support:
- Conversion (erforderlich)
Währungscode
Alphabetischer Währungscode ISO 4217.
Tag-Support:
- ConversionTransaction (optional)
- PIIConversionTransaction (optional)
Country
Das dem Ereignis zugeordnete Land.
Tag-Support:
- Conversion (optional)
- ConversionTransaction (optional)
- PIIConversionTransaction (optional)
Debounce-Zeitraum
Der Zeitraum in Millisekunden, der zwischen Ereignissen, die einen Debounce erfuhren, durchgesetzt wird. Typischerweise ein konstanter Wert, standardmäßig 250 ms.
Tag-Support:
- FeatureUsedInView (optional)
- FeatureUsedViewedUGC (optional)
Zustelldatum
Wird für die Planung der E-Mail-Zustellung verwendet. Bazaarvoice versendet die E-Mail x Tage nach diesem Datum gemäß Ihrer Angabe für emailDelayDays. Bei keiner Angabe wird automatisch das aktuelle Datum/Zeitpunkt verwendet.
Tag-Support:
- PIIConversionTransaction (optional)
Detail 1
Detail auf erster Ebene für die Funktion.
Bazaarvoice empfiehlt, dass die Felder
filter
,sort
undpaginate
in diesem Feld getaggt und gelabelt werden.Tag-Support:
- FeatureUsed (erforderlich)
Detail 2
Detail auf zweiter Ebene für die Funktion.
Tag-Support:
- FeatureUsed (optional)
Anzeige-Code
Anzeige-Code oder andere Kennung der Benutzeroberflächen-Variante. Sollte Ihnen dieser Code nichts sagen, wenden Sie sich bitte an Ihren Support-Techniker.
Tag-Support:
- Conversion (optional)
- ConversionTransaction (optional)
- FeatureUsed (optional)
- FeatureUsedInView (optional)
- FeatureUsedViewedUGC (optional)
- PageViewCategory (optional)
- PageViewProduct (optional)
- PIIConversionTransaction (optional)
E-Mail
Die E-Mail-Adresse des Benutzers.
Tag-Support:
- PIIConversionTransaction (erforderlich)
Funktionsname
Der Name der verwendeten Funktion, zum Beispiel sort, paginate, InView. Für jede verwendete Funktion muss ein separater FeatureUsed-Tag erstellt werden.
Tag-Support:
- FeatureUsed (erforderlich)
Host-Name
Host-Name der Seite, von der das Ereignis gesendet wurde. Wird kein Wert angegeben, wird automatisch window.location.host verwendet.
Tag-Support:
- Conversion (optional)
- ConversionTransaction (optional)
- FeatureUsed (optional)
- FeatureUsedInView (optional)
- FeatureUsedViewedUGC (optional)
- PageViewCategory (optional)
- PageViewProduct (optional)
- PIIConversionTransaction (optional)
Bild-URL (Schlüssel)
Bild-URL-Schlüssel für Artikel im JSON-Objekt. Dieser sollte genau dem Schlüsselnamen innerhalb des JSON-Objekts entsprechen.
Tag-Support:
- ConversionTransaction (optional)
- PIIConversionTransaction (optional)
In-View-Zeit
Wie lange der Container mit benutzergenerierten Inhalten (UGC) sichtbar sein muss, in Millisekunden, damit er als „angesehen“ gilt. Typischerweise ein konstanter Wert, standardmäßig 5000 ms (5 Sekunden).
Tag-Support:
- FeatureUsedInView (optional)
- FeatureUsedViewedUGC (optional)
Element-Objekt
Dies ist ein JSON- oder JSON-ähnliches Objekt, das durch den Datenkatalog referenziert wird. Dieses referenzierte Objekt enthält die Bestellinformationen auf Elementebene.
Tag-Support:
- ConversionTransaction (erforderlich)
- PIIConversionTransaction (erforderlich)
Label
Ein beschreibendes Label, das auf die Conversion angewendet wird.
Tag-Support:
- Conversion (optional)
Min. sichtbare Pixel
Die Mindestanzahl der vertikalen Pixel des UGC-Containers, die angezeigt werden müssen, damit der UGC als sichtbar angesehen wird. Typischerweise ein konstanter Wert. Standardmäßig 100 Pixel.
Tag-Support:
- FeatureUsedInView (optional)
- FeatureUsedViewedUGC (optional)
Anzahl Antworten
Anzahl der Antworten für dieses Produkt.
Tag-Support:
- PageViewProduct (optional)
Anzahl Fragen
Anzahl der Fragen für dieses Produkt.
Tag-Support:
- PageViewProduct (optional)
Anzahl Bewertungen
Anzahl der Bewertungen für das Produkt.
Tag-Support:
- PageViewProduct (optional)
Bestell-ID
Die einzigartige ID der Bestellung.
Tag-Support:
- ConversionTransaction (erforderlich)
- PIIConversionTransaction (erforderlich)
Bestellbetrag
Der Gesamtbetrag der Bestellung.
Tag-Support:
- ConversionTransaction (erforderlich)
- PIIConversionTransaction (erforderlich)
Prozentsatz Empfehlungen
Prozentsatz der Benutzer, die dieses Produkt weiterempfehlen würden. Dieser Wert sollte zwischen 0 und 100 liegen.
Tag-Support:
- PageViewProduct (optional)
Preis (Schlüssel)
Preisschlüssel für Artikel im JSON-Objekt. Dieser sollte genau dem Schlüsselnamen innerhalb des JSON-Objekts entsprechen.
Tag-Support:
- ConversionTransaction (optional)
- PIIConversionTransaction (optional)
Produkt-ID
Kundenorientierte Produkt-ID für Funktionen, die zusammen mit einem Produkt verwendet wird. Diese ID ist innerhalb Ihres Produktkatalogs einzigartig.
Tag-Support:
- FeatureUsed (optional)
- FeatureUsedInView (optional)
- FeatureUsedViewedUGC (optional)
- PageViewProduct (erforderlich)
Produktname (Schlüssel)
Produktnamen-Schlüssel für Artikel im JSON-Objekt. Dieser sollte genau dem Schlüsselnamen innerhalb des JSON-Objekts entsprechen.
Tag-Support:
- ConversionTransaction (optional)
- PIIConversionTransaction (optional)
Menge (Schlüssel)
Mengenschlüssel für Artikel im JSON-Objekt. Dieser sollte genau dem Schlüsselnamen innerhalb des JSON-Objekts entsprechen.
Tag-Support:
- ConversionTransaction (optional)
- PIIConversionTransaction (optional)
Weiterleitende URL
Die Herkunftsseite, von der das Ereignis gesendet wurde, falls verfügbar. Standardmäßig document.referrer.
Tag-Support:
- Conversion (optional)
- ConversionTransaction (optional)
- FeatureUsed (optional)
- FeatureUsedInView (optional)
- FeatureUsedViewedUGC (optional)
- PageViewCategory (optional)
- PageViewProduct (optional)
- PIIConversionTransaction (optional)
Stammkategorie-ID
Kundenorientierte Kategorie-ID der zum Objektwert categoryId relativen Stammkategorie. Diese ID ist innerhalb Ihres Produktkatalogs einzigartig.
Tag-Support:
- FeatureUsed (optional)
- FeatureUsedInView (optional)
- FeatureUsedViewedUGC (optional)
- PageViewCategory (optional)
- PageViewProduct (optional)
Versandbetrag
Die Versandkosten der Bestellung.
Tag-Support:
- ConversionTransaction (optional)
- PIIConversionTransaction (optional)
SKU (Schlüssel)
SKU oder Produkt-ID-Schlüssel für Artikel im JSON-Objekt. Dieser sollte genau dem Schlüsselnamen innerhalb des JSON-Objekts entsprechen.
Hinweis: MUSS mit derExternalId
des Produkts übereinstimmen, die in Ihrem Produktkatalog an Bazaarvoice gesendet wird. Wenn sich die für den Parametersku
festgelegte ID nicht in Ihrem Produktkatalog befindet, wird das Produkt NICHT in die Bewertungsanfrage (ehemals Anschluss-E-Mail oder AE) aufgenommen.Tag-Support:
- ConversionTransaction (erforderlich)
- PIIConversionTransaction (erforderlich)
Bundesland
Das dem Ereignis zugeordnete Bundesland.
Tag-Support:
- Conversion (optional)
- ConversionTransaction (optional)
- PIIConversionTransaction (optional)
Steuerbetrag
Der auf die Bestellung angewendete Steuerbetrag.
Tag-Support:
- ConversionTransaction (optional)
- PIIConversionTransaction (optional)
UGC-Container-ID
Die DOM-ID des Containers, der den Bazaarvoice UGC enthält. Diese informiert den Tag darüber, welches DOM-Objekt für die Sichtbarkeit verantwortlich ist.
Tag-Support:
- FeatureUsedInView (erforderlich)
- FeatureUsedViewedUGC (erforderlich)
Benutzer-ID
Die einzigartige ID des Benutzers.
Tag-Support:
- PIIConversionTransaction (optional)
Spitzname des Benutzers
Der Vorname oder Spitzname des Benutzers.
Tag-Support:
- PIIConversionTransaction (optional)
Postleitzahl
Die der Transaktion zugeordnete Postleitzahl.
Tag-Support:
- PIIConversionTransaction (optional)
- Füllen Sie mithilfe von Datenzuordnungen die Tag-Vorlagen aus.
- Füllen Sie das tag-auslösende Ereignis aus.
Conversion-Tag
Eine Conversion bezeichnet eine nicht-kommerzielle Conversion. Conversions erfassen Benutzeraktivitäten, die nicht direkt Umsatz generieren, aber trotzdem wertvoll sind, wie z. B. die Nutzung einer Händlersuche oder die Bestellung eines kostenlosen Katalogs.
Verweisen Sie auf die Implementierung von BV Pixel mit Analytics-Tags für umfangreiche Implementationsbeispiele.
Ereignis-Binding
Conversions können eindeutig über eine Conversion-Schaltfläche ausgelöst werden, wie im folgenden Beispiel dargestellt:
<button onclick="_bvapiq.push(['Conversion', ConversionData]);">Test Conversion</button>
Daten und Zuordnung
Feld | Integrierte Zuordnung | Beschreibung |
clientID | clientID | Name des Bazaarvoice-Kunden, in dessen Auftrag das Ereignis gesendet wurde. Dies ist derselbe Wert wie der Benutzername für das Workbench login. Priorität: Erforderlich |
Art | conversion.type, conversion.category.type | Art der stattfindenden Conversion. Priorität: Erforderlich |
Wert | conversion.value, conversion.attributes.value | Wert, welcher der Conversion zugeordnet wird. Priorität: Erforderlich |
city | conversion.city, conversion.profile.address.city | Der Transaktion zugeordnete Stadt. Priorität: Empfohlen |
country | conversion.country, conversion.profile.address.country | Der Transaktion zugeordnetes Land. Priorität: Empfohlen |
dc | page.dc, page.pageInfo.region | Anzeige-Code oder andere Kennung der Benutzeroberflächen-Variante. Sollte Ihnen dieser Code nichts sagen, wenden Sie sich an Ihren Support-Techniker. Standardwert: window.navigator.language Priorität: Erforderlich |
environment | environment | Anwendungsumgebung, aus der das Ereignis gesendet wurde. prod steht für den Produktionscode. staging steht für Tests und Debugging. Standardwert: 'prod' Priorität: Empfohlen |
Label | conversion.label, conversion.attributes.label | Beschreibendes Label, das auf die Conversion angewendet wird. Priorität: Empfohlen |
ref | page.ref, page.pageInfo.referringURL | Die Herkunftsseite, von der das Ereignis gesendet wurde, falls verfügbar. Standardwert: document.referrer Priorität: Empfohlen |
state | conversion.state, conversion.profile.address.state | Der Transaktion zugeordnetes Bundesland. Priorität: Empfohlen |
host | page.host, page.pageInfo.hostName | Host-Name der Seite, von der das Ereignis gesendet wurde. Standardwert: window.location.hostname Priorität: Optional |
ConversionTransaction-Tag
ConversionTransaction bezeichnet eine kommerzielle Transaktion oder Conversion. Conversion-Transaktionen verfolgen Einkäufe und sind ein wesentlicher Bestandteil bei der Berechnung eines Conversion-Anstiegs.
Verweisen Sie auf die Implementierung von BV Pixel mit Analytics-Tags für umfangreiche Implementationsbeispiele.
Ereignis-Binding
Fügen Sie den ConversionTransaction-Tag in eine geladene Bestätigungsseite ein, wie im folgenden Beispiel dargestellt:
<script> window._bvapiq = window._bvapiq || []; _bvapiq.push(['ConversionTransaction', TransactionData]); $.getScript('//magpie-static.ugc.bazaarvoice.com/magpie-api/1.4/ bvAnalyticsAPITracker.min.js.gz'); </script>
Daten und Zuordnung
Feld | Integrierte Zuordnung | Beschreibung |
clientID | clientID | Name des Bazaarvoice-Kunden, in dessen Auftrag das Ereignis gesendet wurde. Dies ist derselbe Wert wie der Benutzername für das Workbench login. Priorität: Erforderlich |
orderId | transaction.orderId, transaction.transactionID | Individuelle ID der Bestellung. Priorität: Erforderlich |
sku | items[].sku, items[].productInfo.sku | Das ist die External ID des Produkts von Bazaarvoice. Manchmal ist das ein SKU-Code, meist aber eine andere Produkt-ID. Sie wird speziell bei Bazaarvoice verwendet, um Ihre Produkte eindeutig zu kennzeichnen. Hinweis: MUSS mit der ExternalId des Produkts übereinstimmen, die in Ihrem Produktkatalog an Bazaarvoice gesendet wird. Wenn die für den Parameter sku festgelegte ID nicht in Ihrem Produktkatalog enthalten ist, wird das Produkt NICHT in die Bewertungsanfrage aufgenommen.Priorität: Erforderlich |
total | transaction.total, transaction.total.transactionTotal | Gesamtbetrag der Bestellung. Priorität: Erforderlich |
city | conversion.city, conversion.profile.address.city | Der Transaktion zugeordnete Stadt. Priorität: Empfohlen |
country | conversion.country, conversion.profile.address.country | Der Transaktion zugeordnetes Land. Priorität: Empfohlen |
currency | transaction.currency, transaction.total.currency | Alphabetischer Währungscode ISO 4217. Priorität: Empfohlen |
dc | page.dc, page.pageInfo.region | Anzeige-Code oder andere Kennung der Benutzeroberflächen-Variante. Sollte Ihnen dieser Code nichts sagen, wenden Sie sich an Ihren Support-Techniker. Standardwert: window.navigator.language Priorität: Erforderlich |
environment | environment | Anwendungsumgebung, aus der das Ereignis gesendet wurde. prod steht für den Produktionscode. staging steht für Tests und Debugging. Standardwert: 'prod' Priorität: Empfohlen |
Label | conversion.label, conversion.attributes.label | Beschreibendes Label, das auf die Conversion angewendet wird. Priorität: Empfohlen |
ref | page.ref, page.pageInfo.referringURL | Die Herkunftsseite, von der das Ereignis gesendet wurde, falls verfügbar. Standardwert: document.referrer Priorität: Empfohlen |
state | conversion.state, conversion.profile.address.state | Der Transaktion zugeordnetes Bundesland. Priorität: Empfohlen |
category | items[].category, items[].category.primaryCategory | Produktkategorie. Priorität: Optional |
host | page.host, page.pageInfo.hostName | Host-Name der Seite, von der das Ereignis gesendet wurde. Priorität: Optional |
Bild-URL | items[].imageUrl, items[].productInfo.productImage | Bild-URL des Produkts Priorität: Optional |
name | items[].name, items[].productInfo.productName | Produktname. Priorität: Optional |
price | items[].price, items[].price.basePrice | Produktpreis. Priorität: Optional |
quantity | items[].quantity | Menge des Kaufs. Priorität: Optional |
shipping | transaction.shipping, transaction.total.shipping | Versandkosten der Bestellung. Priorität: Optional |
tax | transaction.tax, transaction.total.taxAmount | Auf die Bestellung angewendeter Steuerbetrag. Priorität: Optional |
FeatureUsed-Tag
FeatureUsed zeigt die Benutzerinteraktion mit dem Container der benutzergenerierten Inhalte und den Steuerelementen an. Dieses Tag sollte für folgende Funktionen verwendet werden, z. B.:
- Filter
- Sortieren
- Paginieren
Ereignis-Binding
Hängen Sie das FeatureUsed-Tag an das Klick-Ereignis irgendeines Elements der Benutzeroberfläche an, wie im folgenden Beispiel dargestellt:
<button onclick="_bvapiq.push(['FeatureUsed', { clientID: 'testClient', bvProduct: 'AskAndAnswer', environment: 'staging', dc: 'custom_DC', name: 'Feature_Button', brand: 'Test Brand', productId: '1234567-bunnyhat', categoryId: 'hats', detail1: 'First feature detail', detail2: 'Second feature detail' }]);">Feature Button</button>
Daten und Zuordnung
Feld | Integrierte Zuordnung | Beschreibung |
brand | product.brand, product.productInfo.brandID | Kundenorientierter Markenname, dem das Produkt zugeordnet ist (soweit vorhanden). Priorität: Empfohlen |
bvProduct | bvProduct | Name des Bazaarvoice-Produkts für das zu sendende Ereignis. Mögliche Werte sind RatingsAndReviews und AskAndAnswer. Priorität: Erforderlich |
categoryId | product.categoryId, product.category.primaryCategory | Kundenorientierte ID der angesehenen Kategorie. Eindeutig mit Produktkatalog des Kunden. Priorität: Empfohlen |
clientID | clientID | Name des Bazaarvoice-Kunden, in dessen Auftrag das Ereignis gesendet wurde. Dies ist derselbe Wert wie der Benutzername für das Workbench login. Priorität: Erforderlich |
dc | page.dc, page.pageInfo.region | Anzeige-Code oder andere Kennung der Benutzeroberflächen-Variante. Sollte Ihnen dieser Code nichts sagen, wenden Sie sich an Ihren Support-Techniker. Standardwert: window.navigator.language Priorität: Erforderlich |
Detail 1 | event.detail1, event[].detail1, event.category.subDetail1, event[].category.subDetail1, (Attribut) bvDetail1 | Subdetail auf erster Ebene für die Funktion. Bazaarvoice empfiehlt, dass die Felder Metriken zur Funktionsverwendung werden automatisch nach Funktionsname, Detail 1 und Detail 2 (in dieser Reihenfolge) kumuliert, sodass Sie hierarchische Metriken extrahieren können, wenn sorgfältig gefertigte Detailattribute vorhanden sind. Priorität: Erforderlich |
Detail 2 | event.detail2, event[].detail2, event.category.subDetail2, event[].category.subDetail2, (Attribut) bvDetail2 | Subdetail auf zweiter Ebene für die Funktion. Siehe „Detail 1“. Standardmäßig: _bvGetState("event.detail2"). Priorität: Empfohlen |
environment | environment | Anwendungsumgebung, aus der das Ereignis gesendet wurde. prod steht für den Produktionscode. staging steht für Tests und Debugging. Standardwert: 'prod' Priorität: Empfohlen |
host | page.host, page.pageInfo.hostName | Host-Name der Seite, von der das Ereignis gesendet wurde. Standardwert: window.location.hostname Priorität: Optional |
name | event.name, event[].name, (Attribut) bvName | Name der verwendeten Funktion, z. B.: „sort“, „paginate“, „InView“. Priorität: Erforderlich |
productId | product.productId, product.productInfo.productID | Kundenorientierte Produkt-ID für Funktionen, die zusammen mit einem Produkt verwendet wird. Eindeutig mit Produktkatalog des Kunden. Hinweis: MUSS der ExternalId
des Produkts in Ihrem Produktkatalog entsprechen.Priorität: Erforderlich |
ref | page.ref, page.pageInfo.referringURL | Die Herkunftsseite, von der das Ereignis gesendet wurde, falls verfügbar. Standardwert: document.referrer Priorität: Empfohlen |
rootCategoryId | product.rootCategoryId, product.category.rootCategory | Kundenorientierte Kategorie-ID der zum Objektwert Eindeutig mit Produktkatalog des Kunden. Priorität: Optional |
FeatureUsedInView-Tag
FeatureUsedInView zeigt an, dass benutzergenerierte Inhalte auf der Seite sichtbar sind. Da dieses Tag ausgelöst wird, wenn benutzergenerierte Inhalte zum ersten Mal sichtbar gemacht werden, hatten die Benutzer noch nicht die Möglichkeit, mit den Inhalten zu interagieren. Dieses Tag wird nur ausgelöst, wenn eine Seite geladen wird.
Ereignis-Binding
FeatureUsedInView ist an FeatureUsedViewedUGG gekoppelt und wird beim Laden der Seite ausgeführt. Dieser Tag ist an das Ereignis bvViewedUGC gebunden, wie im folgenden Beispiel dargestellt:
var InViewData = { clientID: 'testClient', bvProduct: 'RatingsAndReviews', environment: 'staging', bvAttributes: { minVisiblePixels: 100, debouncePeriodMs: 250, inviewTime: 5000, containerId: 'bvUGC' }, dc: "custom_DC", productId: '1234567-bunnyhat', brand: 'Test Brand', categoryId: 'hats', rootCategoryId: 'garments' }; _bvapiq.push(['FeatureUsedInView', InViewData]); $(window).on('resize, scroll', function(event) {_bvapiq.push(['FeatureUsedInView', InViewData]); }); $(window).on('bvViewedUGC', function(event) {_bvapiq.push(['FeatureUsedViewedUGC', InViewData]); });
Daten und Zuordnung
Feld | Integrierte Zuordnung | Beschreibung |
brand | product.brand, product.productInfo.brandID | Kundenorientierter Markenname, dem das Produkt zugeordnet ist (soweit vorhanden). Priorität: Empfohlen |
bvProduct | bvProduct | Name des Bazaarvoice-Produkts für das zu sendende Ereignis. Mögliche Werte sind RatingsAndReviews und AskAndAnswer. Priorität: Erforderlich |
categoryId | product.categoryId, product.category.primaryCategory | Kundenorientierte ID der angesehenen Kategorie. Eindeutig mit Produktkatalog des Kunden. Priorität: Empfohlen |
clientID | clientID | Name des Bazaarvoice-Kunden, in dessen Auftrag das Ereignis gesendet wurde. Dies ist derselbe Wert wie der Benutzername für das Workbench login. Priorität: Erforderlich |
dc | page.dc, page.pageInfo.region | Anzeige-Code oder andere Kennung der Benutzeroberflächen-Variante. Sollte Ihnen dieser Code nichts sagen, wenden Sie sich an Ihren Support-Techniker. Standardwert: window.navigator.language Priorität: Erforderlich |
debouncePeriodMs | bvAttributes.dbouncePeriodMs | Der Zeitraum in Millisekunden, der zwischen Ereignissen, die einen Debounce erfuhren, durchgesetzt wird. Standardwert: 250 Priorität: Optional |
environment | environment | Anwendungsumgebung, aus der das Ereignis gesendet wurde. prod steht für den Produktionscode. staging steht für Tests und Debugging. Standardwert: 'prod' Priorität: Empfohlen |
host | page.host, page.pageInfo.hostName | Host-Name der Seite, von der das Ereignis gesendet wurde. Standardwert: window.location.hostname Priorität: Optional |
productId | product.productId, product.productInfo.productID | Kundenorientierte Produkt-ID für Funktionen, die zusammen mit einem Produkt verwendet wird. Eindeutig mit Produktkatalog des Kunden. Hinweis: MUSS der ExternalId
des Produkts in Ihrem Produktkatalog entsprechen.Priorität: Erforderlich |
ref | page.ref, page.pageInfo.referringURL | Die Herkunftsseite, von der das Ereignis gesendet wurde, falls verfügbar. Standardwert: document.referrer Priorität: Empfohlen |
rootCategoryId | product.rootCategoryId, product.category.rootCategory | Kundenorientierte Kategorie-ID der zum Objektwert Eindeutig mit Produktkatalog des Kunden. Priorität: Optional |
In der folgenden Tabelle finden Sie eine Reihe an Kontrollparametern, die nicht mit dem Tag zusammen gesendet werden, sondern dessen Verhalten steuern. Die Parameter müssen auf der Datenebene erscheinen.
bvAttribute | Beschreibung |
containerId | DOM-ID des Containers, der UGC-Elemente aufweist. Priorität: Erforderlich |
debouncePeriodMs | Der Zeitraum in Millisekunden, der zwischen Ereignissen, die einen Debounce erfuhren, durchgesetzt wird. Standardwert: 250 Priorität: Optional |
inviewTime | Wie lange der UGC-Container angezeigt werden muss (in Millisekunden), damit dieser als „angesehen“ gilt. Standardwert: 5000 Priorität: Optional |
minVisiblePixels | Mindestanzahl der vertikalen Pixel des UGC-Containers, die angezeigt werden müssen, damit der UGC als sichtbar angesehen wird. Standardwert: 100 Priorität: Optional |
FeatureUsedViewedUGC-Tag
Nach fünf Sekunden, oder nach einer Kunden-definierten Verzögerung, nachdem das Ereignis FeatureUsedViewedUGC ausgelöst wurde, findet ein Ereignis bvViewedUGC statt. Das Tag ViewedUGC wird ausgelöst, wenn benutzergenerierte Inhalte noch im Anzeigefenster sichtbar sind, wenn dieses Ereignis verarbeitet wird. ViewedUGC wird nur ausgelöst, wenn eine Seite geladen wird. Wenn benutzergenerierte Inhalte nicht angezeigt werden kann, wenn ViewedUGC es testet, aktiviert das Tag erneut das Ereignis bvViewedUGC und versucht es später erneut.
Ereignis-Binding
FeatureUsedViewedUGG ist an FeatureUsedInView gekoppelt und wird beim Laden der Seite ausgeführt. Dieser Tag ist an das Ereignis bvViewedUGC gebunden, wie im folgenden Beispiel dargestellt:
var InViewData = { clientID: 'testClient', bvProduct: 'Sampling', environment: 'staging', bvAttributes: { minVisiblePixels: 100, debouncePeriodMs: 250, inviewTime: 5000, containerId: 'bvUGC' }, dc: "custom_DC", productId: '1234567-bunnyhat', brand: 'Test Brand', categoryId: 'hats', rootCategoryId: 'garments' }; _bvapiq.push(['FeatureUsedInView', InViewData]); $(window).on('resize, scroll', function(event) {_bvapiq.push(['FeatureUsedInView', InViewData]); }); $(window).on('bvViewedUGC', function(event) {_bvapiq.push(['FeatureUsedViewedUGC', InViewData]); });
Daten und Zuordnung
Die von FeatureUsedViewedUGC verwendeten Daten und Zuordnung stimmt mit den von FeaturesUsedInView verwendeten Daten und Zuordnung überein. Die beiden Tags sind im Grunde zwei Versionen desselben Ereignisses.
Feld | Integrierte Zuordnung | Beschreibung |
brand | product.brand, product.productInfo.brandID | Kundenorientierter Markenname, dem das Produkt zugeordnet ist (soweit vorhanden). Priorität: Empfohlen |
bvProduct | bvProduct | Name des Bazaarvoice-Produkts für das zu sendende Ereignis. Mögliche Werte sind RatingsAndReviews und AskAndAnswer. Priorität: Erforderlich |
categoryId | product.categoryId, product.category.primaryCategory | Kundenorientierte ID der angesehenen Kategorie. Eindeutig mit Produktkatalog des Kunden. Priorität: Empfohlen |
clientID | clientID | Name des Bazaarvoice-Kunden, in dessen Auftrag das Ereignis gesendet wurde. Dies ist derselbe Wert wie der Benutzername für das Workbench login. Priorität: Erforderlich |
dc | page.dc, page.pageInfo.region | Anzeige-Code oder andere Kennung der Benutzeroberflächen-Variante. Sollte Ihnen dieser Code nichts sagen, wenden Sie sich an Ihren Support-Techniker. Standardwert: window.navigator.language Priorität: Erforderlich |
debouncePeriodMs | bvAttributes.dbouncePeriodMs | Der Zeitraum in Millisekunden, der zwischen Ereignissen, die einen Debounce erfuhren, durchgesetzt wird. Standardwert: 250 Priorität: Optional |
environment | environment | Anwendungsumgebung, aus der das Ereignis gesendet wurde. prod steht für den Produktionscode. staging steht für Tests und Debugging. Standardwert: 'prod' Priorität: Empfohlen |
host | page.host, page.pageInfo.hostName | Host-Name der Seite, von der das Ereignis gesendet wurde. Standardwert: window.location.hostname Priorität: Optional |
productId | product.productId, product.productInfo.productID | Kundenorientierte Produkt-ID für Funktionen, die zusammen mit einem Produkt verwendet wird. Eindeutig mit Produktkatalog des Kunden. Hinweis: MUSS der ExternalId
des Produkts in Ihrem Produktkatalog entsprechen.Priorität: Erforderlich |
ref | page.ref, page.pageInfo.referringURL | Die Herkunftsseite, von der das Ereignis gesendet wurde, falls verfügbar. Standardwert: document.referrer Priorität: Empfohlen |
rootCategoryId | product.rootCategoryId, product.category.rootCategory | Kundenorientierte Kategorie-ID der zum Objektwert Eindeutig mit Produktkatalog des Kunden. Priorität: Optional |
In der folgenden Tabelle finden Sie eine Reihe an Kontrollparametern, die nicht mit dem Tag zusammen gesendet werden, sondern dessen Verhalten steuern. Die Parameter müssen auf der Datenebene erscheinen.
bvAttribute | Beschreibung |
containerId | DOM-ID des Containers, der UGC-Elemente aufweist. Priorität: Erforderlich |
debouncePeriodMs | Der Zeitraum in Millisekunden, der zwischen Ereignissen, die einen Debounce erfuhren, durchgesetzt wird. Standardwert: 250 Priorität: Optional |
inviewTime | Wie lange der UGC-Container angezeigt werden muss (in Millisekunden), damit dieser als „angesehen“ gilt. Standardwert: 5000 Priorität: Optional |
minVisiblePixels | Mindestanzahl der vertikalen Pixel des UGC-Containers, die angezeigt werden müssen, damit der UGC als sichtbar angesehen wird. Standardwert: 100 Priorität: Optional |
PageViewCategory-Tag
PageViewCategory gibt an, dass ein Benutzer eine Produktkategorieseite geladen hat. Der PageViewCategory-Tag sollte bei jedem Ladevorgang jeder Kategorieseite ausgelöst werden.
Ereignis-Binding
PageViewCategory sollte im geladenen Analytics-JavaScript aktiviert sein, sodass der Tag beim Laden der Seite sofort aktiviert wird, wie im folgenden Code-Beispiel dargestellt:
window._bvapiq = window._bvapiq || []; _bvapiq.push(['PageViewCategory', CategoryData]); $.getScript('http://magpie-static.ugc.bazaarvoice.com/magpie-api/1.2/bvAnalyticsAPITracker.js')
Daten und Zuordnung
Feld | Integrierte Zuordnung | Beschreibung |
clientID | clientID | Name des Bazaarvoice-Kunden, in dessen Auftrag das Ereignis gesendet wurde. Dies ist derselbe Wert wie der Benutzername für das Workbench login. Priorität: Erforderlich |
categoryId | product.categoryId, product.category.primaryCategory | Kundenorientierte ID der angesehenen Kategorie. Eindeutig mit Produktkatalog des Kunden. Priorität: Empfohlen |
dc | page.dc, page.pageInfo.region | Anzeige-Code oder andere Kennung der Benutzeroberflächen-Variante. Sollte Ihnen dieser Code nichts sagen, wenden Sie sich an Ihren Support-Techniker. Standardwert: window.navigator.language Priorität: Erforderlich |
environment | environment | Anwendungsumgebung, aus der das Ereignis gesendet wurde. prod steht für den Produktionscode. staging steht für Tests und Debugging. Standardwert: 'prod' Priorität: Empfohlen |
ref | page.ref, page.pageInfo.referringURL | Die Herkunftsseite, von der das Ereignis gesendet wurde, falls verfügbar. Standardwert: document.referrer Priorität: Empfohlen |
rootCategoryId | product.rootCategoryId, product.category.rootCategory | Kundenorientierte Kategorie-ID der zum Objektwert Eindeutig mit Produktkatalog des Kunden. Priorität: Empfohlen |
host | page.host, page.pageInfo.hostName | Host-Name der Seite, von der das Ereignis gesendet wurde. Standardwert: window.location.hostname Priorität: Optional |
Datenbeispiele
var ProductData = { clientID: 'example_client_name', environment: 'staging', page: { pageInfo: { region: "custom_dc", hostName: "bazaarvoice.com" } }, product: { category: { categoryID: 'testCategory', rootCategory: 'testing' } } }; var ProductDataFlat = { clientID: 'example_client_name', environment: 'staging', dc: "custom_dc", host: "bazaarvoice.com", categoryId: 'testCategory', rootCategoryId: 'testing' };
PageViewProduct-Tag
PageViewProduct gibt an, dass ein Benutzer eine Produktseite geladen hat. Der PageViewProduct-Tag sollte bei jedem Ladevorgang jeder Produktseite ausgelöst werden. Er sollte nicht hinter einer Registerkarte versteckt sein oder anderweitig von der Auslösung beim Laden der Seite gehindert werden. Dieser Tag treibt zusammen mit demConversionTransaction-Tag den größten Teil der Bazaarvoice-internen Berichte an.
Ereignis-Binding
Wie im folgenden Beispiel dargestellt, wird PageViewProduct durch das Laden das JavaScript des Analytics-Tags aktiviert, sodass der Tag sofort nach Laden der Seite ausgelöst wird:
_bvapiq.push(['PageViewProduct', { clientID: 'testClient', bvProduct: 'RatingsAndReviews', environment: 'staging', dc: "custom_DC", productId: '1234567-bunnyhat', brand: 'Test Brand', categoryId: 'hats', rootCategoryId: 'garments', numReviews: 1, numQuestions: 0, numAnswers: 0, avgRating: 5.0, percentRecommended: 100 } ]);
Daten und Zuordnung
Feld | Integrierte Zuordnung | Beschreibung |
avgRating | product.avgRating, product.attributes.ugc.averageRating | Durchschnittliche Sternebewertung dieses Produkts. Einbinden, wenn dieser Wert Benutzern gezeigt wird, auch wenn der Wert 0 ist, andernfalls das Feld nicht einbinden. Priorität: Empfohlen |
brand | product.brand, product.productInfo.brandID | Kundenorientierter Markenname, dem das Produkt zugeordnet ist (soweit vorhanden). Priorität: Empfohlen |
bvProduct | bvProduct | Name des Bazaarvoice-Produkts für das zu sendende Ereignis. Mögliche Werte sind RatingsAndReviews und AskAndAnswer. Priorität: Erforderlich |
categoryId | product.categoryId, product.category.primaryCategory | Kundenorientierte ID der angesehenen Kategorie. Eindeutig mit Produktkatalog des Kunden. Priorität: Empfohlen |
clientID | clientID | Name des Bazaarvoice-Kunden, in dessen Auftrag das Ereignis gesendet wurde. Dies ist derselbe Wert wie der Benutzername für das Workbench login. Priorität: Erforderlich |
dc | page.dc, page.pageInfo.region | Anzeige-Code oder andere Kennung der Benutzeroberflächen-Variante. Sollte Ihnen dieser Code nichts sagen, wenden Sie sich an Ihren Support-Techniker. Standardwert: window.navigator.language Priorität: Erforderlich |
environment | environment | Anwendungsumgebung, aus der das Ereignis gesendet wurde. prod steht für den Produktionscode. staging steht für Tests und Debugging. Standardwert: 'prod' Priorität: Empfohlen |
host | page.host, page.pageInfo.hostName | Host-Name der Seite, von der das Ereignis gesendet wurde. Standardwert: window.location.language Priorität: Optional |
numAnswers | product.numAnswers, product.attributes.ugc.numAnswers | Anzahl der Antworten für dieses Produkt. Einbinden, wenn dieser Wert Benutzern gezeigt wird, auch wenn der Wert 0 ist, andernfalls das Feld nicht einbinden. Priorität: Erforderlich, wenn bvProduct:'AskAndAnswer' |
numQuestions | product.numQuestions, product.attributes.ugc.numQuestions | Anzahl der Fragen für dieses Produkt. Einbinden, wenn dieser Wert Benutzern gezeigt wird, auch wenn der Wert 0 ist, andernfalls das Feld nicht einbinden. Priorität: Erforderlich, wenn bvProduct:'AskAndAnswer' |
numReviews | product.numReviews, product.attributes.ugc.numReviews | Anzahl der Bewertungen für das Produkt. Einbinden, wenn dieser Wert Benutzern gezeigt wird, auch wenn der Wert 0 ist, andernfalls das Feld nicht einbinden. Priorität: Erforderlich, wenn bvProduct:'RatingsandReviews' |
percentRecommended | product.percentRecommended, product.attributes.ugc.percentRecommended | Prozentsatz der Benutzer, die dieses Produkt weiterempfehlen würden. Dieser Wert sollte zwischen 0 und 1 liegen. Einbinden, wenn dieser Wert Benutzern gezeigt wird, auch wenn der Wert 0 ist, andernfalls das Feld nicht einbinden. Priorität: Optional |
productId | product.productId, product.productInfo.productID | Kundenorientierte Produkt-ID für Funktionen, die zusammen mit einem Produkt verwendet wird. Eindeutig mit Produktkatalog des Kunden. Hinweis: MUSS der ExternalId
des Produkts in Ihrem Produktkatalog entsprechen.Priorität: Erforderlich |
ref | page.ref, page.pageInfo.referringURL | Die Herkunftsseite, von der das Ereignis gesendet wurde, falls verfügbar. Standardwert: document.referrer Priorität: Empfohlen |
rootCategoryId | product.rootCategoryId, product.category.rootCategory | Kundenorientierte Kategorie-ID der zum Objektwert Eindeutig mit Produktkatalog des Kunden. Priorität: Empfohlen |
PIIConversionTransaction-Tag
PIIConversionTransaction zeigt eine kommerzielle Konversionsrate an, die personenbezogene Daten (PII) enthält, ansonsten aber eine duplizierte ConversionTransaction ist. Dieses Tag wird über andere Kanäle und an einen anderen Endpunkt gesendet, um Datenschutzbedenken auszuräumen. Die gesammelten personenbezogenen Daten werden nur für Bewertungsanfragen übertragen, gespeichert und verwendet.
Verweisen Sie auf die Implementierung von BV Pixel mit Analytics-Tags für umfangreiche Implementationsbeispiele.
Ereignis-Binding
Einbinden des Tags PIIConversionTransaction in eine geladene Bestätigungsseite, so wie in folgendem Beispiel gezeigt:
<script> window._bvapiq = window._bvapiq || []; _bvapiq.push(['PIIConversionTransaction', TransactionData]); $.getScript('//magpie-static.ugc.bazaarvoice.com/magpie-api/1.4/bvAnalyticsAPITracker.min.js.gz'); </script>
Daten und Zuordnung
Feld | Integrierte Zuordnung | Beschreibung |
clientID | clientID | Name des Bazaarvoice-Kunden, in dessen Auftrag das Ereignis gesendet wurde. Dies ist derselbe Wert wie der Benutzername für das Workbench login. Priorität: Erforderlich |
transaction.email, transaction.profile.profileInfo.email | E-Mail-Adresse des Benutzters. Priorität: Erforderlich | |
orderId | transaction.orderId, transaction.transactionID | Individuelle ID der Bestellung. Priorität: Erforderlich |
sku | items[].sku, items[].productInfo.sku | Das ist die External ID des Produkts von Bazaarvoice. Manchmal ist das ein SKU-Code, meist aber eine andere Produkt-ID. Sie wird speziell bei Bazaarvoice verwendet, um Ihre Produkte eindeutig zu kennzeichnen. Hinweis: MUSS mit der ExternalId des Produkts übereinstimmen, die in Ihrem Produktkatalog an Bazaarvoice gesendet wird. Wenn die für den Parameter sku festgelegte ID nicht in Ihrem Produktkatalog enthalten ist, wird das Produkt NICHT in die Bewertungsanfrage aufgenommen.Priorität: Erforderlich |
total | transaction.total, transaction.total.transactionTotal | Gesamtbetrag der Bestellung. Priorität: Erforderlich |
userId | Nein, außer bei Verwendung von Website-Authentifikation | userID muss mit dem userToken (User-ID) übereinstimmen, die an Bazaarvoice im Zuge des Prozesses zum Einsenden der Bewertung weitergeleitet wurde. Kann entfallen, wenn keine ID angelegt wird, wie etwa im Falle von Gastbestellern. Hinweis: Stellen Sie sicher, dass Ihr Arbeitsblatt zur Konfiguration der Bewertungsanfrage dies korrekt widerspiegelt. Priorität: Empfohlen |
city | conversion.city, conversion.profile.address.city | Der Transaktion zugeordnete Stadt. Priorität: Empfohlen |
country | conversion.country, conversion.profile.address.country | Der Transaktion zugeordnetes Land. Priorität: Empfohlen |
currency | transaction.currency, transaction.total.currency | Alphabetischer Währungscode ISO 4217. Priorität: Empfohlen |
dc | page.dc, page.pageInfo.region | Anzeige-Code oder andere Kennung der Benutzeroberflächen-Variante. Sollte Ihnen dieser Code nichts sagen, wenden Sie sich an Ihren Support-Techniker. Standardwert: window.navigator.language Priorität: Erforderlich |
environment | environment | Anwendungsumgebung, aus der das Ereignis gesendet wurde. prod steht für den Produktionscode. staging steht für Tests und Debugging. Standardwert: 'prod' Priorität: Empfohlen |
nickname | transaction.nickname, transaction.profile.profileInfo.userName | Vorname oder Spitzname des Benutzers. Priorität: Empfohlen |
ref | page.ref, page.pageInfo.referringURL | Die Herkunftsseite, von der das Ereignis gesendet wurde, falls verfügbar. Standardwert: document.referrer Priorität: Empfohlen |
state | conversion.state, conversion.profile.address.state | Der Transaktion zugeordnetes Bundesland. Priorität: Empfohlen |
Postleitzahl | transaction.zip, transaction.profile.address.postalCode | Die der Transaktion zugeordnete Postleitzahl. Priorität: Empfohlen |
category | items[].category, items[].category.primaryCategory | Produktkategorie. Priorität: Optional |
shippingDate | transaction.shippingDate, transaction.total.shippingDate | Wird für die Planung der E-Mail-Zustellung verwendet. Wir versenden die E-Mail x Tage nach diesem Datum gemäß Ihrer Angabe für emailDelayDays. Liegt keine Angabe vor, wird automatisch das/die aktuelle Datum/Uhrzeit verwendet. Muss folgendem Format entsprechen: YYYY-MM-DDThh:mm:ss.SSS (Y=Jahr, M=Monat, D=Tag, T=Trennzeichen, h=Stunde, m=Minute, s=Sekunde). Priorität: Optional |
host | page.host, page.pageInfo.hostName | Host-Name der Seite, von der das Ereignis gesendet wurde. Standardwert: window.location.hostname Priorität: Optional |
Bild-URL | items[].imageUrl, items[].productInfo.productImage | Bild-URL des Produkts Priorität: Optional |
name | items[].name, items[].productInfo.productName | Produktname. Priorität: Optional |
price | items[].price, items[].price.basePrice | Produktpreis. Priorität: Optional |
quantity | items[].quantity | Menge des Kaufs. Priorität: Optional |
shipping | transaction.shipping, transaction.total.shipping | Versandkosten der Bestellung. Priorität: Optional |
tax | transaction.tax, transaction.total.taxAmount | Auf die Bestellung angewendeter Steuerbetrag. Priorität: Optional |