Vòng đời (phía máy chủ)
Đẩy liên kết phát lại vào ActiveCampaign, Mailchimp, Iterable hoặc Klaviyo từ máy chủ của chúng tôi ngay khi phiên nhận ID khách hàng riêng của bạn.
1. Vì sao có thêm cách này bên cạnh cầu nối trình duyệt
MousePlayer đã có cầu nối vòng đời ghi vào SDK chạy trên trang của bạn - Klaviyo, Braze, Customer.io và sáu nền tảng khác. Cách này thực hiện cùng công việc từ máy chủ của chúng tôi và tồn tại vì với hai nền tảng lớn nhất, không có đường qua trình duyệt:
- ActiveCampaign hoàn toàn không có API trình duyệt cho sự kiện. Lệnh
vgo()có thể đặt tài khoản và địa chỉ email rồi bắt đầu theo dõi - không thể gửi sự kiện. Sự kiện đi qua Event Tracking API với khóa sự kiện riêng, chỉ phía máy chủ. - Mailchimp có API nhưng với bộ tên đóng. Pixel theo dõi trang web chấp nhận
PAGE_VIEWED,PRODUCT_VIEWED,PURCHASEDvà một số tên được định nghĩa sẵn khác. Không có chỗ cho sự kiện tùy chỉnh và ép dữ liệu của chúng tôi vàoPAGE_VIEWEDsẽ là thông tin sai ngay trong mô hình dữ liệu của bạn.
Với Iterable và Klaviyo, đường phía máy chủ đơn giản đáng tin cậy hơn: không trình chặn quảng cáo, không SDK có thể đã tải hoặc chưa, không thẻ đóng sớm.
2. Thông tin cần có
Ba trường và việc điền trường nào tùy thuộc nền tảng.
| Nền tảng | Trường tài khoản | Khóa |
|---|---|---|
| ActiveCampaign | actid | Trang web → Theo dõi trang web, cạnh khóa sự kiện |
| Mailchimp | ID đối tượng | Khóa API - giữ hậu tố dạng -us14 vì trung tâm dữ liệu được đọc từ đó |
| Iterable | không cần - để trống | Khóa có quyền “Cho phép lệnh gọi theo dõi sự kiện” |
| Klaviyo | không cần - để trống | Khóa API riêng tư được sử dụng |
Trường thứ ba là tên sự kiện sẽ hiển thị. Giữ ngắn: tối đa 32 ký tự. Đó là giới hạn API, không phải của chúng tôi và chúng tôi rút ngắn khi bạn lưu thay vì khi gửi - nếu không biểu mẫu sẽ hiển thị khác với dữ liệu được nhận.
Mailchimp: giữ hậu tố trong khóa API. Phần sau dấu gạch ngang cuối (-us14) chỉ định trung tâm dữ liệu chứa tài khoản và địa chỉ được tạo từ đó. Khóa không có hậu tố bị từ chối với thông báo rõ ràng thay vì thất bại ở nơi bạn không nhìn thấy.
3. Khi nào kích hoạt và khi nào không
Ngay khi phiên được nhận diện: khi trang của bạn gọi MousePlayer.setUserId(), khi cầu nối phân tích của chúng tôi đọc lại mã định danh riêng hoặc khi máy chủ của bạn gọi điểm cuối identify. Trước đó chúng tôi không biết bản ghi thuộc về ai.
Chỉ với địa chỉ email
Cả bốn nền tảng xác định liên hệ bằng email. Nếu ID khách hàng của bạn là số hợp đồng, không gửi gì - đưa tác vụ chắc chắn thất bại vào hàng đợi chỉ làm nhật ký đầy thông tin nhiễu.
Liên hệ phải tồn tại từ trước. Không nền tảng nào tạo liên hệ từ sự kiện; ActiveCampaign loại bỏ hoàn toàn sự kiện nếu không nhận ra địa chỉ. Cầu nối này bổ sung thông tin cho liên hệ hiện có - không tạo danh sách của bạn.
Mọi sự kiện đều có ID
Để cùng một phiên không bị đếm hai lần, kể cả khi tác vụ được thử lại.
4. Dữ liệu đến phía bên kia
Một sự kiện, chứa liên kết phát lại dưới dạng thuộc tính tên mouseplayer_session_url. Mở liên kết để vào bản ghi của chính phiên đó.
Từ đó áp dụng logic riêng của nền tảng: dùng sự kiện làm điều kiện kích hoạt tự động hóa, điều kiện phân khúc hoặc chỉ để nhóm mở bản ghi từ liên hệ.
Khóa không bao giờ rời máy chủ của chúng tôi
Khóa được lưu có mã hóa AES-256-GCM, không hiển thị lại sau khi lưu và chủ động không đưa vào hàng đợi nội bộ mang tác vụ - worker tự lấy khóa từ cơ sở dữ liệu.
HTTP 200 không có nghĩa đã gửi thành công
ActiveCampaign trả trạng thái 200 và {"success":0} khi từ chối sự kiện. Chúng tôi đọc nội dung phản hồi, không chỉ trạng thái, nên việc từ chối xuất hiện là thất bại trong nhật ký gửi nhận thay vì thành công âm thầm.
5. Braze, Customer.io và Brevo
Thêm ba nền tảng cho đường phía máy chủ. Hai nền tảng cần một thứ các nền tảng khác không cần: vị trí.
| Bạn cung cấp | Nhận diện bằng | |
|---|---|---|
| Braze | Điểm cuối REST và khóa API | địa chỉ email |
| Customer.io | ID trang web, khóa API và khu vực của bạn | ID khách hàng riêng của bạn |
| Brevo | chỉ khóa theo dõi, không có gì khác | địa chỉ email |
Hai nền tảng nằm tại vị trí cụ thể
Braze dùng điểm cuối REST gắn với từng instance; Customer.io có hai khu vực riêng với các máy chủ khác nhau. Không thể suy ra từ khóa và chọn sai sẽ trả lỗi 401 - khiến bạn kiểm tra khóa. Hai trường tồn tại chỉ vì lý do đó.
Customer.io là nền tảng không cần email
Nó nhận diện người bằng cùng ID bạn gán, nên yêu cầu email sẽ là rào cản không cần thiết. Sáu nền tảng còn lại đối chiếu bằng email và với chúng, phiên nhận diện bằng số hợp đồng không tạo gì - đúng như cần thiết.
Không tạo hồ sơ mới
Lệnh gọi Braze chứa _update_existing_only. Cùng quyết định như cầu nối CRM: phiên trình duyệt không phải khẳng định đáng tin về danh tính khách hàng của bạn và nền tảng vòng đời tạo hồ sơ cho mỗi khách ẩn danh còn tệ hơn không tích hợp.
Brevo trả 204, Braze trả 201 nhưng có điểm cần lưu ý
Brevo hoàn toàn không trả nội dung - ở đó 2xx thực sự đã nói lên toàn bộ kết quả. Braze trả "message": "success" và có thể kèm mảng errors: vấn đề nghiêm trọng xuất hiện trong message, các trường bị bỏ qua nhưng được chấp nhận chỉ xuất hiện trong errors. Chỉ đọc một trong hai sẽ sai theo hướng này hoặc hướng kia.
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.