Migrate sang flows

Trong Adapty, một flow kết hợp onboarding và paywall thành một thực thể duy nhất đằng sau một placement. Flow thay thế cho onboarding và paywall riêng biệt mà bạn xây dựng và phục vụ độc lập.

Hướng dẫn này giải thích những gì thay đổi khi bạn chuyển sang flow, và cách triển khai thay đổi mà không gây gián đoạn cho người dùng trên các phiên bản app cũ hơn.

Flow so với onboarding và paywall

Với onboarding và paywall riêng biệt, bạn phải quản lý hai builder và hai placement. Bạn cũng phải tự viết code để chuyển người dùng từ onboarding sang paywall.

Một flow thay thế cả hai bằng một trải nghiệm liền mạch — màn hình giới thiệu, quiz, và màn hình mua hàng — được xây dựng trong một editor và phục vụ từ một placement duy nhất.

Bảng dưới đây so sánh những gì mỗi lựa chọn mang lại cho bạn:

Bạn có nên migrate không?

Nếu bạn đang xây dựng theo hướng lâu dài, flow là nền tảng tốt hơn — hãy migrate sang flow khi phù hợp với lịch phát hành của bạn.

Cách thực hiện migration

Migration gồm bốn bước. Phần lớn công sức là nâng cấp SDK một lần duy nhất — việc xây dựng và xem trước flow không cần code.

1. Tạo flow của bạn: Chuyển đổi paywall hiện có chỉ với một cú nhấp, hoặc tạo flow từ template; không cần lập trình viên.
2. Xem trước trên thiết bị: Kiểm tra flow trên thiết bị thực qua ứng dụng di động Adapty; không cần build app.
3. Tạo placement mới cho flow: Tạo một placement flow mới với ID riêng, và quyết định cách nó cùng tồn tại với các placement hiện có.
4. Cập nhật SDK: Nâng cấp lên Adapty SDK v4, lấy flow từ placement của nó, và xác minh giao dịch mua trong sandbox. Đây là nhiệm vụ chính của lập trình viên.

Xây dựng flow của bạn

Nếu paywall của bạn được xây dựng trong Paywall Builder cũ, bạn có thể chuyển đổi nó thành flow thay vì xây dựng lại từ đầu. Nếu không, bạn có thể sử dụng template có sẵn hoặc xây dựng flow từ đầu. Tìm hiểu thêm về flow & paywall builder:

• Tài liệu Flow builder: Hướng dẫn bạn qua builder và những gì bạn có thể tạo ra.
• Các flow phổ biến: Hướng dẫn từng bước cho các màn hình phổ biến nhất.
• Ask AI: Sử dụng chat trên bất kỳ trang tài liệu nào khi bạn gặp khó khăn.

Xem trước trên thiết bị

Bạn có thể xem trước flow trên thiết bị thực mà không cần chỉnh sửa ứng dụng. Tải ứng dụng Adapty cho iOS hoặc Android. Sau đó, trong flow builder, nhấp vào Test on device, chọn ngôn ngữ và quét mã QR bằng thiết bị của bạn. Thao tác này hiển thị các màn hình thực tế, nhánh điều hướng, nội dung và giao diện thiết kế.

Tạo một placement mới cho flow của bạn

Một placement chỉ phục vụ một loại nội dung duy nhất — một flow, một paywall, hoặc một onboarding. Bạn không thể chuyển đổi placement onboarding hay paywall hiện có thành placement flow (xem loại placement). Một flow cần có placement mới riêng của nó.

Đặt cho placement flow mới một placement ID hoàn toàn mới và duy nhất. ID này không được trùng hoặc tái sử dụng ID của bất kỳ placement paywall hay onboarding nào đang tồn tại.

Bạn không cần phải chuyển tất cả các vị trí sang flow cùng một lúc. Trong SDK v4, phương thức getFlow lấy dữ liệu từ cả flow placement lẫn paywall placement, vì vậy ứng dụng của bạn gọi cùng một phương thức ở mọi nơi. Giữ nguyên các paywall Paywall Builder ở những placement bạn muốn, và dùng flow cho phần còn lại. Trong quá trình chuyển đổi, mỗi loại placement theo dõi chỉ số riêng của nó. Khi cả phiên bản app cũ và mới đều đang hoạt động, dữ liệu của bạn sẽ được chia thành hai tập placement. Các placement onboarding và paywall cũ phục vụ các phiên bản app cũ hơn; placement flow mới phục vụ SDK v4+. Hãy so sánh chúng như các cohort riêng biệt, và lưu ý rằng tỷ lệ của placement flow sẽ tăng dần khi người dùng cập nhật app. Bạn vẫn có thể chạy A/B test với flow: chạy A/B test thông thường trên các biến thể flow ở một placement flow. A/B test đa placement hiện chỉ hỗ trợ cho paywall, nên bạn chưa thể chạy loại này trên các placement flow. Việc so sánh một flow mới với paywall cũ là so sánh cohort, không phải một bài test đơn lẻ — vì chúng thuộc hai loại placement khác nhau.

Cập nhật SDK

Sau khi placement của flow đã sẵn sàng, hãy trỏ ứng dụng vào đó. Flow chỉ hiển thị trên Adapty SDK v4 trở lên. Hãy nâng cấp SDK và lấy flow từ placement mới bằng getFlow. Xem hướng dẫn migration lên v4 cho nền tảng của bạn — iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform, hoặc Capacitor — để biết các bước nâng cấp cụ thể.

Sau khi kết nối flow xong, hãy kiểm tra như bất kỳ flow mua hàng nào khác: chạy trên thiết bị hoặc simulator và thực hiện một giao dịch mua sandbox để xác nhận rằng sản phẩm, giao dịch mua và mức độ truy cập đều hoạt động đúng. Xem hướng dẫn kiểm tra cho nền tảng của bạn: iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform, hoặc Capacitor.