TRACKING-DOKUMENTATION

Zusätzlich zu den oben aufgeführten Parametern werden einem Event, sofern möglich, immer die folgenden Parameter angehängt:

​

• doorId: Die ID der aktuell ausgewählten Tür

• externalDoorId: Die externe ID der aktuell ausgewählten Tür

• scenarioId: Die ID des aktuell ausgewählten Szenarios (Beispielbild)

• scenarioType: Der Typ des aktuell angezeigten Szenarios. Kann „USER“ für ein vom Nutzer hochgeladenes Szenario oder „EXAMPLE“ für ein Beispielszenario sein

• userId: Die ID des Frontend-Nutzers

• customerKey: Der Schlüssel Ihrer Umgebung

​

Einrichtung im Google Tag Manager

Damit die Custom Events erfolgreich an ein Tag weitergeleitet werden, müssen die folgenden Ressourcen korrekt eingerichtet sein:

• 1. Variablen

• 2. Tag, das das Ziel der Custom Events darstellt (z. B. Google Analytics)​

• 3. Trigger, der festlegt, welches Event an das Tag weitergeleitet werden soll​

​​

​

1. Variablen

Legen Sie für jedes der oben genannten Events, das Sie weiterleiten möchten, mit den folgenden Schritten eine eigene benutzerdefinierte Variable an:

1. Navigieren Sie in GTM zu Variables.

2. Klicken Sie auf „New“ und wählen Sie „Data Layer Variable“:

   • Setzen Sie den Namen der Data Layer Variable auf `body.<label>`, wobei label auf das Label aus der obigen Tabelle verweist.​​

   • Beispiel: Die benutzerdefinierte Variable für die Szenario-ID sollte als `body.scenarioId` definiert werden.

   • Wählen Sie Version 2 als Data-Layer-Version.

​

Zusätzlich zur benutzerdefinierten Variable müssen Sie eine Data Layer Variable für das Feld event im Data Layer anlegen, um den Event-Namen zu erfassen. Gehen Sie dazu wie folgt vor:​​​​​

1. Klicken Sie auf New, um eine neue Variable anzulegen.

2. Wählen Sie Data Layer Variable als Variablentyp.

3. Legen Sie als Data Layer Variable Name "event" fest, um den Event-Namen zu erfassen.

4. Wählen Sie Version 2 als Data-Layer-Version.

​​

2. Trigger

Damit die von Ihnen definierten Custom Events korrekt an ein Tag weitergeleitet werden, muss ein Trigger eingerichtet werden. So erstellen Sie einen Trigger, der auf alle Custom Events reagiert:

1. Navigieren Sie in GTM zu Triggers.

2. Neuen Trigger erstellen:

   • Klicken Sie auf New und wählen Sie Custom Event als Triggertyp.

• Verwenden Sie im Feld Event Name eine Wildcard (.*), damit alle Events erfasst werden. So wird der Trigger bei jedem Custom Event ausgelöst, das in den dataLayer gepusht wird. Aktivieren Sie unbedingt die Checkbox für den Abgleich per regulärem Ausdruck.

  • Beispiel:

    • Trigger Type: Custom Event

    • Event Name: .* (regulärer Ausdruck)

    • This trigger fires on: All Custom Events

​

3. Tag

Sobald der Trigger eingerichtet ist, konfigurieren Sie ein Tag, das die Daten an Ihr Ziel sendet (z. B. Google Analytics GA4). So erstellen Sie das Tag für Google Analytics GA:

1. Navigieren Sie in GTM zu Tags.

2. Neues Tag erstellen:

   • Klicken Sie auf New und wählen Sie Google Analytics: GA4 Event Tag als Tag-Typ.

3. GA4 Event Tag konfigurieren:

   • Wählen Sie in der Tag-Konfiguration das GA4 Configuration Tag aus (das Ihre Measurement ID enthält).

   • Setzen Sie Event Name auf {{event}}, um den Namen des ausgelösten Events dynamisch zu erfassen.

4. Benutzerdefinierte Variablen GA4-Parametern zuordnen:

   • Wenn Sie zusätzliche Daten (wie scenarioId, userId oder doorId) als benutzerdefinierte Parameter senden möchten, fügen Sie diese Zuordnungen im Abschnitt Event Parameters hinzu.

   • Beispiel:

     • Parameter Name: scenario_id, Value: der Name der Variable, zum Beispiel: {{scenario_id}}

5. Trigger zuweisen:

   • Wählen Sie im Abschnitt Triggering den „All Custom Events Trigger“ aus, den Sie im vorherigen Schritt erstellt haben.

​

Sobald diese Einrichtung abgeschlossen ist, wird das Tag bei jedem Custom Event ausgelöst, das an den dataLayer gesendet wird, und die zugehörigen Daten werden an Google Analytics GA4 weitergeleitet.

​

4. Events im Preview Mode debuggen

Nachdem Sie die benutzerdefinierten Variablen, Trigger und Tags eingerichtet haben, sollten Sie vor dem Veröffentlichen unbedingt testen, ob alles korrekt funktioniert. Google Tag Manager bietet dafür einen integrierten Preview Mode zum Debuggen Ihrer Events.

So debuggen Sie Ihre Events:

​

Schritte im Preview Mode:

1. Preview Mode starten:

   • Klicken Sie im GTM-Arbeitsbereich oben rechts auf den Button Preview.

   • Dadurch öffnet sich ein neuer Tab im Tag Assistant, in dem Sie die URL Ihrer Website eingeben können. Verwenden Sie die URL Ihrer DoorVision-Umgebung, zum Beispiel demo.door-vision.com für unsere Demo-Umgebung.

2. Mit Ihrer Website interagieren:

   • Interagieren Sie nach dem Start des Preview Mode mit der Anwendung, indem Sie eine der Aktionen aus der obigen Liste ausführen. Wenn Sie beispielsweise ein selectDoor-Event testen, wählen Sie eine visuelle Tür im Panel mit dem Türsortiment aus.

3. Events im Tag Assistant prüfen:

   • Während Sie mit der Anwendung interagieren, zeigt der Tag Assistant im linken Bereich eine Liste der ausgelösten Events an.

   • Suchen Sie das Custom Event (z. B. selectDoor) in der Event-Liste und klicken Sie darauf, um die Details anzusehen.

4. Auslösestatus des Tags prüfen:

   • Prüfen Sie bei jedem Event anhand der Abschnitte Tags Fired und Tags Not Fired, ob Ihr GA4 Event Tag korrekt ausgelöst wurde.

   • Wurde das Tag nicht ausgelöst, prüfen Sie Ihre Triggerbedingungen und stellen Sie sicher, dass das Event zu Ihrer Trigger-Einrichtung passt (z. B. bei einem Custom-Event-Trigger, ob der Event-Name korrekt ist).

5. Data Layer untersuchen:

   • Untersuchen Sie im Abschnitt Data Layer des Tag Assistant die Daten, die für jedes Event gepusht wurden. Dort sollten alle von Ihnen eingerichteten Variablen mit ihren Werten sichtbar sein, etwa scenarioId, userId sowie das Feld event, das die ausgeführte Aktion beschreibt.

   • Stellen Sie sicher, dass alle erforderlichen Daten vorhanden und Ihre Variablen korrekt zugeordnet sind.

6. Google Analytics DebugView nutzen:

   • Wenn Sie Google Analytics GA4 verwenden, können Sie die Event-Daten zusätzlich in der GA4 DebugView überprüfen.

     • Öffnen Sie Google Analytics, navigieren Sie zur DebugView (im Bereich Events) und prüfen Sie, ob Ihre Events bei GA4 ankommen.

     • Achten Sie auf die benutzerdefinierten Parameter (z. B. scenario_id, user_id), um sicherzustellen, dass sie korrekt übergeben werden.

​

Fehlerbehebung:

• Wenn das Tag nicht ausgelöst wird, prüfen Sie in GTM erneut die Konfiguration von Trigger und Event-Namen.

• Wenn Variablen nicht die richtigen Werte übergeben, überprüfen Sie die Namen der Data Layer Variables.

• Prüfen Sie, ob in Ihrem Browser Adblocker oder Ähnliches aktiviert sind, die das Tracking blockieren könnten (zum Beispiel uBlock, Ghostery, ...)