Идентификация пользователей в iOS SDK

Управление покупками пользователей зависит от модели аутентификации в вашем приложении:

• Если ваше приложение не использует серверную аутентификацию и не хранит данные пользователей, см. раздел об анонимных пользователях.
• Если у вашего приложения есть (или будет) серверная аутентификация, см. раздел об идентифицированных пользователях.

Ключевые понятия:

• Профили — это сущности, необходимые для работы SDK. Adapty создаёт их автоматически.
• Они могут быть анонимными (без customer user ID) или идентифицированными (с customer user ID).
• Вы предоставляете customer user ID, чтобы связать профили в Adapty с вашей внутренней системой аутентификации.

Вот чем отличаются анонимные и идентифицированные пользователи:

Анонимные пользователи

Если у вас нет серверной аутентификации, вам не нужно обрабатывать аутентификацию в коде приложения:

1. При активации SDK на первом запуске приложения Adapty создаёт новый профиль для пользователя.
2. Когда пользователь совершает покупку в приложении, она привязывается к его профилю в Adapty и его аккаунту в сторе.
3. Когда пользователь переустанавливает приложение или устанавливает его на новое устройство, Adapty создаёт новый анонимный профиль при активации.
4. Если пользователь ранее совершал покупки в вашем приложении, по умолчанию они автоматически синхронизируются из App Store при активации SDK.

Таким образом, при работе с анонимными пользователями при каждой установке будут создаваться новые профили, но это не проблема: в аналитике Adapty вы можете настроить, что считать новой установкой.

Для анонимных пользователей нужно считать установки по идентификаторам устройств. В этом случае каждая установка приложения на устройство считается отдельной установкой, включая переустановки.

Идентифицированные пользователи

У вас есть два варианта идентификации пользователей в приложении:

• Во время входа/регистрации: Если пользователи входят в систему после запуска приложения, вызовите identify() с customer user ID при аутентификации.

• Во время активации SDK: Если customer user ID уже известен при запуске приложения, передайте его при вызове activate().

Во время входа/регистрации

Если вы идентифицируете пользователей после запуска приложения (например, после входа или регистрации), используйте метод identify, чтобы задать их customer user ID.

• Если вы ещё не использовали этот customer user ID, Adapty автоматически привяжет его к текущему профилю.
• Если вы уже использовали этот customer user ID для идентификации пользователя, Adapty переключится на работу с профилем, связанным с этим customer user ID.

do {
    try await Adapty.identify("YOUR_USER_ID") // Unique for each user
} catch {
    // handle the error
}

// User IDs must be unique for each user
Adapty.identify("YOUR_USER_ID") { error in
    if let error {
        // handle the error
    }
}

Во время активации SDK

Если вы уже знаете customer user ID на момент активации SDK, вы можете передать его в метод activate вместо отдельного вызова identify.

Если вы знаете customer user ID, но передаёте его только после активации, это означает, что при активации Adapty создаст новый анонимный профиль и переключится на существующий только после вызова identify.

Вы можете передать как существующий customer user ID (уже использованный ранее), так и новый. Если передать новый, новый профиль, созданный при активации, будет автоматически привязан к этому customer user ID.

// Place in the app main struct for SwiftUI or in AppDelegate for UIKit

let configurationBuilder =
    AdaptyConfiguration
        .builder(withAPIKey: "PUBLIC_SDK_KEY")
        .with(customerUserId: "YOUR_USER_ID") // Customer user IDs must be unique for each user. If you hardcode the parameter value, all users will be considered as one.

do {
  try await Adapty.activate(with: configurationBuilder.build())
} catch {
  // handle the error
}

// Place in the app main struct for SwiftUI or in AppDelegate for UIKit

let configurationBuilder =
    AdaptyConfiguration
        .builder(withAPIKey: "PUBLIC_SDK_KEY")
        .with(customerUserId: "YOUR_USER_ID") // Customer user IDs must be unique for each user. If you hardcode the parameter value, all users will be considered as one.

Adapty.activate(with: configurationBuilder.build()) { error in
  // handle the error
}

Выход пользователей из системы

Если в вашем приложении есть кнопка выхода, используйте метод logout.

do {
    try await Adapty.logout()
} catch {
    // handle the error
}

Adapty.logout { error in
    if error == nil {
        // successful logout
    }
}

Разрешить покупки без входа

Если ваши пользователи могут совершать покупки как до, так и после входа в приложение, нужно убедиться, что после входа они сохранят доступ:

1. Когда пользователь без аккаунта совершает покупку, Adapty привязывает её к его анонимному идентификатору профиля.
2. Когда пользователь входит в аккаунт, Adapty переключается на работу с его идентифицированным профилем.
   • Если это новый customer user ID (например, покупка была сделана до регистрации), Adapty присваивает customer user ID текущему профилю, сохраняя всю историю покупок.
   • Если это существующий customer user ID (customer user ID уже привязан к профилю), после смены профиля нужно получить актуальный уровень доступа. Вы можете вызвать getProfile сразу после идентификации или отслеживать обновления профиля, чтобы данные синхронизировались автоматически.

Следующие шаги

Поздравляем! Вы реализовали логику встроенных платежей в своём приложении! Желаем вам успехов с монетизацией!

Чтобы получить ещё больше от Adapty, изучите следующие темы:

• Тестирование: Убедитесь, что всё работает как ожидается
• Онбординги: Вовлекайте пользователей с помощью онбордингов и повышайте удержание
• Интеграции: Подключайте сервисы маркетинговой атрибуции и аналитики всего одной строкой кода
• Задать пользовательские атрибуты профиля: Добавляйте пользовательские атрибуты к профилям пользователей и создавайте сегменты для запуска A/B-тестов или показа разных пейволов разным пользователям