Мост за GTM & събития в GA4

Обединяване на количествената телеметрия от Google Analytics 4 с качественото възпроизвеждане на сесии от MousePlayer чрез двупосочна синхронизация на dataLayer и API, съвместими с GA4.

1. Преглед на архитектурата & възможности

Съвременният уеб анализ често страда от основно разделение на данните: количествените платформи (като Google Analytics 4) отчитат какво се е случило на сайта, докато качествените инструменти за възпроизвеждане на сесии обясняват защо се е случило. Този мост за GTM & GA4 на MousePlayer премахва празнината, като установява канал за двупосочна синхронизация в JavaScript средата на браузъра.

При активиране скриптът за проследяване инициализира два специализирани основни модула:

  • Експортиране на възпроизвеждане на сесии (initGa4SessionBridge): Автоматично изпраща идентификатора на активната сесия за запис (mp_session_id) и директен URL адрес за възпроизвеждане (mp_session_url) към слоя данни на сайта веднага щом сесията бъде установена.
  • Приемане на събития от GA4 (initDataLayerBridge): Добавя обработчик към масива на слоя данни, без да нарушава работата му. Всяко персонализирано събитие за електронна търговия или поведение, изпратено за GA4, веднага се отразява в аналитичната база данни на MousePlayer като персонализирано събитие (ce), включително всички числови и текстови параметри.

Поддръжка на персонализиран dataLayer обект: Ако уеб приложение използва собствено име за JavaScript масива вместо стандартното dataLayer (например xyzDataLayer), механизмът динамично се адаптира към конфигурирания параметър gtm_datalayer_name без необходимост от ръчни промени в кода.

2. Стратегическа бизнес стойност

Включването на връзки за възпроизвеждане на сесии директно в корпоративните аналитични потоци осигурява няколко съществени оперативни предимства:

Бизнес възможност Оперативно въздействие
Оптимизация на процента на реализация (CRO) Позволява на дигиталните анализатори да откриват точки на триене във фуниите за реализация в GA4 и веднага да пускат записи на потребители, изоставили кошници на конкретни стъпки при завършване на поръчката.
Приписване на приходи & одит Транзакции с висока стойност в електронната търговия могат да се проверяват чрез преглед на точните траектории на курсора, кликванията и състоянията на видимата област, довели до покупка.
По-бързо техническо отстраняване на грешки Екипите по качество могат да съпоставят JavaScript изключения от GA4 или дневници с API грешки директно с визуалните записи на екрана, без да се налага ръчно възпроизвеждане на грешките.
Решаване на заявки за поддръжка Заявките за поддръжка с идентификатори на потребителски сесии позволяват на операторите да прегледат точното възпроизвеждане на сесията на клиента и значително съкращават времето за решаване.

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.

Създадената таблица на отчета показва директни връзки до показателите на 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 адреси на сесии в конзолата, да добавят 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. Задаване на собствени B2B клиентски идентификатори (user_id)

За да идентифицирате влезли SaaS или B2B клиенти, можете да подадете собствен user_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 няма търговски отношения с тези доставчици.