Подключение Adapty к Adapty Mail

Adapty — одна из точек входа в Adapty Mail: используйте её, если ваше приложение уже работает с Adapty SDK. Adapty передаёт профили, адреса электронной почты и события подписок в Adapty Mail, который использует их для выбора получателей, добавления каждого пользователя во флоу и атрибуции дохода письму, инициировавшему покупку.

Если ваше приложение не использует Adapty SDK, отправляйте те же данные с вашего сервера — см. Отправка писем и транзакций через Adapty Mail API.

Important

Чтобы получать точные данные о доходах, минимальная настройка — установить SDK Adapty в режиме наблюдателя и включить серверные уведомления App Store.

Adapty Mail требует от вашего приложения трёх вещей: данных о покупках (чтобы можно было привязать доход к письму, которое привело к каждой конверсии), стабильного идентификатора пользователя и адресов электронной почты. Настройте все три, затем настройте домен, оформление заказа, кампанию и флоу в Adapty Mail, и только после этого включите отправку.

1. Позвольте Adapty отслеживать ваш доход

Первый шаг зависит от того, реализованы ли у вас уже встроенные покупки:

Если вы уже реализовали встроенные покупки через Adapty, на этом этапе ничего дополнительно делать не нужно.
Если вы уже реализовали встроенные покупки без Adapty и не планируете переходить на Adapty, установите SDK для вашей платформы в режиме наблюдателя. На этом этапе достаточно добавить SDK в проект, активировать его с включённым режимом наблюдателя и передавать транзакции. Гайды по платформам: iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform, Capacitor.
Если вы ещё не реализовали встроенные покупки и хотите использовать Adapty, выполните шаги из гайда по быстрому старту, чтобы делегировать обработку покупок Adapty.

Затем включите уведомления сервера App Store в Adapty, чтобы получать обновления о доходах напрямую из App Store.

2. Идентифицируйте пользователей

Передайте стабильный идентификатор — ID пользователя из вашего бэкенда, Firebase UID или аналогичный — либо через параметр customerUserId в .activate() при запуске SDK, либо вызвав Adapty.identify() позже (например, при входе в аккаунт). В любом случае установите ID до того, как будет показан какой-либо пейвол. Adapty использует его, чтобы привязывать один профиль к одному человеку независимо от переустановок и входов в систему, а Adapty Mail сохраняет его среди внешних ID профиля. Adapty Mail сопоставляет пользователей по адресу электронной почты, а не по этому ID.

Гайды по платформам: iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform, Capacitor.

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

Как только пользователь указывает свой email в приложении (например, при регистрации или оформлении заказа), передайте его в Adapty с помощью вызова updateProfile с атрибутом email. Это значение необходимо для каждого получателя кампании.

Гайды по платформам: iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform, Capacitor.

Important

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

Проверьте охват по email

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

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

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

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

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

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

4. Настройте домен, чекаут, кампанию и флоу

Для отправки писем Adapty Mail требует:

Верифицированный домен отправки
Страницу чекаута, на которую будут вести ссылки в письмах
Кампанию для отправки
Флоу, который определяет, кто её получит

Настройте все четыре элемента в Adapty Mail — следуйте шагам 3–8 из гайда Начало работы с Adapty Mail.

5. Включите отправку

Включение интеграции — это финальный переключатель: события начинают поступать, сегменты начинают работать, а письма начинают отправляться. Наличие или отсутствие связи вашего Mail-проекта с приложением Adapty влияет только на то, как вы это включаете, но не на то, что приходит:

Связан с приложением Adapty. Adapty создал этот проект автоматически, когда вы впервые открыли Mail из дашборда Adapty.

В Adapty Mail перейдите в Settings > Project и в разделе Data integration нажмите Enable Adapty integration (или Enable, если интеграция уже существует после предыдущей настройки).
Не связан. Вы создали этот проект самостоятельно в Adapty Mail — на отдельном аккаунте или в рамках аккаунта Adapty.

В разделе Data integration нет кнопки Enable Adapty integration, но Adapty всё равно может передавать данные в проект — для этого нужен только ключ.
1. В Adapty Mail перейдите в Settings > Project и скопируйте Secret key.
2. В дашборде Adapty перейдите в Integrations > Adapty Mail, включите интеграцию, вставьте ключ в поле Secret Key и сохраните.

Оба способа создают одну и ту же интеграцию в Adapty — кнопка в Adapty Mail автоматически подставляет секретный ключ.

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

Ограничения

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