Buundada GTM & Buundada dhacdooyinka GA4

Midaynta telemetry-ga tirooyinka ee Google Analytics 4 iyo dib-u-ciyaarista fadhiyada ee tayada leh ee MousePlayer iyadoo la adeegsanayo isku-waafajin dataLayer oo labada jiho ah iyo API-yo GA4 la jaanqaada.

1. Dulmarka qaab-dhismeedka & awoodaha

Falanqaynta webka ee casriga ahi badanaa waxay la kulantaa xog si aasaasi ah u kala go'doonsan: madallada tirooyinka (sida Google Analytics 4) waxay soo sheegaan waxa websayt ku dhacay, halka qalabka dib-u-ciyaarista fadhiyada ee tayada ahi sharxaan sababta uu u dhacay. Buundada MousePlayer GTM & GA4 waxay meesha ka saartaa farqigaas iyadoo samaysa kanaal isku-waafajin labada jiho ah gudaha deegaanka JavaScript ee biraawsarka.

Marka la hawlgeliyo, iskribtiga dabagalku wuxuu bilaabaa laba module oo aasaasi ah oo gaar ah:

  • Dhoofiyaha dib-u-ciyaarista fadhiga (initGa4SessionBridge): Wuxuu si otomaatig ah ugu diraa aqoonsiga fadhiga duubista ee firfircoon (mp_session_id) iyo URL dib-u-ciyaaris toos ah (mp_session_url) lakabka xogta ee websaytka isla marka fadhiga la sameeyo.
  • Soo-dejiyaha dhacdooyinka GA4 (initDataLayerBridge): Wuxuu array-ga lakabka xogta ku lifaaqaa dhegayste aan wax burburin. Dhacdo kasta oo ganacsi elektaroonig ah ama habdhaqan oo gaar ah oo GA4 loo diro waxaa isla markiiba dhacdo gaar ah ahaan loogu nuqulaa kaydka falanqaynta MousePlayer (ce), iyadoo dhammaan halbeegyada tirooyinka iyo qoraalka ah ku jiraan.

Taageerada walax dataLayer oo gaar ah: Haddii app web ahi adeegsado magac array JavaScript oo gaar ah halkii kan caadiga ah ee dataLayer (tusaale, xyzDataLayer), matoorku si firfircoon ayuu ula qabsadaa halbeegga la dejiyay ee gtm_datalayer_name iyada oo aan loo baahnayn beddelidda koodhka ee gacanta.

2. Qiimaha istaraatiijiyadeed ee ganacsiga

Ku dhexgelinta xiriirrada dib-u-ciyaarista fadhiga si toos ah marinnada falanqaynta shirkaddu waxay bixisaa dhowr faa'iido hawlgal oo saamayn weyn leh:

Awoodda ganacsiga Saamaynta hawlgalka
Hagaajinta heerka beddelashada (CRO) Waxay falanqeeyayaasha dijitaalka u oggolaanaysaa inay aqoonsadaan caqabadaha funnels-ka beddelashada GA4 oo ay isla markiiba furaan duubisyada isticmaalayaasha dambiilaha kaga tagay tallaabooyin checkout oo gaar ah.
U-qoondeynta dakhliga & hubinta Wax-iibsiyada ganacsiga elektaroonigga ah ee qiimaha sare leh waxaa lagu hubin karaa dib-u-eegista waddooyinka saxda ah ee tilmaamaha, gujinnada iyo xaaladaha aagga muuqda ee horseeday iibsashada.
Baaritaan cilad farsamo oo degdeg ah Kooxaha injineernimada QA waxay dhacdooyinka khaladaadka JavaScript ee GA4 ama diiwaannada khaladaadka API si toos ah ugu xiriirin karaan duubisyada muuqaalka shaashadda, taas oo meesha ka saaraysa baahida dib-u-soo-saaridda khaladaadka ee gacanta.
Xallinta taageerada macaamiisha Tickets taageero oo wata ID-yada fadhiyada isticmaalaha waxay wakiillada taageerada u oggolaanayaan inay dib u eegaan dib-u-ciyaarista saxda ah ee fadhiga macmiilka, si weynna u gaabiyaan waqtiga xallinta.

3. Hagaha dejinta Google Tag Manager

Si URL-ka dib-u-ciyaarista loogu qabto Google Tag Manager looguna sii mariyo Google Analytics 4, saddex agab GTM oo kala duwan ayaa la dejinayaa:

Tallaabada 1: abuur doorsoomayaasha lakabka xogta

Goobta shaqada GTM, tag Doorsoomayaasha → Doorsoomayaasha isticmaaluhu qeexay oo abuur laba doorsoome oo noocoodu yahay Doorsoome lakabka xogta:

  • Magaca doorsoomaha: dlv - mp_session_id • Magaca doorsoomaha lakabka xogta: mp_session_id
  • Magaca doorsoomaha: dlv - mp_session_url • Magaca doorsoomaha lakabka xogta: mp_session_url

Tallaabada 2: abuur kiciyaha hawlgelinta

Tag Kiciyeyaasha → Cusub oo dooro nooca kiciyaha Dhacdo gaar ah. Deji halbeegyada soo socda:

  • Magaca dhacdada: mp_session_ready
  • Kiciyahani wuxuu ka shaqeeyaa: Dhammaan dhacdooyinka gaarka ah

Tallaabada 3: deji tag-ga dhacdada GA4

Abuur tag cusub oo noociisu yahay Google Analytics: Dhacdada GA4 si xiriirka fadhiga loogu gudbiyo GA4 property:

# 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. Dejinta Sahaminnada (warbixinnada gaarka ah) ee GA4

Marka tag-ga GTM la hawlgeliyo, GA4 wuxuu bilaabaa inuu URL-ka dib-u-ciyaarista u helo halbeeg dhacdo ahaan. Si xogtan loogu falanqeeyo warbixinnada sahaminta gaarka ah, halbeegga waa in marka hore loo diiwaangeliyo Custom Dimension ahaan.

Diiwaangelinta cabbirrada gaarka ah ee GA4 Admin

Muuqaalka Google Analytics 4, tag Maamul → Muujinta xogta → Qeexitaannada gaarka ah oo guji Abuur cabbir gaar ah:

  • Magaca cabbirka: MousePlayer Session URL
  • Baaxad: Dhacdo (ama Fadhi haddii lagu lifaaqay halbeegyo fadhi khuseeya)
  • Halbeegga dhacdada: mp_session_url

Dhisidda sahaminta baaritaanka fadhiga

Qaybta Sahami ee GA4, ka abuur sahamin cusub oo Qaab xor ah si aad u baarto safarrada isticmaalayaasha gaarka ah:

  • Safaf: Ku dar Event name, Transaction ID (ganacsiga elektaroonigga ah), ama Landing page.
  • Tiirar / Cabbirro: Ku dar cabbirka gaarka ah ee cusub ee la abuuray MousePlayer Session URL.
  • Qiimayaal: Ku dar Event count ama Total users.

Jadwalka warbixinta la soo saaray wuxuu muujinayaa URL-yo toos loo gujin karo oo la socda cabbirrada GA4, taas oo suurtagelinaysa in isla markiiba laga gudbo waxyaabaha tirakoob ahaan ka duwan loona gudbo dib-u-ciyaaris muuqaal ah.

5. Ku dhexgelinta URL-yada dib-u-ciyaarista warbixinnada caadiga ah ee GA4

Sahaminnada ka sokow, cabbirrada gaarka ah waxaa lagu dhexgelin karaa warbixinnada caadiga ah ee GA4 (sida Soo-jiidashada taraafikada, Bogagga iyo shaashadaha, ama Iibsashooyinka ganacsiga elektaroonigga ah) iyadoo la adeegsanayo Maktabadda Warbixinnada GA4.

Wax-ka-beddelidda jadwallada warbixinta caadiga ah

  1. Gudaha GA4, fur warbixin faahfaahsan oo caadi ah (tusaale, Warbixinnada → Ka-qaybgalka → Bogagga iyo shaashadaha).
  2. Guji astaanta qalinka Habbee warbixinta ee geeska midig ee kore (gelitaan maamul ayaa loo baahan yahay).
  3. Dhinaca midig hoosta Xogta warbixinta, guji Cabbirrada.
  4. Ku dar MousePlayer Session URL liiska cabbirrada koowaad ama labaad oo ka dhig mid muuqda.
  5. Guji Kaydi → Kaydi isbeddellada warbixinta hadda.

Marka la kaydiyo, falanqeeye kasta oo dib u eegaya jadwallada soo-jiidashada ama beddelashada ee caadiga ah wuxuu ku dari karaa MousePlayer Session URL cabbir labaad ahaan, si uu isla markiiba muuqaal ahaan u baaro habdhaqanka booqdayaasha ee qaybaha taraafikada caadiga ah.

6. Tixraaca waafaqsanaanta JavaScript API & GA4 / GTM

MousePlayer wuxuu bixiyaa JavaScript API dareen-gal ah oo GA4 la jaanqaada (isagoo adeegsada amarro caadi ah oo qaabka gtag() ah) iyo walax caalami ah oo dadweyne (window.MousePlayer). Tani waxay horumariyeyaasha u oggolaanaysaa inay URL-yada fadhiga ku weydiiyaan console, ku lifaaqaan ID-yada macaamiisha B2B oo xiriirrada dib-u-ciyaarista ku daraan helpdesks ama dabagalayaasha khaladaadka ee dhinac saddexaad.

1. Ku-daridda tooska ah ee URL-ka dib-u-ciyaarista (Intercom / Zendesk / Buundooyin gaar ah)

Waxaad URL-ka dib-u-ciyaarista oo buuxa ee fadhiga booqdaha firfircoon si toos ah uga heli kartaa console-ka biraawsarka ama iskribti gaar ah adigoo adeegsanaya 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. Dejinta ID-yada macaamiisha B2B ee gaarka ah (user_id)

Si aad u aqoonsato macaamiisha SaaS ama B2B ee galay, waxaad gudbin kartaa aqoonsi gaar ah oo user_id ah (sida ID kayd xogeed, iimayl ama UUID) inta la dejinayo iskribtiga bilowgiisa ama si firfircoon xilliga uu socdo adigoo adeegsanaya qaabka 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. Hababka soo-qaadashada xogta ee asynchronous

Waxaad adeegsan kartaa qaabka callback ee caadiga ah ee GA4 si aad metadata fadhiga si asynchronous ah uga soo qaadato gudaha iskribtiyada maareynta tags ee gaarka ah:

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

Dhammaan calaamadaha ganacsi ee halkan lagu magacaabay waxaa leh milkiilayaashooda. MousePlayer xiriir ganacsi lama laha bixiyeyaashan.