trbo

Legen Sie im Tag Manager ein neues Tag an. Unter Tag-Konfiguration wählen Sie bitte als Tag-Typ Benutzerdefiniertes HTML aus. Kopieren Sie nun den Code aus der Integrationsanleitung hier herein.

Wichtig: da es sich um ein HTML-Tag handelt, dürfen die <script> Tags im Code nicht vergessen werden.

Bitte stellen Sie sicher, dass die Checkbox document.write unterstützen angehakt ist. Eine Besonderheit des Plugin Tags ist, dass es nach den anderen trbo Tags gefeuert werden sollte. Deshalb stellen Sie bitte die Priorität auf 98. Die restlichen Tags stellen Sie bitte auf eine Priorität von 99. Über Prioritäten können Sie in Google Tag Manager festlegen, in welcher Reihenfolge die Tags ausgespielt werden. Je höher die Priorität, desto früher wird das Tag ausgespielt.
Wählen Sie abschließend noch den Trigger All Pages aus, damit das Plugin Tag bei jedem Seitenaufruf Ihrer Webseite gefeuert wird.

{{shopTrackingCode}}

Bei SPAs ist es üblich, dass die nötigen Javascript Dateien nur einmal beim initialen Pageload geladen werden. So verhält es sich auch beim trbo Plugin Code. Es genügt, den Plugin Code ein mal zu laden. Bei einem Seitenwechsel muss dann aber zusätzlich ein Tag gefeuert werden. Erstellen Sie ein neues Tag und nennen Sie das bspw. trbo Plugin Reload API.

mit diesem Tag simulieren Sie einen neuen Seitenaufruf für unser Plugin. Stellen Sie sicher, dass vor dem Aufruf dieses Tags auch das PageView Tracking (aus Schritt 2) neu ausgelöst werden muss und mit dem entsprechenden Seitentyp befüllt werden muss. Gleichermaßen muss das ProductView Tracking (aus Schritt 3) schon vor dem Plugin Reload ausgelöst werden, wenn es sich bei der Zielseite um eine Produktdetailseite handelt.

Als Trigger dient hier ein benutzerdefinierter Trigger, der auf Ihrer Seite immer dann gefeuert wird, wenn innerhalb der Single Page Application ein Seitenwechsel stattgefunden hat. Dieses Tag dient dazu, dass die API die vorhandenen Layer auf der Seite aufräumt und neue, qualifizierte Kampagnen/Layer nachlädt.

{{spa}}

Das PageView Tracking ist dazu da, dem trbo Plugin die Information zu übermitteln, auf welchem Seitentyp sich der User befindet. Diese Information wird einerseits verwendet, um darauf die Ausspielung von Kampagnen zu regeln. Andererseits wird diese Information genutzt, damit wir genauere Produktempfehlungen berechnen können oder Maßnahmen, wie z.B. zuletzt gesehene Produkte richtig ausspielen können. Je mehr PageTypes Sie übergeben, desto granularer kann nachher die Ausspielung der Maßnahmen gesteuert werden.

Erstellen Sie wie in Schritt 1 ein neues Tag und nennen Sie es bspw. trbo PageView. Achten Sie darauf, diesem und den folgenden trbo Tags eine Priorität von 99 zuzuweisen. Der Trigger bleibt in diesem Fall bei All Pages.

Bitte passen Sie in dem Javascript Objekt trboPageTypes die Objekt-Keys an, so dass diese mit Ihren internen PageType Namen übereinstimmen. Ebenso müssen Sie die GTM Variable pageType an Ihren bereits vorhandenen Namen anpassen.

PageTypes, die es so in Ihrem Shop nicht gibt, werden als “static” übergeben.

Es wird davon ausgegangen, dass bereits die GTM Variable pageType angelegt ist. Sollte dies nicht der Fall sein wird empfohlen diese über ein benutzerdefiniertes Javascript oder Lookup Table zu befüllen und als trbo - pageType zur Verfügung zu stellen.

{{pageView}}

Das Productview Tracking wird auf Produktdetailseiten ausgespielt und enthält wichtige Informationen zum aktuell betrachteten Produkt, wie die Artikelnummer, den Preis oder auch den Namen des Produkts. Trbo nutzt diese Informationen um Views eines einzelnen Produkts zu speichern.

Erstellen Sie ein neues Tag und nennen Sie es bspw. trbo ProductView. Die Priorität sollte wieder auf 99 gestellt werden. Beim Trigger achten Sie bitte dieses mal darauf, dieses Tag nur auf Produktdetailseiten auszuspielen.

productId - Eindeutige Artikelnummer des Produkts
productName - Name des Produkts
productQuantity - kann ggf. immer den Wert 1 enthalten
productPrice - Preis des Produkts in englischer Dezimalnotation (bpsw. 12.99)

Lassen Sie sich nicht durch die Struktur des JSON verwirren. products ist zwar ein Array, auf Detailseiten hat dieses Array aber grundsätzlich eine Länge von 1.

Die Artikelnummer, die Sie in productId übergeben muss übereinstimmen mit der Artikelnummer des Produkts im Produktfeed und der Artikelnummer im CurrentBasket bzw. im Conversion Tracking.

{{productView}}

Es wird davon ausgegangen, dass jede der nötigen Produktinformationen als eigene GTM Variable verfügbar ist. Wenn Sie alle Daten des Produktes in einer einzigen Variable zur Verfügung stellen können Sie diese Informationen auch direkt von dieser Variable verwenden.
In Folgenden Beispiel wird davon ausgegangen dass die Produktdaten in der Variable productData bereit gestellt werden.

{{productViewObject}}

Das Current Basket Tracking stellt seitenweit die Informationen darüber zu Verfügung, welche Produkte sich im Warenkorb befinden und welchen Gesamtwert der aktuelle Warenkorb des Users hat. Darüberhinaus können Sie angeben, ob sich im Warenkorb ein eingelöster Gutschein befindet.

Diese Informationen sollten möglichst vollständig befüllt sein. So sind Sie später flexibler, was die Ausspielung entsprechender Kampagnen angeht. Es ist bspw. ein sehr beliebter Usecase auf Basis der Produkte im Warenkorb weitere Produktempfehlungen anzuzeigen. Ob ein User einen Gutschein im Warenkorb eingelöst hat oder nicht kann später bspw. dafür verwendet werden, diese User von anderen Gutscheinaktionen auszuschließen.

Erstellen Sie ein neues Tag und nennen Sie es bspw. trbo CurrentBasket. Achten Sie darauf, diesem und den folgenden trbo Tags eine Priorität von 99 zuzuweisen. Der Trigger bleibt in diesem Fall bei All Pages.

basketValue - Gesamtwert des aktuellen Warenkorbs
basketVoucher - ist ein Gutschein-Code im aktuellen Warenkorb vorhanden. 0 für nein, 1 für Gutschein-Code vorhanden.
basketProductIdsArray - ein Array der Produkt-IDs, die sich im Warenkorb befinden.

{{currentBasket}}

Das Sales/Conversion Tracking ist ein zentraler Baustein im ganzheitlichen Tracking-Prozess von trbo. Hiermit misst trbo für die einzelnen Produkte bspw. die Conversion Rate oder identifiziert die Top Seller Ihres Shops. Wenn Sie seitens trbo viele Gutscheinmaßnahmen ausspielen möchten, sollten Sie unbedingt den Gutscheincode mit in der Conversion angeben, da wir den Code nur so als ungültig in markieren können.

Erstellen Sie ein neues Tag mit der Priorität 99. Dieses Tag darf ausschließlich auf der Bestellbestätigungsseite (confirmation) ausgespielt werden - stellen Sie entsprechend den Trigger so ein.

orderId - eine eindeutige ID der Order
orderValue - der Gesamtwert der Bestellung
orderCouponCode - falls ein Gutschein eingelöst wurde, geben Sie ihn bitte hier an, so dass trbo den Gutschein in unserer Datenbank als ungültig markieren können
orderProductsArray - ein Array of Objects der Produkte, die bei dieser Bestellung
- product_id: die eindeutige Id des Produkts
- name: Name des Produkts
- quantity: Stückzahl des Produkts in der jeweiligen Bestellung
- price: der Preis des gekauften Produkts

{{sale}}

Erstellen Sie ein neues Tag namens trbo Basket Conversion. Dieses Tag soll immer dann (und nur dann) gefeuert werden, wenn ein Produkt über den Warenkorb-Button in den Warenkorb gelegt wird. Dazu müssen Sie ggf. ein neues Event erstellen (lassen). Die Priorität spielt daher bei diesem Tag keine Rolle. Diese Information wird von uns für eine einwandfreie Berechnung der Produktempfehlungen benötigt.

addedProductValue - Gesamtwert aller zum Warenkorb hinzugefügten Artikel. Entspricht in den meisten Fällen Preis des Produkts x Anzahl hinzugefüg
addedProductId - Eindeutige Artikelnummer des Produkts
addedProductName - Name des Produkts
addedProductQuantity - kann ggf. immer den Wert 1 enthalten
addedProductPrice - Preis des Produkts in englischer Dezimalnotation (bpsw. 12.99)

Lassen Sie sich nicht durch die Struktur des JSON verwirren. products ist zwar ein Array, in den meisten Fällen hat dieses Array aber eine Länge von 1.

{{basket}}

Sie können den trbo-internen DataLayer mit beliebigen Daten befüllen. Dies ist zum Beispiel dann nützlich, wenn Sie bestimmte Daten auf Ihrer Seite als Ausspielungsregel nutzen möchten oder komplexere Produktlogiken anlegen wollen. Wichtig ist auch hier eine Prioritätseinstellung von 99, damit das Tag vor dem Plugin Code gefeuert wird.

Im folgenden Beispiel sehen Sie ein Tag, das auf Detailseiten gefeuert wird und den trbo-DataLayer mit der Kategorie und der Marke des aktuell betrachteten Produkts bestückt.

Legen Sie anschließend in trbo unter Setup → DataLayer die Parameter an, die Sie in den Regeln gern nutzen wollen.

Die Befüllung des DataLayers ist persistent. Wenn Sie die Befüllung zurücksetzen möchten, befüllen Sie den DataLayer mit dem Wert "n/a".

Achten Sie darauf, dass die Parameter exakt gleich heißen, wie im Tag (productBrand) und achten Sie auch auf Groß- und Kleinschreibung.

{{datalayer}}

Die hier gezeigten Beispiele setzen voraus, dass in Ihrem Google Tag Manager relevante Variablen bereits angelegt und entsprechend befüllt sind. Hierzu zählen unter anderem:

Seitentypen / Pagetypes
Gesamtwert und Produkte des Warenkorbs
ProduktID, Name, Preis auf Detailseiten
uvm.

Sollte es einzelne Variablen noch nicht geben, so sprechen Sie bitte mit Ihrer zuständigen IT, damit diese eingerichtet werden können. Bei Fragen stehen wir Ihnen gern zur Seite.

{{translations.plugin_sendLink}}
{{frontendBaseUrl}}/integration/gtm/{{clientId}}/{{shopId}}/{{hashCode}}/
{{translations.plugin_sendLinkDescription}}

{{translations.plugin_sendHeadline}}