Penghubung Peristiwa GTM & GA4

1. Gambaran keseluruhan seni bina & keupayaan

Analitik web moden sering mengalami pengasingan data asas: platform kuantitatif (seperti Google Analytics 4) melaporkan apa yang berlaku pada laman web, manakala alat main semula sesi kualitatif menerangkan sebab ia berlaku. Penghubung GTM & GA4 MousePlayer menghapuskan jurang ini dengan mewujudkan saluran penyegerakan dua hala dalam persekitaran pelaksanaan JavaScript pelayar.

Apabila diaktifkan, skrip penjejakan memulakan dua modul teras khusus:

Pengeksport Main Semula Sesi (initGa4SessionBridge): Menghantar pengecam sesi rakaman aktif (mp_session_id) dan URL main semula langsung (mp_session_url) secara automatik ke lapisan data laman web sebaik sesi diwujudkan.
Penerima Peristiwa GA4 (initDataLayerBridge): Melampirkan pendengar yang tidak merosakkan pada tatasusunan lapisan data. Sebarang peristiwa e-dagang atau tingkah laku tersuai yang dihantar untuk GA4 dicerminkan serta-merta ke dalam pangkalan data analitik MousePlayer sebagai peristiwa tersuai (ce), termasuk semua parameter angka dan rentetan.

Sokongan objek dataLayer tersuai: Jika aplikasi web menggunakan nama tatasusunan JavaScript tersuai dan bukannya nama standard dataLayer (contohnya, xyzDataLayer), enjin menyesuaikan diri secara dinamik dengan parameter gtm_datalayer_name yang dikonfigurasi tanpa memerlukan perubahan kod manual.

2. Nilai perniagaan strategik

Mengintegrasikan pautan main semula sesi terus ke dalam saluran analitik perusahaan memberikan beberapa kelebihan operasi berimpak tinggi:

Keupayaan perniagaan	Kesan operasi
Pengoptimuman kadar penukaran (CRO)	Membolehkan penganalisis digital mengenal pasti titik geseran dalam corong penukaran GA4 dan segera membuka rakaman pengguna yang meninggalkan troli pada langkah pembayaran tertentu.
Atribusi hasil & pengauditan	Transaksi e-dagang bernilai tinggi boleh diaudit dengan menyemak trajektori kursor, klik dan keadaan ruang pandang tepat yang membawa kepada pembelian.
Penyahpepijatan teknikal dipercepat	Pasukan kejuruteraan QA boleh mengaitkan peristiwa pengecualian JavaScript GA4 atau log ralat API terus dengan rakaman skrin visual, menghapuskan keperluan menghasilkan semula pepijat secara manual.
Penyelesaian sokongan pelanggan	Tiket sokongan yang mengandungi ID sesi pengguna membolehkan ejen sokongan menyemak main semula sesi pelanggan yang tepat, memendekkan masa penyelesaian dengan ketara.

3. Panduan konfigurasi Google Tag Manager

Untuk merakam URL main semula dalam Google Tag Manager dan menghalakannya ke Google Analytics 4, tiga aset GTM berbeza mesti dikonfigurasi:

Langkah 1: cipta pemboleh ubah lapisan data

Dalam ruang kerja GTM, navigasi ke Variables → User-Defined Variables dan cipta dua pemboleh ubah jenis Data Layer Variable:

Nama pemboleh ubah: dlv - mp_session_id • Nama pemboleh ubah lapisan data: mp_session_id
Nama pemboleh ubah: dlv - mp_session_url • Nama pemboleh ubah lapisan data: mp_session_url

Langkah 2: cipta pencetus pengaktifan

Navigasi ke Triggers → New dan pilih jenis pencetus Custom Event. Konfigurasikan parameter berikut:

Nama peristiwa: mp_session_ready
Pencetus ini dicetuskan pada: All Custom Events

Langkah 3: konfigurasikan tag peristiwa GA4

Cipta tag baharu jenis Google Analytics: GA4 Event untuk menghantar pautan sesi ke aset web 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. Mengkonfigurasi penerokaan (Laporan tersuai) dalam GA4

Setelah tag GTM dipasang, GA4 mula menerima URL main semula sebagai parameter peristiwa. Untuk menganalisis data ini dalam laporan penerokaan tersuai, parameter mesti didaftarkan sebagai Dimensi Tersuai terlebih dahulu.

Mendaftarkan dimensi tersuai dalam GA4 Admin

Dalam antara muka Google Analytics 4, navigasi ke Admin → Data display → Custom definitions dan klik Create custom dimension:

Nama dimensi: MousePlayer Session URL
Skop: Event (atau Session jika dilampirkan pada parameter berskop sesi)
Parameter peristiwa: mp_session_url

Membina penerokaan pemeriksaan sesi

Dalam bahagian Explore GA4, cipta penerokaan baharu Free form untuk memeriksa perjalanan pengguna individu:

Baris: Tambah Event name, Transaction ID (untuk e-dagang), atau Landing page.
Lajur / Dimensi: Sertakan dimensi tersuai yang baru dicipta MousePlayer Session URL.
Nilai: Tambah Event count atau Total users.

Jadual laporan yang dijana memaparkan URL langsung boleh diklik di sebelah metrik GA4, membolehkan peralihan serta-merta daripada pencilan statistik kepada main semula visual.

5. Mengintegrasikan URL main semula ke dalam laporan lalai GA4

Selain Penerokaan, dimensi tersuai boleh diintegrasikan ke dalam laporan lalai standard GA4 (seperti Traffic acquisition, Pages and screens, atau E-commerce purchases) menggunakan Pustaka Laporan GA4.

Mengubah jadual laporan standard

Dalam GA4, buka mana-mana laporan terperinci lalai (cth. Reports → Engagement → Pages and screens).
Klik ikon pensel Customize report di penjuru kanan atas (akses pentadbiran diperlukan).
Dalam panel kanan di bawah Report Data, klik Dimensions.
Tambah MousePlayer Session URL ke senarai dimensi utama atau sekunder dan tetapkan sebagai kelihatan.
Klik Save → Save changes to current report.

Setelah disimpan, mana-mana penganalisis yang menyemak jadual pemerolehan atau penukaran standard boleh menambah MousePlayer Session URL sebagai dimensi sekunder, membolehkan pemeriksaan visual segera tingkah laku pelawat merentas segmen trafik standard.

6. Rujukan keserasian API JavaScript & GA4 / GTM

MousePlayer menyediakan API JavaScript intuitif serasi GA4 (menggunakan perintah standard bergaya gtag()) dan objek global awam (window.MousePlayer). Ini membolehkan pembangun menanyakan URL sesi dalam konsol, melampirkan ID pelanggan B2B dan menyisipkan pautan main semula ke meja bantuan atau penjejak ralat pihak ketiga.

1. Penyisipan URL main semula langsung (Intercom / Zendesk / Penghubung tersuai)

Anda boleh mendapatkan URL main semula penuh sesi pelawat aktif terus daripada konsol pelayar atau mana-mana skrip tersuai menggunakan 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. Menetapkan ID pelanggan B2B tersuai (user_id)

Untuk mengenal pasti pelanggan SaaS atau B2B yang didaftarkan masuk, anda boleh menghantar user_id tersuai (seperti ID pangkalan data, e-mel atau UUID) sama ada semasa konfigurasi skrip awal atau secara dinamik ketika berjalan menggunakan sintaks 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. Kaedah pengambilan data tak segerak

Anda boleh menggunakan sintaks panggil balik GA4 standard untuk mendapatkan metadata sesi secara tak segerak dalam skrip pengurusan tag tersuai:

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

Bagaimanakah kami boleh membantu?