XỠlý dữ liệu từ onboarding trong Kotlin Multiplatform SDK
Onboarding đã bị deprecated trong SDK v4 và sẽ bị xóa trong các phiên bản tÆ°Æ¡ng lai. Chúng không còn nháºn được các bản sá»a lá»—i hay cải tiến nữa. Hãy sá» dụng flows thay thế: khác vá»›i onboarding chạy trong WebView, flows render trá»±c tiếp trên thiết bị — mang lại hiệu ứng animation mượt mà hÆ¡n, giao diện native nhất quán, thá»i gian tải nhanh hÆ¡n và không phụ thuá»™c và o WebView runtime. Xem Lấy flows & paywalls và Hiển thị flows & paywalls để bắt đầu.
Khi ngÆ°á»i dùng trả lá»i câu há»i trong bà i quiz hoặc nháºp dữ liệu và o trÆ°á»ng nháºp liệu, phÆ°Æ¡ng thức onboardingViewOnStateUpdatedAction sẽ được gá»i. Bạn có thể lÆ°u hoặc xá» lý loại trÆ°á»ng đó trong code của mình.
Và dụ:
class MyAdaptyUIOnboardingsEventsObserver : AdaptyUIOnboardingsEventsObserver {
override fun onboardingViewOnStateUpdatedAction(
view: AdaptyUIOnboardingView,
meta: AdaptyUIOnboardingMeta,
elementId: String,
params: AdaptyOnboardingsStateUpdatedParams
) {
// Store user preferences or responses
when (params) {
is AdaptyOnboardingsSelectParams -> {
// Handle single selection
val id = params.id
val value = params.value
val label = params.label
AppLogger.d("Selected option: $label (id: $id, value: $value)")
}
is AdaptyOnboardingsMultiSelectParams -> {
// Handle multiple selections
}
is AdaptyOnboardingsInputParams -> {
// Handle text input
}
is AdaptyOnboardingsDatePickerParams -> {
// Handle date selection
}
}
}
}
// Set up the observer
AdaptyUI.setOnboardingsEventsObserver(MyAdaptyUIOnboardingsEventsObserver())Và dụ dữ liệu đã lưu (định dạng có thể khác trong phần triển khai của bạn)
// Example of a saved select action
{
"id": "onboarding_on_state_updated_action",
"view": { /* AdaptyUI.OnboardingView object */ },
"meta": {
"onboarding_id": "onboarding_123",
"screen_cid": "preferences_screen",
"screen_index": 1,
"total_screens": 3
},
"action": {
"element_id": "preference_selector",
"element_type": "select",
"value": {
"id": "option_1",
"value": "premium",
"label": "Premium Plan"
}
}
}
// Example of a saved multi-select action
{
"id": "onboarding_on_state_updated_action",
"view": { /* AdaptyUI.OnboardingView object */ },
"meta": {
"onboarding_id": "onboarding_123",
"screen_cid": "interests_screen",
"screen_index": 2,
"total_screens": 3
},
"action": {
"element_id": "interests_selector",
"element_type": "multi_select",
"value": [
{
"id": "interest_1",
"value": "sports",
"label": "Sports"
},
{
"id": "interest_2",
"value": "music",
"label": "Music"
}
]
}
}
// Example of a saved input action
{
"id": "onboarding_on_state_updated_action",
"view": { /* AdaptyUI.OnboardingView object */ },
"meta": {
"onboarding_id": "onboarding_123",
"screen_cid": "profile_screen",
"screen_index": 0,
"total_screens": 3
},
"action": {
"element_id": "name_input",
"element_type": "input",
"value": {
"type": "text",
"value": "John Doe"
}
}
}
// Example of a saved date picker action
{
"id": "onboarding_on_state_updated_action",
"view": { /* AdaptyUI.OnboardingView object */ },
"meta": {
"onboarding_id": "onboarding_123",
"screen_cid": "profile_screen",
"screen_index": 0,
"total_screens": 3
},
"action": {
"element_id": "birthday_picker",
"element_type": "date_picker",
"value": {
"day": 15,
"month": 6,
"year": 1990
}
}
}Các trÆ°á»ng hợp sá» dụng
Là m phong phú hồ sÆ¡ ngÆ°á»i dùng vá»›i dữ liệu
Nếu bạn muốn liên kết ngay dữ liệu đầu và o vá»›i hồ sÆ¡ ngÆ°á»i dùng và tránh há»i há» hai lần cùng má»™t thông tin, bạn cần cáºp nháºt hồ sÆ¡ ngÆ°á»i dùng vá»›i dữ liệu đầu và o khi xá» lý action.
Và dụ: bạn yêu cầu ngÆ°á»i dùng nháºp tên và o trÆ°á»ng văn bản có ID là name, và bạn muốn đặt giá trị của trÆ°á»ng nà y là m tên của ngÆ°á»i dùng. Ngoà i ra, bạn yêu cầu há» nháºp email và o trÆ°á»ng email. Trong code của ứng dụng, nó có thể trông nhÆ° thế nà y:
class MyAdaptyUIOnboardingsEventsObserver : AdaptyUIOnboardingsEventsObserver {
override fun onboardingViewOnStateUpdatedAction(
view: AdaptyUIOnboardingView,
meta: AdaptyUIOnboardingMeta,
elementId: String,
params: AdaptyOnboardingsStateUpdatedParams
) {
// Store user preferences or responses
when (params) {
is AdaptyOnboardingsInputParams -> {
// Handle text input
val builder = AdaptyProfileParameters.Builder()
// Map elementId to appropriate profile field
when (elementId) {
"name" -> {
when (val input = params.input) {
is AdaptyOnboardingsTextInput -> {
builder.withFirstName(input.value)
}
}
}
"email" -> {
when (val input = params.input) {
is AdaptyOnboardingsEmailInput -> {
builder.withEmail(input.value)
}
}
}
}
// Update profile asynchronously
mainUiScope.launch {
val profileParams = builder.build()
val result = Adapty.updateProfile(profileParams)
result.onSuccess { profile ->
// Profile updated successfully
AppLogger.d("Profile updated: ${profile.email}")
}.onError { error ->
// Handle the error
AppLogger.e("Failed to update profile: ${error.message}")
}
}
}
}
}
}
// Set up the observer
AdaptyUI.setOnboardingsEventsObserver(MyAdaptyUIOnboardingsEventsObserver())Tùy chỉnh paywall dá»±a trên câu trả lá»i
Bằng cách sá» dụng các bà i quiz trong onboarding, bạn cÅ©ng có thể tùy chỉnh paywall hiển thị cho ngÆ°á»i dùng sau khi há» hoà n thà nh onboarding.
Và dụ, bạn có thể há»i ngÆ°á»i dùng vá» kinh nghiệm thể thao của há» và hiển thị các CTA và sản phẩm khác nhau cho các nhóm ngÆ°á»i dùng khác nhau.
- Thêm má»™t bà i quiz trong trình tạo onboarding và gán ID có ý nghÄ©a cho các tùy chá»n của nó.
- Xá» lý các phản hồi bà i quiz dá»±a trên ID của chúng và đặt thuá»™c tÃnh tùy chỉnh cho ngÆ°á»i dùng.
class MyAdaptyUIOnboardingsEventsObserver : AdaptyUIOnboardingsEventsObserver {
override fun onboardingViewOnStateUpdatedAction(
view: AdaptyUIOnboardingView,
meta: AdaptyUIOnboardingMeta,
elementId: String,
params: AdaptyOnboardingsStateUpdatedParams
) {
// Handle quiz responses and set custom attributes
when (params) {
is AdaptyOnboardingsSelectParams -> {
// Handle quiz selection
val builder = AdaptyProfileParameters.Builder()
// Map quiz responses to custom attributes
when (elementId) {
"experience" -> {
// Set custom attribute 'experience' with the selected value (beginner, amateur, pro)
builder.withCustomAttribute("experience", params.value)
}
}
// Update profile asynchronously
mainUiScope.launch {
val profileParams = builder.build()
val result = Adapty.updateProfile(profileParams)
result.onSuccess { profile ->
// Profile updated successfully
AppLogger.d("Custom attribute 'experience' set to: ${params.value}")
}.onError { error ->
// Handle the error
AppLogger.e("Failed to update profile: ${error.message}")
}
}
}
}
}
}
// Set up the observer
AdaptyUI.setOnboardingsEventsObserver(MyAdaptyUIOnboardingsEventsObserver())- Tạo phân khúc cho má»—i giá trị thuá»™c tÃnh tùy chỉnh.
- Tạo một placement và thêm đối tượng cho mỗi phân khúc bạn đã tạo.
- Hiển thị paywall cho placement trong code của ứng dụng. Nếu onboarding của bạn có nút mở paywall, hãy triển khai code paywall như một phản hồi cho hà nh động của nút nà y.