GTM-brug & GA4-gebeurtenisbrug

Verbind kwantitatiewe Google Analytics 4-telemetrie met kwalitatiewe MousePlayer-sessieherspelings deur tweerigting-dataLayer-sinkronisering en GA4-versoenbare API's.

1. Argitektuuroorsig & vermoëns

Moderne webontleding het dikwels 'n fundamentele dataskeiding: kwantitatiewe platforms (soos Google Analytics 4) rapporteer wat op 'n webwerf gebeur het, terwyl kwalitatiewe sessieherspeelhulpmiddels verduidelik waarom dit gebeur het. Die MousePlayer GTM- & GA4-brug verwyder dié gaping deur 'n tweerigtingsinkroniseringskanaal binne die blaaier se JavaScript-loopomgewing te skep.

By aktivering inisialiseer die nasporingskrip twee toegewyde kernmodules:

  • Sessieherspeeluitvoerder (initGa4SessionBridge): Stuur die aktiewe opnamesessie se identifiseerder (mp_session_id) en 'n direkte afspeel-URL (mp_session_url) outomaties na die webwerf se datalaag sodra die sessie begin.
  • GA4-gebeurtenisinvoerder (initDataLayerBridge): Heg 'n nievernietigende luisteraar aan die datalaagskikking. Elke pasgemaakte e-handels- of gedragsgebeurtenis wat vir GA4 gestuur word, word onmiddellik as pasgemaakte gebeurtenis in die MousePlayer-ontledingsdatabasis weerspieël (ce), met alle numeriese en teksparameters.

Ondersteuning vir pasgemaakte dataLayer-objekte: As 'n webtoepassing 'n pasgemaakte JavaScript-skikkingsnaam gebruik in plaas van die gewone dataLayer (byvoorbeeld, xyzDataLayer), pas die enjin dinamies by die ingestelde gtm_datalayer_name parameter aan sonder handmatige kodeveranderinge.

2. Strategiese besigheidswaarde

Direkte integrasie van sessieherspeelskakels in ondernemingsontledingspyplyne bied verskeie belangrike bedryfsvoordele:

Besigheidsvermoë Bedryfsimpak
Omskakelingskoersverbetering (CRO) Laat digitale ontleders struikelblokke in GA4-omskakelingstregters vind en onmiddellik die opnames oopmaak van gebruikers wat mandjies by bepaalde betaalstappe verlaat het.
Inkomstetoerekening & ouditering Waardevolle e-handelstransaksies kan geoudit word deur die presiese wyserbane, klikke en sigbare-gebiedstoestande wat tot 'n aankoop gelei het, te hersien.
Vinniger tegniese ontfouting QA-spanne kan GA4 se JavaScript-uitsonderingsgebeure of API-foutlogboeke direk met visuele skermopnames verbind, sonder om foute met die hand te herhaal.
Oplossing van klantondersteuningsake Ondersteuningskaartjies met gebruikersessie-ID's laat agente die klant se presiese sessieherspeling hersien, wat oplossingstyd aansienlik verkort.

3. Google Tag Manager-opstelgids

Om die herspeel-URL binne Google Tag Manager vas te lê en na Google Analytics 4 te stuur, moet drie afsonderlike GTM-komponente opgestel word:

Stap 1: skep datalaagveranderlikes

Gaan in die GTM-werkruimte na Veranderlikes → Gebruikersgedefinieerde veranderlikes en skep twee veranderlikes van tipe Datalaagveranderlike:

  • Veranderlikenaam: dlv - mp_session_id • Datalaagveranderlikenaam: mp_session_id
  • Veranderlikenaam: dlv - mp_session_url • Datalaagveranderlikenaam: mp_session_url

Stap 2: skep die aktiveringsneller

Gaan na Snellers → Nuut en kies die snellertipe Pasgemaakte gebeurtenis. Stel die volgende parameters op:

  • Gebeurtenisnaam: mp_session_ready
  • Hierdie sneller aktiveer op: Alle pasgemaakte gebeure

Stap 3: stel die GA4-gebeurtenisetiket op

Skep 'n nuwe etiket van tipe Google Analytics: GA4-gebeurtenis om die sessieskakel na die GA4-webwerf te stuur:

# 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. Stel verkennings (pasgemaakte verslae) in GA4 op

Nadat die GTM-etiket ontplooi is, begin GA4 die afspeel-URL as gebeurtenisparameter ontvang. Om dit in pasgemaakte verkenningsverslae te ontleed, moet die parameter eers as pasgemaakte dimensie geregistreer word.

Registreer pasgemaakte dimensies in GA4-administrasie

Gaan in die Google Analytics 4-koppelvlak na Administrasie → Datavertoning → Pasgemaakte definisies en klik Skep pasgemaakte dimensie:

  • Dimensienaam: MousePlayer Session URL
  • Omvang: Gebeurtenis (of Sessie as dit aan sessieparameters geheg is)
  • Gebeurtenisparameter: mp_session_url

Bou 'n sessie-inspeksieverkenning

In die Verken afdeling van GA4, skep 'n nuwe Vrye vorm verkenning om individuele gebruikersreise te ondersoek:

  • Rye: Voeg by: Event name, Transaction ID (vir e-handel), of Landing page.
  • Kolomme / dimensies: Sluit die nuut geskepte pasgemaakte dimensie in: MousePlayer Session URL.
  • Waardes: Voeg by: Event count of Total users.

Die geskepte verslag wys direk klikbare URL's langs GA4-metrieke, sodat u onmiddellik van statistiese uitskieters na visuele herspelings kan gaan.

5. Voeg herspeel-URL's by GA4 se standaardverslae

Benewens verkennings kan pasgemaakte dimensies in gewone GA4-verslae geïntegreer word (soos Verkeerverkryging, Bladsye en skermsof E-handelsaankope) deur die GA4-verslagbiblioteek.

Wysig standaardverslagtabelle

  1. Maak in GA4 enige standaard-gedetailleerde verslag oop (bv. Verslae → Betrokkenheid → Bladsye en skerms).
  2. Klik die Pas verslag aan potloodikoon regs bo (administrateurtoegang vereis).
  3. In die regterpaneel onder Verslagdata, klik Dimensies.
  4. Voeg MousePlayer Session URL by die primêre of sekondêre dimensielys en stel dit as sigbaar.
  5. Klik Stoor → Stoor veranderinge aan huidige verslag.

Ná stoor kan enige ontleder wat standaardverkrygings- of omskakelingstabelle hersien, MousePlayer Session URL as sekondêre dimensie byvoeg en besoekersgedrag oor gewone verkeersegmente onmiddellik visueel ondersoek.

6. JavaScript API- & GA4 / GTM-versoenbaarheidsverwysing

MousePlayer bied 'n intuïtiewe, GA4-versoenbare JavaScript API (met gewone gtag()-tipe bevele) en 'n openbare globale objek (window.MousePlayer). Só kan ontwikkelaars sessie-URL's in die konsole opvra, B2B-klant-ID's heg en herspeelskakels by derdeparty-hulptoonbanke of foutopsporingstelsels voeg.

1. Direkte invoeging van herspeel-URL's (Intercom / Zendesk / pasgemaakte brûe)

U kan die aktiewe besoekersessie se volle afspeel-URL direk uit die blaaierkonsole of enige pasgemaakte skrip kry 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. Stel pasgemaakte B2B-klant-ID's (user_id)

Om aangemelde SaaS- of B2B-klante te identifiseer, kan u 'n pasgemaakte user_id (soos 'n databasis-ID, e-posadres of UUID) tydens die aanvanklike skripopstelling of dinamies tydens uitvoering met GA4-sintaksis deurgee:

// 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. Asinchroniese data-ophaalmetodes

U kan gewone GA4-terugroepsintaksis gebruik om sessiemetadata asinchronies binne pasgemaakte etiketbestuurskripte op te haal:

// 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 handelsmerke wat hier genoem word, behoort aan hul onderskeie eienaars. MousePlayer het geen sakeverhouding met hierdie verskaffers nie.