Kết nối FunnelFox với Adapty Mail

FunnelFox là một trong những điểm đầu vào của Adapty Mail — sử dụng khi bạn thu hút và tính phí người dùng thông qua web funnel FunnelFox. FunnelFox đã lưu trữ sẵn địa chỉ email, giao dịch mua và các sự kiện gói đăng ký của họ, vì vậy việc kết nối không cần bất kỳ công việc SDK nào hay yêu cầu nào từ phía bạn.

Kết nối này là một chiều. FunnelFox đẩy dữ liệu sang Adapty Mail; nó không đọc lại các chiến dịch của bạn, và cũng không tự gửi email.

FunnelFox gửi những gì

Hồ sơ người dùng và địa chỉ email, khi funnel thu thập email.
Các mã định danh: ID hồ sơ người dùng FunnelFox của người nhận, và ID người dùng tùy chỉnh mà funnel lưu cho họ (nếu có). Trên trang hồ sơ người dùng, chúng hiển thị trong phần External Profile IDs, dưới dạng hàng FunnelFox và hàng Custom.
Lịch sử mua hàng: các gói đăng ký, gia hạn và sản phẩm mua một lần. Hoàn tiền sẽ xuất hiện dưới dạng số âm.
Sự kiện gói đăng ký: hủy, kích hoạt lại, lỗi thanh toán và hết hạn. Đây là những gì đưa mỗi người dùng vào một flow.
Thuộc tính hồ sơ người dùng: quốc gia, thiết bị, hệ điều hành, nền tảng và ngôn ngữ — cả năm đều là bộ lọc phân khúc. FunnelFox đọc bốn giá trị cuối từ user agent của trình duyệt. Ngoài ra, FunnelFox cũng gửi múi giờ — thứ xác định thời điểm người nhận nhận email nhưng không phải là bộ lọc. FunnelFox không gửi phiên bản ứng dụng, vì vậy bộ lọc đó luôn trống đối với người dùng funnel.
Ngữ cảnh funnel, được lưu dưới dạng thuộc tính tùy chỉnh trên hồ sơ người dùng với các khóa sau:
- fnlfx_funnel_id: funnel đã thu thập email.
- fnlfx_session_id: phiên funnel.
- fnlfx_experiment_id: thử nghiệm funnel, nếu người dùng tham gia thử nghiệm.
- email_consent: liệu người dùng có đồng ý nhận email trong funnel hay không. Giá trị là chuỗi văn bản "true" hoặc "false", vì vậy bộ lọc phân khúc cho trường này sẽ so sánh văn bản.

Để truyền một trong các giá trị này đến trang thanh toán, hãy thêm placeholder của nó vào link — ví dụ: {custom_attribute.fnlfx_session_id}. Xem placeholders.

Dữ liệu sẽ đến Adapty Mail trong khoảng một phút sau khi sự kiện funnel xảy ra.

Kết nối FunnelFox

Hoàn tất phần cài đặt Adapty Mail của bạn trước — xem Bắt đầu với Adapty Mail. Nếu chưa có flow nào, mọi thứ bạn gửi đều sẽ không tạo ra email.

Trong Adapty Mail, vào Settings > Project và sao chép Secret key.
Trong FunnelFox, vào Integrations > Adapty Mail.
Dán key vào và lưu lại.

Để biết cách thiết lập phía FunnelFox, xem Hướng dẫn tích hợp của FunnelFox.

Sau khi kết nối

Trên trang của một hồ sơ người dùng, External Profile IDs hiển thị một dòng FunnelFox cùng với ID mà FunnelFox dùng để định danh người đó. Nếu một hồ sơ người dùng được báo cáo từ nhiều nguồn, mỗi nguồn sẽ có một dòng riêng, giúp bạn thấy tất cả các nguồn đã biết đến họ.

Khi bạn tự tạo link thanh toán, {funnelfox.external_profile_id} sẽ được thay thế bằng ID hồ sơ người dùng của người nhận trong FunnelFox. Đích email liệt kê tất cả các placeholder.

Sử dụng cùng với một entry point khác

Bạn có thể chạy FunnelFox cùng lúc với một entry point khác. Adapty Mail khớp người dùng theo địa chỉ email. Hai nguồn báo cáo cùng một địa chỉ sẽ được gộp vào một hồ sơ người dùng; hai địa chỉ khác nhau sẽ tạo ra các hồ sơ người dùng riêng biệt, dù customer_user_id có giống nhau.