在 iOS SDK 中处理用户引导数据
当用户回答测验问题或在输入字段中输入数据时，onStateUpdatedAction 方法将被调用。你可以在代码中保存或处理字段类型。
例如：
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
}
}action 对象包含：
| 参数 | 描述 |
|---|---|
elementId | 输入元素的唯一标识符。可用于在保存时将问题与答案关联起来。 |
params | 用户输入数据对象，包含 type 和 value 属性。 |
params.type | 输入元素的类型，可选值为： • "select" - 从选项中单选• "multiSelect" - 从选项中多选• "input" - 文本输入框• "datePicker" - 日期选择 |
params.value | 用户选择或输入的值，结构取决于类型： • select：包含 id、value、label 的对象• multiSelect：由包含 id、value、label 的对象组成的数组• input：包含 type、value 的对象• datePicker：包含 day、month、year 的对象 |
已保存数据示例（实际实现可能有所不同）
// 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",
"value": {
"day": 15,
"month": 6,
"year": 1990
}
}
}使用场景
用户画像数据补全
如果你希望立即将用户输入的数据与其用户画像关联，避免重复询问同样的信息，可以在处理操作时用输入数据更新用户画像。
例如，你让用户在 ID 为 name 的文本框中输入姓名，并希望将该字段的值设置为用户的名字；同时让用户在 email 字段中输入邮箱。在你的应用代码中，实现方式如下：
func onboardingController(_ controller: AdaptyOnboardingController, onStateUpdatedAction action: AdaptyOnboardingsStateUpdatedAction) {
// 存储用户偏好或响应
switch action.params {
case .input(let params):
// 处理文本输入
let builder = AdaptyProfileParameters.Builder()
// 将 elementId 映射到相应的用户画像字段
switch action.elementId {
case "name":
builder.with(firstName: params.value.value)
case "email":
builder.with(email: params.value.value)
default:
break
}
// 委托方法是同步的；在 Task 中启动异步更新。
Task {
do {
try await Adapty.updateProfile(params: builder.build())
} catch {
// 处理错误
}
}
default:
break
}
}根据答案自定义付费墙
通过在用户引导中使用测验，你还可以根据用户完成引导后的情况，为他们展示定制化的付费墙。
例如，你可以询问用户的运动经验，并向不同用户群体展示不同的行动号召文案和产品。
- 在用户引导编辑器中添加测验，并为各选项设置有意义的 ID。
- 根据 ID 处理测验响应，并为用户设置自定义属性。
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
}
}