GTM Bridge & GA4 Event Bridge

Zusammenführung quantitativer Google Analytics 4-Telemetriedaten mit qualitativen MousePlayer-Sitzungsaufzeichnungen durch bidirektionale dataLayer-Synchronisation und GA4-kompatible APIs.

1. Systemarchitektur & technische Funktionen

Die moderne Webanalytik leidet häufig unter Datensilos: Quantitative Plattformen (wie Google Analytics 4) erfassen, was auf einer Website geschieht, während qualitative Session-Replay-Tools erklären, warum es geschieht. Die MousePlayer GTM & GA4 Bridge schließt diese Lücke, indem eine bidirektionale Synchronisationsschnittstelle direkt in der JavaScript-Laufzeitumgebung des Browsers bereitgestellt wird.

Nach der Aktivierung initialisiert das Tracking-Skript zwei spezialisierte Kernmodule:

  • Session Replay Exporter (initGa4SessionBridge): Überträgt die eindeutige Sitzungs-ID (mp_session_id) sowie eine direkte Wiedergabe-URL (mp_session_url) automatisch in den dataLayer der Website, sobald die Sitzung aufgebaut ist.
  • GA4 Event Ingestor (initDataLayerBridge): Registriert einen zerstörungsfreien Listener im dataLayer-Array. Jedes für GA4 ausgelöste E-Commerce- oder Verhaltensereignis wird unmittelbar als benutzerdefiniertes Ereignis (ce) in die MousePlayer-Analyse-Datenbank gespiegelt, inklusive aller numerischen und textuellen Parameter.

Unterstützung benutzerdefinierter dataLayer-Namen: Falls eine Webanwendung anstelle des Standardnamens dataLayer ein benutzerdefiniertes JavaScript-Array verwendet (beispielsweise xyzDataLayer), passt sich die Engine dynamisch an den konfigurierten Parameter gtm_datalayer_name an, ohne dass manuelle Codeanpassungen erforderlich sind.

2. Strategischer Unternehmenswert

Die direkte Integration von Replay-URLs in bestehende Enterprise-Analyse-Pipelines bietet signifikante operative Vorteile:

Anwendungsbereich Operativer Nutzen
Conversion-Rate-Optimierung (CRO) Ermöglicht es Analysten, Abbruchpunkte in GA4-Trichtern zu identifizieren und sofort die Aufzeichnungen von Benutzern abzuspielen, die den Warenkorb in bestimmten Checkout-Schritten verlassen haben.
Umsatzattribuierung & Auditing Hochwertige E-Commerce-Transaktionen können durch die Überprüfung der exakten Cursor-Trajektorien, Klicks und Viewport-Zustände, die zum Kauf geführt haben, überprüft werden.
Beschleunigtes technisches Debugging QA-Teams können in GA4 protokollierte JavaScript-Ausnahmen oder API-Fehlermeldungen direkt mit visuellen Bildschirmaufzeichnungen verknüpfen, wodurch die manuelle Fehlerreproduktion entfällt.
Kundensupport-Lösung Support-Tickets, die eine Sitzungs-ID enthalten, ermöglichen es Support-Mitarbeitern, den genauen Sitzungsverlauf des Kunden anzusehen, was die Lösungszeiten erheblich verkürzt.

3. Google Tag Manager Konfigurationsanleitung

Um die Replay-URL im Google Tag Manager zu erfassen und an Google Analytics 4 weiterzuleiten, müssen drei spezifische GTM-Komponenten konfiguriert werden:

Schritt 1: Erstellung der dataLayer-Variablen

Im GTM-Arbeitsbereich unter Variablen → Benutzerdefinierte Variablen müssen zwei Variablen vom Typ Datenschicht-Variable erstellt werden:

  • Variablenname: dlv - mp_session_id • Name der Datenschicht-Variablen: mp_session_id
  • Variablenname: dlv - mp_session_url • Name der Datenschicht-Variablen: mp_session_url

Schritt 2: Erstellung des Auslösers (Trigger)

Unter Auslöser → Neu ist ein Auslöser vom Typ Benutzerdefiniertes Ereignis mit folgenden Parametern einzurichten:

  • Ereignisname: mp_session_ready
  • Diesen Auslöser auslösen bei: Alle benutzerdefinierten Ereignisse

Schritt 3: Konfiguration des GA4-Ereignis-Tags

Es wird ein neues Tag vom Typ Google Analytics: GA4-Ereignis erstellt, um den Sitzungs-Link an die GA4-Property zu übertragen:

# GA4-Ereignis-Tag Konfiguration Tag-Typ: Google Analytics: GA4-Ereignis Konfigurations-Tag: [Standard GA4-Konfigurations-Tag auswählen] Ereignisname: mp_recording_ready # Ereignisparameter: | Parametername | Wert | |-----------------|---------------------------| | mp_session_id | {{dlv - mp_session_id}} | | mp_session_url | {{dlv - mp_session_url}} | Auslöser: Benutzerdefiniertes Ereignis -> mp_session_ready

4. Konfiguration von explorativen Datenanalysen in GA4

Sobald das GTM-Tag bereitgestellt ist, empfängt GA4 die Wiedergabe-URL als Ereignisparameter. Um diese Daten in benutzerdefinierten Explorationsberichten zu analysieren, muss der Parameter zunächst als benutzerdefinierte Dimension registriert werden.

Registrierung benutzerdefinierter Dimensionen in der GA4-Verwaltung

In der Google Analytics 4-Oberfläche unter Verwaltung → Datenanzeige → Benutzerdefinierte Definitionen wird über Benutzerdefinierte Dimension erstellen eine neue Definition angelegt:

  • Dimensionsname: MousePlayer Session URL
  • Bereich: Ereignis (oder Sitzung bei sitzungsbezogenen Parametern)
  • Ereignisparameter: mp_session_url

Erstellung einer Explorativen Analyse zur Sitzungsprüfung

Im Bereich Explorative Datenanalyse in GA4 wird eine neue Freie Form-Exploration erstellt, um individuelle User Journeys zu untersuchen:

  • Zeilen: Hinzufügen von Ereignisname, Transaktions-ID (für E-Commerce) oder Einstiegsseite.
  • Spalten / Dimensionen: Einbinden der neu erstellten Dimension MousePlayer Session URL.
  • Werte: Hinzufügen von Ereignisanzahl oder Gesamtzahl der Nutzer.

Der generierte Berichtsbericht zeigt direkt anklickbare URLs neben GA4-Metriken an, was den sofortigen Wechsel von statistischen Ausreißern zu visuellen Sitzungsaufzeichnungen ermöglicht.

5. Integration von Replay-URLs in GA4-Standardberichte

Zusätzlich zu Explorativen Datenanalysen können benutzerdefinierte Dimensionen mithilfe der GA4-Berichtsbibliothek in Standardberichte (wie Neuakquisition von Zugriffen, Seiten und Bildschirme oder E-Commerce-Käufe) integriert werden.

Anpassung von Standard-Berichtstabellen

  1. In GA4 wird ein beliebiger Standard-Detailbericht geöffnet (z. B. Berichte → Engagement → Seiten und Bildschirme).
  2. Auf das Stiftsymbol Bericht anpassen in der oberen rechten Ecke klicken (erfordert Administratorrechte).
  3. Im rechten Bereich unter Berichtsdaten auf Dimensionen klicken.
  4. MousePlayer Session URL zur primären oder sekundären Dimensionsliste hinzufügen und als sichtbar festlegen.
  5. Auf Speichern → Änderungen am aktuellen Bericht speichern klicken.

Nach dem Speichern kann bei der Analyse von Standard-Akquisitions- oder Conversion-Tabellen die Dimension MousePlayer Session URL als sekundäre Dimension hinzugefügt werden, was eine sofortige visuelle Überprüfung des Besucheraufkommens in standardmäßigen Traffic-Segmenten ermöglicht.

6. JavaScript API & GA4 / GTM Kompatibilitätsreferenz

MousePlayer bietet eine intuitive, mit Google Analytics 4 (gtag()) kompatible JavaScript-API und ein öffentliches globales Objekt (window.MousePlayer). Dies ermöglicht es Entwicklern, Replay-URLs in der Konsole abzufragen, B2B-Kunden-IDs zuzuweisen und Wiedergabe-Links in Drittanbieter-Helpdesks oder Fehlerverfolgungssysteme zu integrieren.

1. Direkte Replay-URL-Abfrage (Intercom / Zendesk / Custom Bridges)

Die vollständige Wiedergabe-URL der aktiven Benutzersitzung kann direkt aus der Browser-Konsole oder in einem benutzerdefinierten Skript über window.MousePlayer.getSessionUrl() abgerufen werden:

// Beispiel: Aktive Sitzungs-URL abrufen und in Intercom-Metadaten einfügen if (window.MousePlayer && window.MousePlayer.getSessionUrl) { var replayUrl = window.MousePlayer.getSessionUrl(); console.log('Active Replay:', replayUrl); // In Intercom Messenger Metadaten eintragen if (window.Intercom) { Intercom('update', { 'mouseplayer_replay_url': replayUrl }); } }

2. Zuweisung benutzerdefinierter B2B-Kunden-IDs (user_id)

Zur Identifizierung von eingeloggten SaaS- oder B2B-Kunden kann eine benutzerdefinierte user_id (z. B. Datenbank-ID, E-Mail oder UUID) entweder bei der Initialisierung oder dynamisch zur Laufzeit im GA4-Syntax-Stil übergeben werden:

// Methode A: Dynamisch beim Login festlegen (GA4 / gtag Stil) mp('set', 'user_id', 'USR-987654'); // Methode B: Über das Konfigurationsobjekt festlegen mp('config', 'IHRE_CHANNEL_ID', { user_id: 'USR-987654' }); // Methode C: Direkter SDK-Aufruf window.MousePlayer.setUserId('USR-987654');

3. Asynchrone Datenabfrage-Methoden

Sitzungs-Metadaten können in benutzerdefinierten Tag-Management-Skripten mithilfe der GA4-Standard-Callback-Syntax asynchron abgefragt werden:

// Aktive Sitzungs-URL abrufen mp('get', 'session_url', function(url) { console.log('Session URL:', url); }); // Besucher-ID abrufen (Entsprechend der GA4 Client ID) mp('get', 'client_id', function(clientId) { console.log('Visitor ID:', clientId); });

Alle genannten Marken gehören ihren jeweiligen Inhabern. MousePlayer steht in keiner geschäftlichen Verbindung zu diesen Anbietern.