Cầu nối PostHog, Mixpanel & Amplitude

Công cụ phân tích sản phẩm cho bạn biết điều gì đã xảy ra. MousePlayer cho thấy vì sao. Cầu nối này kết nối hai bên theo cả hai hướng, nên từ một điểm rời bỏ trong phễu chỉ cần một lượt nhấp để đến bản ghi giải thích điều đó.

1. Vấn đề: số liệu không gắn với con người

Phân tích sản phẩm cho bạn một phễu: 1.000 người dùng đến bước thanh toán, 620 người bỏ dở. Đó là phép đo chính xác về một vấn đề bạn vẫn chưa thể nhìn thấy. Xem một vài bản ghi trong số 620 bản ghi đó thường trả lời câu hỏi trong vài phút — nhưng chỉ khi bạn có thể đi từ biểu đồ đến đúng phiên mà không cần xuất ID và tìm thủ công.

Cầu nối phân tích sản phẩm xóa bỏ khoảng trống đó. Nó chạy bên trong mp.js và tự động liên kết hai hệ thống:

  • Chiều đi: mỗi sự kiện công cụ phân tích ghi nhận đều có thuộc tính mouseplayer_session_url. Mở bất kỳ sự kiện nào, nhấp liên kết và xem phiên.
  • Chiều về: mã định danh của khách distinct_id được đọc lại và lưu vào phiên MousePlayer để có thể tìm bản ghi bằng cùng danh tính bạn đang dùng trong PostHog, Mixpanel hoặc Amplitude.

Không cần viết mã. Cầu nối tự nhận diện SDK phân tích. Bạn không cần gọi hàm MousePlayer hay thay đổi cách theo dõi sự kiện.

2. Kích hoạt

Cách A: bảng điều khiển (không cần mã)

  1. Mở dự án và đến thẻ Tích hợp.
  2. Chuyển Cầu nối PostHog, Mixpanel & Amplitude sang ON.
  3. Chọn nền tảng bạn sử dụng. Thay đổi được lưu tự động.

Cài đặt có hiệu lực khi trang web tải lần tiếp theo. Không áp dụng hồi tố cho các phiên đã có.

Cách B: cấu hình tập lệnh thủ công

Nếu muốn đặt trực tiếp trong mã, hãy đặt hai giá trị bên trong window.mp_config:

<!-- MousePlayer SDK with the Product Analytics Bridge enabled --> <script> window.mp_config = { channel: 'YOUR_CHANNEL_ID', analytics_bridge_active: true, analytics_provider: 'posthog' // 'posthog', 'mixpanel' or 'amplitude' }; </script>

3. Điều xảy ra trên từng nền tảng

Mỗi nền tảng cung cấp API khác nhau nên cầu nối ánh xạ sang lệnh gọi phù hợp với từng nền tảng. Bạn không cần cấu hình — cầu nối làm theo nhà cung cấp bạn chọn.

Nền tảngChiều đi (URL phát lại)Chiều về (danh tính)
PostHog posthog.register() — được đăng ký là thuộc tính dùng chung, nên được gắn vào mọi sự kiện tiếp theo posthog.get_distinct_id()
Mixpanel mixpanel.register() — cùng cách hoạt động của thuộc tính dùng chung mixpanel.get_distinct_id()
Amplitude setUserProperties() — được đặt là thuộc tính người dùng getDeviceId(), dùng dự phòng getInstance().options.deviceId trên SDK cũ

Thuộc tính dùng chung và thuộc tính người dùng: trong PostHog và Mixpanel, URL phát lại được gắn vào các sự kiện từ đó trở đi, nên bạn sẽ tìm thấy trên mọi sự kiện được gửi sau khi cầu nối khởi tạo — không có trên các sự kiện đã gửi trước đó trong lần tải trang.

4. Danh tính: từ distinct_id đến phiên có tên

Chiều về là phần hầu hết các nhóm đánh giá thấp. Không có nó, các phiên MousePlayer là ẩn danh: bạn có thể xem nhưng không thể trả lời “hiển thị bản ghi của tài khoản đã rời bỏ tuần trước.”

Khi cầu nối hoạt động, distinct_id từ công cụ phân tích được ghi vào trường custom_user_id của phiên — cùng trường mà lệnh gọi SDK thủ công ghi vào:

// The manual equivalent - you do NOT need this when the bridge is active mp('set', { user_id: 'your-internal-id' });

Nếu bạn đã tự gọi mp('set'), hãy tiếp tục. Danh tính bạn cung cấp rõ ràng đáng tin cậy hơn vì đó là khóa chính của bạn thay vì mã định danh phân tích theo từng trình duyệt.

Lưu ý quyền riêng tư: chỉ truyền mã định danh mà công cụ phân tích đã cấp. Không đọc địa chỉ email, tên hay trường cá nhân khác từ SDK. Đảm bảo chính sách quyền riêng tư của bạn bao quát việc xử lý này và để công cụ quản lý sự đồng ý chặn tập lệnh theo dõi nếu bạn dựa vào sự đồng ý làm cơ sở pháp lý.

5. Cách hoạt động kỹ thuật

SDK phân tích thường được tải bất đồng bộ, nhiều khi sau khi mp.js đã chạy. Vì vậy chỉ thử một lần khi khởi động sẽ thất bại trên hầu hết các trang web thực.

  • Cầu nối thử lại mỗi 1,5 giây, tối đa mười lần, rồi dừng ngay khi cả hai chiều đã hoàn tất.
  • Mỗi chiều hoàn tất độc lập nên URL phát lại không bao giờ được gửi hai lần trong khi chờ xuất hiện danh tính.
  • Nếu SDK không xuất hiện, cầu nối âm thầm dừng sau khoảng 15 giây. Không ghi gì vào bảng điều khiển và việc ghi phiên vẫn tiếp tục, không bị ảnh hưởng.
  • Mã định danh dài hơn 128 ký tự được bỏ qua thay vì cắt ngắn để tránh lưu một nửa mã không bao giờ khớp với bất cứ thứ gì.

6. Xác minh hoạt động

  1. Mở trang web trong thẻ trình duyệt thông thường và tương tác ngắn với trang.
  2. Trong công cụ phân tích, mở sự kiện mới nhất và tìm thuộc tính mouseplayer_session_url. Mở thuộc tính này sẽ đưa bạn thẳng đến bản ghi.
  3. Trong MousePlayer, mở Trình khám phá người dùng. Các phiên có danh tính sẽ hiển thị danh tính đó thay cho biệt danh khách được tạo.

Nếu không thấy dữ liệu

  • Thuộc tính thiếu trên mọi sự kiện: kiểm tra SDK phân tích thực sự được tải trên trang và bạn đã chọn nền tảng phù hợp. Chọn PostHog sẽ không đọc Mixpanel.
  • Thuộc tính chỉ xuất hiện trên các sự kiện về sau: đó là điều được dự kiến, xem lưu ý ở mục 3.
  • Có URL nhưng không có danh tính: SDK của bạn chưa cấp distinct_id, đây là điều bình thường trước khi nhận diện người dùng. Giá trị sẽ được lấy trong lần tải trang sau.
  • Bạn đang kiểm tra với tư cách quản trị viên đã đăng nhập: một số thiết lập loại trừ lưu lượng nội bộ. Hãy thử cửa sổ riêng tư.

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.