Мост GTM & мост падзей GA4

Аб'яднанне колькаснай тэлеметрыі Google Analytics 4 з якасным прайграваннем MousePlayer праз двухбаковую сінхранізацыю dataLayer і API, сумяшчальныя з GA4.

1. Агляд архітэктуры & магчымасці

Сучасная вэб-аналітыка часта пакутуе ад ізаляцыі даных: колькасныя платформы накшталт Google Analytics 4 паведамляюць, што адбылося на сайце, а інструменты прайгравання тлумачаць, чаму . Гэты мост MousePlayer GTM & GA4 ліквідуе прабел, ствараючы двухбаковы канал сінхранізацыі ў асяроддзі JavaScript браўзера.

Пасля ўключэння скрыпт ініцыялізуе два асноўныя модулі:

  • Экспарцёр прайгравання сеанса (initGa4SessionBridge): Аўтаматычна перадае ідэнтыфікатар актыўнага запісу (mp_session_id) і прамы URL прайгравання (mp_session_url) у пласт даных сайта адразу пасля стварэння сеанса.
  • Прыёмнік падзей GA4 (initDataLayerBridge): Дадае слухача да масіву пласта даных без парушэння яго працы. Кожная ўласная падзея камерцыі або паводзін для GA4 адразу адлюстроўваецца ў базе аналітыкі MousePlayer як уласная падзея (ce), уключаючы ўсе лікавыя і радковыя параметры.

Падтрымка ўласнага аб'екта dataLayer: Калі вэб-праграма выкарыстоўвае ўласную назву масіву замест стандартнай dataLayer (напрыклад, xyzDataLayer), рухавік дынамічна падладжваецца пад зададзены параметр gtm_datalayer_name без ручных змен кода.

2. Стратэгічная каштоўнасць для бізнесу

Прамое ўключэнне спасылак прайгравання ў карпаратыўныя аналітычныя патокі дае істотныя аперацыйныя перавагі:

Магчымасць для бізнесу Аперацыйны эфект
Аптымізацыя канверсіі (CRO) Дазваляе аналітыкам знаходзіць перашкоды ў варонках GA4 і адразу запускаць запісы карыстальнікаў, якія пакінулі кошык на пэўным кроку афармлення.
Атрыбуцыя выручкі & аўдыт Дарагія транзакцыі можна праверыць праз дакладныя траекторыі паказальніка, клікі і стан вобласці прагляду, што прывялі да пакупкі.
Паскораная тэхнічная адладка Каманды QA могуць непасрэдна звязаць выключэнні JavaScript у GA4 або журналы памылак API з візуальным запісам экрана без ручнога паўтарэння памылак.
Вырашэнне запытаў падтрымкі ID сеансаў у запытах дазваляюць супрацоўнікам паглядзець дакладны сеанс кліента і істотна скараціць час вырашэння.

3. Інструкцыя наладжвання Google Tag Manager

Каб атрымаць URL прайгравання ў Google Tag Manager і перадаць яго ў Google Analytics 4, трэба наладзіць тры аб'екты GTM:

Крок 1: стварыце зменныя пласта даных

У працоўнай прасторы GTM перайдзіце ў Зменныя → Карыстальніцкія зменныя і стварыце дзве зменныя тыпу Зменная пласта даных:

  • Назва зменнай: dlv - mp_session_id • Назва зменнай пласта даных: mp_session_id
  • Назва зменнай: dlv - mp_session_url • Назва зменнай пласта даных: mp_session_url

Крок 2: стварыце трыгер уключэння

Перайдзіце ў Трыгеры → Новы і выберыце тып трыгера Уласная падзея. Наладзьце параметры:

  • Назва падзеі: mp_session_ready
  • Гэты трыгер спрацоўвае для: Усіх уласных падзей

Крок 3: наладзьце тэг падзеі GA4

Стварыце новы тэг тыпу Google Analytics: падзея GA4 для перадачы спасылкі сеанса ў рэсурс 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. Наладжванне даследаванняў (уласных справаздач) у GA4

Пасля разгортвання тэга GTM GA4 атрымлівае URL прайгравання як параметр падзеі. Для аналізу ва ўласных даследаваннях спачатку зарэгіструйце яго як уласнае вымярэнне.

Рэгістрацыя ўласных вымярэнняў у GA4

У інтэрфейсе Google Analytics 4 перайдзіце ў Адміністратар → Паказ даных → Уласныя азначэнні і націсніце Стварыць уласнае вымярэнне:

  • Назва вымярэння: MousePlayer Session URL
  • Вобласць: Падзея (або Сеанс для параметраў узроўню сеанса)
  • Параметр падзеі: mp_session_url

Стварэнне даследавання сеансаў

У раздзеле Даследаванне GA4 стварыце новае даследаванне тыпу Свабодная форма для праверкі асобных шляхоў карыстальнікаў:

  • Радкі: Дадайце Event name, Transaction ID (для камерцыі) або Landing page.
  • Слупкі / вымярэнні: Дадайце новае ўласнае вымярэнне MousePlayer Session URL.
  • Значэнні: Дадайце Event count або Total users.

Табліца справаздачы паказвае прамыя актыўныя URL побач з метрыкамі GA4, дазваляючы імгненна пераходзіць ад статыстычных анамалій да прайгравання.

5. URL прайгравання ў стандартных справаздачах GA4

Акрамя даследаванняў, уласныя вымярэнні можна дадаць у стандартныя справаздачы GA4 (напрыклад, Прыцягненне трафіку, Старонкі і экраныабо Пакупкі электроннай камерцыі) праз бібліятэку справаздач GA4.

Змена стандартных табліц справаздач

  1. У GA4 адкрыйце падрабязную стандартную справаздачу (напрыклад, Справаздачы → Уцягнутасць → Старонкі і экраны).
  2. Націсніце значок алоўка Наладзіць справаздачу справа ўверсе (патрэбны правы адміністратара).
  3. На правай панэлі ў раздзеле Даныя справаздачынацісніце Вымярэнні.
  4. Дадайце MousePlayer Session URL у спіс асноўных або дадатковых вымярэнняў і зрабіце бачным.
  5. Націсніце Захаваць → Захаваць змены ў бягучай справаздачы.

Пасля захавання аналітык у стандартных табліцах прыцягнення або канверсій можа дадаць MousePlayer Session URL як дадатковае вымярэнне і адразу праверыць паводзіны наведвальнікаў у стандартных сегментах трафіку.

6. Даведнік JavaScript API & сумяшчальнасці GA4 / GTM

MousePlayer дае зразумелы JavaScript API, сумяшчальны з GA4 (са стандартнымі камандамі ў стылі gtag()), і адкрыты глабальны аб'ект (window.MousePlayer). Гэта дазваляе запытваць URL сеансаў у кансолі, далучаць ID B2B-кліентаў і дадаваць спасылкі ў староннія сістэмы падтрымкі або адсочвання памылак.

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. Заданне ўласных ID B2B-кліентаў (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 не мае дзелавых адносін з гэтымі пастаўшчыкамі.