GTM-bro & GA4-hændelsesbro

Forbind kvantitativ telemetri fra Google Analytics 4 med kvalitative MousePlayer-sessionsafspilninger gennem tovejs dataLayer-synkronisering og GA4-kompatible API'er.

1. Arkitekturoversigt & muligheder

Moderne webanalyse har ofte en grundlæggende datasilo: kvantitative platforme (som Google Analytics 4) fortæller, hvad der skete på et websted, mens kvalitative sessionsafspillere forklarer, hvorfor det skete. Denne MousePlayer GTM- & GA4-bro lukker hullet ved at etablere en tovejs synkroniseringskanal i browserens JavaScript-miljø.

Når funktionen aktiveres, initialiserer sporingsscriptet to dedikerede kernemoduler:

  • Eksport af sessionsafspilning (initGa4SessionBridge): Sender automatisk den aktive optagelsessessions identifikator (mp_session_id) og en direkte afspilnings-URL (mp_session_url) til webstedets datalag, så snart sessionen er etableret.
  • Modtagelse af GA4-hændelser (initDataLayerBridge): Føjer en lytter til datalagsarrayet uden at ødelægge det. Enhver brugerdefineret e-handels- eller adfærdshændelse, der sendes til GA4, spejles straks i MousePlayers analysedatabase som en brugerdefineret hændelse (ce), inklusive alle tal- og tekstparametre.

Understøttelse af brugerdefinerede dataLayer-objekter: Hvis en webapplikation bruger et tilpasset JavaScript-arraynavn i stedet for standarden dataLayer (f.eks. xyzDataLayer), tilpasser motoren sig dynamisk til den konfigurerede gtm_datalayer_name-parameter uden manuelle kodeændringer.

2. Strategisk forretningsværdi

Direkte integration af sessionsafspilningslinks i virksomhedens analyseforløb giver flere væsentlige driftsfordele:

Forretningsmulighed Driftsmæssig effekt
Optimering af konverteringsrate (CRO) Gør det muligt for digitale analytikere at finde friktionspunkter i GA4-konverteringstragte og straks åbne optagelser af brugere, der forlod indkøbskurven på bestemte betalingstrin.
Omsætningsattribution & kontrol E-handelstransaktioner med høj værdi kan kontrolleres ved at gennemgå de præcise markørbaner, klik og visningsområder, der førte til købet.
Hurtigere teknisk fejlfinding QA-teams kan koble JavaScript-undtagelser i GA4 eller API-fejllogge direkte til visuelle skærmoptagelser og slipper dermed for at genskabe fejl manuelt.
Løsning af supportsager Supportsager med brugersessions-ID'er giver medarbejdere adgang til kundens præcise sessionsafspilning og reducerer løsningstiden markant.

3. Konfigurationsvejledning til Google Tag Manager

For at hente afspilnings-URL'en i Google Tag Manager og sende den til Google Analytics 4 skal tre GTM-komponenter konfigureres:

Trin 1: Opret datalagsvariabler

Gå i GTM-arbejdsområdet til Variabler → Brugerdefinerede variabler og opret to variabler af typen Datalagsvariabel:

  • Variabelnavn: dlv - mp_session_id • Navn på datalagsvariabel: mp_session_id
  • Variabelnavn: dlv - mp_session_url • Navn på datalagsvariabel: mp_session_url

Trin 2: Opret aktiveringsudløseren

Gå til Udløsere → Ny og vælg udløsertypen Brugerdefineret hændelse. Konfigurer følgende parametre:

  • Hændelsesnavn: mp_session_ready
  • Denne udløser aktiveres ved: Alle brugerdefinerede hændelser

Trin 3: Konfigurer GA4-hændelsestagget

Opret et nyt tag af typen Google Analytics: GA4-hændelse for at sende sessionslinket til GA4-ejendommen:

# 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. Konfiguration af udforskninger (brugerdefinerede rapporter) i GA4

Når GTM-tagget er udgivet, begynder GA4 at modtage afspilnings-URL'en som en hændelsesparameter. For at analysere disse data i brugerdefinerede udforskningsrapporter skal parameteren først registreres som en brugerdefineret dimension.

Registrer brugerdefinerede dimensioner i GA4-administration

Gå i Google Analytics 4 til Administrator → Datavisning → Tilpassede definitioner og klik på Opret tilpasset dimension:

  • Dimensionsnavn: MousePlayer Session URL
  • Omfang: Hændelse (eller Session hvis den er knyttet til parametre på sessionsniveau)
  • Hændelsesparameter: mp_session_url

Opret en udforskning til sessionskontrol

Opret i GA4-sektionen Udforsk en ny udforskning af typen Frit format for at undersøge enkelte brugerrejser:

  • Rækker: Tilføj Event name, Transaction ID (til e-handel) eller Landing page.
  • Kolonner / dimensioner: Medtag den nyoprettede brugerdefinerede dimension MousePlayer Session URL.
  • Værdier: Tilføj Event count eller Total users.

Den genererede rapporttabel viser direkte klikbare URL'er ved siden af GA4-målinger, så du straks kan gå fra statistiske afvigelser til visuelle afspilninger.

5. Integrer afspilnings-URL'er i GA4-standardrapporter

Ud over udforskninger kan brugerdefinerede dimensioner integreres i almindelige GA4-standardrapporter (som Trafiktilgang, Sider og skærme eller E-handelskøb) via GA4's rapportbibliotek.

Rediger standardrapporttabeller

  1. Åbn en detaljeret standardrapport i GA4 (f.eks. Rapporter → Engagement → Sider og skærme).
  2. Klik på blyantikonet Tilpas rapport øverst til højre (kræver administratoradgang).
  3. Klik i panelet til højre under Rapportdata på Dimensioner.
  4. Tilføj MousePlayer Session URL til listen over primære eller sekundære dimensioner, og gør den synlig.
  5. Klik på Gem → Gem ændringer i den aktuelle rapport.

Efter lagring kan enhver analytiker, der gennemgår almindelige tilgangs- eller konverteringstabeller, tilføje MousePlayer Session URL som sekundær dimension og straks visuelt undersøge besøgsadfærd på tværs af almindelige trafiksegmenter.

6. JavaScript-API & reference for GA4-/GTM-kompatibilitet

MousePlayer har et intuitivt, GA4-kompatibelt JavaScript-API (med standardkommandoer i gtag()-format) og et offentligt globalt objekt (window.MousePlayer). Det giver udviklere mulighed for at hente sessions-URL'er i konsollen, tilføje B2B-kunde-ID'er og indsætte afspilningslinks i eksterne helpdesk- eller fejlsporingsværktøjer.

1. Direkte indsættelse af afspilnings-URL (Intercom / Zendesk / egne broer)

Du kan hente den fulde afspilnings-URL for den aktive besøgssession direkte fra browserkonsollen eller et brugerdefineret script med window.MousePlayer.getSessionUrl():

// 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. Angiv egne B2B-kunde-ID'er (user_id)

For at identificere indloggede SaaS- eller B2B-kunder kan du sende et brugerdefineret user_id (som et database-ID, en e-mailadresse eller en UUID) enten ved den indledende scriptkonfiguration eller dynamisk under kørslen med GA4-syntaks:

// 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. Metoder til asynkron datahentning

Du kan bruge almindelig GA4-callbacksyntaks til at hente sessionsmetadata asynkront i egne tagadministrationsscripts:

// 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); });

Alle nævnte varemærker tilhører deres respektive ejere. MousePlayer har ingen forretningsforbindelse med disse udbydere.