GTM- en GA4-gebeurteniskoppeling

1. Architectuuroverzicht & mogelijkheden

Moderne webanalyse kent vaak een fundamentele scheiding van gegevens: kwantitatieve platforms (zoals Google Analytics 4) rapporteren wat er op een website gebeurde, terwijl kwalitatieve tools voor het afspelen van sessies verklaren waarom het gebeurde. De MousePlayer GTM- & GA4-koppeling overbrugt dit verschil met een synchronisatiekanaal in twee richtingen binnen de JavaScript-runtime van de browser.

Wanneer u de koppeling activeert, initialiseert het trackingscript twee specifieke kernmodules:

Exportmodule voor sessie-opnamen (initGa4SessionBridge): Plaatst automatisch de identificatie van de actieve opnamesessie (mp_session_id) en een directe afspeel-URL (mp_session_url) in de gegevenslaag van de website zodra de sessie tot stand komt.
Importmodule voor GA4-gebeurtenissen (initDataLayerBridge): Voegt een listener toe aan het array van de gegevenslaag zonder het bestaande gedrag te verstoren. Elke aangepaste e-commerce- of gedragsgebeurtenis die voor GA4 wordt toegevoegd, wordt direct als aangepaste gebeurtenis naar de analysedatabase van MousePlayer gekopieerd (ce), inclusief alle numerieke en tekstparameters.

Ondersteuning voor aangepaste dataLayer-objecten: Als een webapplicatie een aangepaste naam voor het JavaScript-array gebruikt in plaats van de standaardnaam dataLayer (bijvoorbeeld xyzDataLayer), past de engine zich dynamisch aan de ingestelde parameter gtm_datalayer_name aan, zonder dat u de code handmatig hoeft te wijzigen.

2. Strategische bedrijfswaarde

Door afspeellinks voor sessies rechtstreeks in de analyseprocessen van uw organisatie op te nemen, krijgt u verschillende belangrijke operationele voordelen:

Bedrijfstoepassing	Operationeel effect
Conversieoptimalisatie (CRO)	Digitale analisten kunnen frictiepunten in conversietrechters van GA4 herkennen en meteen opnamen openen van gebruikers die hun winkelwagen bij specifieke stappen van het afrekenen achterlieten.
Omzetattributie & controle	U kunt waardevolle e-commercetransacties controleren door de precieze cursorbewegingen, klikken en viewporttoestanden te bekijken die tot een aankoop leidden.
Sneller technische fouten opsporen	QA-teams kunnen JavaScript-uitzonderingen in GA4 of API-foutlogboeken direct koppelen aan visuele schermopnamen, waardoor ze fouten niet meer handmatig hoeven te reproduceren.
Supportvragen oplossen	Met gebruikerssessie-ID’s in supporttickets kunnen medewerkers precies de sessie-opname van de klant bekijken, wat de oplostijd sterk verkort.

3. Google Tag Manager instellen

Om de afspeel-URL in Google Tag Manager op te halen en door te sturen naar Google Analytics 4, moet u drie afzonderlijke GTM-onderdelen instellen:

Stap 1: variabelen voor de gegevenslaag maken

Ga in de GTM-werkruimte naar Variabelen → Door de gebruiker gedefinieerde variabelen en maak twee variabelen van het type Variabele voor gegevenslaag:

Variabelenaam: dlv - mp_session_id • Naam van variabele voor gegevenslaag: mp_session_id
Variabelenaam: dlv - mp_session_url • Naam van variabele voor gegevenslaag: mp_session_url

Stap 2: de activeringstrigger maken

Ga naar Triggers → Nieuw en selecteer het triggertype Aangepaste gebeurtenis. Stel de volgende parameters in:

Gebeurtenisnaam: mp_session_ready
Deze trigger wordt geactiveerd bij: Alle aangepaste gebeurtenissen

Stap 3: de GA4-gebeurtenistag instellen

Maak een nieuwe tag van het type Google Analytics: GA4-gebeurtenis om de sessielink naar de GA4-property te verzenden:

# 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. Verkenningen (aangepaste rapporten) instellen in GA4

Zodra de GTM-tag is gepubliceerd, ontvangt GA4 de afspeel-URL als gebeurtenisparameter. Om deze gegevens in aangepaste verkenningsrapporten te analyseren, moet u de parameter eerst als aangepaste dimensie registreren.

Aangepaste dimensies registreren in GA4 Beheer

Ga in de interface van Google Analytics 4 naar Beheer → Gegevensweergave → Aangepaste definities en klik op Aangepaste dimensie maken:

Dimensienaam: MousePlayer Session URL
Bereik: Gebeurtenis (of Sessie bij koppeling aan parameters op sessieniveau)
Gebeurtenisparameter: mp_session_url

Een verkenning maken om sessies te onderzoeken

Maak in het onderdeel Verkennen van GA4 een nieuwe verkenning van het type Vrije vorm om afzonderlijke gebruikersreizen te onderzoeken:

Rijen: Voeg Event name, Transaction ID (voor e-commerce) of Landing pagetoe.
Kolommen / dimensies: Voeg de zojuist gemaakte aangepaste dimensie MousePlayer Session URLtoe.
Waarden: Voeg Event count of Total userstoe.

De gegenereerde rapporttabel toont direct aanklikbare URL’s naast GA4-statistieken, zodat u onmiddellijk van statistische uitschieters naar visuele sessie-opnamen kunt gaan.

5. Afspeel-URL’s opnemen in standaardrapporten van GA4

Naast verkenningen kunt u aangepaste dimensies via de rapportbibliotheek van GA4 ook opnemen in standaardrapporten (zoals Verkeersacquisitie, Pagina’s en schermenof E-commerceaankopen).

Standaardrapporttabellen aanpassen

Open in GA4 een willekeurig gedetailleerd standaardrapport (bijvoorbeeld Rapporten → Betrokkenheid → Pagina’s en schermen).
Klik rechtsboven op het potloodpictogram Rapport aanpassen (beheerdersrechten vereist).
Klik in het rechterpaneel onder Rapportgegevensop Dimensies.
Voeg MousePlayer Session URL toe aan de lijst met primaire of secundaire dimensies en maak deze zichtbaar.
Klik op Opslaan → Wijzigingen in huidig rapport opslaan.

Na het opslaan kan elke analist die standaardtabellen voor acquisitie of conversies bekijkt, MousePlayer Session URL als secundaire dimensie toevoegen en het bezoekersgedrag binnen standaardverkeerssegmenten direct visueel onderzoeken.

6. JavaScript-API & compatibiliteit met GA4 / GTM

MousePlayer biedt een intuïtieve JavaScript-API die compatibel is met GA4 (met standaardopdrachten in de stijl van gtag()) en een openbaar globaal object (window.MousePlayer). Daarmee kunnen ontwikkelaars sessie-URL’s opvragen in de console, B2B-klant-ID’s toevoegen en afspeellinks invoegen in helpdesks of foutregistratietools van derden.

1. Afspeel-URL rechtstreeks invoegen (Intercom / Zendesk / eigen koppelingen)

U kunt de volledige afspeel-URL van de actieve bezoekerssessie rechtstreeks ophalen vanuit de browserconsole of een eigen script met 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. Eigen B2B-klant-ID’s instellen (user_id)

Om ingelogde SaaS- of B2B-klanten te herkennen, kunt u een eigen user_id (zoals een database-ID, e-mailadres of UUID) doorgeven bij de eerste scriptconfiguratie of dynamisch tijdens de uitvoering met de GA4-syntaxis:

// 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. Methoden voor asynchroon ophalen van gegevens

U kunt de standaardcallbacks van GA4 gebruiken om sessiemetadata asynchroon op te halen in eigen scripts voor tagbeheer:

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

Waarmee kunnen we helpen?