GTM-Bréck & GA4-Eventbréck

Quantitativ Telemetrie vu Google Analytics 4 mat qualitative Sessiouns-Widdergabe vu MousePlayer verbannen, duerch Synchroniséierung vum dataLayer a béid Richtungen a GA4-kompatibel APIen.

1. Architektur & Méiglechkeeten am Iwwerbléck

Modern Webanalysen hunn dacks e fundamentale Problem vu getrennten Donnéeën: Quantitativ Plattformen (ewéi Google Analytics 4) mellen, wat op enger Websäit geschitt ass, wärend qualitativ Instrumenter fir Sessiouns-Widdergab erklären, firwat et geschitt ass. D' MousePlayer-GTM- & GA4-Bréck schléisst dës Lück duerch e Synchroniséierungskanal a béid Richtungen an der JavaScript-Lafzäitëmwelt vum Browser.

Wann aktivéiert, initialiséiert de Verfollegungsskript zwee speziell Kärmoduler:

  • Sessiouns-Widdergab-Exporter (initGa4SessionBridge): Schéckt automatesch d'Kennung vun der aktiver Opnamsessioun (mp_session_id) an eng direkt Ofspill-URL (mp_session_url) an den Datelayer vun der Websäit, soubal d'Sessioun opgebaut ass.
  • GA4-Event-Iwwerhueler (initDataLayerBridge): Hänkt en net destruktiven Event-Listener un den Datelayer-Array. All eegendefinéierten E-Commerce- oder Verhalensevent, dee fir GA4 geschéckt gëtt, gëtt direkt als eegendefinéierten Event (ce) an d'Analysdatebank vu MousePlayer gespigelt, mat allen numeresche Parameteren an Zeecheketten.

Ënnerstëtzung fir eegendefinéiert dataLayer-Objeten: Wann eng Webapplikatioun en eegene JavaScript-Arraynumm amplaz vum Standard dataLayer benotzt (zum Beispill xyzDataLayer), passt sech de Motor dynamesch un de konfiguréierte Parameter gtm_datalayer_name un, ouni datt de Code manuell geännert muss ginn.

2. Strategesche Geschäftswäert

D'Integratioun vu Sessiouns-Widdergab-Linken direkt an d'Analys-Dateveraarbechtung vun Entreprisë bréngt e puer bedeitend Virdeeler am Alldag:

Geschäftlech Méiglechkeet Wierkung am Betrib
Optiméierung vum Konversiounstaux (CRO) Digital Analyste kënnen Hindernisser an de GA4-Konversiounstrichter fannen an direkt Opname vu Benotzer starten, déi hir Wuerekuerf bei bestëmmte Keessschrëtt verlooss hunn.
Revenu-Zouuerdnung & Kontroll Héichwäerteg E-Commerce-Transaktioune kënne kontrolléiert ginn, andeems déi genee Zeigerweeër, Klicken a siichtbar Beräicher nokuckt ginn, déi zu engem Akaf gefouert hunn.
Méi séier technesch Feelersich QA-Ekippe kënnen GA4-JavaScript-Ausnamseventer oder API-Feelerprotokoller direkt mat visuellen Opname verbannen, soudatt si Feeler net manuell nomaache mussen.
Problemléisung am Clientssupport Supporttickete mat Benotzersessiouns-IDen erlaben Agenten, déi genee Sessiouns-Widdergab vum Client ze kucken, wat d'Léisungszäit staark verkierzt.

3. Konfiguratiounsuleedung fir Google Tag Manager

Fir d'Ofspill-URL a Google Tag Manager ze iwwerhuelen an op Google Analytics 4 ze leeden, mussen dräi verschidde GTM-Bestanddeeler ageriicht ginn:

Schrëtt 1: Datelayer-Variabelen erstellen

Gitt am GTM-Aarbechtsberäich op Variabelen → Benotzerdefinéiert Variabelen an erstellt zwou Variabelen vum Typ Datelayer-Variabel:

  • Variabelennumm: dlv - mp_session_id • Numm vun der Datelayer-Variabel: mp_session_id
  • Variabelennumm: dlv - mp_session_url • Numm vun der Datelayer-Variabel: mp_session_url

Schrëtt 2: Aktivéierungsausléiser erstellen

Gitt op Ausléiser → Nei a wielt den Ausléisertyp Benotzerdefinéierten Event. Konfiguréiert dës Parameteren:

  • Eventnumm: mp_session_ready
  • Dësen Ausléiser gëtt ausgeléist bei: Allen eegendefinéierten Eventer

Schrëtt 3: GA4-Event-Tag konfiguréieren

Erstellt en neien Tag vum Typ Google Analytics: GA4-Event , fir de Sessiounslink un d'GA4-Websäit ze iwwerdroen:

# GA4 Event Tag Configuration Tag Type: Google Analytics: GA4 Event Configuration Tag: [Select standard GA4 Configuration Tag] Event Name: mp_recording_ready # Event Parameters: | Parameter Name | Value | |-----------------|---------------------------| | mp_session_id | {{dlv - mp_session_id}} | | mp_session_url | {{dlv - mp_session_url}} | Triggering: Fire on Custom Event -> mp_session_ready

4. Exploratiounen (eegene Berichter) a GA4 konfiguréieren

Soubal de GTM-Tag agesat ass, kritt GA4 d'Ofspill-URL als Eventparameter. Fir dës Donnéeën an eegene Exploratiounsberichter ze analyséieren, muss de Parameter fir d'éischt als Benotzerdefinéiert Dimensioun registréiert ginn.

Benotzerdefinéiert Dimensiounen an der GA4-Verwaltung registréieren

Gitt an der Uewerfläch vu Google Analytics 4 op Verwaltung → Datevisualiséierung → Benotzerdefinéiert Definitiounen a klickt op Benotzerdefinéiert Dimensioun erstellen:

  • Dimensiounsnumm: MousePlayer Session URL
  • Scope: Event (oder Sessioun , wa se un e Parameter mam Sessiounsscope ugehaangen ass)
  • Eventparameter: mp_session_url

Eng Exploratioun fir Sessiounskontroll erstellen

Erstellt am GA4-Abschnitt Exploréieren eng nei Exploratioun vum Typ Fräi Form , fir eenzel Benotzerreesen ze iwwerpréiwen:

  • Zeilen: Füügt Event name, Transaction ID (fir E-Commerce) oder Landing pagederbäi.
  • Kolonnen / Dimensiounen: Huelt déi nei erstallt Benotzerdefinéiert Dimensioun MousePlayer Session URLderbäi.
  • Wäerter: Füügt Event count oder Total usersderbäi.

Déi generéiert Berichtstabell weist direkt uklickbar URLen nieft de GA4-Moosswäerter. Esou kënnt Dir direkt vu statisteschen Ausräisser op visuell Widdergabe wiesselen.

5. Ofspill-URLen an d'GA4-Standardberichter integréieren

Nieft Exploratioune kënnen eegendefinéiert Dimensiounen a gewéinlech GA4-Standardberichter (ewéi Trafic-Gewënnung, Säiten an Ecranenoder E-Commerce-Akeef) mat der GA4-Berichtsbibliothéik integréiert ginn.

Standardberichtstabelle beaarbechten

  1. Maacht a GA4 e belibegen detailléierte Standardbericht op (z. B. Berichter → Bedeelegung → Säiten an Ecranen).
  2. Klickt op d'Stëftsymbol Bericht upassen uewe riets (Verwaltungszougrëff erfuerderlech).
  3. Klickt am rietse Beräich ënner Berichtsdonnéeënop Dimensiounen.
  4. Füügt MousePlayer Session URL an d'Lëscht vun de primären oder sekundären Dimensiounen derbäi a maacht se siichtbar.
  5. Klickt op Späicheren → Ännerungen am aktuelle Bericht späicheren.

Soubal gespäichert, kann all Analyst, dee Standardtabelle fir d'Gewënnung oder Konversioun kuckt, MousePlayer Session URL als sekundär Dimensioun derbäisetzen an esou direkt d'Verhale vu Visiteuren iwwer déi üblech Traficsegmenter visuell iwwerpréiwen.

6. JavaScript-API & Referenz fir GA4-/GTM-Kompatibilitéit

MousePlayer bitt eng verständlech, GA4-kompatibel JavaScript-API (mat Standardbefehler am gtag()-Stil) an e globalen ëffentlechen Objet (window.MousePlayer). Esou kënnen Entwéckler d'Sessiouns-URLen an der Konsole ofroen, B2B-Clients-IDen bäifügen an Ofspill-Linken an extern Supportsystemer oder Feelerverfolger asetzen.

1. Direkt Ofspill-URL asetzen (Intercom / Zendesk / eege Brécken)

Dir kënnt déi ganz Ofspill-URL vun der aktiver Visiteursessioun direkt aus der Browserkonsole oder engem eegene Skript mat window.MousePlayer.getSessionUrl()ofruffen:

// Example: Retrieve the active session URL and attach it to Intercom chat metadata if (window.MousePlayer && window.MousePlayer.getSessionUrl) { var replayUrl = window.MousePlayer.getSessionUrl(); console.log('Active Replay:', replayUrl); // Attach to Intercom Messenger metadata if (window.Intercom) { Intercom('update', { 'mouseplayer_replay_url': replayUrl }); } }

2. Eegendefinéiert B2B-Clients-IDe setzen (user_id)

Fir ugemellte SaaS- oder B2B-Clienten ze identifizéieren, kënnt Dir eng eege user_id (ewéi eng Datebank-ID, E-Mail oder UUID) entweder bei der initialer Skriptkonfiguratioun oder dynamesch zur Lafzäit mat der GA4-Syntax matginn:

// Method A: Set user_id dynamically at login (GA4 / gtag style) mp('set', 'user_id', 'USR-987654'); // Method B: Set via config object mp('config', 'YOUR_CHANNEL_ID', { user_id: 'USR-987654' }); // Method C: Direct SDK invocation window.MousePlayer.setUserId('USR-987654');

3. Methode fir asynchron Donnéeën ofzeruffen

Dir kënnt d'Standard-GA4-Callback-Syntax benotzen, fir Sessiounsmetadonnéeën an eegene Skripte fir Tag-Verwaltung asynchron ofzeruffen:

// Retrieve active session URL mp('get', 'session_url', function(url) { console.log('Session URL:', url); }); // Retrieve visitor ID (Client ID equivalent) mp('get', 'client_id', function(clientId) { console.log('Visitor ID:', clientId); });

All hei genannt Marke gehéieren hire jeeweilege Besëtzer. MousePlayer huet keng Geschäftsbezéiung mat dësen Ubidder.