在 Unity SDK 中处理用户引导数据
当您的用户回答测验问题或在输入字段中填写数据时，OnboardingViewOnStateUpdatedAction 方法将被调用。您可以在代码中保存或处理字段类型。
在您的类中实现 OnboardingViewOnStateUpdatedAction 方法：
在 SDK 4.0 中，监听器接口遵循 C# 的 I 前缀命名规范：请实现 IAdaptyOnboardingsEventsListener 而非 AdaptyOnboardingsEventsListener。方法本身保持不变。详见迁移指南。
public class OnboardingManager : MonoBehaviour, AdaptyOnboardingsEventsListener
{
public void OnboardingViewOnStateUpdatedAction(
AdaptyUIOnboardingView view,
AdaptyUIOnboardingMeta meta,
string elementId,
AdaptyOnboardingsStateUpdatedParams @params
)
{
switch (@params) {
case AdaptyOnboardingsSelectParams selectParams:
// handle single selection
break;
case AdaptyOnboardingsMultiSelectParams multiSelectParams:
// handle multiple selections
break;
case AdaptyOnboardingsInputParams inputParams:
// handle text input
break;
case AdaptyOnboardingsDatePickerParams datePickerParams:
// handle date selection
break;
}
}
// ... other interface methods
}参数说明如下：
| 参数 | 描述 |
|---|---|
elementId | 输入元素的唯一标识符。保存答案时可用它将问题与答案关联起来。 |
@params | 用户输入数据对象，可以是以下类型之一。 |
AdaptyOnboardingsSelectParams | 从选项中单选。包含 Id、Value、Label |
AdaptyOnboardingsMultiSelectParams | 从选项中多选。包含一个 Params 列表（每项包含 Id、Value、Label）• input：包含 type、value 的对象• datePicker：包含 day、month、year 的对象 |
AdaptyOnboardingsInputParams | 文本输入字段。包含 Input，可以是 AdaptyOnboardingsTextInput、AdaptyOnboardingsEmailInput 或 AdaptyOnboardingsNumberInput |
AdaptyOnboardingsDatePickerParams | 日期选择。包含可为空的 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 字段中输入邮箱地址。在您的应用代码中，示例如下：
public class OnboardingManager : MonoBehaviour, AdaptyOnboardingsEventsListener
{
public void OnboardingViewOnStateUpdatedAction(
AdaptyUIOnboardingView view,
AdaptyUIOnboardingMeta meta,
string elementId,
AdaptyOnboardingsStateUpdatedParams @params
)
{
if (@params is AdaptyOnboardingsInputParams inputParams) {
var builder = new AdaptyProfileParameters.Builder();
switch (elementId) {
case "name":
if (inputParams.Input is AdaptyOnboardingsTextInput textInput) {
builder.SetFirstName(textInput.Value);
}
break;
case "email":
if (inputParams.Input is AdaptyOnboardingsEmailInput emailInput) {
builder.SetEmail(emailInput.Value);
}
break;
}
Adapty.UpdateProfile(builder.Build(), (error) => {
if (error != null) {
// handle the error
}
});
}
}
// ... other interface methods
}根据答案自定义付费墙
通过在用户引导中加入问卷，你可以根据用户完成引导后的答案来自定义向他们展示的付费墙。
例如，你可以询问用户的运动经验，然后向不同用户群展示不同的 CTA 和产品。
- 在用户引导编辑器中添加问卷，并为每个选项设置有意义的 ID。
- 根据 ID 处理问卷响应，并为用户设置自定义属性。
public class OnboardingManager : MonoBehaviour, AdaptyOnboardingsEventsListener
{
public void OnboardingViewOnStateUpdatedAction(
AdaptyUIOnboardingView view,
AdaptyUIOnboardingMeta meta,
string elementId,
AdaptyOnboardingsStateUpdatedParams @params
)
{
if (@params is AdaptyOnboardingsSelectParams selectParams) {
var builder = new AdaptyProfileParameters.Builder();
switch (elementId) {
case "experience":
// set custom attribute 'experience' with the selected value (beginner, amateur, pro)
builder.SetCustomStringAttribute("experience", selectParams.Value);
break;
}
Adapty.UpdateProfile(builder.Build(), (error) => {
if (error != null) {
// handle the error
}
});
}
}
// ... other interface methods
}