Trong Adapty, một flow kết hợp onboarding và paywall thành một thực thể duy nhất dưới một placement. Flow thay thế onboarding và paywall riêng lẻ mà bạn đang xây dựng và phục vụ độc lập hiện nay.

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

Flows so với onboardings và paywalls

Với onboardings và paywalls riêng lẻ, bạn phải duy trì hai builder và hai placement. Bạn cũng phải tự xử lý việc chuyển người dùng từ onboarding sang paywall trong code của mình.

Một flow thay thế cả hai bằng một trải nghiệm duy nhất — màn hình giới thiệu, bài 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.

Bảng dưới đây so sánh những gì mỗi tùy chọn cung cấp:

	Flow	Paywall Builder paywall	Onboarding
Nhiều màn hình	Có	Không — màn hình đơn	Có
Hiển thị	Native	Native	WebView
Sản phẩm và placement	Một placement; bạn thêm sản phẩm trực tiếp vào flow	Một placement; bạn thêm sản phẩm trực tiếp vào paywall	Một placement, nhưng không có sản phẩm của riêng nó — để bán hàng, bạn tạo một paywall riêng và phục vụ nó từ placement của chính nó

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

Các onboardings và paywalls hiện tại của bạn vẫn hoạt động bình thường, và Adapty tiếp tục hỗ trợ chúng. Tuy nhiên, các tính năng mới sẽ được phát triển cho flows thay vì các builder onboarding và paywall độc lập.

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

Cách migrate

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

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

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

Trên trang Flows, nhấp Create flow để bắt đầu xây dựng, tái tạo onboarding và paywall của bạn thành một trải nghiệm duy nhất. Để tìm hiểu thêm về builder:

• Tài liệu Flows: Hướng dẫn bạn qua builder và những gì bạn có thể tạo ra.
• Các công thứ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.
• 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 xuống app Adapty từ App Store. Sau đó, trong flow builder, nhấp 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ế, phân nhánh, nội dung và 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 — flow, paywall hoặc onboarding. Bạn không thể chuyển đổi một placement onboarding hoặc paywall hiện có thành flow placement (xem loại placement). Một flow cần placement mới của riêng nó.

Đặt cho flow placement 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 hoặc onboarding nào hiện có.

Bạn không cần phải chuyển tất cả các vị trí sang flows cùng một lúc. Trong iOS SDK v4, phương thức getFlow lấy dữ liệu từ cả flow placement và paywall placement, vì vậy app của bạn gọi cùng một phương thức ở mọi nơi. Giữ các paywall Paywall Builder trong các placement mà bạn muốn, và sử dụng flows ở phần còn lại.

Trong thời gian chuyển tiếp, mỗi loại placement theo dõi chỉ số của riêng mình. Trong khi cả phiên bản app cũ và mới đều đang hoạt động, dữ liệu của bạn sẽ phân tán trên hai bộ placement. Các placement onboarding và paywall cũ phủ các phiên bản cũ hơn; flow placement mới phủ SDK v4+. So sánh chúng như các cohort riêng biệt, và dự kiến tỷ lệ của flow placement sẽ tăng khi người dùng cập nhật.

Bạn có thể tiếp tục A/B test với flows: chạy A/B test thông thường trên các biến thể flow trong một flow placement. A/B test đa placement hiện chỉ khả dụng cho paywalls, vì vậy bạn chưa thể chạy loại này trên các flow placement. Việc so sánh một flow mới với paywall cũ của bạn là so sánh cohort, không phải một bài test duy nhất — chúng thuộc các loại placement khác nhau.

Cập nhật SDK

Khi flow placement của bạn đã sẵn sàng, hãy trỏ app vào nó. Flows chỉ hiển thị trên Adapty SDK v4 trở lên. Nâng cấp SDK và lấy flow từ placement mới của bạn bằng getFlow(placementId:). Xem hướng dẫn migration iOS SDK v4 để biết các bước nâng cấp cụ thể.

Sau khi flow đã được kết nối, hãy xác minh nó như bất kỳ flow mua hàng nào khác: chạy nó trên thiết bị hoặc simulator và thực hiện 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.