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

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

Настройка состоит из шести этапов:

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

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

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

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

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

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

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

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

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

    • Если вы уже реализовали встроенные покупки через 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 или аналогичный — вызвав 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 к данным вашего приложения

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

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

    adapty-mail-adapty-integration.webp

  2. Добавьте URL вашего приложения в App Store или Google Play. В Adapty Mail перейдите в Settings → App metadata и вставьте прямую ссылку на стор — https://apps.apple.com/…id{numbers} для iOS или https://play.google.com/store/apps/details?id={package} для Android.

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, чтобы начать новое окно.

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

4. Создайте веб-пейвол

Каждое письмо ведёт на веб-пейвол — страницу оформления заказа, на которую попадают пользователи при нажатии на CTA. Есть два варианта:

  • Сгенерировать с помощью ИИ: встроенный конструктор веб-пейволов создаст страницу специально для вашего приложения.
  • Использовать собственный пейвол: подключите уже существующий пейвол, размещённый на вашем хостинге.

Для начала в Adapty Mail перейдите в Web Paywalls → Create.

new-web-paywall.webp

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

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

Вариант Б: Использование собственного пейвола

  1. Выберите Enter URL manually.

  2. Вставьте URL вашего пейвола. URL должен содержать плейсхолдеры {email} и {external_profile_id} в качестве параметров запроса — Adapty Mail подставит их для каждого получателя, чтобы страница оформления заказа знала, кто её посещает. Пример:

    https://example.com/paywall?email={email}&profile={external_profile_id}

  3. Сохраните и опубликуйте.

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

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

generate-web-paywall.webp

5. Сгенерируйте кампанию с помощью ИИ

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

  1. В Adapty Mail перейдите в Campaigns и нажмите Create.
  2. Задайте название кампании.
  3. В выпадающем меню Web paywall выберите веб-пейвол, добавленный на предыдущем шаге.
mail-new-campaign.webp
  1. Нажмите Generate emails.
  2. В диалоге генерации выберите тон и язык. По умолчанию ИИ сам определяет количество писем, исходя из лучших практик и контекста приложения. Если вы хотите задать количество писем самостоятельно, нажмите Set number manually и укажите его (1–15, по умолчанию 4).
generate-emails.webp
  1. Нажмите Generate. Генерация обычно занимает несколько минут. Если за 5 минут она не завершится, произойдёт таймаут — в этом случае попробуйте снова.
  2. Просмотрите каждое письмо. Вы можете перегенерировать отдельные письма, отредактировать текст или открыть HTML-редактор для детальной настройки.
generated-emails.webp
  1. Нажмите Create, чтобы сохранить кампанию.

Кампания сохраняется в статусе draft и пока не отправляется — кампании начинают работу только после привязки к флоу (следующий шаг). Отдельной кнопки «Опубликовать» в редакторе кампании нет.

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

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

  1. В Adapty Mail перейдите в Flows, затем откройте нужный триггер:
    • Never purchased — пользователи, которые зарегистрировались, но ещё ничего не купили.
    • Expired — истёкшие подписки.
    • Refunded — возвращённые покупки.
  2. Нажмите Create, чтобы открыть диалог.
create-flow-mail.webp
  1. В диалоге:
    • Выберите Segment (например, All Users, чтобы охватить всех пользователей, которые попадут под этот триггер, или создайте новый сегмент на основе атрибутов профиля).
    • Оставьте тип контента Campaign (вариант A/B Test рассмотрен в разделе A/B-тестирование).
    • Выберите Campaign, сохранённую на шаге 5.
  2. Нажмите Save.

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

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

mail-flow-details.webp

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

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

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