Pont GTM & Pont Digwyddiadau GA4

Uno telemetreg feintiol Google Analytics 4 ag ailchwarae sesiynau ansoddol MousePlayer drwy gysoni dataLayer i’r ddau gyfeiriad ac APIs sy’n gydnaws â GA4.

1. Trosolwg o’r Bensaernïaeth & Galluoedd

Mae dadansoddeg gwe modern yn aml yn dioddef o wahaniad data sylfaenol: mae platfformau meintiol (fel Google Analytics 4) yn adrodd beth ddigwyddodd ar wefan, tra bo offer ailchwarae sesiynau ansoddol yn esbonio pam y digwyddodd. Mae’r Bont MousePlayer GTM & GA4 yn dileu’r bwlch hwn drwy sefydlu sianel gysoni i’r ddau gyfeiriad yn amgylchedd rhedeg JavaScript y porwr.

Pan gaiff ei hactifadu, mae’r sgript tracio yn cychwyn dau fodiwl craidd penodedig:

  • Allforiwr Ailchwarae Sesiynau (initGa4SessionBridge): Yn gwthio dynodwr y sesiwn recordio weithredol (mp_session_id) ac URL ailchwarae uniongyrchol (mp_session_url) yn awtomatig i haen ddata’r wefan cyn gynted ag y sefydlir y sesiwn.
  • Derbynnydd Digwyddiadau GA4 (initDataLayerBridge): Yn atodi gwrandäwr annistrywiol at arae’r haen ddata. Caiff unrhyw ddigwyddiad e-fasnach neu ymddygiad personol a wthir ar gyfer GA4 ei adlewyrchu ar unwaith yng nghronfa ddata dadansoddeg MousePlayer fel digwyddiad personol (ce), gan gynnwys pob paramedr rhifiadol a llinynnol.

Cymorth ar gyfer Gwrthrych dataLayer Personol: Os yw rhaglen we’n defnyddio enw arae JavaScript personol yn lle’r safon dataLayer (er enghraifft, xyzDataLayer), mae’r peiriant yn addasu’n ddeinamig i’r paramedr gtm_datalayer_name wedi’i ffurfweddu heb fod angen newidiadau cod â llaw.

2. Gwerth Busnes Strategol

Mae integreiddio dolenni ailchwarae sesiynau’n uniongyrchol i biblinellau dadansoddeg menter yn darparu nifer o fanteision gweithredol sylweddol:

Gallu Busnes Effaith Weithredol
Optimeiddio Cyfradd Trosi (CRO) Yn galluogi dadansoddwyr digidol i ganfod pwyntiau ffrithiant mewn twndisau trosi GA4 a lansio recordiadau ar unwaith o ddefnyddwyr a adawodd fasgedi siopa ar gamau talu penodol.
Priodoli Refeniw & Archwilio Gellir archwilio trafodion e-fasnach gwerth uchel drwy adolygu’r union lwybrau cyrchwr, cliciau a chyflyrau maes gweld a arweiniodd at bryniant.
Dadfygio Technegol Cyflymach Gall timau peirianneg QA gysylltu digwyddiadau eithriad JavaScript GA4 neu logiau gwall API yn uniongyrchol â recordiadau sgrin gweledol, gan ddileu’r angen i ail-greu bygiau â llaw.
Datrys Cymorth Cwsmeriaid Mae tocynnau cymorth sy’n cynnwys IDs sesiynau defnyddwyr yn gadael i asiantau cymorth adolygu union ailchwarae sesiwn y cwsmer, gan leihau amseroedd datrys yn sylweddol.

3. Canllaw Ffurfweddu Google Tag Manager

I gasglu’r URL ailchwarae yn Google Tag Manager a’i lwybro i Google Analytics 4, rhaid ffurfweddu tri ased GTM ar wahân:

Cam 1: Creu Newidynnau Haen Ddata

Yng ngweithle GTM, ewch i Variables → User-Defined Variables a chreu dau newidyn o’r math Data Layer Variable:

  • Enw’r Newidyn: dlv - mp_session_id • Enw’r Newidyn Haen Ddata: mp_session_id
  • Enw’r Newidyn: dlv - mp_session_url • Enw’r Newidyn Haen Ddata: mp_session_url

Cam 2: Creu’r Sbardun Actifadu

Ewch i Triggers → New a dewiswch y math o sbardun Custom Event. Ffurfweddwch y paramedrau canlynol:

  • Enw’r Digwyddiad: mp_session_ready
  • Mae’r sbardun hwn yn tanio ar: All Custom Events

Cam 3: Ffurfweddu’r Tag Digwyddiad GA4

Crëwch dag newydd o’r math Google Analytics: GA4 Event i drosglwyddo dolen y sesiwn i’r wefan 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. Ffurfweddu Archwiliadau (Adroddiadau Personol) yn GA4

Ar ôl gosod y tag GTM, mae GA4 yn dechrau derbyn yr URL ailchwarae fel paramedr digwyddiad. I ddadansoddi’r data hwn mewn adroddiadau archwilio personol, rhaid cofrestru’r paramedr fel Dimensiwn Personol yn gyntaf.

Cofrestru Dimensiynau Personol yng Ngweinyddiaeth GA4

Yn rhyngwyneb Google Analytics 4, ewch i Admin → Data display → Custom definitions a chliciwch Create custom dimension:

  • Enw’r dimensiwn: MousePlayer Session URL
  • Cwmpas: Event (neu Session os yw wedi’i atodi at baramedrau cwmpas sesiwn)
  • Paramedr digwyddiad: mp_session_url

Adeiladu Archwiliad Arolygu Sesiynau

Yn adran Explore GA4, crëwch archwiliad Free form newydd i arolygu teithiau defnyddwyr unigol:

  • Rhesi: Ychwanegwch Event name, Transaction ID (ar gyfer e-fasnach), neu Landing page.
  • Colofnau / Dimensiynau: Cynhwyswch y dimensiwn personol newydd MousePlayer Session URL.
  • Gwerthoedd: Ychwanegwch Event count neu Total users.

Mae’r tabl adroddiad a gynhyrchir yn dangos URLs uniongyrchol y gellir eu clicio wrth ymyl metrigau GA4, gan alluogi symud ar unwaith o allanolion ystadegol i ailchwarae gweledol.

5. Integreiddio URLs Ailchwarae yn Adroddiadau Diofyn GA4

Yn ogystal ag Archwiliadau, gellir integreiddio dimensiynau personol i adroddiadau diofyn safonol GA4 (fel Traffic acquisition, Pages and screens, neu E-commerce purchases) drwy Lyfrgell Adroddiadau GA4.

Addasu Tablau Adroddiadau Safonol

  1. Yn GA4, agorwch unrhyw adroddiad manwl diofyn (e.e., Reports → Engagement → Pages and screens).
  2. Cliciwch eicon pensil Customize report yn y gornel dde uchaf (angen mynediad gweinyddol).
  3. Yn y panel ar y dde o dan Report Data, cliciwch Dimensions.
  4. Ychwanegwch MousePlayer Session URL at y rhestr dimensiynau cynradd neu eilaidd a’i osod yn weladwy.
  5. Cliciwch Save → Save changes to current report.

Ar ôl cadw, gall unrhyw ddadansoddwr sy’n adolygu tablau caffael neu drosi safonol ychwanegu MousePlayer Session URL fel dimensiwn eilaidd, gan alluogi arolygu gweledol ar unwaith o ymddygiad ymwelwyr ar draws segmentau traffig safonol.

6. Cyfeirnod Cydnawsedd API JavaScript & GA4 / GTM

Mae MousePlayer yn darparu API JavaScript greddfol sy’n gydnaws â GA4 (gan ddefnyddio gorchmynion safonol arddull gtag()) a gwrthrych byd-eang cyhoeddus (window.MousePlayer). Mae hyn yn gadael i ddatblygwyr ymholi URLs sesiynau yn y consol, atodi IDs cwsmeriaid B2B a mewnosod dolenni ailchwarae mewn desgiau cymorth neu dracwyr gwallau trydydd parti.

1. Mewnosod URL Ailchwarae’n Uniongyrchol (Intercom / Zendesk / Pontydd Personol)

Gallwch gael URL ailchwarae llawn sesiwn yr ymwelydd gweithredol yn uniongyrchol o gonsol y porwr neu unrhyw sgript bersonol gan ddefnyddio 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. Gosod IDs Cwsmeriaid B2B Personol (user_id)

I adnabod cwsmeriaid SaaS neu B2B sydd wedi mewngofnodi, gallwch drosglwyddo user_id personol (fel ID cronfa ddata, e-bost neu UUID) naill ai yn ystod ffurfweddu’r sgript i ddechrau neu’n ddeinamig wrth redeg gyda chystrawen 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. Dulliau Casglu Data Anghydamserol

Gallwch ddefnyddio cystrawen galw’n ôl GA4 safonol i gasglu metadata sesiwn yn anghydamserol mewn sgriptiau rheoli tagiau personol:

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

Mae pob nod masnach a enwir yma yn perthyn i’w berchennog priodol. Nid oes gan MousePlayer berthynas fusnes â’r darparwyr hyn.