Ibhuloho le-GTM & ibhuloho lezehlakalo ze-GA4

Ukuhlanganisa i-telemetry yezinombolo ye-Google Analytics 4 nokudlala kabusha kwamaseshini okuchazayo kwe-MousePlayer ngokuvumelanisa i-dataLayer nhlangothi zombili nama-API ahambisana ne-GA4.

1. Ukubuka konke kokwakheka & amandla

Ukuhlaziya iwebhu kwesimanje kuvame ukuba nenkinga eyisisekelo yokuhlukaniswa kwedatha: izinkundla zezinombolo (njenge-Google Analytics 4) zibika okwenzekile kuwebhusayithi, kanti amathuluzi achazayo okudlala kabusha amaseshini achaza ukuthi kungani kwenzekile. Ibhuloho elithi MousePlayer GTM & GA4 Bridge livala lesi sikhala ngokwakha isiteshi sokuvumelanisa nhlangothi zombili endaweni yokusebenza ye-JavaScript yesiphequluli.

Lapho kuvuliwe, umbhalo wohlelo wokulandelela uqalisa amamojuli amabili ayinhloko azinikele:

  • Ithekelisi lokudlala kabusha kweseshini (initGa4SessionBridge): Lithumela ngokuzenzakalela isihlonzi seseshini yokurekhoda esebenzayo (mp_session_id) ne-URL eqondile yokudlala (mp_session_url) kungqimba yedatha yewebhusayithi lapho iseshini isungulwa.
  • Isamukeli sezehlakalo ze-GA4 (initDataLayerBridge): Sinamathisela isilaleli esingaphazamisi ohlwini longqimba yedatha. Noma yisiphi isehlakalo sangokwezifiso sokuhweba nge-inthanethi noma sokuziphatha esithunyelwa ku-GA4 sifakwa ngokushesha kusizindalwazi sokuhlaziya se-MousePlayer njengesehlakalo sangokwezifiso (ce), kuhlanganise nawo wonke amapharamitha ezinombolo nawombhalo.

Ukusekelwa kwento ye-dataLayer yangokwezifiso: Uma uhlelo lwewebhu lusebenzisa igama lohlu lwe-JavaScript langokwezifiso esikhundleni selijwayelekile elithi dataLayer (isibonelo, xyzDataLayer), injini ivumelana ngokuzenzakalela nepharamitha esethiwe ethi gtm_datalayer_name ngaphandle kokudinga ukushintsha ikhodi ngesandla.

2. Inani lamasu ebhizinisi

Ukuhlanganisa izixhumanisi zokudlala kabusha kwamaseshini ngokuqondile ezindleleni zokuhlaziya zebhizinisi kunikeza izinzuzo eziningana ezinomthelela omkhulu ekusebenzeni:

Amandla ebhizinisi Umthelela ekusebenzeni
Ukuthuthukisa izinga lokuguqula (CRO) Kuvumela abahlaziyi bedijithali ukuthi bathole izindawo zezithiyo kumafaneli okuguqula e-GA4 bese bevula ngokushesha okurekhodiwe kwabasebenzisi abashiye izinqola zokuthenga ezinyathelweni ezithile zokukhokha.
Ukwabela imali engenayo & ukuyicwaninga Ukuthengiselana kokuhweba nge-inthanethi kwamanani amakhulu kungacwaningwa ngokubuyekeza izindlela zesikhombisi, ukuchofoza nezimo zendawo ebonakalayo eziholele ekuthengeni.
Ukulungisa amaphutha ezobuchwepheshe ngokushesha Amaqembu onjiniyela be-QA angahlobanisa izehlakalo zokuhlukile kwe-JavaScript ze-GA4 noma amalogi amaphutha e-API ngokuqondile nokurekhodiwe kwesikrini okubonakalayo, kususwe isidingo sokuphinda amaphutha ngesandla.
Ukuxazulula izicelo zosizo lwamakhasimende Amathikithi osizo anama-ID eseshini yomsebenzisi avumela abenzeli bosizo ukuthi babuyekeze ukudlala kabusha kweseshini yekhasimende ngokuqondile, kunciphe kakhulu isikhathi sokuxazulula.

3. Umhlahlandlela wokusetha i-Google Tag Manager

Ukuze uqoqe i-URL yokudlala kabusha ngaphakathi kwe-Google Tag Manager uyithumele ku-Google Analytics 4, kufanele kusethwe izinto ezintathu ezihlukene ze-GTM:

Isinyathelo 1: dala okuguquguqukayo kongqimba yedatha

Endaweni yokusebenzela ye-GTM, iya kokuthi Okuguquguqukayo → Okuguquguqukayo okuchazwe ngumsebenzisi bese udala okuguquguqukayo okubili kohlobo oluthi Okuguquguqukayo kongqimba yedatha:

  • Igama lokuguquguqukayo: dlv - mp_session_id • Igama lokuguquguqukayo kongqimba yedatha: mp_session_id
  • Igama lokuguquguqukayo: dlv - mp_session_url • Igama lokuguquguqukayo kongqimba yedatha: mp_session_url

Isinyathelo 2: dala isiqalisi sokuvula

Iya kokuthi Iziqalisi → Okusha bese ukhetha uhlobo lwesiqalisi oluthi Isehlakalo sangokwezifiso. Setha amapharamitha alandelayo:

  • Igama lesehlakalo: mp_session_ready
  • Lesi siqalisi sisebenza kulokhu: Zonke izehlakalo zangokwezifiso

Isinyathelo 3: setha ithegi yesehlakalo se-GA4

Dala ithegi entsha yohlobo oluthi Google Analytics: Isehlakalo se-GA4 ukuze uthumele isixhumanisi seseshini kusayithi le-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. Ukusetha ukuhlola (imibiko yangokwezifiso) ku-GA4

Lapho ithegi ye-GTM isifakiwe, i-GA4 iqala ukwamukela i-URL yokudlala njengepharamitha yesehlakalo. Ukuze uhlaziye le datha emibikweni yokuhlola yangokwezifiso, ipharamitha kufanele iqale ibhaliswe njengohlobo lwedatha langokwezifiso.

Ukubhalisa izinhlobo zedatha zangokwezifiso ku-GA4 Admin

Kusixhumi esibonakalayo se-Google Analytics 4, iya kokuthi Umphathi → Ukuboniswa kwedatha → Izincazelo zangokwezifiso bese uchofoza Dala uhlobo lwedatha langokwezifiso:

  • Igama lohlobo lwedatha: MousePlayer Session URL
  • Ububanzi: Isehlakalo (noma Iseshini uma kunamathiselwe kumapharamitha obubanzi beseshini)
  • Ipharamitha yesehlakalo: mp_session_url

Ukwakha ukuhlola kokuhlola iseshini

Esigabeni esithi Hlola se-GA4, dala ukuhlola okusha kohlobo oluthi Ifomu elikhululekile ukuze uhlole izindlela zomsebenzisi ngamunye:

  • Imigqa: Faka Event name, Transaction ID (kokuhweba nge-inthanethi), noma Landing page.
  • Amakholomu / Izinhlobo zedatha: Faka uhlobo lwedatha langokwezifiso olusanda kudalwa oluthi MousePlayer Session URL.
  • Amanani: Faka Event count noma Total users.

Ithebula lombiko elikhiqiziwe libonisa ama-URL achofozekayo aqondile eduze kwamamethrikhi e-GA4, okuvumela ukusuka ngokushesha ezibalweni ezingajwayelekile uye ekudlalweni kabusha okubonakalayo.

5. Ukuhlanganisa ama-URL okudlala kabusha emibikweni ezenzakalelayo ye-GA4

Ngaphezu kokuhlola, izinhlobo zedatha zangokwezifiso zingahlanganiswa emibikweni ezenzakalelayo evamile ye-GA4 (njengokuthi Ukutholwa kwethrafikhi, Amakhasi nezikrini, noma Ukuthenga kwe-inthanethi) kusetshenziswa umtapo wemibiko ye-GA4.

Ukushintsha amathebula emibiko ejwayelekile

  1. Ku-GA4, vula noma yimuphi umbiko onemininingwane ozenzakalelayo (isib. Imibiko → Ukuzibandakanya → Amakhasi nezikrini).
  2. Chofoza isithonjana sepensela esithi Enza umbiko ngokwezifiso ekhoneni eliphezulu kwesokudla (kudingeka ukufinyelela komphathi).
  3. Ephanelini elingakwesokudla ngaphansi kokuthi Idatha yombiko, chofoza Izinhlobo zedatha.
  4. Faka MousePlayer Session URL ohlwini lohlobo lwedatha oluyinhloko noma lwesibili bese ulusetha lubonakale.
  5. Chofoza Gcina → Gcina izinguquko embikweni wamanje.

Ngemva kokugcina, noma yimuphi umhlaziyi obuyekeza amathebula ajwayelekile okutholwa kwezivakashi noma okuguqula angafaka MousePlayer Session URL njengohlobo lwedatha lwesibili, okuvumela ukuhlola ngokubona ukuziphatha kwezivakashi ngokushesha kuzo zonke izingxenye zethrafikhi ezijwayelekile.

6. Ireferensi yokuhambisana kwe-JavaScript API & i-GA4 / GTM

I-MousePlayer inikeza i-JavaScript API esebenziseka kalula nehambisana ne-GA4 (isebenzisa imiyalo evamile yohlobo lwe- gtag()) nento yomhlaba wonke yomphakathi (window.MousePlayer). Lokhu kuvumela onjiniyela ukubuza ama-URL eseshini kukhonsoli, ukunamathisela ama-ID amakhasimende e-B2B nokufaka izixhumanisi zokudlala kabusha emadeskini osizo noma kuzilandeleli zamaphutha zabanye.

1. Ukufaka i-URL yokudlala kabusha ngokuqondile (Intercom / Zendesk / amabhuloho angokwezifiso)

Ungathola i-URL ephelele yokudlala yeseshini yesivakashi esebenzayo ngokuqondile kukhonsoli yesiphequluli noma kunoma yimuphi umbhalo wohlelo wangokwezifiso usebenzisa 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. Ukusetha ama-ID amakhasimende e-B2B angokwezifiso (user_id)

Ukuze uhlonze amakhasimende e-SaaS noma e-B2B angenile, ungadlulisa isihlonzi sangokwezifiso esithi user_id (njenge-ID yesizindalwazi, i-imeyili noma i-UUID) ngesikhathi sokusetha kokuqala kombhalo wohlelo noma ngokuguqukayo ngesikhathi sokusebenza usebenzisa indlela yokubhala ye-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. Izindlela zokulanda idatha ngokuzimela

Ungasebenzisa indlela evamile ye-GA4 yokubiza okubuyayo ukuze ulande imethadatha yeseshini ngokuzimela ngaphakathi kwemibhalo yohlelo yangokwezifiso yokuphatha amathegi:

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

Zonke izimpawu zokuhweba ezishiwo lapha zingezabanikazi bazo. I-MousePlayer ayinabo ubudlelwano bebhizinisi nalaba bahlinzeki.