GTM köprüsi & GA4 waka köprüsi

Iki ugurly dataLayer sinhronlaşmasy we GA4 bilen utgaşykly API-ler arkaly sanlaýyn Google Analytics 4 telemetriýasyny hil taýdan MousePlayer sessiýa ýazgylary bilen birleşdirmek.

1. Arhitektura syny & mümkinçilikler

Häzirki zaman web seljermesinde köplenç esasy maglumat bölünişigi bolýar: sanlaýyn platformalar (Google Analytics 4 ýaly) websaýtda näme bolandygyny habar berýär, sessiýa ýazgy gurallary bolsa onuň sebäbini düşündirýär. MousePlayer GTM & GA4 köprüsi brauzeriň JavaScript işleýiş gurşawynda iki ugurly sinhronlaşma kanalyny döredip, bu boşlugy aýyrýar.

Işjeňleşdirilende yzarlama skripti iki ýörite esasy moduly başlatýar:

  • Sessiýa ýazgy eksport edijisi (initGa4SessionBridge): Sessiýa döredilen badyna işjeň ýazgy sessiýasynyň kesgitleýjisini (mp_session_id) we göni görkeziliş URL-sini (mp_session_url) websaýtyň maglumat gatlagyna awtomatik iberýär.
  • GA4 waka kabul edijisi (initDataLayerBridge): Maglumat gatlagynyň massiwine ony bozmaýan diňleýji goşýar. GA4 üçin iberilen islendik ýörite elektron söwda ýa-da häsiýet wakasy dessine ähli san we tekst parametrleri bilen MousePlayer seljeriş bazasynda ýörite waka (ce) hökmünde gaýtalanýar.

Ýörite dataLayer obýektiniň goldawy: Web programmasy adaty dataLayer ýerine (mysal üçin xyzDataLayer) ýörite JavaScript massiw adyny ulanýan bolsa, hereketlendiriji düzülen gtm_datalayer_name parametrine kody el bilen üýtgetmezden dinamiki uýgunlaşýar.

2. Strategik işewürlik gymmaty

Sessiýa ýazgy baglanyşyklaryny göni kärhana seljeriş akymlaryna goşmak birnäçe güýçli amaly artykmaçlyk berýär:

Işewürlik mümkinçiligi Amaly täsir
Konwersiýa derejesini optimallaşdyrmak (CRO) Sanly seljerijilere GA4 konwersiýa guýguçlarynda päsgelçilik nokatlaryny tapmaga we belli töleg ädimlerinde sebedi taşlan ulanyjylaryň ýazgylaryny dessine açmaga mümkinçilik berýär.
Girdejini baglanyşdyrmak & barlag Ýokary bahaly elektron söwda amallaryny satyn alyşa getiren takyk görkeziji ýollaryna, basyşlara we görünýän meýdan ýagdaýlaryna seretmek arkaly barlap bolýar.
Tehniki näsazlygy has çalt tapmak QA inženerçilik toparlary GA4 JavaScript kadadan çykma wakalaryny ýa-da API ýalňyşlyk gündeliklerini göni görünýän ekran ýazgylary bilen baglap, näsazlyklary el bilen gaýtalamak zerurlygyny aýryp biler.
Müşderi goldawynda çözgüt Ulanyjy sessiýa ID-lerini saklaýan goldaw biletleri agentlere müşderiniň takyk sessiýa ýazgysyny görmäge mümkinçilik berip, çözgüt wagtyny ep-esli azaldýar.

3. Google Tag Manager sazlama gollanmasy

Ýazgy URL-sini Google Tag Manager içinde almak we Google Analytics 4-e ugrukdyrmak üçin üç aýratyn GTM bölegi düzülmeli:

1-nji ädim: maglumat gatlagynyň üýtgeýjilerini döretmek

GTM iş meýdançasynda şu ýere geçiň: Üýtgeýjiler → Ulanyjy kesgitlän üýtgeýjiler we şu görnüşli iki üýtgeýji dörediň: Maglumat gatlagynyň üýtgeýjisi:

  • Üýtgeýjiniň ady: dlv - mp_session_id • Maglumat gatlagyndaky üýtgeýjiniň ady: mp_session_id
  • Üýtgeýjiniň ady: dlv - mp_session_url • Maglumat gatlagyndaky üýtgeýjiniň ady: mp_session_url

2-nji ädim: işjeňleşdiriji döretmek

Şu ýere geçiň: Işe girizijiler → Täze we şu görnüşi saýlaň: Ýörite waka. Aşakdaky parametrleri düzüň:

  • Wakanyň ady: mp_session_ready
  • Bu işe giriziji şu ýerde işleýär: Ähli ýörite wakalar

3-nji ädim: GA4 waka tegini düzmek

Şu görnüşli täze teg dörediň: Google Analytics: GA4 wakasy , sessiýa baglanyşygyny GA4 emlägine ibermek üçin:

# 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. GA4-de gözlegleri (ýörite hasabatlary) düzmek

GTM tegi ýerleşdirilenden soň, GA4 görkeziliş URL-sini waka parametri hökmünde alyp başlaýar. Maglumaty ýörite gözleg hasabatlarynda seljermek üçin parametr ilki ýörite ölçeg hökmünde bellige alynmaly.

GA4 Admin-de ýörite ölçegleri bellige almak

Google Analytics 4 interfeýsinde şu ýere geçiň: Admin → Maglumat görkezilişi → Ýörite kesgitlemeler we şuňa basyň: Ýörite ölçeg döretmek:

  • Ölçegiň ady: MousePlayer Session URL
  • Ulanyş çägi: Waka (ýa-da Sessiýa , sessiýa çäkli parametrlere goşulan bolsa)
  • Waka parametri: mp_session_url

Sessiýa barlag gözlegini gurmak

GA4-iň Gözlemek bölüminde täze Erkin görnüş gözlegini döredip, aýry ulanyjy ýollaryny barlaň:

  • Setirler: Şuny goşuň: Event name, Transaction ID (elektron söwda üçin) ýa-da Landing page.
  • Sütünler / ölçegler: Täze döredilen ýörite ölçegi goşuň: MousePlayer Session URL.
  • Bahalar: Şuny goşuň: Event count ýa-da Total users.

Döredilen hasabat tablisasy GA4 görkezijileriniň ýanynda göni basylýan URL-leri görkezýär, şeýdip statistiki üýtgeşiklerden görünýän ýazgylara dessine geçip bolýar.

5. Ýazgy URL-lerini GA4 adaty hasabatlaryna goşmak

Gözleglerden başga-da, ýörite ölçegleri GA4 Hasabat kitaphanasy arkaly adaty GA4 hasabatlaryna (mysal üçin Trafik çekmek, Sahypalar we ekranlar ýa-da Elektron söwda satyn alyşlary) goşup bolýar.

Adaty hasabat tablisalaryny üýtgetmek

  1. GA4-de islendik adaty jikme-jik hasabaty açyň (mysal üçin Hasabatlar → Gatnaşyk → Sahypalar we ekranlar).
  2. Ýokarky sag burçdaky Hasabaty sazlamak galam nyşanyna basyň (administrator girişi gerek).
  3. Sagdaky panelde Hasabat maglumatlary astynda şuňa basyň: Ölçegler.
  4. Şuny MousePlayer Session URL esasy ýa-da ikinji ölçeg sanawyna goşup, görünýän ediň.
  5. Şuňa basyň: Saklamak → Häzirki hasabatdaky üýtgeşmeleri saklamak.

Saklanandan soň adaty myhman çekiş ýa-da konwersiýa tablisalaryny barlaýan islendik seljeriji MousePlayer Session URL ikinji ölçeg hökmünde goşup, adaty trafik segmentlerinde myhman häsiýetini dessine görüp barlap biler.

6. JavaScript API & GA4 / GTM utgaşyklyk gollanmasy

MousePlayer düşnükli, GA4 bilen utgaşykly JavaScript API berýär (adaty gtag() görnüşli buýruklar bilen) we açyk umumy obýekti (window.MousePlayer) hödürleýär. Bu işläp düzüjilere konsolda sessiýa URL-lerini soramaga, B2B müşderi ID-lerini goşmaga we üçünji tarap kömek gulluklaryna ýa-da ýalňyşlyk yzarlaýjylaryna ýazgy baglanyşyklaryny goşmaga mümkinçilik berýär.

1. Ýazgy URL-sini göni goşmak (Intercom / Zendesk / ýörite köprüler)

Işjeň myhman sessiýasynyň doly görkeziliş URL-sini brauzer konsolyndan ýa-da islendik ýörite skriptden göni şu usul bilen alyp bilersiňiz: 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. Ýörite B2B müşderi ID-lerini bellemek (user_id)

Giren SaaS ýa-da B2B müşderilerini tanamak üçin ýörite user_id (maglumat bazasynyň ID-si, e-poçta ýa-da UUID ýaly) başlangyç skript sazlamasynda ýa-da GA4 sintaksisi bilen dinamiki iş wagtynda geçirip bilersiňiz:

// 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. Asinkron maglumat alma usullary

Ýörite teg dolandyryş skriptlerinde sessiýa meta maglumatlaryny asinkron almak üçin adaty GA4 gaýtaryş funksiýa sintaksisini ulanyp bilersiňiz:

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

Bu ýerde agzalan ähli söwda bellikleri degişli eýelerine degişlidir. MousePlayer-iň bu üpjün edijiler bilen işewürlik gatnaşygy ýok.