Kết nối FunnelFox với Adapty

FunnelFox xây dựng web funnel: các landing page và quiz giúp bán gói đăng ký của bạn bên ngoài App Store và Google Play. Kết nối FunnelFox với Adapty để cấp quyền truy cập tính năng trả phí trong ứng dụng di động cho người mua hàng qua web, đồng thời xem giao dịch của họ trên cùng dashboard với các giao dịch từ cửa hàng.

Kết nối chỉ cần một khóa và một ID mức độ truy cập. Sau đó, ứng dụng của bạn cần xác định người mua để đạt được mức độ truy cập đó. Xem Cấp quyền truy cập trong ứng dụng của bạn.

Cách tích hợp hoạt động

FunnelFox thu thập thanh toán trên web. Sau đó, FunnelFox gọi Adapty Server-side API để tạo hồ sơ người dùng, ghi lại giao dịch và cấp mức độ truy cập có ID bạn nhập trong cài đặt tích hợp FunnelFox. Các lần gia hạn, hủy và thanh toán thất bại đều cập nhật hồ sơ người dùng đó. Các giao dịch mua trên web sẽ xuất hiện trong Adapty analytics cùng với doanh thu từ App Store và Google Play.

Adapty liên kết giao dịch mua trên web với người dùng ứng dụng thông qua customer user ID. Theo mặc định, FunnelFox sử dụng địa chỉ email được nhập khi thanh toán làm ID đó.

Để tự xây dựng flow tương tự với quy trình thanh toán web của riêng bạn thay vì dùng FunnelFox funnel, hãy xem Đồng bộ giao dịch mua giữa web và mobile.

Kết nối FunnelFox

Bạn thiết lập kết nối ở phía FunnelFox, theo hướng dẫn tích hợp Adapty của FunnelFox. Hướng dẫn này yêu cầu hai giá trị từ Adapty:

• Secret API key: Mở App Settings trong Adapty và sao chép secret key.
• Access level ID: Mức độ truy cập cần cấp. Bạn cũng có thể thiết lập riêng cho từng phần tử checkout, như mô tả trong Thiết lập mức độ truy cập cho từng phần tử checkout.

Đặt mức độ truy cập cho từng phần tử thanh toán

Trong FunnelFox, trường Custom entitlement trên một phần tử thanh toán xác định mức độ truy cập mà giao dịch mua qua phần tử đó cấp cho người dùng. Mọi ứng dụng Adapty đều bắt đầu với mức độ truy cập premium; nếu muốn cấp mức độ truy cập khác, hãy tạo mức độ đó trước.

Đặt trường này cho từng phần tử thanh toán trong funnel. Một funnel có thể chứa nhiều hơn một phần tử, chẳng hạn như nút Wallet và một accordion checkout, và mỗi phần tử đều có trường Custom entitlement riêng.

Cấp quyền truy cập trong ứng dụng của bạn

Để mở khóa các tính năng trả phí cho người mua qua web, hãy gọi Adapty.activate() hoặc Adapty.identify() với cùng customer user ID mà FunnelFox đã sử dụng. Theo mặc định, ID đó là địa chỉ email mà người mua đã nhập khi thanh toán. Xem Identifying users iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform, và Capacitor để biết cách gọi.

Cài đặt ứng dụng từ một liên kết trong funnel không tự động xác định người mua. Cho đến khi ứng dụng của bạn gọi Adapty.identify() với ID khớp, hồ sơ người dùng đang giữ mức độ truy cập và hồ sơ người dùng mà ứng dụng đã tạo vẫn tách biệt, và ứng dụng sẽ không hiển thị quyền truy cập đã trả phí. Đăng nhập bằng email thanh toán sẽ ghép hai hồ sơ đó lại với nhau.

Để mở khóa quyền truy cập mà không cần bước đăng nhập, hãy truyền customer user ID từ funnel vào ứng dụng thông qua deferred deep link, sau đó gọi Adapty.identify() với ID đó khi khởi chạy lần đầu.

Sau đó đọc mức độ truy cập từ hồ sơ người dùng để mở khóa các tính năng. Xem Kiểm tra trạng thái gói đăng ký iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform, và Capacitor .

Kiểm tra tích hợp

1. Hoàn tất một giao dịch mua trong funnel của bạn.
2. Trong Adapty, mở Profiles và tìm hồ sơ người dùng theo customer user ID mà FunnelFox sử dụng.
3. Xác nhận rằng mức độ truy cập có ID bạn đã nhập trong cài đặt tích hợp FunnelFox đang hoạt động trên hồ sơ đó.
4. Mở ứng dụng, xác định cùng người dùng đó và xác nhận rằng các tính năng trả phí đã được mở khóa.

Khắc phục sự cố

Người mua qua web mở ứng dụng nhưng không có quyền truy cập

Ứng dụng của bạn chưa xác định được người mua. FunnelFox đã cấp mức độ truy cập cho một hồ sơ người dùng được định danh bằng ID mà nó sử dụng — mặc định là email thanh toán — nhưng ứng dụng của bạn đang đọc một hồ sơ người dùng khác. Hãy gọi Adapty.identify() với ID đó, như được mô tả trong Cấp quyền truy cập trong ứng dụng của bạn.

Các tích hợp FunnelFox khác

FunnelFox kết nối với ba sản phẩm của Adapty, mỗi sản phẩm được thiết lập riêng biệt.