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.

Tạo một sản phẩm tương ứng trong Adapty cho mỗi sản phẩm mà funnel của bạn bán. Giao dịch mua vẫn sẽ được ghi nhận vào Adapty dù sao, nhưng nếu không có sản phẩm, Adapty sẽ không biết thời hạn gói đăng ký, khiến analytics có thể báo cáo sai thời hạn hoặc để giao dịch không được phân loại.

Adapty liên kết mộ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 nhập vào lúc thanh toán làm ID đó.

Nếu funnel của bạn thanh toán qua Stripe hoặc Paddle, bạn không cần phải kết nối thêm nhà cung cấp đó với Adapty. Chỉ kết nối khi bạn cũng bán hàng qua đó ngoài các funnel, và Adapty sẽ tự động loại trùng các giao dịch đến từ cả hai nguồn.

Để xây dựng flow tương tự với trang thanh toán web của riêng bạn thay vì funnel FunnelFox, 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 mà một giao dịch mua 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 độ khác, hãy tạo mới trước.

Cấp các mức độ truy cập khác nhau trong một funnel

Một funnel chỉ bán một gói duy nhất không cần thiết lập gì ở đây: mọi lần mua đều cấp mức độ truy cập theo cài đặt tích hợp.

Để bán nhiều hơn một gói từ một funnel, hãy dùng trường Custom entitlement trên phần tử checkout. Trường này ghi đè access level ID từ cài đặt tích hợp, áp dụng cho các giao dịch mua qua phần tử đó. Một funnel có thể chứa nhiều phần tử checkout, chẳng hạn như nút Wallet và một accordion checkout. Mỗi phần tử có trường Custom entitlement riêng, vì vậy hãy điền vào tất cả các phần tử cần ghi đè.

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.