Обработка данных из онбордингов в iOS SDK

Начиная с SDK v4 (бета), вы можете создавать флоу как более мощную альтернативу онбордингам. В отличие от онбордингов, которые работают внутри WebView, флоу рендерятся нативно на устройстве — это обеспечивает более плавные анимации, единый стиль iOS, быструю загрузку и отсутствие зависимости от WebView. См. Получение флоу и пейволов и Отображение флоу и пейволов, чтобы начать работу.

Когда пользователи отвечают на вопрос викторины или вводят данные в поле ввода, вызывается метод 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 в поле 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
    }
}

Настройка пейволов на основе ответов

С помощью квизов в онбординге можно настраивать пейволы, которые пользователи видят после его прохождения.

Например, можно спросить пользователей об их опыте в спорте и показывать разным группам разные CTA и продукты.

Добавьте квиз в конструкторе онбординга и задайте значимые идентификаторы его вариантам ответов.

Обработайте ответы квиза по их идентификаторам и задайте пользовательские атрибуты для пользователей.

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
    }
}

Создайте сегменты для каждого значения пользовательского атрибута.
Создайте плейсмент и добавьте аудитории для каждого созданного сегмента.
Отобразите пейвол для плейсмента в коде вашего приложения. Если в онбординге есть кнопка, открывающая пейвол, реализуйте код пейвола как реакцию на действие этой кнопки.