Сбор 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.

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

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

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

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

Ограничения

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