CAPI phía máy chủ & theo dõi sự kiện

Vượt qua trình chặn quảng cáo và hạn chế ITP bằng cách định tuyến lưu lượng MousePlayer qua vùng chứa GTM phía máy chủ bên thứ nhất của riêng bạn và theo dõi phân tích thương mại điện tử chuyên sâu.

1. Tổng quan chế độ theo dõi

MousePlayer V2 giới thiệu Event Router mạnh mẽ cho phép kiểm soát luồng dữ liệu từ trình duyệt người dùng đến máy chủ của chúng tôi. Bạn có thể chọn ba chế độ:

  • Chỉ web (mặc định): Truyền mọi dữ liệu qua WebSockets trực tiếp đến MousePlayer. Phù hợp nhất để xem trực tiếp theo thời gian thực nhưng dễ bị trình chặn quảng cáo mạnh tác động.
  • Chế độ kết hợp: Kết hợp ưu điểm của cả hai. Gửi tọa độ chuột/cuộn nhẹ qua WebSockets để xem trực tiếp mượt, trong khi thay đổi DOM lớn và sự kiện tùy chỉnh được gom lô, định tuyến an toàn qua GTM phía máy chủ bằng HTTP POST.
  • Pure CAPI: Gửi theo lô HTTP POST 100%. Quyền riêng tư tối đa, không WebSockets, hoàn toàn bên thứ nhất. Lưu ý: chế độ xem trực tiếp bị tắt ở chế độ này.

2. Thiết lập Google Tag Manager (được khuyến nghị)

Cách dễ nhất triển khai chế độ kết hợp hoặc Pure CAPI là dùng mẫu cộng đồng GTM chính thức. Tải các tệp .tpl bên dưới rồi nhập vào không gian làm việc GTM.

Tải mẫu:

↓ Web GTM: thẻ MousePlayer SDK

↓ Server GTM: máy khách tiếp nhận MousePlayer

↓ Server GTM: thẻ kết nối MousePlayer

Bước 1: cấu hình máy khách & thẻ phía máy chủ

Trong vùng chứa GTM phía máy chủ, nhập mẫu Máy khách tiếp nhận. Đặt để lắng nghe đường dẫn tùy chỉnh (ví dụ: /mp_capi). Sau đó nhập Thẻ kết nối, cấu hình kích hoạt trên sự kiện mouseplayer_batch rồi triển khai vùng chứa.

Bước 2: cấu hình thẻ Web GTM

Trong vùng chứa Web GTM, nhập Thẻ SDK. Chọn “Cấu hình & Khởi tạo” làm loại thẻ, nhập Channel ID, chọn Chế độ kết hợp rồi dán URL điểm cuối ssGTM (ví dụ: https://metrics.yourdomain.com/mp_capi).

3. Cài đặt thủ công (không GTM)

Nếu muốn đặt tập lệnh trực tiếp trong mã, bạn phải định nghĩa đối tượng window.mp_config trước khi tải đoạn mã theo dõi.

<!-- MousePlayer Config & SDK --> <script> window.mp_config = { channel: 'YOUR_UNIQUE_ID_HERE', mode: 'hybrid', // 'web_only', 'hybrid', or 'pure_capi' capi_endpoint: 'https://metrics.yourdomain.com/mp_capi' }; window.mp = window.mp || function() { (window.mp.q = window.mp.q || []).push(arguments); }; (function(w, d, s) { var f = d.getElementsByTagName(s)[0], j = d.createElement(s); j.async = true; j.src = 'https://www.mouseplayer.com/mp.js'; f.parentNode.insertBefore(j, f); })(window, document, 'script'); </script>

4. Theo dõi phễu thương mại điện tử

Theo dõi toàn bộ hành trình khách hàng. Tên sự kiện tiêu chuẩn cho phép MousePlayer tự tạo báo cáo phễu thương mại điện tử đẹp mắt trong không gian làm việc dự án. Mọi sự kiện đều tương thích hoàn toàn với chế độ CAPI và chỉ web.

1. view_item

Kích hoạt sự kiện này khi người dùng xem trang sản phẩm cụ thể.

mp('event', 'view_item', { item_id: 'SKU_98765', item_name: 'Wireless Noise-Cancelling Headphones', item_category: 'Electronics', price: 299.99 });

2. add_to_cart

Kích hoạt sự kiện này khi người dùng thêm sản phẩm vào giỏ hàng.

mp('event', 'add_to_cart', { item_id: 'SKU_98765', item_name: 'Wireless Noise-Cancelling Headphones', price: 299.99, quantity: 1 });

3. begin_checkout

Kích hoạt sự kiện này khi người dùng đến màn hình thanh toán.

mp('event', 'begin_checkout', { cart_value: 299.99, currency: 'USD', total_items: 1 });

4. purchase

Kích hoạt sự kiện này khi thanh toán thành công hoặc xác nhận đơn hàng.

mp('event', 'purchase', { transaction_id: 'T_1002938', value: 299.99, tax: 24.00, shipping: 0.00, currency: 'USD', coupon_used: 'FREESHIP' });

5. Sự kiện tùy chỉnh & thu hút khách hàng tiềm năng

Không giới hạn ở thương mại điện tử. Theo dõi lượt gửi biểu mẫu, đăng ký bản tin hoặc tương tác tùy chỉnh riêng của ứng dụng web.

Thu hút khách hàng tiềm năng (gửi biểu mẫu)

Kích hoạt sự kiện này khi người dùng gửi thành công biểu mẫu liên hệ hoặc yêu cầu báo giá.

mp('event', 'generate_lead', { form_name: 'B2B Contact Form', industry: 'Software Development', company_size: '50-200' });

Tương tác giao diện tùy chỉnh

Hiểu cách người dùng tương tác với phần tử phức tạp như công cụ tính toán, hộp thoại hoặc chuyển thẻ.

mp('event', 'calculator_used', { loan_amount: 50000, duration_months: 48, interest_rate: 7.5 });

6. Giới hạn tham số & hướng dẫn

Kiểu dữ liệu: MousePlayer tự nhận diện kiểu tham số. Gửi số dưới dạng số nguyên hoặc số thực (ví dụ: 150.00, không phải "150.00") để bật lọc số nâng cao (ví dụ: “Giá > 100”) trong bảng điều khiển.

Quy tắc Mô tả
Độ dài tên sự kiện Tối đa 128 ký tự. Dùng snake_case để dễ đọc nhất (ví dụ: user_signup).
Độ dài khóa tham số Tối đa 64 ký tự mỗi tên khóa (ví dụ: transaction_id).
Giá trị chuỗi Tham số văn bản được cắt còn 255 ký tự để đảm bảo hiệu suất cơ sở dữ liệu tối ưu.
Quyền riêng tư dữ liệu Tuyệt đối không gửi thông tin nhận dạng cá nhân (PII) như email thô, tên thật hoặc mật khẩu dưới dạng tham số sự kiện.