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 sau một placement. Một flow thay thế cho onboarding và paywall riêng lẻ 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 sự thay đổi mà không làm gián đoạn người dùng trên các phiên bản ứng dụng cũ hơn.

Flow với onboarding và paywall

Khi dùng onboarding và paywall riêng biệt, bạn phải quản lý hai builder và hai placement, đồng thờ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 duy nhất và phục vụ từ một placement duy nhất. Placement đó là một placement mới: flow là loại nội dung riêng, nên không thể chạy trên placement onboarding hay paywall mà nó thay thế.

Bảng dưới đây so sánh những gì mỗi tùy 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 tạo bằng legacy Paywall Builder, hãy chuyển đổi thay vì xây dựng lại từ đầu. Thao tác Move to new builder sẽ tái tạo nó thành một flow nháp chỉ với một cú nhấp — bố cục, nội dung ở mọi ngôn ngữ, và sản phẩm với giá dưới dạng biến — trong khi bản gốc vẫn hoạt động bình thường để bạn chỉnh sửa và kiểm thử. Xem Chuyển đổi paywall thành flow.

Để xây dựng thứ gì đó mới, hãy chọn hướng phù hợp:

• Bắt đầu từ template: Một template khởi đầu hoặc flow trắng trong Flow & Paywall Builder, không cần code.
• Dùng agent skill: Công cụ AI coding của bạn tự tạo và chỉnh sửa flow từ terminal — hữu ích cho quiz, phân nhánh và thêm locale hàng loạt.

Tham khảo khi bạn xây dựng:

• Tài liệu về Flow & Paywall Builder: Hướng dẫn bạn qua builder và những gì bạn có thể tạo ra.
• Các flow mẫu phổ biến: Hướng dẫn từng bước cho các màn hình phổ biến nhất.
• Hỏi 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 app. Tải app Adapty dành cho iOS hoặc Android. Sau đó, trong Flow & Paywall Builder, nhấn 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 sẽ hiển thị các màn hình thực tế, nhánh rẽ, nội dung và thiết kế.

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

Flow, paywall và onboarding là ba loại nội dung khác nhau, mỗi loại được đo lường bằng bộ chỉ số riêng — đó là lý do tại sao mỗi placement chỉ phục vụ một loại. Loại của placement được cố định ngay khi bạn tạo, vì vậy không thể chuyển đổi một placement onboarding hoặc paywall hiện có thành placement flow (xem loại placement). Mỗi flow bạn cung cấp đều cần một placement riêng mớ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ả placement của flow lẫn placement của paywall, 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ữ các paywall của Paywall Builder trong các placement mà bạn muốn, và sử dụng flow ở những vị trí 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ể thực hiện A/B test với các flow: chạy A/B test thông thường trên các biến thể flow trong một placement flow. A/B test xuyên placement hiện chỉ khả dụng 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 duy nhất — chúng thuộc hai loại placement khác nhau.

Tạo các placement bằng agent skill

З більш ніж кількома placement для переміщення, навик migrate-placements створює їх із вашого власного інструменту кодування з AI. Він зчитує кожен placement у вашому застосунку через Adapty CLI, групує їх за paywall, який кожен обслуговує, запитує для кожного paywall, звідки надходить flow, потім створює один flow placement на кожен paywall placement у межах охоплення та повертає зіставлення старих і нових ID разом із викликом getFlow, який потрібно включити у ваш застосунок.

Khi có nhiều hơn một vài placement cần chuyển, kỹ năng migrate-placements sẽ tạo chúng từ chính công cụ lập trình AI của bạn. Nó đọc toàn bộ placement trong ứng dụng thông qua Adapty CLI, nhóm chúng theo paywall mà mỗi placement phục vụ, hỏi từng paywall xem flow đến từ đâu, sau đó tạo một flow placement cho mỗi paywall placement trong phạm vi và trả về mapping ID cũ-mới cùng với lệnh gọi getFlow mà ứng dụng của bạn cần triển khai.

Các placement paywall của bạn chỉ được đọc, không bao giờ bị chỉnh sửa, vì vậy chúng vẫn hoạt động bình thường trong khi bạn làm việc, và mọi placement ID mà skill đề xuất đều chờ sự phê duyệt của bạn.

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.