Идентификация пользователей в 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() с идентификатором пользователя в момент аутентификации.

• При активации SDK: Если идентификатор пользователя уже сохранён на момент запуска приложения, передайте его при вызове activate().

При входе в систему или регистрации

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

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

Всегда используйте await для identify перед вызовом других методов SDK. Параллельные вызовы приводят к ошибке #3006 profileWasChanged или попаданию в анонимный профиль. Подробнее: Порядок вызовов в iOS SDK.

do {
    try await Adapty.identify("YOUR_USER_ID") // Уникальный для каждого пользователя
} catch {
    // обработайте ошибку
}

// Идентификаторы пользователей должны быть уникальными для каждого пользователя
Adapty.identify("YOUR_USER_ID") { error in
    if let 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 привязывает её к анонимному ID профиля.
2. Когда пользователь входит в аккаунт, Adapty переключается на работу с его идентифицированным профилем.
   • Если customer user ID новый (например, покупка была совершена до регистрации), Adapty присваивает этот customer user ID текущему профилю, сохраняя всю историю покупок.
   • Если customer user ID уже существует (он уже привязан к другому профилю), нужно получить актуальный уровень доступа после переключения профиля. Можно вызвать getProfile сразу после идентификации или подписаться на обновления профиля, чтобы данные синхронизировались автоматически.

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

Поздравляем! Вы реализовали логику встроенных покупок в своём приложении! Желаем вам успехов в монетизации! Чтобы получить от Adapty ещё больше, изучите эти темы:

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