Мост GTM & мост событий GA4

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

1. Архитектура & возможности

В современной веб-аналитике данные часто изолированы: количественные платформы, например Google Analytics 4, сообщают, что произошло, а качественные записи объясняют, почему . Мост MousePlayer GTM & GA4 устраняет пробел, создавая двусторонний канал синхронизации в среде JavaScript браузера.

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

  • Экспорт записей (initGa4SessionBridge): Автоматически передаёт ID активного сеанса записи (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 записи в GTM и передачи в GA4 нужно настроить три объекта 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 нет деловых отношений с поставщиками.