То, как вы управляете покупками пользователей, зависит от модели аутентификации вашего приложения:

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

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

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

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

	Анонимные пользователи	Идентифицированные пользователи
Управление покупками	Восстановление покупок на уровне стора	История покупок сохраняется на всех устройствах через customer user ID
Управление профилями	Новый профиль при каждой переустановке	Один и тот же профиль во всех сессиях и на всех устройствах
Сохранность данных	Данные анонимных пользователей привязаны к установке приложения	Данные идентифицированных пользователей сохраняются при переустановке приложения

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

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

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.

try {
    await adapty.identify("YOUR_USER_ID"); // Unique for each user
    // successfully identified
} catch (error) {
    // handle the error
}

При активации SDK

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

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

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

adapty.activate("PUBLIC_SDK_KEY", {
    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.
});

Выход пользователей из аккаунта

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

try {
    await adapty.logout();
    // successful logout
} catch (error) {
    // handle the error
}

Покупки без входа в аккаунт

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

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

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

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

Чтобы использовать Adapty по максимуму, изучите эти темы:

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