GTM байланысы & GA4 оқиға байланысы

Екі бағытты dataLayer синхрондауы және GA4 үйлесімді API арқылы Google Analytics 4 сандық телеметриясын MousePlayer сапалық сеанс қайта ойнатуларымен біріктіру.

1. Архитектураға шолу & мүмкіндіктер

Заманауи веб-талдауда негізгі дерек оқшаулануы жиі кездеседі: сандық платформалар (Google Analytics 4 сияқты) веб-сайтта не болғанын хабарлайды, ал сапалық сеанс қайта ойнату құралдары оның неге болғанын түсіндіреді. Осы MousePlayer GTM & GA4 байланысы браузердің JavaScript ортасында екі бағытты синхрондау арнасын орнатып, ол олқылықты жояды.

Қосылғанда бақылау скрипті екі арнайы негізгі модульді іске қосады:

  • Сеансты қайта ойнату экспорттағышы (initGa4SessionBridge): Сеанс құрылған бойда белсенді жазба сеансының идентификаторын (mp_session_id) және тікелей қайта ойнату URL мекенжайын (mp_session_url) веб-сайттың деректер қабатына автоматты жібереді.
  • GA4 оқиғаларын қабылдағыш (initDataLayerBridge): Деректер қабаты массивіне бұзбайтын тыңдағыш қосады. GA4 үшін жіберілген кез келген арнайы электрондық сауда немесе әрекет оқиғасы MousePlayer талдау дерекқорына арнайы оқиға (ce) ретінде барлық сандық және мәтіндік параметрімен бірден көшіріледі.

Арнайы dataLayer нысанын қолдау: Веб-қолданба стандартты dataLayer орнына JavaScript массивінің арнайы атауын қолданса (мысалы, xyzDataLayer), қозғалтқыш бапталған gtm_datalayer_name параметріне қолмен код өзгертпей динамикалық бейімделеді.

2. Стратегиялық бизнес құны

Қайта ойнату сілтемелерін корпоративтік талдау ағындарына тікелей қосу жұмыста бірнеше маңызды артықшылық береді:

Бизнес мүмкіндігі Жұмысқа әсері
Конверсия үлесін оңтайландыру (CRO) Цифрлық талдаушыларға GA4 конверсия шұңқырларындағы кедергілерді анықтап, төлемді рәсімдеудің нақты қадамында себетін тастаған пайдаланушылардың жазбасын бірден ашуға мүмкіндік береді.
Табыс атрибуциясы & аудиті Құндылығы жоғары электрондық сауда мәмілелерін сатып алуға әкелген нақты меңзер жолдарын, басуларды және көрінетін аймақ күйлерін қарап тексеруге болады.
Техникалық қатені жедел іздеу QA инженерлері GA4 JavaScript ерекше жағдай оқиғаларын немесе API қате журналдарын экран жазбаларымен тікелей байланыстырып, ақауды қолмен қайталаудан арылады.
Тұтынушыны қолдау мәселесін шешу Пайдаланушы сеанс ID-і бар қолдау өтінімдері операторларға тұтынушының дәл сеансын қайта көруге мүмкіндік беріп, шешу уақытын айтарлықтай қысқартады.

3. Google Tag Manager баптау нұсқаулығы

Қайта ойнату URL мекенжайын Google Tag Manager ішінде алып, Google Analytics 4 жүйесіне жіберу үшін үш бөлек GTM нысанын баптау керек:

1-қадам: деректер қабаты айнымалыларын жасау

GTM жұмыс кеңістігінде Variables → User-Defined Variables бөліміне өтіп, мына түрдегі екі айнымалы жасаңыз: Data Layer Variable:

  • Айнымалы атауы: dlv - mp_session_id • Деректер қабаты айнымалысының атауы: mp_session_id
  • Айнымалы атауы: dlv - mp_session_url • Деректер қабаты айнымалысының атауы: mp_session_url

2-қадам: іске қосу триггерін жасау

Мына бөлімге өтіңіз: Triggers → New және триггер түрін таңдаңыз: Custom Event. Мына параметрлерді баптаңыз:

  • Оқиға атауы: mp_session_ready
  • Бұл триггер мынада іске қосылады: All Custom Events

3-қадам: GA4 оқиға тегін баптау

Сеанс сілтемесін GA4 ресурсына жіберу үшін мына түрдегі жаңа тег жасаңыз: Google Analytics: GA4 Event .

# 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 ішінде зерттеулерді (арнайы есептерді) баптау

GTM тегі орнатылғаннан кейін GA4 қайта ойнату URL мекенжайын оқиға параметрі ретінде қабылдай бастайды. Бұл деректерді арнайы зерттеу есептерінде талдау үшін параметрді алдымен арнайы өлшем ретінде тіркеу керек.

GA4 әкімшілік бөлімінде арнайы өлшемдерді тіркеу

Google Analytics 4 интерфейсінде Admin → Data display → Custom definitions бөліміне өтіп, Create custom dimensionбасыңыз:

  • Өлшем атауы: MousePlayer Session URL
  • Ауқым: Event (немесе Session сеанс ауқымындағы параметрлерге қосылса)
  • Оқиға параметрі: mp_session_url

Сеансты тексеру зерттеуін жасау

Мына бөлімде: Explore GA4 ішінде жаңа Free form зерттеуін жасап, жеке пайдаланушы жолдарын тексеріңіз:

  • Жолдар: Қосыңыз: Event name, Transaction ID (электрондық сауда үшін) немесе Landing page.
  • Бағандар / Өлшемдер: Жаңа жасалған арнайы өлшемді қосыңыз: MousePlayer Session URL.
  • Мәндер: Қосыңыз: Event count немесе Total users.

Жасалған есеп кестесі GA4 көрсеткіштерінің жанында басуға болатын тікелей URL мекенжайларын көрсетіп, статистикалық ауытқудан көрнекі қайта ойнатуға бірден өтуге мүмкіндік береді.

5. Қайта ойнату URL мекенжайларын GA4 әдепкі есептеріне қосу

Зерттеулерден бөлек, арнайы өлшемдерді стандартты әдепкі есептерге қосуға болады (мысалы, GA4 ішінде: Traffic acquisition, Pages and screensнемесе E-commerce purchases). Ол үшін GA4 Report Library қолданылады.

Стандартты есеп кестелерін өзгерту

  1. GA4 ішінде кез келген әдепкі толық есепті ашыңыз (мысалы, Reports → Engagement → Pages and screens).
  2. Жоғарғы оң жақтағы Customize report қарындаш белгісін басыңыз (әкімші рұқсаты қажет).
  3. Оң жақ панельдегі Report Dataастында Dimensionsбасыңыз.
  4. Мына өлшемді: MousePlayer Session URL негізгі немесе қосымша өлшемдер тізіміне қосып, көрінетін етіңіз.
  5. Мынаны басыңыз: Save → Save changes to current report.

Сақтағаннан кейін стандартты тарту не конверсия кестелерін қарайтын кез келген талдаушы MousePlayer Session URL мәнін қосымша өлшем ретінде қосып, стандартты трафик сегменттеріндегі келуші әрекетін бірден көре алады.

6. JavaScript API & GA4 / GTM үйлесімділігі анықтамасы

MousePlayer түсінікті, GA4 үйлесімді JavaScript API (стандартты gtag()үлгісіндегі пәрмендермен) және жалпыға ашық жаһандық нысан (window.MousePlayer) ұсынады. Бұл әзірлеушілерге консольден сеанс URL мекенжайын сұрауға, B2B тұтынушы ID-ін қосуға және қайта ойнату сілтемелерін сыртқы қолдау не қате трекерлеріне енгізуге мүмкіндік береді.

1. Қайта ойнату URL мекенжайын тікелей енгізу (Intercom / Zendesk / арнайы байланыстар)

Белсенді келуші сеансының толық қайта ойнату URL мекенжайын браузер консолінен не арнайы скрипттен мына әдіспен ала аласыз: 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. Арнайы B2B тұтынушы ID-ін орнату (user_id)

Жүйеге кірген SaaS немесе B2B тұтынушыларды сәйкестендіру үшін арнайы user_id мәнін (дерекқор ID-і, электрондық пошта не UUID сияқты) скриптті бастапқы баптауда немесе 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. Деректерді асинхронды алу әдістері

Арнайы тег басқару скрипттерінде сеанс метадеректерін асинхронды алу үшін стандартты GA4 кері шақыру синтаксисін қолдана аласыз:

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

Мұнда аталған барлық сауда белгілері өз иелеріне тиесілі. MousePlayer осы қызмет жеткізушілерімен іскерлік қатынаста емес.