---
title: "Идентификация пользователей в Android SDK"
description: "Краткое руководство по настройке Adapty для управления встроенными покупками в Android."
---

:::important
Этот гайд для вас, если у вас есть собственная система аутентификации. Здесь вы узнаете, как работать с профилями пользователей в Adapty, чтобы они соответствовали вашей существующей системе аутентификации.
:::

То, как вы управляете покупками пользователей, зависит от модели аутентификации вашего приложения:
- Если ваше приложение не использует бэкенд-аутентификацию и не хранит данные пользователей, смотрите [раздел об анонимных пользователях](#anonymous-users).
- Если ваше приложение использует (или будет использовать) бэкенд-аутентификацию, смотрите [раздел об идентифицированных пользователях](#identified-users).
**Ключевые понятия**:
- **Профили** — сущности, необходимые для работы SDK. Adapty создаёт их автоматически.
- Они могут быть анонимными **(без customer user ID)** или идентифицированными **(с customer user ID)**.
- Вы передаёте **customer user ID**, чтобы связать профили в Adapty с вашей внутренней системой авторизации.

Вот чем различаются анонимные и идентифицированные пользователи:
|                         | Анонимные пользователи                                        | Идентифицированные пользователи                                                                       |
|-------------------------|---------------------------------------------------------------|-------------------------------------------------------------------------------------------------------|
| **Purchase management** | Восстановление покупок на уровне стора                        | История покупок сохраняется на всех устройствах благодаря customer user ID                            |
| **Profile management**  | Новый профиль при каждой переустановке                        | Один и тот же профиль в разных сессиях и на разных устройствах                                        |
| **Data persistence**    | Данные анонимных пользователей привязаны к установке приложения | Данные идентифицированных пользователей сохраняются между установками приложения                      |
## Анонимные пользователи \{#anonymous-users\}

Если у вас нет серверной аутентификации, **вам не нужно обрабатывать аутентификацию в коде приложения**:
1. Когда SDK активируется при первом запуске приложения, Adapty **создаёт новый профиль для пользователя**.
2. Когда пользователь совершает покупку в приложении, она **привязывается к его профилю в Adapty и его аккаунту в сторе**.
3. Когда пользователь **переустанавливает** приложение или устанавливает его на **новое устройство**, Adapty **создаёт новый анонимный профиль при активации**.
4. Если пользователь ранее совершал покупки в вашем приложении, по умолчанию они автоматически синхронизируются из App Store при активации SDK.
Таким образом, для анонимных пользователей при каждой установке будет создаваться новый профиль — но это не проблема, поскольку в аналитике Adapty можно [настроить, что считается новой установкой](general#4-installs-definition-for-analytics).

Для анонимных пользователей установки нужно считать по **идентификаторам устройств**. В этом случае каждая установка приложения на устройство считается отдельной установкой, включая повторные.
## Идентифицированные пользователи \{#identified-users\}

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

- [**При входе/регистрации:**](#during-loginsignup) Если пользователи входят в систему после запуска приложения, вызовите `identify()` с customer user ID в момент аутентификации.

- [**При активации SDK:**](#during-the-sdk-activation) Если customer user ID уже сохранён на момент запуска приложения, передайте его при вызове `activate()`.
:::important
По умолчанию, когда Adapty получает покупку от Customer User ID, который уже связан с другим Customer User ID, уровень доступа становится общим — оба профиля получают платный доступ. Вы можете настроить это поведение так, чтобы платный доступ переносился с одного профиля на другой, или полностью отключить совместное использование. Подробнее — в [статье](general#6-sharing-paid-access-between-user-accounts).
:::

  <img src="/assets/shared/img/identify-diagram.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

### В момент входа или регистрации \{#during-loginsignup\}

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

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

Дождитесь срабатывания колбэка завершения `identify`, прежде чем вызывать другие методы SDK. Параллельные вызовы могут попасть в анонимный профиль вместо идентифицированного. См. [Порядок вызовов в Android SDK](android-sdk-call-order).

<Tabs groupId="current-os" queryString>
<TabItem value="kotlin" label="Kotlin" default>
```kotlin showLineNumbers
Adapty.identify("YOUR_USER_ID") { error -> // Уникальный для каждого пользователя
    if (error == null) {
        // успешная идентификация
    }
}
```

</TabItem>
<TabItem value="java" label="Java" default>
```java showLineNumbers
// ID пользователей должны быть уникальными для каждого пользователя
Adapty.identify("YOUR_USER_ID", error -> {
    if (error == null) {
        // успешная идентификация
    }
});
```
</TabItem>
</Tabs>
### Во время активации SDK \{#during-the-sdk-activation\}

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

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

:::note
По умолчанию создание анонимных профилей не влияет на аналитические дашборды, поскольку установки учитываются на основе идентификаторов устройств.
Идентификатор устройства соответствует одной установке приложения из стора на устройстве и обновляется только при переустановке приложения.
Он не зависит от того, первая это установка или повторная, и от того, используется ли существующий customer user ID.

Создание профиля (при активации SDK или выходе из системы), вход в систему или обновление приложения без переустановки не генерируют дополнительные события установки.
Если вы хотите считать установки по уникальным пользователям, а не устройствам, перейдите в **App settings** и настройте [**Installs definition for analytics**](general#4-installs-definition-for-analytics).
:::

<Tabs>
<TabItem value="kotlin" label="Kotlin" default>

```kotlin showLineNumbers
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()
```
</TabItem>
<TabItem value="java" label="Java" default>
```java showLineNumbers
new AdaptyConfig.Builder("PUBLIC_SDK_KEY")
    .withCustomerUserId("user123") // Идентификаторы пользователей должны быть уникальными для каждого пользователя. Если вы укажете значение параметра в коде явно, все пользователи будут считаться одним.
    .build();
```
</TabItem>
</Tabs>
### Выход пользователей из системы \{#log-users-out\}

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

:::important
При выходе из системы для пользователя создаётся новый анонимный профиль.
:::

<Tabs groupId="current-os" queryString>
<TabItem value="kotlin" label="Kotlin" default>

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

</TabItem>
<TabItem value="java" label="Java" default>
```java showLineNumbers
Adapty.logout(error -> {
    if (error == null) {
        // successful logout
    }
});
```
</TabItem>
</Tabs>
:::info
Чтобы снова авторизовать пользователей в приложении, используйте метод `identify`.
:::
### Разрешите покупки без входа в систему \{#allow-purchases-without-login\}

Если пользователи могут совершать покупки как до, так и после входа в приложение, нужно убедиться, что после авторизации они сохранят доступ к своим покупкам:
1. Когда неавторизованный пользователь совершает покупку, Adapty привязывает её к анонимному идентификатору профиля.
2. Когда пользователь входит в аккаунт, Adapty переключается на работу с его идентифицированным профилем.
   - Если это новый customer user ID (например, покупка была совершена до регистрации), Adapty присваивает customer user ID текущему профилю, сохраняя всю историю покупок.
   - Если это существующий customer user ID (customer user ID уже привязан к профилю), нужно получить актуальный уровень доступа после переключения профиля. Можно вызвать [`getProfile`](android-check-subscription-status) сразу после идентификации или [подписаться на обновления профиля](android-check-subscription-status), чтобы данные синхронизировались автоматически.
## Следующие шаги \{#next-steps\}

Поздравляем! Вы реализовали логику встроенных покупок в своём приложении. Желаем вам успехов в монетизации!
Чтобы получить от Adapty ещё больше, изучите эти темы:
- [**Тестирование**](troubleshooting-test-purchases): Убедитесь, что всё работает как ожидается
- [**Онбординги**](android-onboardings): Вовлекайте пользователей с помощью онбордингов и повышайте удержание
- [**Интеграции**](configuration): Подключите сервисы маркетинговой атрибуции и аналитики буквально в одну строку кода
- [**Установка пользовательских атрибутов профиля**](android-setting-user-attributes): Добавляйте пользовательские атрибуты к профилям, создавайте сегменты и запускайте A/B-тесты или показывайте разные пейволы разным пользователям