Cầu nối GTM & cầu nối sự kiện GA4

Kết hợp dữ liệu đo lường định lượng Google Analytics 4 với bản phát lại phiên định tính MousePlayer qua đồng bộ dataLayer hai chiều và API tương thích GA4.

1. Tổng quan kiến trúc & khả năng

Phân tích web hiện đại thường gặp tình trạng dữ liệu bị tách biệt cơ bản: nền tảng định lượng (như Google Analytics 4) báo cáo điều gì đã xảy ra trên trang web, trong khi công cụ phát lại phiên định tính giải thích vì sao điều đó xảy ra. Cầu nối MousePlayer GTM & GA4 xóa bỏ khoảng trống này bằng cách thiết lập kênh đồng bộ hai chiều trong môi trường chạy JavaScript của trình duyệt.

Khi kích hoạt, tập lệnh theo dõi khởi tạo hai mô-đun cốt lõi chuyên biệt:

  • Bộ xuất bản phát lại phiên (initGa4SessionBridge): Tự động đẩy mã định danh phiên đang ghi (mp_session_id) và URL phát lại trực tiếp (mp_session_url) vào lớp dữ liệu của trang web ngay khi phiên được thiết lập.
  • Bộ tiếp nhận sự kiện GA4 (initDataLayerBridge): Gắn trình lắng nghe không phá vỡ hoạt động vào mảng lớp dữ liệu. Mọi sự kiện thương mại điện tử hoặc hành vi tùy chỉnh được đẩy cho GA4 đều được sao chép ngay vào cơ sở dữ liệu phân tích MousePlayer dưới dạng sự kiện tùy chỉnh (ce), bao gồm mọi tham số số và chuỗi.

Hỗ trợ đối tượng dataLayer tùy chỉnh: Nếu ứng dụng web dùng tên mảng JavaScript tùy chỉnh thay cho tên tiêu chuẩn dataLayer (ví dụ: xyzDataLayer), công cụ tự thích ứng với tham số đã cấu hình gtm_datalayer_name mà không cần sửa mã thủ công.

2. Giá trị kinh doanh chiến lược

Tích hợp liên kết phát lại phiên trực tiếp vào luồng phân tích doanh nghiệp mang lại nhiều lợi ích vận hành có tác động lớn:

Khả năng kinh doanh Tác động vận hành
Tối ưu tỷ lệ chuyển đổi (CRO) Cho phép nhà phân tích số nhận diện điểm trở ngại trong phễu chuyển đổi GA4 và mở ngay bản ghi của những người dùng bỏ giỏ hàng tại các bước thanh toán cụ thể.
Phân bổ doanh thu & kiểm tra đối chiếu Có thể kiểm tra các giao dịch thương mại điện tử giá trị cao bằng cách xem chính xác quỹ đạo con trỏ, lượt nhấp và trạng thái vùng nhìn dẫn đến giao dịch mua.
Tăng tốc gỡ lỗi kỹ thuật Nhóm kỹ thuật QA có thể đối chiếu trực tiếp sự kiện ngoại lệ JavaScript GA4 hoặc nhật ký lỗi API với bản ghi màn hình trực quan, không cần tái hiện lỗi thủ công.
Giải quyết yêu cầu hỗ trợ khách hàng Phiếu hỗ trợ chứa ID phiên người dùng cho phép nhân viên xem đúng bản phát lại phiên của khách hàng, giảm đáng kể thời gian giải quyết.

3. Hướng dẫn cấu hình Google Tag Manager

Để lấy URL phát lại trong Google Tag Manager và chuyển đến Google Analytics 4, cần cấu hình ba thành phần GTM riêng biệt:

Bước 1: tạo biến lớp dữ liệu

Trong không gian làm việc GTM, đến Biến → Biến do người dùng xác định và tạo hai biến thuộc loại Biến lớp dữ liệu:

  • Tên biến: dlv - mp_session_id • Tên biến lớp dữ liệu: mp_session_id
  • Tên biến: dlv - mp_session_url • Tên biến lớp dữ liệu: mp_session_url

Bước 2: tạo điều kiện kích hoạt

Đến Điều kiện kích hoạt → Mới và chọn loại điều kiện kích hoạt Sự kiện tùy chỉnh. Cấu hình các tham số sau:

  • Tên sự kiện: mp_session_ready
  • Điều kiện này kích hoạt trên: Mọi sự kiện tùy chỉnh

Bước 3: cấu hình thẻ sự kiện GA4

Tạo thẻ mới thuộc loại Google Analytics: Sự kiện GA4 để truyền liên kết phiên đến thuộc tính 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. Cấu hình Khám phá (báo cáo tùy chỉnh) trong GA4

Khi thẻ GTM được triển khai, GA4 bắt đầu nhận URL phát lại dưới dạng tham số sự kiện. Để phân tích dữ liệu trong báo cáo khám phá tùy chỉnh, trước tiên phải đăng ký tham số là một Phương diện tùy chỉnh.

Đăng ký phương diện tùy chỉnh trong phần quản trị GA4

Trong giao diện Google Analytics 4, đến Quản trị → Hiển thị dữ liệu → Định nghĩa tùy chỉnh và nhấp Tạo phương diện tùy chỉnh:

  • Tên phương diện: MousePlayer Session URL
  • Phạm vi: Sự kiện (hoặc Phiên nếu gắn với tham số phạm vi phiên)
  • Tham số sự kiện: mp_session_url

Tạo báo cáo khám phá kiểm tra phiên

Trong phần Khám phá của GA4, tạo báo cáo khám phá mới dạng Tự do để kiểm tra từng hành trình người dùng:

  • Hàng: Thêm Event name, Transaction ID (cho thương mại điện tử) hoặc Landing page.
  • Cột / Phương diện: Bao gồm phương diện tùy chỉnh vừa tạo MousePlayer Session URL.
  • Giá trị: Thêm Event count hoặc Total users.

Bảng báo cáo được tạo hiển thị URL nhấp trực tiếp được cạnh các chỉ số GA4, cho phép chuyển ngay từ giá trị ngoại lệ thống kê sang bản phát lại trực quan.

5. Tích hợp URL phát lại vào báo cáo mặc định GA4

Ngoài Khám phá, có thể tích hợp phương diện tùy chỉnh vào báo cáo mặc định tiêu chuẩn GA4 (như Thu hút lưu lượng truy cập, Trang và màn hình hoặc Lượt mua hàng thương mại điện tử) bằng Thư viện báo cáo GA4.

Sửa bảng báo cáo tiêu chuẩn

  1. Trong GA4, mở bất kỳ báo cáo chi tiết mặc định nào (ví dụ: Báo cáo → Tương tác → Trang và màn hình).
  2. Nhấp biểu tượng bút chì Tùy chỉnh báo cáo ở góc trên bên phải (cần quyền quản trị).
  3. Trong bảng bên phải, ở mục Dữ liệu báo cáo, nhấp Phương diện.
  4. Thêm MousePlayer Session URL vào danh sách phương diện chính hoặc phụ rồi đặt để hiển thị.
  5. Nhấp Lưu → Lưu thay đổi vào báo cáo hiện tại.

Sau khi lưu, nhà phân tích xem bảng thu hút lưu lượng hoặc chuyển đổi tiêu chuẩn có thể thêm MousePlayer Session URL làm phương diện phụ, cho phép kiểm tra trực quan ngay hành vi khách trên các phân khúc lưu lượng tiêu chuẩn.

6. Tài liệu tham khảo JavaScript API & tương thích GA4 / GTM

MousePlayer cung cấp JavaScript API trực quan, tương thích GA4 (dùng các lệnh tiêu chuẩn kiểu gtag()) và một đối tượng toàn cục công khai (window.MousePlayer). Điều này cho phép nhà phát triển truy vấn URL phiên trong bảng điều khiển, gắn ID khách hàng B2B và chèn liên kết phát lại vào hệ thống hỗ trợ hoặc công cụ theo dõi lỗi bên thứ ba.

1. Chèn trực tiếp URL phát lại (Intercom / Zendesk / cầu nối tùy chỉnh)

Bạn có thể lấy URL phát lại đầy đủ của phiên khách đang hoạt động trực tiếp từ bảng điều khiển trình duyệt hoặc tập lệnh tùy chỉnh bằng 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. Đặt ID khách hàng B2B tùy chỉnh (user_id)

Để nhận diện khách hàng SaaS hoặc B2B đã đăng nhập, bạn có thể truyền giá trị tùy chỉnh user_id (như ID cơ sở dữ liệu, email hoặc UUID) khi cấu hình tập lệnh ban đầu hoặc linh hoạt lúc chạy bằng cú pháp 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. Phương thức lấy dữ liệu bất đồng bộ

Bạn có thể dùng cú pháp callback tiêu chuẩn GA4 để lấy siêu dữ liệu phiên bất đồng bộ trong tập lệnh quản lý thẻ tùy chỉnh:

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

Mọi nhãn hiệu nêu ở đây thuộc chủ sở hữu tương ứng. MousePlayer không có quan hệ kinh doanh với các nhà cung cấp này.