Идентификация пользователей в Android 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.

Дождитесь срабатывания колбэка завершения identify, прежде чем вызывать другие методы SDK. Параллельные вызовы могут попасть в анонимный профиль вместо идентифицированного. См. Порядок вызовов в Android SDK.

Adapty.identify("YOUR_USER_ID") { error -> // Уникальный для каждого пользователя
    if (error == null) {
        // успешная идентификация
    }
}

// ID пользователей должны быть уникальными для каждого пользователя
Adapty.identify("YOUR_USER_ID", error -> {
    if (error == null) {
        // успешная идентификация
    }
});

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

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

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

AdaptyConfig.Builder("PUBLIC_SDK_KEY")
    .withCustomerUserId("user123") // Customer user IDs must be unique for each user. If you hardcode the parameter value, all users will be considered as one.
    .build()

new AdaptyConfig.Builder("PUBLIC_SDK_KEY")
    .withCustomerUserId("user123") // Идентификаторы пользователей должны быть уникальными для каждого пользователя. Если вы укажете значение параметра в коде явно, все пользователи будут считаться одним.
    .build();

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

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

Adapty.logout { error ->
    if (error == null) {
        // successful logout
    }
}

Adapty.logout(error -> {
    if (error == null) {
        // successful logout
    }
});

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

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

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

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

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

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