XỠlý dữ liệu từ onboarding trong iOS SDK
Bắt đầu từ SDK v4, bạn có thể xây dá»±ng flow nhÆ° má»™t lá»±a chá»n mạnh mẽ hÆ¡n so vá»›i onboarding. Khác vá»›i onboarding chạy trong WebView, flow render trá»±c tiếp trên thiết bị — mang lại hiệu ứng chuyển Ä‘á»™ng mượt mà hÆ¡n, giao diện iOS 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 flow & paywall và Hiển thị flow & paywall để 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 onStateUpdatedAction 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ụ:
func onboardingController(_ controller: AdaptyOnboardingController, onStateUpdatedAction action: AdaptyOnboardingsStateUpdatedAction) {
// Store user preferences or responses
switch action.params {
case .select(let params):
// Handle single selection
case .multiSelect(let params):
// Handle multiple selections
case .input(let params):
// Handle text input
case .datePicker(let params):
// Handle date selection
}
}Äối tượng action chứa:
| Tham số | Mô tả |
|---|---|
elementId | Äịnh danh duy nhất cho phần tá» input. Bạn có thể dùng nó để liên kết câu há»i vá»›i câu trả lá»i khi lÆ°u lại. |
params | Äối tượng dữ liệu đầu và o của ngÆ°á»i dùng, chứa các thuá»™c tÃnh type và value. |
params.type | Loại phần tá» input. Có thể là : • "select" - Chá»n má»™t giá trị từ các tùy chá»n• "multiSelect" - Chá»n nhiá»u giá trị từ các tùy chá»n• "input" - TrÆ°á»ng nháºp văn bản• "datePicker" - Chá»n ngà y |
params.value | Giá trị được ngÆ°á»i dùng chá»n hoặc nháºp. Cấu trúc phụ thuá»™c và o loại: • select: Äối tượng có id, value, label• multiSelect: Mảng các đối tượng có id, value, label• input: Äối tượng có type, value• datePicker: Äối tượng có day, month, year |
Và dụ dữ liệu đã lưu (có thể khác với triển khai của bạn)
// Example of a saved select action
{
"elementId": "preference_selector",
"meta": {
"onboardingId": "onboarding_123",
"screenClientId": "preferences_screen",
"screenIndex": 1,
"screensTotal": 3
},
"params": {
"type": "select",
"value": {
"id": "option_1",
"value": "premium",
"label": "Premium Plan"
}
}
}
// Example of a saved multi-select action
{
"elementId": "interests_selector",
"meta": {
"onboardingId": "onboarding_123",
"screenClientId": "interests_screen",
"screenIndex": 2,
"screensTotal": 3
},
"params": {
"type": "multiSelect",
"value": [
{
"id": "interest_1",
"value": "sports",
"label": "Sports"
},
{
"id": "interest_2",
"value": "music",
"label": "Music"
}
]
}
}
// Example of a saved input action
{
"elementId": "name_input",
"meta": {
"onboardingId": "onboarding_123",
"screenClientId": "profile_screen",
"screenIndex": 0,
"screensTotal": 3
},
"params": {
"type": "input",
"value": {
"type": "text",
"value": "John Doe"
}
}
}
// Example of a saved date picker action
{
"elementId": "birthday_picker",
"meta": {
"onboardingId": "onboarding_123",
"screenClientId": "profile_screen",
"screenIndex": 0,
"screensTotal": 3
},
"params": {
"type": "datePicker",
"v ÿÿ alue": {
"day": 15,
"month": 6,
"year": 1990
}
}
}Các trÆ°á»ng hợp sá» dụng
Là m phong phú thêm dữ liệu hồ sÆ¡ ngÆ°á»i dùng
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 vá» 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 của há» 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 ứng dụng của bạn, nó có thể trông nhÆ° thế nà y:
func onboardingController(_ controller: AdaptyOnboardingController, onStateUpdatedAction action: AdaptyOnboardingsStateUpdatedAction) {
// Store user preferences or responses
switch action.params {
case .input(let params):
// Handle text input
let builder = AdaptyProfileParameters.Builder()
// Map elementId to appropriate profile field
switch action.elementId {
case "name":
builder.with(firstName: params.value.value)
case "email":
builder.with(email: params.value.value)
default:
break
}
// Delegate methods are synchronous; kick off the async update in a Task.
Task {
do {
try await Adapty.updateProfile(params: builder.build())
} catch {
// handle the error
}
}
default:
break
}
}Tùy chỉnh paywall dá»±a trên câu trả lá»i
Sá» dụng quiz trong onboarding, bạn cÅ©ng có thể tùy chỉnh các 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 cùng sản phẩm khác nhau cho từng nhóm ngÆ°á»i dùng.
- Thêm quiz trong trình tạo onboarding và gán ID có ý nghÄ©a cho các lá»±a chá»n của quiz.
- Xá» lý các phản hồ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.
func onboardingController(_ controller: AdaptyOnboardingController, onStateUpdatedAction action: AdaptyOnboardingsStateUpdatedAction) {
// Handle quiz responses and set custom attributes
switch action.params {
case .select(let params):
// Handle quiz selection
let builder = AdaptyProfileParameters.Builder()
// Map quiz responses to custom attributes
switch action.elementId {
case "experience":
// Set custom attribute 'experience' with the selected value (beginner, amateur, pro)
try? builder.with(customAttribute: params.value.value, forKey: "experience")
default:
break
}
// Delegate methods are synchronous; kick off the async update in a Task.
Task {
do {
try await Adapty.updateProfile(params: builder.build())
} catch {
// handle the error
}
}
default:
break
}
}- Tạo phân khúc cho từng giá trị thuá»™c tÃnh tùy chỉnh.
- Tạo một placement và thêm đối tượng cho từng phân khúc bạn đã tạo.
- Hiển thị paywall cho placement trong code ứng dụng của bạn. Nếu onboarding 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.