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. 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 hiện nay. 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 làm gián đoạn người dùng trên các phiên bản app cũ hơn.

Flow hiện được hỗ trợ trên iOS, Android, React Native, Flutter và Capacitor SDK v4 trở lên. Hỗ trợ cho các nền tảng và framework khác sẽ sớm ra mắt.

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:

	Flow	Paywall xây dựng bằng Paywall Builder	Onboarding
Nhiều màn hình	Có	Không — chỉ một màn hình	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 riêng — để 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 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.

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

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

Trên trang Flows, nhấn Create flow để bắt đầu xây dựng, kết hợp onboarding và paywall của bạn thành một trải nghiệm liền mạch. Để 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 flow recipe phổ biến: Hướng dẫn từng bước cho các màn hình thông dụng nhất.
Hỏi AI: Dùng chat trên bất kỳ trang tài liệu nào khi bạn gặp khó khăn.

Tính năng tạo flow từ template có sẵn hoặc tạo tự động bằng AI hiện chưa khả dụng — cả hai sẽ sớm ra mắt. Hiện tại, mỗi flow mới sẽ bắt đầu với một số màn hình thông dụng mà bạn có thể chỉnh sửa và tùy chỉnh theo nhu cầu.

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

Bạn có thể xem trước flow trên thiết bị thật mà không cần chỉnh sửa ứng dụng. Tải ứng dụng Adapty từ App Store. Sau đó, trong flow 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ế, luồng phân nhánh, nội dung văn bản và giao diện thiết kế.

Trong chế độ xem trước, Adapty không thể kết nối với sản phẩm của bạn trên các cửa hàng, nên giá hiển thị trong bản xem trước không phải giá thực. Giao dịch mua thực sẽ được xác minh sau, trong bản build v4 với tài khoản sandbox — xem Cập nhật SDK.

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.

Giữ các placement cũ của bạn hoạt động trong suốt quá trình chuyển đổi Người dùng trên các phiên bản ứng dụng cũ đã có sẵn ID placement của onboarding và paywall được biên dịch trong ứng dụng. Họ vẫn tiếp tục gọi các phương thức onboarding và paywall và thấy onboarding cũng như paywall hiện tại của bạn cho đến khi cập nhật. Chỉ ngừng sử dụng các placement cũ khi tỷ lệ áp dụng SDK v4 đã đủ cao.

Danh sách placement với các tab riêng biệt cho Flows, Paywalls và Onboardings

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 flow đã sẵn sàng, hãy trỏ ứng dụng vào đó. Flow chỉ hoạt động 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 theo từng nền tảng — iOS, Android, React Native, hoặc Capacitor — để biết các bước nâng cấp cụ thể. Sau khi đã kết nối flow, hãy kiểm tra nó như bất kỳ luồng mua hàng nào khác: chạy trên thiết bị thực hoặc máy giả lập và thực hiện một giao dịch mua sandbox (iOS / Android) để 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.

Người dùng chỉ thấy flow sau khi họ cài đặt bản app được build với SDK v4+. Những ai đang dùng phiên bản app cũ hơn vẫn tiếp tục thấy onboarding và paywall hiện tại của bạn — đó là lý do các placement cũ vẫn được giữ hoạt động trong quá trình chuyển đổi. Điều tương tự cũng áp dụng cho các nền tảng chưa hỗ trợ flow.