Mostek GTM i GA4 Event Bridge

1. Architektura systemu i możliwości techniczne

Współczesna analityka internetowa często boryka się z problemem silosów danych: platformy ilościowe (takie jak Google Analytics 4) raportują co wydarzyło się na stronie, podczas gdy narzędzia jakościowe odtwarzające sesje wyjaśniają dlaczego do tego doszło. Mostek MousePlayer GTM & GA4 Bridge eliminuje tę barierę, ustanawiając dwukierunkowy kanał synchronizacji bezpośrednio w środowisku wykonawczym JavaScript przeglądarki.

Po aktywacji skrypt śledzący uruchamia dwa wyspecjalizowane moduły:

Eksporter Nagrań (initGa4SessionBridge): Automatycznie przekazuje identyfikator aktywnej sesji nagrywania (mp_session_id) oraz bezpośredni adres URL do odtwarzacza (mp_session_url) do warstwy danych witryny natychmiast po zainicjowaniu połączenia.
Ingestor Zdarzeń GA4 (initDataLayerBridge): Rejestruje bezinwazyjny moduł nasłuchujący w tablicy warstwy danych. Każde zdarzenie e-commerce lub behawioralne wysłane do GA4 jest natychmiast duplikowane do bazy danych MousePlayer jako zdarzenie niestandardowe (ce), wraz ze wszystkimi parametrami liczbowymi i tekstowymi.

Obsługa niestandardowej nazwy dataLayer: Jeżeli aplikacja internetowa wykorzystuje niestandardową nazwę tablicy JavaScript zamiast domyślnej dataLayer (np. xyzDataLayer), silnik automatycznie dostosowuje się do parametru gtm_datalayer_name bez konieczności ingerencji w kod źródłowy.

2. Strategiczna wartość biznesowa

Przekazywanie linków do nagrań sesji bezpośrednio do firmowych potoków analitycznych przynosi kluczowe korzyści operacyjne:

Zastosowanie biznesowe	Wpływ operacyjny
Optymalizacja konwersji (CRO)	Umożliwia analitykom identyfikowanie punktów porzuceń w lejkach GA4 i natychmiastowe odtwarzanie sesji użytkowników, którzy opuścili koszyk na konkretnym etapie zamówienia.
Audyt i atrybucja przychodów	Transakcje o wysokiej wartości mogą być audytowane poprzez weryfikację dokładnych trajektorii kursora, kliknięć oraz stanu interfejsu, które doprowadziły do zakupu.
Przyspieszone debugowanie techniczne	Zespoły QA mogą powiązać zdarzenia wyjątków JavaScript lub błędy API zarejestrowane w GA4 bezpośrednio z zapisem wideo ekranu, eliminując konieczność manualnego odtwarzania błędów.
Obsługa zgłoszeń wsparcia	Zgłoszenia serwisowe zawierające identyfikator sesji pozwalają pracownikom wsparcia obejrzeć dokładny przebieg wizyty klienta, co radykalnie skraca czas rozwiązywania problemów.

3. Przewodnik konfiguracji w Google Tag Manager

W celu przechwycenia adresu URL nagrania w Google Tag Managerze i przekazania go do Google Analytics 4, konieczna jest konfiguracja trzech elementów w kontenerze GTM:

Krok 1: Utworzenie zmiennych warstwy danych

W sekcji Zmienne → Zmienne zdefiniowane przez użytkownika należy utworzyć dwie zmienne typu Zmienna warstwy danych:

Nazwa zmiennej: dlv - mp_session_id • Nazwa zmiennej warstwy danych: mp_session_id
Nazwa zmiennej: dlv - mp_session_url • Nazwa zmiennej warstwy danych: mp_session_url

Krok 2: Utworzenie reguły aktywującej (Trigger)

W sekcji Reguły → Nowa należy wybrać typ reguły Zdarzenie niestandardowe i ustawić parametry:

Nazwa zdarzenia: mp_session_ready
Reguła odpala się dla: Wszystkie zdarzenia niestandardowe

Krok 3: Konfiguracja tagu zdarzenia GA4

Należy utworzyć nowy tag typu Google Analytics: zdarzenie GA4, który przekaże adres URL do usługi GA4:

# Konfiguracja Tagu Zdarzenia GA4 Typ tagu: Google Analytics: zdarzenie GA4 Tag konfiguracji: [Wybierz standardowy tag konfiguracji GA4] Nazwa zdarzenia: mp_recording_ready # Parametry zdarzenia: | Nazwa parametru | Wartość | |-----------------|---------------------------| | mp_session_id | {{dlv - mp_session_id}} | | mp_session_url | {{dlv - mp_session_url}} | Reguła aktywująca: Zdarzenie niestandardowe -> mp_session_ready

4. Konfiguracja raportów swobodnych (Eksploracje) w GA4

Po opublikowaniu tagu GTM, usługa GA4 zaczyna odbierać adres URL nagrania jako parametr zdarzenia. Aby analizować te dane w raportach eksploracji, parametr musi zostać zarejestrowany jako Wymiar Niestandardowy.

Rejestracja wymiaru niestandardowego w panelu Administracyjnym GA4

W interfejsie Google Analytics 4 należy przejść do sekcji Administracja → Wyświetlanie danych → Definicje niestandardowe i wybrać Utwórz wymiar niestandardowy:

Nazwa wymiaru: MousePlayer Session URL
Zakres: Zdarzenie (lub Sesja w przypadku parametrów o zasięgu sesyjnym)
Parametr zdarzenia: mp_session_url

Budowa raportu eksploracji do analizy sesji

W sekcji Eksplorowanie w GA4 należy utworzyć nową eksplorację w formacie Swobodna:

Wiersze: Należy dodać Nazwa zdarzenia, Identyfikator transakcji (dla e-commerce) lub Strona wejścia.
Kolumny / Wymiary: Należy uwzględnić nowo utworzony wymiar MousePlayer Session URL.
Wartości: Należy dodać Liczba zdarzeń lub Wszyscy użytkownicy.

Wygenerowana tabela prezentuje klikalne adresy URL bezpośrednio obok wskaźników GA4, co umożliwia natychmiastowe przejście od statystycznych odchyleń do wizualnego odtworzenia wizyty.

5. Integracja adresów URL nagrań ze standardowymi raportami GA4

Oprócz Eksploracji, wymiary niestandardowe można włączyć do standardowych raportów domyślnych GA4 (takich jak Pozyskiwanie ruchu, Strony i ekrany czy Zakupy e-commerce), korzystając z Biblioteki raportów.

Modyfikacja standardowych tabel raportowych

W interfejsie GA4 należy otworzyć dowolny szczegółowy raport domyślny (np. Raporty → Zaangażowanie → Strony i ekrany).
Należy kliknąć ikonę ołówka Dostosuj raport w prawym górnym rogu (wymagane uprawnienia administracyjne).
W prawym panelu w sekcji Dane raportu należy wybrać Wymiary.
Należy dodać MousePlayer Session URL do listy wymiarów podstawowych lub dodatkowych i ustawić jako widoczny.
Należy wybrać Zapisz → Zapisz zmiany w bieżącym raporcie.

Po zapisaniu każdy użytkownik analizujący standardowe tabele pozyskiwania lub konwersji może dodać MousePlayer Session URL jako wymiar dodatkowy, co umożliwia weryfikację wizualną zachowań użytkowników w standardowych segmentach ruchu.

6. Dokumentacja JavaScript API i kompatybilność z GA4 / GTM

MousePlayer udostępnia intuicyjne API JavaScript zgodne ze składnią Google Analytics 4 (gtag()) oraz globalny obiekt window.MousePlayer. Umożliwia to programistom pobieranie adresów URL nagrań w konsoli, przypisywanie ID klientów B2B oraz wstrzykiwanie linków do powtórek do narzędzi helpdesk lub systemów śledzenia błędów.

1. Bezpośrednie pobieranie URL nagrania (Intercom / Zendesk / Custom Bridges)

Pełny adres URL do odtworzenia aktywnej sesji użytkownika można pobrać w konsoli przeglądarki lub w dowolnym własnym skrypcie za pomocą window.MousePlayer.getSessionUrl():

// Przykład: Pobranie URL sesji i dołączenie go do metadanych czatu Intercom if (window.MousePlayer && window.MousePlayer.getSessionUrl) { var replayUrl = window.MousePlayer.getSessionUrl(); console.log('Active Replay:', replayUrl); // Dołączenie linku do metadanych Intercom Messenger if (window.Intercom) { Intercom('update', { 'mouseplayer_replay_url': replayUrl }); } }

2. Ustawianie ID klienta B2B (user_id)

W celu identyfikacji zalogowanych klientów B2B lub SaaS można przekazać niestandardowe user_id (np. ID z bazy, e-mail lub UUID) w konfiguracji początkowej lub dynamicznie przy użyciu składni GA4:

// Metoda A: Ustawienie user_id po zalogowaniu (składnia GA4 / gtag) mp('set', 'user_id', 'USR-987654'); // Metoda B: Ustawienie przez obiekt konfiguracji mp('config', 'TWOJE_CHANNEL_ID', { user_id: 'USR-987654' }); // Metoda C: Bezpośrednie wywołanie SDK window.MousePlayer.setUserId('USR-987654');

3. Asynchroniczne odpytywanie o dane sesji

Zgodnie ze standardem GA4 można odpytywać o dane sesji asynchronicznie za pomocą funkcji zwrotnej (callback):

// Pobranie adresu URL aktywnej sesji mp('get', 'session_url', function(url) { console.log('Session URL:', url); }); // Pobranie identyfikatora odwiedzającego (odpowiednik Client ID) mp('get', 'client_id', function(clientId) { console.log('Visitor ID:', clientId); });

W czym możemy pomóc?