GTM Bridge & GA4 Event Bridge

Għaqqdu t-telemetrija kwantitattiva Google Analytics 4 mar-riproduzzjonijiet kwalitattivi MousePlayer b’sinkronizzazzjoni bidirezzjonali dataLayer u APIs kompatibbli ma’ GA4.

1. Arkitettura & kapaċitajiet

Analiżi moderna spiss tbati minn data separata: pjattaformi bħal Google Analytics 4 jgħidu dak li ġara fis-sit, filwaqt li r-riproduzzjonijiet jispjegaw għaliex ġara. Il- MousePlayer GTM & GA4 Bridge jelimina d-differenza b’kanal b’żewġ direzzjonijiet fir-runtime JavaScript tal-browser.

Meta attiv, jibdew żewġ moduli ewlenin:

  • Esportatur tar-riproduzzjoni (initGa4SessionBridge): Jibgħat awtomatikament l-identifikatur tas-sessjoni (mp_session_id) u URL dirett (mp_session_url) fid-data layer malli tibda sessjoni.
  • Importatur tal-avvenimenti GA4 (initDataLayerBridge): Listener mhux distruttiv mal-array. Kull avveniment kummerċjali jew tal-imġiba għal GA4 jiġi rifless fid-database bħala avveniment personalizzat (ce), bil-parametri numeriċi u testwali kollha.

Appoġġ għal oġġett dataLayer personalizzat: Jekk l-app tuża array b’isem differenti mill-istandard dataLayer (eż., xyzDataLayer), l-engine jadatta għall-parametru gtm_datalayer_name mingħajr bidla manwali fil-kodiċi.

2. Valur strateġiku għan-negozju

Links tar-riproduzzjonijiet fil-pipelines analitiċi jagħtu diversi vantaġġi operattivi:

Kapaċità Impatt operattiv
Ottimizzazzjoni tar-rata tal-konverżjoni (CRO) Analisti jsibu frizzjoni fil-lembuti GA4 u jiftħu reġistrazzjonijiet ta’ min abbanduna l-basket f’pass speċifiku.
Attribuzzjoni tad-dħul & awditjar Iċċekkjaw tranżazzjonijiet ta’ valur għoli bit-triq eżatta tal-kursur, klikks u stati tal-iskrin li wasslu għax-xiri.
Debugging aktar mgħaġġel Timijiet QA jgħaqqdu eċċezzjonijiet JavaScript GA4 jew logs tal-API direttament ma’ reġistrazzjonijiet, bla riproduzzjoni manwali tal-bugs.
Riżoluzzjoni tal-appoġġ Tickets b’IDs tas-sessjonijiet jippermettu lill-aġenti jaraw eżatt x’ġara, u jqassru ħafna r-riżoluzzjoni.

3. Konfigurazzjoni Google Tag Manager

Biex jinqabad il-link f’GTM u jintbagħat lil GA4, ikkonfiguraw tliet riżorsi:

Pass 1: varjabbli tad-data layer

Fil-workspace GTM morru Varjabbli → Varjabbli definiti mill-utent u oħolqu tnejn tat-tip Varjabbli tad-data layer:

  • Isem il-varjabbli: dlv - mp_session_id • Isem il-varjabbli tad-data layer: mp_session_id
  • Isem il-varjabbli: dlv - mp_session_url • Isem il-varjabbli tad-data layer: mp_session_url

Pass 2: trigger tal-attivazzjoni

Morru Triggers → Ġdid u agħżlu t-tip Avveniment personalizzat. Issettjaw:

  • Isem l-avveniment: mp_session_ready
  • Dan it-trigger jaħdem fuq: L-avvenimenti personalizzati kollha

Pass 3: tag tal-avveniment GA4

Oħolqu tag tat-tip Google Analytics: Avveniment GA4 biex tibagħtu l-link lill-proprjetà GA4:

# 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. Esplorazzjonijiet (rapporti personalizzati) f’GA4

Wara l-pubblikazzjoni tat-tag, GA4 jirċievi l-link bħala parametru. Għal rapporti personalizzati, irreġistrawh bħala Custom Dimension l-ewwel.

Reġistrazzjoni ta’ dimensjonijiet f’GA4 Admin

Fl-interface Google Analytics 4 morru Admin → Wiri tad-data → Definizzjonijiet personalizzati u kklikkjaw Oħolqu dimensjoni personalizzata:

  • Isem id-dimensjoni: MousePlayer Session URL
  • Ambitu: Avveniment (jew Sessjoni għal parametri fl-ambitu tas-sessjoni)
  • Parametru tal-avveniment: mp_session_url

Esplorazzjoni għall-ispezzjoni tas-sessjonijiet

Fit-taqsima Esploraw ta’ GA4 oħolqu esplorazzjoni Forma ħielsa biex tispezzjonaw vjaġġi individwali:

  • Ringieli: Żidu Event name, Transaction ID (għall-kummerċ elettroniku), jew Landing page.
  • Kolonni / dimensjonijiet: Inkludu d-dimensjoni l-ġdida MousePlayer Session URL.
  • Valuri: Żidu Event count jew Total users.

It-tabella turi URLs klikkjabbli ħdejn metrika GA4, għal qabża immedjata minn anomalija għal riproduzzjoni.

5. Links fir-rapporti standard GA4

Minbarra esplorazzjonijiet, dimensjonijiet jistgħu jiżdiedu fir-rapporti standard GA4 (bħal Akkwist tat-traffiku, Paġni u skrins, jew Xiri tal-kummerċ elettroniku) bil-Librerija tar-Rapporti GA4.

Bidla fit-tabelli standard

  1. Iftħu rapport dettaljat standard GA4 (eż., Rapporti → Involviment → Paġni u skrins).
  2. Ikklikkjaw Ippersonalizzaw ir-rapport bil-lapes fuq il-lemin (jeħtieġ aċċess admin).
  3. Fil-panel tal-lemin taħt Data tar-rapport, ikklikkjaw Dimensjonijiet.
  4. Żidu MousePlayer Session URL mal-lista primarja jew sekondarja u agħmluha viżibbli.
  5. Ikklikkjaw Issejvjaw → Issejvjaw bidliet fir-rapport attwali.

Wara, analisti jistgħu jżidu MousePlayer Session URL bħala dimensjoni sekondarja biex jaraw imġiba viżivament bejn segmenti standard.

6. Referenza JavaScript API & kompatibbiltà GA4 / GTM

MousePlayer jagħti JavaScript API intuwittiva kompatibbli ma’ GA4 (b’kmandi standard stil gtag()) u oġġett globali pubbliku (window.MousePlayer). L-iżviluppaturi jistaqsu għal URLs fil-console, iżidu IDs B2B u links f’helpdesks jew trackers oħra.

1. Żieda diretta tal-URL (Intercom / Zendesk / bridges personalizzati)

Iksbu l-URL sħiħ tas-sessjoni attiva mill-console jew skript permezz ta’ 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. IDs B2B personalizzati (user_id)

Biex tidentifikaw klijenti SaaS jew B2B imdaħħla, għaddu user_id personalizzat (database ID, email jew UUID) fil-konfigurazzjoni inizjali jew dinamikament bis-sintassi GA4:

// 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. Metodi asinkroniċi għall-qari

Użaw callbacks standard GA4 għal metadata asinkronika fl-iskripts tal-ġestjoni tat-tags:

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

It-trademarks tas-sidien rispettivi. MousePlayer bla relazzjoni kummerċjali ma’ dawn il-fornituri.