Начало работы с Adapty Mail

В этом гайде вы настроите Adapty Mail и запустите свой первый email-поток.

Настройка состоит из шести частей:

  1. Настройте Adapty SDK
  2. Настройте домен отправки
  3. Создайте веб-пейвол
  4. Сгенерируйте кампанию с помощью ИИ
  5. Запустите флоу
  6. Включите отправку

Если вы зарегистрировались в Adapty Mail через Adapty, профиль бренда создаётся автоматически на основе URL стора вашего проекта. Откройте Brand в любой момент, чтобы просмотреть или уточнить его — см. Бренд. Если вы регистрировались отдельно, настройте бренд на той же странице перед созданием кампаний или веб-пейволов.

Перед началом работы

Убедитесь, что у вас есть всё необходимое:

  • Доступ к DNS: вы можете добавлять записи к вашему корневому домену.
  • Провайдер веб-платежей: у вас есть аккаунт Stripe, Paddle или PayPal с настроенными продуктами подписки.

1. Настройте Adapty SDK

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

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

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

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

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

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

Если ваше приложение пока не собирает email-адреса, см. Стратегии сбора email.

2. Настройте домен для отправки

Adapty Mail отправляет письма с вашего собственного домена. Достаточно один раз добавить DNS-записи — все кампании будут использовать один и тот же верифицированный домен.

  1. В Adapty Mail перейдите в Settings → Email Domains.
  2. Введите корневой домен (например, yourapp.com) и нажмите Preview. Принимаются только apex-домены — субдомены вида app.yourapp.com будут отклонены при вводе.
mail-email-domains.webp
  1. Adapty сгенерирует два поддомена для отправки (mail.yourapp.com и email.yourapp.com). Нажмите Confirm, чтобы увидеть необходимые DNS-записи.
confirm-subdomains.webp
  1. В панели управления вашим доменом добавьте 10 DNS-записей (по 5 на каждый поддомен):
    • 3 CNAME-записи (DKIM) для каждого поддомена
    • 1 MX-запись (Mail-From) для каждого поддомена
    • 1 TXT-запись (SPF, v=spf1 include:amazonses.com ~all) для каждого поддомена
  2. Опционально добавьте DMARC TXT-запись для корневого домена (рекомендуется).
  3. Вернитесь в Settings → Email Domains и нажмите Check Verification.
email-domains.webp

Сроки верификации — кратко:

  • Автоматическая проверка: первая проверка запускается примерно через 5 минут после отправки. Интервалы постепенно увеличиваются до одного раза в час, пока записи не будут найдены.
  • Ручная проверка: нажмите Check Verification в любой момент, чтобы запустить немедленную проверку.
  • Распространение DNS: обычно занимает несколько минут, в редких случаях — до 48 часов.
  • Окно верификации: 7 дней. Если оно истекает, DNS-записи остаются на месте — повторно введите домен в Settings → Email Domains, чтобы начать новое окно.

Подробнее о каждом типе записей и прогреве домена см. в разделе Настройка домена для отправки.

3. Настройте отправляющий домен

Adapty Mail отправляет письма с вашего собственного домена. DNS-записи добавляются один раз — все кампании используют один проверенный домен.

  1. В Adapty Mail перейдите в Settings → Email Domains.
  2. Введите ваш корневой домен (например, yourapp.com) и нажмите Preview. Принимаются только apex-домены — поддомены вида app.yourapp.com будут отклонены при вводе.
mail-email-domains.webp
  1. Adapty сгенерирует два отправляющих поддомена (mail.yourapp.com и email.yourapp.com). Нажмите Confirm, чтобы увидеть необходимые DNS-записи.
confirm-subdomains.webp
  1. В панели управления вашего регистратора добавьте 10 DNS-записей (по 5 на каждый поддомен):
    • 3 CNAME-записи (DKIM) на каждый поддомен
    • 1 MX-запись (Mail-From) на каждый поддомен
    • 1 TXT-запись (SPF, v=spf1 include:amazonses.com ~all) на каждый поддомен
  2. При желании добавьте DMARC TXT-запись на корневом домене (рекомендуется).
  3. Вернитесь в Settings → Email Domains и нажмите Check Verification.
email-domains.webp

Краткий обзор времени верификации:

  • Автоматическая проверка: первая проверка запускается примерно через 5 минут после отправки. Интервалы постепенно увеличиваются до одного раза в час, пока записи не будут обнаружены.
  • Ручная проверка: нажмите Check Verification в любое время, чтобы запустить немедленную проверку.
  • Распространение DNS: обычно занимает несколько минут, в редких случаях — до 48 часов.
  • Окно верификации: 7 дней. Если оно истечёт, ваши DNS-записи останутся на месте — повторно введите домен в Settings → Email Domains, чтобы начать новое окно.

Подробнее о каждом типе записи и прогреве домена см. в Настройке отправляющего домена.

Вариант A: Создание с помощью AI

На странице отображается чеклист Prerequisites со встроенными кнопками — пройдите его по порядку, затем вернитесь и нажмите Generate. Чеклист включает вход в Paywall Builder, подключение Stripe, добавление продуктов и проверку результата. Подробное описание есть в Настройке чекаута.

Когда все пункты чеклиста отмечены зелёным, нажмите Generate, чтобы открыть диалог создания:

  • Environment: Выберите Production или Sandbox. Sandbox использует тестовые продукты Stripe и является безопасным вариантом по умолчанию для разработки и локальных окружений.
  • Plans: Выберите до 3 планов Stripe (каждый план — это продукт + цена). Это офферы, которые сгенерированный пейвол будет предлагать пользователям при оформлении заказа.

Нажмите Generate, чтобы запустить сборку. После завершения откройте редактор, чтобы проверить и опубликовать пейвол.

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

Вариант А: Генерация с помощью ИИ

  1. Выберите Generate with AI.
  2. Нажмите Log in to the paywall builder. Конструктор веб-пейволов откроется в новой вкладке. Если вы ещё не вошли в систему, войдите, используя учётные данные Adapty.
  3. В конструкторе включите интеграцию с вашим платёжным провайдером (Stripe, Paddle или PayPal). Подробнее см. в Настройке веб-пейвола.
  4. Вернитесь в Adapty Mail и нажмите Proceed to generation.
  5. Просмотрите сгенерированный пейвол, затем сохраните и опубликуйте его.

4. Создайте кампанию с помощью ИИ

ИИ создаёт для вас полную email-последовательность — тексты, дизайн, hero-изображения и персонализированные ссылки на оформление, всё адаптировано под ваш бренд.

  1. В Adapty Mail перейдите в Campaigns и нажмите Create.
  2. Задайте название кампании.
  3. В выпадающем списке Web paywall выберите web-пейвол, добавленный на предыдущем шаге.
mail-new-campaign.webp
  1. Нажмите Generate emails.
  2. Заполните диалог генерации — тон, язык, необязательный пользовательский промпт (до 2 000 символов) и количество писем (1–15, по умолчанию 4). Подробнее о каждом поле — в разделе Создание кампании.
generate-emails.webp
  1. Нажмите Generate. Генерация обычно занимает несколько минут. Если за 5 минут завершить не удалось, система прерывает процесс — попробуйте ещё раз.
  2. Просмотрите каждое письмо. В шапке предпросмотра есть Theme toggle (Auto, Light, Dark) — он управляет отображением превью, но сгенерированный контент одинаков во всех режимах. Можно перегенерировать отдельные письма, отредактировать текст или открыть HTML-редактор для точной настройки.
generated-emails.webp
  1. Нажмите Create, чтобы сохранить кампанию. Кампания сохраняется как черновик и пока не отправляется — кампании запускаются только после привязки к флоу (следующий шаг). Отдельной кнопки «Опубликовать» в редакторе кампании нет.

5. Запустите флоу

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

  1. В Adapty Mail перейдите в Flows и откройте триггер, который хотите настроить:

    • Never purchased — пользователи, которые зарегистрировались, но ещё не совершили покупку.
    • Renewal cancelled — пользователи, отключившие авторенью, у которых ещё активна подписка.
    • Billing issue — платёж не прошёл, карта отклонена или истекла, либо наступил льготный период.
    • Expired — подписка истекла и доступ потерян.
    • Refunded — пользователи, запросившие возврат средств после покупки.

    Подробнее о целях и тональности каждого триггера см. в разделе Flows.

  2. Нажмите Create, чтобы открыть диалог.

create-flow-mail.webp
  1. В диалоге:
    • Выберите Segment (например, All Users, чтобы охватить всех, кто попадает под этот триггер, или создайте новый сегмент на основе атрибутов профиля).
    • Оставьте тип контента Campaign (вариант A/B-теста рассматривается в разделе A/B-тестирование).
    • Выберите Campaign, которую вы сохранили на шаге 4.
  2. Нажмите Save.

Флоу запускается сразу — никаких отдельных шагов для старта нет. С этого момента пользователи, соответствующие сегменту, начнут получать кампанию, как только попадут под триггерное событие.

Вы можете добавить несколько строк «сегмент → кампания» к одному триггеру; они выполняются в порядке приоритета. Строка All Users, если используется, должна быть последней (с наименьшим приоритетом), чтобы охватить всех пользователей, не подпавших под более конкретный сегмент.

mail-flow-details.webp

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

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

Этот шаг доступен только после шага 5. До запуска флоу кнопка Enable в Settings → Integrations неактивна и отображает подсказку: «Set up at least one flow before enabling Adapty integration.»

  1. В Adapty Mail перейдите в Settings → Integrations.
  2. Нажмите Enable Adapty integration (или Enable, если интеграция уже была настроена ранее).

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

adapty-mail-adapty-integration.webp

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

Устранение неполадок

ПроблемаРешение
Верификация DNS завислаУбедитесь, что записи совпадают точно — без завершающих точек, с правильными CNAME-таргетами. Подождите 5–10 минут и нажмите Check Verification снова
Окно верификации истеклоВаши записи остаются на месте. Повторно введите домен в Settings → Email Domains, чтобы начать новое окно
Генерация завершилась ошибкой или истекла по таймаутуПроверьте подключение к интернету и попробуйте снова. Если проблема не исчезает, обратитесь в поддержку Adapty

Дополнительные материалы