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

Гайды по платформам: 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.

Перед запуском первой кампании добейтесь охвата 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 и в разделе Adapty Integration нажмите Enable Adapty integration (или Enable, если интеграция уже существует с предыдущей настройки). Кнопка остаётся неактивной, пока у вас нет ни одного флоу — с подсказкой “Set up at least one flow before enabling Adapty integration”.

Not linked. Вы создали этот проект самостоятельно в Adapty Mail — либо на отдельном аккаунте, либо на аккаунте Adapty.

Раздел Adapty Integration не отображается, но Adapty всё равно может передавать данные в проект — для этого нужен только ключ.

В Adapty Mail перейдите в Settings > Project и скопируйте Secret key. 2. В дашборде Adapty перейдите в Integrations > Adapty Mail, включите интеграцию, вставьте ключ в поле Secret Key и сохраните.

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

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

Ограничения

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