Uqhagamshelo lweGTM & lweziganeko zeGA4

Ukudibanisa idatha yamanani yeGoogle Analytics 4 nokurekhodwa kweeseshoni zeMousePlayer ezichaza indlela yokusebenzisa, ngokungqamanisa i-dataLayer kumacala omabini nee-API ezihambelana ne-GA4.

1. Isishwankathelo solwakhiwo & amandla

Uhlalutyo lwewebhu lwanamhlanje ludla ngokwahlula idatha: amaqonga amanani (afana neGoogle Analytics 4) axela okwenzekileyo kwiwebhusayithi, ngoxa izixhobo zokudlala kwakhona iiseshoni zichaza isizathu soko. Uqhagamshelo lwe MousePlayer GTM & GA4 luvala esi sikhewu ngokwenza ijelo lokungqamanisa kumacala omabini ngaphakathi kwendawo yokuqhuba iJavaScript yesikhangeli.

Xa luvuliwe, isikripthi sokulandelela siqalisa iimodyuli ezimbini ezisisiseko:

  • Umkhupheli wokurekhodwa kweeseshoni (initGa4SessionBridge): Uthumela ngokuzenzekelayo isichongi seseshoni yokurekhoda esebenzayo (mp_session_id) ne-URL yokudlala ngqo (mp_session_url) kwi-data layer yewebhusayithi kwakamsinya nje ukuba iseshoni yenziwe.
  • Umamkeli weziganeko zeGA4 (initDataLayerBridge): Uqhoboshela isimameli esingonakalisi nto kwi-array ye-data layer. Nasiphi na isiganeko se-e-commerce okanye sokuziphatha esenzelwe wena nesithunyelwa kwi-GA4 sikhutshelwa ngoko nangoko kwisiseko sedatha sohlalutyo lweMousePlayer njengesiganeko esenzelwe wena (ce), kuquka zonke iiparamitha zamanani nezombhalo.

Inkxaso yento ye-dataLayer enegama elenzelwe wena: Ukuba isicelo sewebhu sisebenzisa igama le-array yeJavaScript elenzelwe sona endaweni yeliqhelekileyo elithi dataLayer (umzekelo, xyzDataLayer), inkqubo iyaziqhelanisa ngokuguquguqukayo neparamitha esetiweyo ethi gtm_datalayer_name ngaphandle kokufuna ukutshintshwa kwekhowudi ngesandla.

2. Ixabiso elibalulekileyo kwishishini

Ukudibanisa amakhonkco okurekhodwa kweeseshoni ngqo kwiinkqubo zohlalutyo zeshishini kunika izibonelelo ezininzi ezibalulekileyo:

Amandla eshishini Impembelelo ekusebenzeni
Ukuphucula umlinganiselo woguquko (CRO) Kuvumela abahlalutyi bedijithali ukuba bachonge imiqobo kwiifaneli zoguquko zeGA4 baze bavule ngoko nangoko ukurekhoda kwabasebenzisi abashiye iinqwelo zokuthenga kumanyathelo athile okuhlawula.
Ukunxulumanisa ingeniso & nophicotho Iintengiselwano ze-e-commerce zexabiso eliphezulu zinokuphicothwa ngokujonga iindlela ezichanekileyo zesalathisi, ukucofa neemeko zendawo ebonwayo ezikhokelele ekuthengeni.
Ukufumana iimpazamo zobugcisa ngokukhawuleza Amaqela obunjineli ovavanyo anganxulumanisa iziganeko zeempazamo zeJavaScript zeGA4 okanye iilog zeempazamo ze-API ngqo nokurekhodwa kwesikrini, kupheliswe imfuneko yokuphinda kuveliswe iimpazamo ngesandla.
Ukusombulula uncedo lwabathengi Amatikiti oncedo anezichongi zeeseshoni zomsebenzisi avumela abasebenzi boncedo ukuba bajonge ukurekhodwa kanye kweseshoni yomthengi, anciphise kakhulu ixesha lokusombulula.

3. Isikhokelo sokuseta iGoogle Tag Manager

Ukuze ufumane i-URL yokudlala kwakhona ngaphakathi kweGoogle Tag Manager uze uyithumele kwiGoogle Analytics 4, kufuneka kusetwe izinto ezintathu ezahlukileyo zeGTM:

Inyathelo 1: yenza iivariyebheli ze-data layer

Kwindawo yokusebenza yeGTM, yiya ku Variables → User-Defined Variables uze wenze iivariyebheli ezimbini zohlobo oluthi Data Layer Variable:

  • Igama levariyebheli: dlv - mp_session_id • Igama levariyebheli ye-data layer: mp_session_id
  • Igama levariyebheli: dlv - mp_session_url • Igama levariyebheli ye-data layer: mp_session_url

Inyathelo 2: yenza into yokuqalisa

Yiya ku Triggers → New uze ukhethe uhlobo lwento yokuqalisa oluthi Custom Event. Seta ezi paramitha zilandelayo:

  • Igama lesiganeko: mp_session_ready
  • Le nto yokuqalisa isebenza ku: All Custom Events

Inyathelo 3: seta ithegi yesiganeko seGA4

Yenza ithegi entsha yohlobo oluthi Google Analytics: GA4 Event ukuze uthumele ikhonkco leseshoni kwipropathi yeGA4:

# 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. Ukuseta uphononongo (iingxelo ezenzelwe wena) kwiGA4

Xa ithegi yeGTM ifakiwe, iGA4 iqalisa ukufumana i-URL yokudlala njengeparamitha yesiganeko. Ukuhlalutya le datha kwiingxelo zophononongo ezenzelwe wena, iparamitha kufuneka kuqala ibhaliswe njenge-Custom Dimension.

Ukubhalisa i-Custom Dimensions kulawulo lweGA4

Kujongano lweGoogle Analytics 4, yiya ku Admin → Data display → Custom definitions uze ucofe Create custom dimension:

  • Igama lomlinganiselo: MousePlayer Session URL
  • Umda: Event (okanye Session ukuba iqhotyoshelwe kwiiparamitha ezinomda weseshoni)
  • Iparamitha yesiganeko: mp_session_url

Ukwenza uphononongo lokujonga iiseshoni

Kwicandelo elithi Explore leGA4, yenza uphononongo olutsha lohlobo oluthi Free form ukuze ujonge iindlela zabasebenzisi ngabanye:

  • Imiqolo: Yongeza Event name, Transaction ID (kwi-e-commerce), okanye Landing page.
  • Iikholam / imilinganiselo: Bandakanya umlinganiselo owenziwe ngokutsha othi MousePlayer Session URL.
  • Amaxabiso: Yongeza Event count okanye Total users.

Itheyibhile yengxelo eyenziweyo ibonisa ii-URL ezicofekayo ngqo ecaleni kweemetriki zeGA4, ivumele ukusuka kwiziphumo ezingaqhelekanga zamanani ukuya kukurekhoda ngoko nangoko.

5. Ukudibanisa ii-URL zokudlala kwakhona kwiingxelo eziqhelekileyo zeGA4

Ukongeza kuphononongo, imilinganiselo eyenzelwe wena ingadityaniswa kwiingxelo eziqhelekileyo zeGA4 (ezifana ne Traffic acquisition, Pages and screens, okanye E-commerce purchases) kusetyenziswa iGA4 Report Library.

Ukutshintsha iitheyibhile zeengxelo eziqhelekileyo

  1. KwiGA4, vula nayiphi na ingxelo eneenkcukacha eqhelekileyo (umzekelo, Reports → Engagement → Pages and screens).
  2. Cofa uphawu lwepensile oluthi Customize report kwikona ephezulu ngasekunene (kufuneka ufikelelo lomlawuli).
  3. Kwiphaneli engasekunene phantsi kwe Report Data, cofa Dimensions.
  4. Yongeza MousePlayer Session URL kuluhlu lwemilinganiselo ephambili okanye eyesibini uze uyimise ibonakale.
  5. Cofa Save → Save changes to current report.

Xa igciniwe, nawuphi na umhlalutyi ojonga iitheyibhile eziqhelekileyo zokufumana abasebenzisi okanye zoguquko unokongeza MousePlayer Session URL njengomlinganiselo wesibini, avumele ukujonga ngoko nangoko indlela iindwendwe eziziphatha ngayo kumaqela aqhelekileyo otyelelo.

6. Isalathiso sokuhambelana kweJavaScript API & neGA4 / GTM

IMousePlayer inika iJavaScript API elula, ehambelana neGA4 (isebenzisa imiyalelo yohlobo lwe gtag()) nento yehlabathi evulelekileyo (window.MousePlayer). Oku kuvumela abaphuhlisi ukuba babuze ii-URL zeeseshoni kwikhonsoli, baqhoboshele izichongi zabathengi beB2B baze bafake amakhonkco okurekhoda kwiinkqubo zoncedo okanye zokulandelela iimpazamo zabanye.

1. Ukufaka i-URL yokudlala ngqo (Intercom / Zendesk / uqhagamshelo olwenzelwe wena)

Ungafumana i-URL epheleleyo yokudlala yeseshoni yondwendwe esebenzayo ngqo kwikhonsoli yesikhangeli okanye kuso nasiphi na isikripthi esenzelwe wena 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. Ukuseta izichongi zabathengi beB2B ezenzelwe wena (user_id)

Ukuchonga abathengi beSaaS okanye beB2B abangene kwiakhawunti, ungadlulisa isichongi esenzelwe wena esithi user_id (njengesichongi sesiseko sedatha, imeyile okanye i-UUID) xa useta isikripthi ekuqaleni okanye ngokuguquguqukayo xa sisebenza usebenzisa indlela yokubhala yeGA4:

// 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. Iindlela zokufumana idatha ngokuzimeleyo

Ungasebenzisa indlela eqhelekileyo yeGA4 yokubuyisela ubizo ukuze ufumane imethadatha yeseshoni ngokuzimeleyo ngaphakathi kwezikripthi zolawulo lweethegi ezenzelwe wena:

// 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 iimpawu zorhwebo ezikhankanywe apha zezabanini bazo. IMousePlayer ayinabudlelwane bezoshishino naba baboneleli.