GTM və GA4 hadisə körpüsü

1. Arxitektura icmalı & imkanlar

Müasir veb analitikada çox vaxt əsas məlumat ayrılığı var: kəmiyyət platformaları (Google Analytics 4 kimi) saytda nə baş verdiyini bildirir, keyfiyyət yönümlü seans təkrar oynatma alətləri isə niyə baş verdiyini izah edir. MousePlayer GTM & GA4 körpüsü brauzerin JavaScript icra mühitində ikiistiqamətli sinxronlaşdırma kanalı yaradaraq bu boşluğu aradan qaldırır.

Aktivləşdirildikdə izləmə skripti iki xüsusi əsas modulu başladır:

Seans təkrar oynatması ixracçısı (initGa4SessionBridge): Seans qurulan kimi aktiv qeyd seansının identifikatorunu (mp_session_id) və birbaşa oynatma URL-sini (mp_session_url) avtomatik saytın məlumat qatına ötürür.
GA4 hadisə qəbuledicisi (initDataLayerBridge): Məlumat qatı massivinə onu pozmayan dinləyici əlavə edir. GA4 üçün ötürülən istənilən fərdi elektron ticarət və ya davranış hadisəsi dərhal MousePlayer analitika bazasında fərdi hadisə kimi əks olunur (ce), bütün rəqəmli və mətn parametrləri ilə birlikdə.

Fərdi dataLayer obyektinə dəstək: Veb tətbiq standart ad əvəzinə fərdi JavaScript massiv adı istifadə edirsə: dataLayer (məsələn, xyzDataLayer), mühərrik tənzimlənmiş bu parametrə: gtm_datalayer_name əl ilə kod dəyişikliyi tələb etmədən dinamik uyğunlaşır.

2. Strateji biznes dəyəri

Seans təkrar oynatma keçidlərinin birbaşa müəssisə analitika axınlarına inteqrasiyası bir neçə güclü əməliyyat üstünlüyü verir:

Biznes imkanı	Əməliyyat təsiri
Konversiya nisbətinin optimallaşdırılması (CRO)	Rəqəmsal analitiklərə GA4 konversiya qıflarında maneə nöqtələrini müəyyən etməyə və konkret ödəniş addımlarında səbəti tərk etmiş istifadəçilərin qeydlərini dərhal açmağa imkan verir.
Gəlirin aid edilməsi & auditi	Alışa gətirən dəqiq göstərici yollarını, klikləri və görünüş sahəsi vəziyyətlərini nəzərdən keçirərək yüksək dəyərli elektron ticarət əməliyyatlarını audit etmək olar.
Texniki xəta axtarışının sürətləndirilməsi	QA mühəndislik komandaları GA4 JavaScript istisna hadisələrini və ya API xəta jurnallarını birbaşa vizual ekran qeydləri ilə əlaqələndirərək problemləri əl ilə təkrar yaratmaq ehtiyacını aradan qaldıra bilər.
Müştəri dəstəyi problemlərinin həlli	İstifadəçi seans ID-ləri olan dəstək sorğuları əməkdaşlara müştərinin məhz həmin seans təkrar oynatmasına baxmağa imkan verərək həll müddətini xeyli azaldır.

3. Google Tag Manager quraşdırma təlimatı

Təkrar oynatma URL-sini Google Tag Manager daxilində qəbul edib Google Analytics 4-ə yönləndirmək üçün üç ayrı GTM elementi tənzimlənməlidir:

Addım 1: məlumat qatı dəyişənləri yaradın

GTM iş sahəsində bu bölməyə keçin: Dəyişənlər → İstifadəçinin təyin etdiyi dəyişənlər və bu növdə iki dəyişən yaradın: Məlumat qatı dəyişəni:

Dəyişənin adı: dlv - mp_session_id • Məlumat qatı dəyişəninin adı: mp_session_id
Dəyişənin adı: dlv - mp_session_url • Məlumat qatı dəyişəninin adı: mp_session_url

Addım 2: aktivləşdirmə tətikləyicisi yaradın

Bu bölməyə keçin: Tətikləyicilər → Yeni və bu tətikləyici növünü seçin: Fərdi hadisə. Aşağıdakı parametrləri tənzimləyin:

Hadisənin adı: mp_session_ready
Bu tətikləyici bu hallarda işə düşür: Bütün fərdi hadisələr

Addım 3: GA4 hadisə teqini tənzimləyin

Bu növdə yeni teq yaradın: Google Analytics: GA4 hadisəsi ki, seans keçidini GA4 resursuna ötürsün:

# 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-də araşdırmaların (fərdi hesabatların) tənzimlənməsi

GTM teqi yerləşdirildikdən sonra GA4 oynatma URL-sini hadisə parametri kimi almağa başlayır. Bu məlumatı fərdi araşdırma hesabatlarında təhlil etmək üçün parametr əvvəlcə fərdi ölçü kimi qeydiyyata alınmalıdır.

GA4 Admin-də fərdi ölçülərin qeydiyyatı

Google Analytics 4 interfeysində bu bölməyə keçin: Admin → Məlumat göstərilişi → Fərdi təriflər və bu düyməyə klikləyin: Fərdi ölçü yaradın:

Ölçünün adı: MousePlayer Session URL
Əhatə: Hadisə (və ya Seans — seans əhatəli parametrlərə bağlanıbsa)
Hadisə parametri: mp_session_url

Seans yoxlama araşdırmasının qurulması

GA4-də bu bölmədə: Araşdırın yeni bu növdə araşdırma yaradın: Sərbəst forma ki, fərdi istifadəçi yollarını yoxlayasınız:

Sətirlər: Əlavə edin: Event name, Transaction ID (elektron ticarət üçün) və ya Landing page.
Sütunlar / Ölçülər: Yeni yaradılmış fərdi ölçünü daxil edin: MousePlayer Session URL.
Dəyərlər: Əlavə edin: Event count və ya Total users.

Yaradılmış hesabat cədvəli GA4 göstəriciləri ilə yanaşı birbaşa kliklənən URL-ləri göstərərək statistik kənarlaşmalardan vizual təkrar oynatmalara dərhal keçməyə imkan verir.

5. Təkrar oynatma URL-lərinin GA4 standart hesabatlarına inteqrasiyası

Araşdırmalardan əlavə fərdi ölçülər GA4 Hesabat Kitabxanası ilə standart GA4 hesabatlarına inteqrasiya edilə bilər, məsələn: Trafikin cəlb edilməsi, Səhifələr və ekranlarvə ya Elektron ticarət alışları.

Standart hesabat cədvəllərinin dəyişdirilməsi

GA4-də istənilən standart ətraflı hesabatı açın (məsələn, Hesabatlar → İştirak → Səhifələr və ekranlar).
Bu düyməyə klikləyin: Hesabatı fərdiləşdirin — yuxarı sağdakı karandaş işarəsi (administrator girişi tələb olunur).
Sağ paneldə bu bölmədə: Hesabat məlumatlarıbu seçimi açın: Ölçülər.
Bu ölçünü: MousePlayer Session URL əsas və ya əlavə ölçü siyahısına əlavə edib görünən edin.
Bu düyməyə klikləyin: Saxlayın → Cari hesabata dəyişiklikləri saxlayın.

Saxlandıqdan sonra standart cəlbetmə və ya konversiya cədvəllərinə baxan istənilən analitik bu ölçünü: MousePlayer Session URL əlavə ölçü kimi seçərək standart trafik seqmentləri üzrə ziyarətçi davranışını dərhal vizual yoxlaya bilər.

6. JavaScript API & GA4 / GTM uyğunluğu təlimatı

MousePlayer intuitiv, GA4 uyğun JavaScript API təqdim edir (standart gtag()üslublu əmrlərlə) və açıq qlobal obyekt verir (window.MousePlayer). Bu, tərtibatçılara konsolda seans URL-lərini sorğulamağa, B2B müştəri ID-lərini bağlamağa və təkrar oynatma keçidlərini üçüncü tərəf yardım xidmətlərinə və ya xəta izləyicilərinə əlavə etməyə imkan verir.

1. Təkrar oynatma URL-sinin birbaşa əlavə edilməsi (Intercom / Zendesk / fərdi körpülər)

Aktiv ziyarətçi seansının tam oynatma URL-sini brauzer konsolundan və ya istənilən fərdi skriptdən bu üsulla birbaşa ala bilərsiniz: 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. Fərdi B2B müştəri ID-lərinin təyin edilməsi (user_id)

Daxil olmuş SaaS və ya B2B müştərilərini müəyyənləşdirmək üçün fərdi identifikatoru: user_id (məsələn, verilənlər bazası ID-si, e-poçt və ya UUID) ilkin skript tənzimlənməsində və ya icra zamanı dinamik olaraq GA4 sintaksisi ilə ötürə bilərsiniz:

// 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. Asinxron məlumat alma üsulları

Fərdi teq idarəetmə skriptlərində seans metaməlumatlarını asinxron almaq üçün standart GA4 geri çağırış sintaksisindən istifadə edə bilərsiniz:

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

Necə kömək edə bilərik?