Сбор email-адресов пользователей для Adapty Mail

Adapty Mail требует стабильный customer_user_id и email для каждого пользователя, которому он доставляет письма. Подключите оба значения в коде приложения до запуска кампании.

Сбор email-адресов пользователей

Для каждого пользователя в Adapty должны поступить два значения: стабильный customer_user_id, идентифицирующий пользователя, и сам email. Сначала необходима идентификация — без неё Adapty не знает, к какому профилю привязать email.

Идентифицируйте пользователя. Передайте стабильный ID — ID пользователя из вашего бэкенда, Firebase UID или аналогичный — либо через параметр customerUserId в .activate() при запуске SDK, либо вызвав Adapty.identify() позже (например, при входе в аккаунт). В любом случае ID должен быть задан до того, как пользователь увидит пейвол. Платформенные гайды: iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform, Capacitor.
Передайте email. Как только пользователь укажет свой email, отправьте его в Adapty через updateProfile, используя параметр email. Руководства по платформам: iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform, Capacitor.

Всегда передавайте стабильный customer_user_id, никогда — анонимный идентификатор. Если пользователь удалит и переустановит приложение, Adapty использует этот ID, чтобы связать переустановку с существующим профилем и корректно атрибутировать покупки нужному пользователю.
Получите явное согласие пользователя перед сбором и отправкой email-адресов в Adapty. Вы несёте ответственность за соответствие требованиям GDPR, CAN-SPAM и аналогичных регламентов на ваших целевых рынках.

Проверьте охват email-адресов

После внедрения сбора данных проверьте охват в Adapty:

Перейдите в Customers → Profiles.
Отфильтруйте профили, у которых указан email.

Стремитесь к охвату email не менее 30–50% среди активных пользователей, прежде чем запускать первую кампанию. Необязательно ждать 100% — запускайте, как только достигнете 30%. Пользователи, которые укажут email позже, автоматически попадут в активные кампании, как только будут соответствовать условиям.

Стратегии сбора email-адресов

Большинство приложений по умолчанию не собирают email-адреса. Выберите подход, который подходит вашему приложению.

Стратегия	Лучше всего для	Как работает
Существующая аутентификация	Приложения с любой формой входа	Email у вас уже есть — передайте его в Adapty после того, как пользователь аутентифицируется. Где его считать — смотрите в справочнике по методам аутентификации ниже.
Email-форма перед пейволом	Приложения без авторизации — здоровье, велнес, астрология, фоторедакторы	Добавьте один экран с полем для email между онбордингом и пейволом. Конверсия обычно составляет 70–90%, потому что пользователи уже вложили время.
Чекаут в веб-конструкторе пейвола	Минимум работы с SDK; email собирается на вебе	Первый экран веб-конструктора пейвола запрашивает email и передаёт его в Adapty — удобно для пользователей, которые переходят по ссылке из кампании до того, как in-app форма готова.
Шаг онбординга	Онбординг в формате квиза (фитнес, питание, образование)	Разместите поле для email на 2–3-м шаге онбординга. Подайте это как пользу для пользователя («Мы пришлём ваш персональный план на почту») и не делайте шаг пропускаемым.
Adapty Mail API	Отправка писем с вашего сервера без SDK Adapty	Отправляйте профили на эндпоинт Save profile Adapty Mail API. Подробнее — в разделе Отправка писем и транзакций через Adapty Mail API.

Ограничения

Анонимные пользователи: пользователи без стабильного customer_user_id не могут получать кампании. Идентифицируйте их в момент создания аккаунта или входа в систему — с этого момента любой указанный ими email будет привязан к их профилю в Adapty.
Пользователи без email: профили без email исключаются из доставки кампаний и не отображаются в аналитике кампаний. Как только они укажут email, они станут доступны для будущих кампаний.