Подключение Adapty к Adapty Mail
Adapty — одна из точек входа в Adapty Mail: используйте её, если ваше приложение уже работает с Adapty SDK. Adapty передаёт профили, адреса электронной почты и события подписок в Adapty Mail, который использует их для выбора получателей, добавления каждого пользователя во флоу и атрибуции дохода письму, инициировавшему покупку.
Если ваше приложение не использует Adapty SDK, отправляйте те же данные с вашего сервера — см. Отправка писем и транзакций через Adapty Mail API.
Adapty Mail — это самостоятельный продукт. Вы можете использовать его, даже если пейволы, подписки или аналитика не обслуживаются Adapty — мигрировать весь стек не нужно.
Для получения точных данных о выручке достаточно установить SDK Adapty в режиме наблюдателя и включить серверные уведомления App Store.
Adapty Mail требует от вашего приложения трёх вещей: данные о покупках (чтобы атрибутировать выручку к письму, которое привело к конверсии), стабильный идентификатор пользователя и email-адреса пользователей. Настройте всё три, а затем включите отправку.
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.
- Всегда передавайте стабильный
customer_user_id, никогда не используйте анонимные идентификаторы. Если пользователь удалит и переустановит приложение, Adapty использует этот ID для привязки переустановки к существующему профилю и корректного атрибутирования покупок. - Получите явное согласие пользователя перед сбором и отправкой email-адресов в Adapty. Вы несёте ответственность за соблюдение GDPR, CAN-SPAM и аналогичных норм на ваших целевых рынках.
Проверьте охват по 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 блокирует кнопку Enable до тех пор, пока у вас не будет хотя бы одного флоу — с подсказкой «Set up at least one flow before enabling Adapty integration» — поэтому сначала настройте домен отправки, чекаут, кампанию и флоу. См. Начало работы с Adapty Mail.
Включение интеграции — это финальный шаг: начинают поступать события, применяются сегменты и отправляются письма.
- В Adapty Mail перейдите в Settings → Project и найдите раздел Adapty Integration.
- Нажмите Enable Adapty integration (или Enable, если интеграция уже существует из предыдущей настройки).
После включения Adapty отправляет в Adapty Mail все события подписок — новые подписки, продления, триалы, конверсии, возвраты, проблемы с оплатой. Эти события управляют членством в сегментах, маршрутизацией кампаний и условиями остановки, которые приостанавливают последовательность, когда пользователь совершает конверсию.
Раздел Adapty Integration отображается только для проектов, привязанных к воркспейсу Adapty. Если вы зарегистрировались в Adapty Mail напрямую и ваш проект не привязан, этого раздела не будет — передавайте данные через Adapty Mail API.
Переключатель интеграции с Adapty в настройках — не то же самое, что партнёрское рабочее пространство Adapty, через которое вы вошли в Adapty Mail. Партнёрское рабочее пространство — это то, что создало вашу учётную запись и (если вы зарегистрировались через Adapty) ваш бренд. Переключатель интеграции здесь управляет синхронизацией событий — его нужно включать отдельно для каждого проекта.
Ограничения
- Анонимные пользователи: пользователи без стабильного
customer_user_idне могут получать кампании. Идентифицируйте их в момент создания аккаунта или входа в систему — с этого момента любой указанный ими email будет привязан к их профилю в Adapty. - Пользователи без email: профили без email исключаются из доставки кампаний и не отображаются в аналитике кампаний. Как только они укажут email, они станут доступны для будущих кампаний.