Eigene Tracking-Events anlegen (Pro)

Mit eigenen Tracking-Events schreibst du zusätzliche Ereignisse in den dataLayer, ohne dass dafür ein Plugin-Update nötig ist. Die Funktion gehört zum Pro-Paket. Du findest die Liste unter Einstellungen › Erweiterungen – es ist der zweite Eintrag des Plugins, zwischen den Einstellungen und dem Setup-Assistenten.

Event anlegen

Klicke in der Liste auf Hinzufügen und fülle das Formular aus:

• Name – frei wählbar, nur zur Orientierung in der Liste.
• Ereignisname – der Name des dataLayer-Events, den dein Tag Manager auswertet. Pflicht.
• Service-Schlüssel – eindeutiger Schlüssel des Events. Pflicht.
• Verkaufskanal – leer lassen, damit das Event für alle Kanäle gilt.
• Zweite Container-ID – optional, siehe unten.
• Kategorie – optionale Einordnung.
• Parameter – JSON-Objekt mit den Werten, die das Event mitgibt.
• Aktiv – schaltet das Event ein oder aus.

Die Liste zeigt Name, Ereignisname und Aktiv. Hinzufügen ist erst mit dem Pro-Paket aktiv.

Wann und wo das Event auslöst

Das Event wird erst nach der Einwilligung des Besuchers ausgelöst. Es erscheint auf Produktseiten, Kategorieseiten, Suchergebnissen, im Warenkorb (inklusive Offcanvas-Warenkorb), auf der Bestellbestätigung und auf der Bestellabschluss-Seite. Voraussetzung sind das Pro-Paket sowie ein aktiver Tag Manager mit Container-ID.

Gibt es für denselben Service-Schlüssel einen globalen Eintrag und einen für den aktuellen Verkaufskanal, gilt der Eintrag des Verkaufskanals.

Platzhalter in Parametern

In Textwerten der Parameter kannst du diese Platzhalter einsetzen:

| Platzhalter | Wert |
|---|---|
| {{cart.total}} | Warenkorb-Gesamtsumme (nur Warenkorb, Offcanvas-Warenkorb, Bestellbestätigung) |
| {{cart.currency}} | Währungscode (gleiche Seiten) |
| {{order.orderNumber}} | Bestellnummer (nur Bestellabschluss-Seite) |
| {{page.type}} | Seitentyp: navigation, product, search, checkout-cart, offcanvas-cart, checkout-confirm, checkout-finish |
| {{salesChannel.name}} | Name des Verkaufskanals |

Ein Platzhalter ohne Wert auf der jeweiligen Seite wird zu einem leeren Text. Andere Platzhalter bleiben unverändert stehen – es wird nichts ausgewertet.

Zweiter GTM-Container

Trägst du bei einem Event eine Zweite Container-ID ein, lädt das Plugin zusätzlich diesen Container, ebenfalls erst nach der Einwilligung. Mehrfach eingetragene IDs lädt es nur einmal, und die primäre Container-ID wird nie doppelt geladen.

Export und Import

Mit Exportieren lädst du alle eigenen Events als Datei coe-gtm-custom-services.json herunter. Importieren liest eine solche Datei wieder ein. Das hilft beim Umzug zwischen Staging und Live.

• Der Import ist „ganz oder gar nicht": Ist ein Eintrag ungültig, übernimmt das Plugin nichts. Korrigiere die Datei und importiere erneut.
• Pflichtangaben je Eintrag sind Service-Schlüssel und Ereignisname. Parameterwerte müssen Text sein.
• Existiert ein Eintrag mit gleichem Service-Schlüssel und gleichem Verkaufskanal bereits, wird er aktualisiert, sonst neu angelegt.
• Verkaufskanäle sind in der Datei über ihre ID eingetragen, die je System verschieden ist. Globale Einträge ziehen daher am problemlosesten um.

Export und Import sind nur mit Pro-Paket möglich und setzen die passenden Benutzerrechte voraus.