GTM-bro & GA4-hendelsesbro

Koble kvantitativ telemetri fra Google Analytics 4 med kvalitative øktavspillinger i MousePlayer gjennom toveis dataLayer-synkronisering og GA4-kompatible API-er.

1. Arkitektur & muligheter

Moderne nettanalyse lider ofte av en grunnleggende datasilo: kvantitative plattformer (som Google Analytics 4) rapporterer hva som skjedde på et nettsted, mens kvalitative verktøy for øktavspilling forklarer hvorfor det skjedde. Med MousePlayers GTM- & GA4-bro forsvinner gapet ved at en toveis synkroniseringskanal opprettes i nettleserens JavaScript-miljø.

Når funksjonen aktiveres, starter sporingsskriptet to egne kjernemoduler:

  • Eksportør for øktavspilling (initGa4SessionBridge): Sender automatisk identifikatoren for den aktive opptaksøkten (mp_session_id) og en direkte avspillings-URL (mp_session_url) til nettstedets datalag så snart økten er opprettet.
  • Mottaker av GA4-hendelser (initDataLayerBridge): Kobler en lytter til datalagets array uten å forstyrre det. Alle egendefinerte netthandels- eller atferdshendelser sendt til GA4 speiles straks i MousePlayers analysedatabase som egendefinerte hendelser (ce), med alle tall- og tekstparametere.

Støtte for egendefinerte dataLayer-objekter: Hvis en nettapplikasjon bruker et egendefinert navn på JavaScript-arrayet i stedet for standardnavnet dataLayer (for eksempel xyzDataLayer), tilpasser motoren seg dynamisk til den konfigurerte parameteren gtm_datalayer_name uten manuelle kodeendringer.

2. Strategisk forretningsverdi

Å koble lenker til øktavspilling direkte inn i bedriftens analyseflyt gir flere viktige driftsfordeler:

Forretningsmulighet Virkning i praksis
Optimalisering av konverteringsraten (CRO) Lar digitale analytikere finne friksjonspunkter i GA4-konverteringstrakter og straks åpne opptak av brukere som forlot handlekurven ved bestemte trinn i kassen.
Omsetningsattribusjon & revisjon Verdifulle netthandelstransaksjoner kan etterprøves ved å se nøyaktige pekerbaner, klikk og tilstander for visningsområdet som førte til et kjøp.
Raskere teknisk feilsøking QA-team kan koble GA4-hendelser for JavaScript-unntak eller API-feillogger direkte til visuelle skjermopptak, slik at feil ikke må gjenskapes manuelt.
Løsning av supportsaker Supportsaker med brukerens økt-ID lar medarbeidere se den nøyaktige øktavspillingen og reduserer løsningstiden kraftig.

3. Oppsett i Google Tag Manager

For å fange opp avspillings-URL-en i Google Tag Manager og sende den til Google Analytics 4 må tre ulike GTM-elementer konfigureres:

Trinn 1: Opprett datalagsvariabler

I GTM-arbeidsområdet går du til Variabler → Brukerdefinerte variabler og oppretter to variabler av typen Datalagsvariabel:

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

Trinn 2: Opprett aktiveringsutløseren

Gå til Utløsere → Ny og velg utløsertypen Egendefinert hendelse. Angi følgende parametere:

  • Hendelsesnavn: mp_session_ready
  • Denne utløseren aktiveres ved: Alle egendefinerte hendelser

Trinn 3: Konfigurer GA4-hendelsestaggen

Opprett en ny tagg av typen Google Analytics: GA4-hendelse for å sende øktlenken til GA4-området:

# 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. Konfigurer utforskninger (egendefinerte rapporter) i GA4

Når GTM-taggen er publisert, begynner GA4 å motta avspillings-URL-en som hendelsesparameter. For å analysere dataene i egendefinerte utforskningsrapporter må parameteren først registreres som en egendefinert dimensjon.

Registrer egendefinerte dimensjoner i GA4-administrasjonen

I Google Analytics 4 går du til Administrator → Datavisning → Egendefinerte definisjoner og klikker på Opprett egendefinert dimensjon:

  • Dimensjonsnavn: MousePlayer Session URL
  • Omfang: Hendelse (eller Økt hvis den knyttes til parametere med øktomfang)
  • Hendelsesparameter: mp_session_url

Lag en utforskning for øktkontroll

I delen Utforsk i GA4 oppretter du en ny utforskning av typen Fritt format for å undersøke enkeltstående brukerreiser:

  • Rader: Legg til Event name, Transaction ID (for netthandel), eller Landing page.
  • Kolonner / dimensjoner: Ta med den nylig opprettede egendefinerte dimensjonen MousePlayer Session URL.
  • Verdier: Legg til Event count eller Total users.

Rapporttabellen viser direkte klikkbare URL-er sammen med GA4-målinger, slik at du straks kan gå fra statistiske avvik til visuelle avspillinger.

5. Avspillings-URL-er i GA4-standardrapporter

I tillegg til utforskninger kan egendefinerte dimensjoner legges inn i vanlige GA4-standardrapporter (som Trafikkanskaffelse, Sider og skjermer, eller Netthandelskjøp) via GA4-rapportbiblioteket.

Endre standardrapporttabeller

  1. Åpne en detaljert standardrapport i GA4 (f.eks. Rapporter → Engasjement → Sider og skjermer).
  2. Klikk på blyantikonet Tilpass rapport øverst til høyre (krever administratortilgang).
  3. I panelet til høyre, under Rapportdata, klikker du på Dimensjoner.
  4. Legg til MousePlayer Session URL i listen over primære eller sekundære dimensjoner og gjør den synlig.
  5. Klikk på Lagre → Lagre endringer i gjeldende rapport.

Når rapporten er lagret, kan analytikere som ser vanlige tabeller for trafikkanskaffelse eller konvertering, legge til MousePlayer Session URL som sekundær dimensjon og straks undersøke besøksatferd visuelt på tvers av vanlige trafikksegmenter.

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

MousePlayer har et intuitivt, GA4-kompatibelt JavaScript-API (med standardkommandoer i gtag()-stil) og et offentlig globalt objekt (window.MousePlayer). Utviklere kan dermed hente økt-URL-er i konsollen, knytte til B2B-kunde-ID-er og sette inn avspillingslenker i eksterne support- eller feilsporingsverktøy.

1. Sett inn avspillings-URL direkte (Intercom / Zendesk / egne broer)

Du kan hente hele avspillings-URL-en for den aktive besøksøkten direkte fra nettleserkonsollen eller et eget skript 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. Angi egne B2B-kunde-ID-er (user_id)

For å identifisere innloggede SaaS- eller B2B-kunder kan du sende en egen user_id (som database-ID, e-postadresse eller UUID), enten ved første skriptkonfigurasjon eller dynamisk under kjøring 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. Asynkron henting av data

Du kan bruke vanlig GA4-syntaks for tilbakekall til å hente øktmetadata asynkront i egne skript for taggadministrasjon:

// 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 nevnte varemerker tilhører sine respektive eiere. MousePlayer har ingen forretningsforbindelse med disse leverandørene.