---
title: "在 Unity SDK 中处理用户引导数据"
description: "使用 Adapty SDK 在 Unity 应用中保存和使用用户引导数据。"
---

当用户回答测验问题或在输入框中输入数据时，`OnboardingViewOnStateUpdatedAction` 方法将被调用。您可以在代码中保存或处理字段类型。

在您的类中实现 `OnboardingViewOnStateUpdatedAction` 方法：

```csharp showLineNumbers title="Unity"
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`）<br/>• `input`：包含 `type`、`value` 的对象<br/>• `datePicker`：包含 `day`、`month`、`year` 的对象 |
| `AdaptyOnboardingsInputParams` | 文本输入框。包含 `Input`，可以是 `AdaptyOnboardingsTextInput`、`AdaptyOnboardingsEmailInput` 或 `AdaptyOnboardingsNumberInput` |
| `AdaptyOnboardingsDatePickerParams` | 日期选择。包含可为空的 `Day`、`Month`、`Year` |

<Details>
<summary>已保存数据示例（您的实现可能有所不同）</summary>

```javascript
// 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
        }
    }
}
```
</Details>

## 使用场景 \{#use-cases\}

### 用数据丰富用户画像 \{#enrich-user-profiles-with-data\}

如果您希望立即将输入数据与用户画像关联，避免重复询问相同信息，则需要在处理操作时使用输入数据[更新用户画像](unity-setting-user-attributes)。

例如，您要求用户在 ID 为 `name` 的文本框中输入姓名，并希望将该字段的值设为用户的名字；同时要求用户在 `email` 字段中输入电子邮件。在您的应用代码中，可以如下实现：

```csharp showLineNumbers title="Unity"
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
}
```

### 根据答案自定义付费墙 \{#customize-paywalls-based-on-answers\}

通过在用户引导中使用测验，您还可以根据用户完成用户引导后的情况自定义向其展示的付费墙。

例如，您可以询问用户的运动经验，并向不同用户群体展示不同的 CTA 和产品。

1. 在用户引导编辑工具中[添加测验](onboarding-quizzes)，并为其选项分配有意义的 ID。

2. 根据 ID 处理测验响应，并为用户[设置自定义属性](unity-setting-user-attributes)。

```csharp showLineNumbers title="Unity"
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
}
```

3. 为每个自定义属性值[创建市场细分](segments)。
4. 创建一个[版位](placements)，并为您创建的每个市场细分添加[目标受众](audience)。
5. 在您的应用代码中为该版位[展示付费墙](unity-paywalls)。如果您的用户引导中有一个按钮用于打开付费墙，请将付费墙代码作为[该按钮操作的响应](unity-handling-onboarding-events#opening-a-paywall)来实现。