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, PURCHASED và 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ào PAGE_VIEWED sẽ 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ảngTrường tài khoảnKhóa
ActiveCampaignactidTrang web → Theo dõi trang web, cạnh khóa sự kiện
MailchimpID đối tượngKhóa API - giữ hậu tố dạng -us14 vì trung tâm dữ liệu được đọc từ đó
Iterablekhông cần - để trốngKhóa có quyền “Cho phép lệnh gọi theo dõi sự kiện”
Klaviyokhông cần - để trốngKhó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ấpNhận diện bằng
BrazeĐiểm cuối REST và khóa APIđịa chỉ email
Customer.ioID trang web, khóa API và khu vực của bạnID khách hàng riêng của bạn
Brevochỉ 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.