---
title: "iOS SDKでオンボーディングのデータを処理する"
description: "Adapty SDKを使用して、iOSアプリでオンボーディングのデータを保存・活用します。"
---

:::tip
**SDK v4以降**、オンボーディングのより強力な代替として[フロー](get-pb-paywalls)を構築できます。オンボーディングがWebView内で動作するのに対し、フローはデバイス上でネイティブにレンダリングされるため、スムーズなアニメーション、iOSらしい一貫したルック＆フィール、高速な読み込み、WebViewランタイムへの依存がないといったメリットがあります。まずは[フローとペイウォールの取得](get-pb-paywalls)および[フローとペイウォールの表示](ios-present-paywalls)をご覧ください。
:::

ユーザーがクイズの質問に回答したり、入力フィールドにデータを入力したりすると、`onStateUpdatedAction` メソッドが呼び出されます。フィールドの種類をコード内で保存したり処理したりできます。

例えば：

```swift showLineNumbers
func onboardingController(_ controller: AdaptyOnboardingController, onStateUpdatedAction action: AdaptyOnboardingsStateUpdatedAction) {
    // ユーザーの設定や回答を保存する
    switch action.params {
    case .select(let params):
        // 単一選択を処理する
    case .multiSelect(let params):
        // 複数選択を処理する
    case .input(let params):
        // テキスト入力を処理する
    case .datePicker(let params):
        // 日付選択を処理する
    }
}
```

`action` オブジェクトには以下が含まれます：

| パラメーター      | 説明                                                                                                                                                                                                                                                                                     |
|----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `elementId`    | 入力要素の一意の識別子。保存時に質問と回答を関連付けるために使用できます。                                                                                                                                                                                                                 |
| `params`       | typeおよびvalueプロパティを含む、ユーザーの入力データオブジェクト。                                                                                                                                                                                                                              |
| `params.type`  | 入力要素のタイプ。以下のいずれかを指定できます：<br/>• `"select"` - 選択肢から1つを選択<br/>• `"multiSelect"` - 選択肢から複数を選択<br/>• `"input"` - テキスト入力フィールド<br/>• `"datePicker"` - 日付の選択                                                                           |
| `params.value` | ユーザーが選択または入力した値。構造はタイプによって異なります：<br/>• `select`：`id`、`value`、`label`を持つオブジェクト<br/>• `multiSelect`：`id`、`value`、`label`を持つオブジェクトの配列<br/>• `input`：`type`、`value`を持つオブジェクト<br/>• `datePicker`：`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\}

入力データをユーザープロファイルとすぐに紐付け、同じ情報を二度聞かなくて済むようにするには、アクションの処理時に入力データを使って[ユーザープロファイルを更新](setting-user-attributes)する必要があります。

たとえば、IDが`name`のテキストフィールドでユーザーに名前を入力してもらい、その値をユーザーのファーストネームとして設定したい場合や、`email`フィールドでメールアドレスを入力してもらいたい場合、アプリのコードは次のようになります。

```swift showLineNumbers
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
    }
}
```

### オンボーディングの回答に基づいてペイウォールをカスタマイズする \{#customize-paywalls-based-on-answers\}

オンボーディングのクイズを活用すると、ユーザーがオンボーディングを完了した後に表示するペイウォールもカスタマイズできます。

たとえば、スポーツ経験についてユーザーに質問し、ユーザーグループごとに異なるCTAやプロダクトを表示することができます。

1. オンボーディングビルダーに[クイズを追加](onboarding-quizzes)し、各選択肢にわかりやすいIDを設定します。

2. IDに基づいてクイズの回答を処理し、ユーザーに[カスタム属性を設定](setting-user-attributes)します。

```swift showLineNumbers
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
    }
}
```

3. カスタム属性値ごとに[セグメント](segments)を作成します。
4. [プレースメント](placements)を作成し、作成した各セグメントに対して[オーディエンス](audience)を追加します。
5. アプリのコード内でプレースメントの[ペイウォールを表示](ios-paywalls)します。オンボーディングにペイウォールを開くボタンがある場合は、[このボタンのアクションへの応答](ios-handling-onboarding-events#opening-a-paywall)としてペイウォールのコードを実装してください。