Lấy onboarding và cấu hình của chúng
Onboardings đã bị deprecated kể từ Adapty SDK v4. Hãy xây dựng flows thay thế: không giống onboardings chạy trong WebView, flows render trực tiếp trên thiết bị — hiệu ứng mượt mà hơn, giao diện native nhất quán, tải nhanh hơn, và không phụ thuộc vào WebView runtime.
Sau khi bạn đã thiết kế phần giao diện cho onboarding của mình bằng trình dựng trong Adapty Dashboard, bạn có thể hiển thị nó trong ứng dụng di động của mình. Bước đầu tiên trong quy trình này là lấy onboarding được liên kết với placement và cấu hình hiển thị của nó như mô tả bên dưới.
Trước khi bắt đầu, hãy đảm bảo rằng:
- Bạn đã cài đặt Adapty iOS, Android, React Native, hoặc Flutter SDK phiên bản 3.8.0 trở lên.
- Bạn đã tạo một onboarding.
- Bạn đã thêm onboarding vào một placement.
Lấy dữ liệu onboarding
Khi bạn tạo một onboarding bằng công cụ no-code builder của chúng tôi, nó được lưu trữ dưới dạng một container chứa cấu hình mà ứng dụng cần lấy về và hiển thị. Container này quản lý toàn bộ trải nghiệm — nội dung hiển thị, cách trình bày, và cách xử lý các tương tác của người dùng (như câu trả lời quiz hoặc dữ liệu nhập vào form). Container cũng tự động ghi lại các sự kiện analytics, nên bạn không cần tự triển khai tính năng theo dõi lượt xem riêng.
Để đạt hiệu suất tốt nhất, hãy lấy cấu hình onboarding sớm để ảnh có đủ thời gian tải xuống trước khi hiển thị cho người dùng.
Để lấy một onboarding, hãy sử dụng phương thức getOnboarding:
do {
let onboarding = try await Adapty.getOnboarding(placementId: "YOUR_PLACEMENT_ID")
// the requested onboarding
} catch {
// handle the error
}
Các tham số:
| Tham số | Bắt buộc | Mô tả |
|---|---|---|
| placementId | bắt buộc | Định danh của Placement mong muốn. Đây là giá trị bạn đã chỉ định khi tạo placement trong Adapty Dashboard. |
| locale | tùy chọn mặc định: | Định danh của bản địa hóa onboarding. Tham số này cần là mã ngôn ngữ gồm một hoặc hai thẻ con được phân tách bằng ký tự dấu trừ (-). Thẻ con đầu tiên dùng cho ngôn ngữ, thẻ con thứ hai dùng cho khu vực. Ví dụ: Xem Localizations and locale codes để biết thêm thông tin về mã locale và cách chúng tôi khuyến nghị sử dụng chúng. |
| fetchPolicy | mặc định: .reloadRevalidatingCacheData | Theo mặc định, SDK sẽ cố tải dữ liệu từ máy chủ và trả về dữ liệu đã lưu trong cache nếu gặp lỗi. Chúng tôi khuyến nghị tùy chọn này vì nó đảm bảo người dùng luôn nhận được dữ liệu mới nhất. Tuy nhiên, nếu bạn cho rằng người dùng của mình thường xuyên gặp tình trạng kết nối internet không ổn định, hãy cân nhắc dùng Lưu ý rằng cache vẫn được giữ nguyên khi khởi động lại ứng dụng và chỉ bị xóa khi gỡ cài đặt ứng dụng hoặc thực hiện dọn dẹp thủ công. Adapty SDK lưu trữ onboardings cục bộ theo hai lớp: cache được cập nhật thường xuyên như mô tả ở trên và onboardings dự phòng. Chúng tôi cũng sử dụng CDN để tải onboardings nhanh hơn và một máy chủ dự phòng độc lập trong trường hợp CDN không thể truy cập. Hệ thống này được thiết kế để đảm bảo bạn luôn nhận được phiên bản mới nhất của onboardings trong khi vẫn đảm bảo độ tin cậy ngay cả khi kết nối internet hạn chế. |
| loadTimeout | mặc định: 5 giây | Giá trị này giới hạn thời gian chờ cho phương thức này. Nếu máy chủ Adapty không phản hồi kịp thời hoặc trả về lỗi, SDK sẽ trả về onboarding đã lưu trong cache. Nếu không có gì trong cache và máy chủ hết thời gian chờ hoặc trả về lỗi máy chủ, SDK sẽ yêu cầu onboarding từ máy chủ dự phòng (một bản sao CDN chỉ phục vụ đối tượng All Users của placement). Như là phương án cuối cùng, SDK trả về onboarding từ fallback file của bạn. SDK v3 sử dụng ba nguồn tương tự theo thứ tự khác. Lưu ý rằng trong một số trường hợp hiếm gặp, phương thức này có thể hết thời gian chờ muộn hơn một chút so với giá trị được chỉ định trong |
Các tham số phản hồi:
| Tham số | Mô tả |
|---|---|
| Onboarding | Một đối tượng AdaptyOnboarding bao gồm: mã định danh và cấu hình onboarding, Remote Config, và một số thuộc tính khác. |
Tăng tốc tải onboarding với onboarding đối tượng mặc định
Thông thường, onboarding được tải gần như ngay lập tức, nên bạn không cần lo lắng về việc tăng tốc quá trình này. Tuy nhiên, trong trường hợp bạn có nhiều đối tượng và onboarding, và người dùng có kết nối internet yếu, việc tải onboarding có thể mất nhiều thời gian hơn mong muốn. Trong những tình huống như vậy, bạn có thể muốn hiển thị một onboarding mặc định để đảm bảo trải nghiệm người dùng mượt mà thay vì không hiển thị gì cả.
Để giải quyết vấn đề này, bạn có thể sử dụng phương thức getOnboardingForDefaultAudience, phương thức này sẽ lấy onboarding của placement được chỉ định cho đối tượng All Users. Tuy nhiên, điều quan trọng cần hiểu là cách tiếp cận được khuyến nghị là lấy onboarding bằng phương thức getOnboarding, như đã trình bày chi tiết trong phần Fetch Onboarding ở trên.
Hãy cân nhắc sử dụng getOnboarding thay vì getOnboardingForDefaultAudience, vì phương thức sau có những hạn chế quan trọng:
- Vấn đề tương thích: Có thể gây ra sự cố khi hỗ trợ nhiều phiên bản app, đòi hỏi thiết kế tương thích ngược hoặc chấp nhận rằng các phiên bản cũ có thể hiển thị không đúng.
- Không có cá nhân hóa: Chỉ hiển thị nội dung cho đối tượng “All Users”, loại bỏ khả năng nhắm mục tiêu theo quốc gia, attribution, hoặc thuộc tính tùy chỉnh.
Nếu tốc độ tải nhanh hơn là ưu tiên và bù đắp được những hạn chế này trong trường hợp của bạn, hãy dùng getOnboardingForDefaultAudience như hướng dẫn bên dưới. Nếu không, hãy dùng getOnboarding như đã mô tả ở trên.
Adapty.getOnboardingForDefaultAudience(placementId: "YOUR_PLACEMENT_ID") { result in
switch result {
case let .success(onboarding):
// the requested onboarding
case let .failure(error):
// handle the error
}
}
Tham số:
| Tham số | Bắt buộc | Mô tả |
|---|---|---|
| placementId | bắt buộc | Mã định danh của Placement mong muốn. Đây là giá trị bạn đã chỉ định khi tạo placement trong Adapty Dashboard. |
| locale | tùy chọn mặc định: | Mã định danh của bản địa hóa onboarding. Tham số này được kỳ vọng là một mã ngôn ngữ gồm một hoặc hai thẻ phụ được phân tách bằng ký tự dấu trừ (-). Thẻ phụ đầu tiên dành cho ngôn ngữ, thẻ thứ hai dành cho vùng. Ví dụ: Xem Bản địa hóa và mã locale để biết thêm thông tin về mã locale và cách chúng tôi khuyến nghị sử dụng chúng. |
| fetchPolicy | mặc định: .reloadRevalidatingCacheData | Theo mặc định, SDK sẽ cố gắng tải dữ liệu từ máy chủ và trả về dữ liệu đã lưu trong cache khi gặp lỗi. Chúng tôi khuyến nghị tùy chọn này vì nó đảm bảo người dùng của bạn luôn nhận được dữ liệu mới nhất. Tuy nhiên, nếu bạn cho rằng người dùng của mình thường xuyên gặp phải kết nối internet không ổn định, hãy cân nhắc sử dụng Lưu ý rằng cache vẫn còn nguyên sau khi khởi động lại ứng dụng và chỉ bị xóa khi ứng dụng được cài đặt lại hoặc thông qua việc dọn dẹp thủ công. Adapty SDK lưu trữ onboarding cục bộ theo hai lớp: cache được cập nhật thường xuyên như mô tả ở trên và onboarding dự phòng. Chúng tôi cũng sử dụng CDN để tải onboarding nhanh hơn và một máy chủ dự phòng độc lập trong trường hợp CDN không thể truy cập được. Hệ thống này được thiết kế để đảm bảo bạn luôn nhận được phiên bản mới nhất của onboarding trong khi vẫn đảm bảo độ tin cậy ngay cả trong trường hợp kết nối internet yếu. |