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

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

Управление покупками пользователей зависит от модели аутентификации в вашем приложении:
- Если ваше приложение не использует серверную аутентификацию и не хранит данные пользователей, см. [раздел об анонимных пользователях](#anonymous-users).
- Если у вашего приложения есть (или будет) серверная аутентификация, см. [раздел об идентифицированных пользователях](#identified-users).

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

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

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

## Анонимные пользователи \{#anonymous-users\}

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

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

:::note
Восстановление из резервной копии работает иначе, чем переустановка. По умолчанию при восстановлении из резервной копии SDK сохраняет кэшированные данные и не создаёт новый профиль. Вы можете настроить это поведение с помощью параметра `clearDataOnBackup`. [Подробнее](sdk-installation-ios#clear-data-on-backup-restore).
:::

Таким образом, при работе с анонимными пользователями при каждой установке будут создаваться новые профили, но это не проблема: в аналитике 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 должны быть уникальными для каждого пользователя. Если вы захардкодите значение параметра, все пользователи будут считаться одним человеком.
:::

<Tabs groupId="current-os" queryString>
<TabItem value="swift" label="Swift" default>

```swift showLineNumbers
do {
    try await Adapty.identify("YOUR_USER_ID") // Unique for each user
} catch {
    // handle the error
}
```
</TabItem>
<TabItem value="swift-callback" label="Swift-Callback" default>

```swift showLineNumbers
// User IDs must be unique for each user
Adapty.identify("YOUR_USER_ID") { error in
    if let error {
        // handle the error
    }
}
```
</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 groupId="current-os" queryString>
<TabItem value="swift" label="Swift" default>

```swift showLineNumbers
// 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
}
```
</TabItem>

<TabItem value="swift-callback" label="Swift-Callback" default>

```swift showLineNumbers
// 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
}
```

</TabItem>

</Tabs>

### Выход пользователей из системы \{#log-users-out\}

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

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

<Tabs groupId="current-os" queryString>
<TabItem value="swift" label="Swift" default>

```swift showLineNumbers
do {
    try await Adapty.logout()
} catch {
    // handle the error
}
```
</TabItem>
<TabItem value="swift-callback" label="Swift-Callback" default>

```swift showLineNumbers
Adapty.logout { error in
    if error == nil {
        // 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`](ios-check-subscription-status) сразу после идентификации или [отслеживать обновления профиля](ios-check-subscription-status), чтобы данные синхронизировались автоматически.

## Следующие шаги \{#next-steps\}

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

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