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

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

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

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

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

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

• Доступ к DNS: вы можете добавлять записи в корневой домен.
• Платежи: у вас есть аккаунт Stripe с настроенными продуктами подписки. Чтобы использовать другого провайдера, разместите чекаут самостоятельно — см. Настройка чекаута.

1. Подключите свои данные

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

• Adapty: Если ваше приложение использует Adapty SDK, настройте идентификацию пользователей и сбор email-адресов. Пока оставьте саму интеграцию отключённой — Adapty Mail блокирует её до создания флоу. См. Подключить Adapty к Adapty Mail.
• Adapty Mail API: Если ваш бэкенд является источником истины, получите секретный ключ в разделе Settings и подготовьте запросы, но пока не отправляйте их. Профили, поступившие до завершения настройки, не получат ничего. См. Отправка писем и транзакций через Adapty Mail API.

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

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

Откройте Adapty Mail: нажмите на логотип Adapty в шапке и выберите Mail.

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

1. В Adapty Mail перейдите в Settings → DNS и в разделе Email domains нажмите Add domain.
2. В поле Domain введите корневой домен (например, yourapp.com). Допускаются только апекс-домены — поддомены вроде app.yourapp.com будут отклонены.
3. В поле Sending subdomain введите префикс, с которого будут отправляться письма, или оставьте поле пустым, чтобы использовать mail. В этом случае письма будут приходить с адреса hello@mail.yourapp.com.
4. Нажмите Add domain.

5. В регистраторе домена добавьте все DNS-записи, которые перечислены в карточке нового домена. Они разбиты на три группы: записи DKIM и MAIL FROM для отправляющего поддомена, записи для почтового ящика, который прогревает домен, и записи для go.yourapp.com, обслуживающего изображения и отслеживаемые ссылки. Подробнее о том, что аутентифицирует каждая группа, — в разделе Какие записи добавить. Чтобы скопировать все сразу, нажмите Export.
6. При желании добавьте предложенную TXT-запись DMARC на корневом домене (рекомендуется).
7. Нажмите Check, чтобы проверить немедленно, или закройте карточку — Adapty Mail сама опросит DNS.

Краткий обзор сроков проверки:

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

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

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

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

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

1. В Adapty Mail перейдите в Settings → Email Domains.
2. Введите ваш корневой домен (например, yourapp.com) и нажмите Preview. Принимаются только apex-домены — поддомены вида app.yourapp.com будут отклонены при вводе.

3. Adapty сгенерирует два отправляющих поддомена (mail.yourapp.com и email.yourapp.com). Нажмите Confirm, чтобы увидеть необходимые DNS-записи.

4. В панели управления вашего регистратора добавьте 10 DNS-записей (по 5 на каждый поддомен):
   • 3 CNAME-записи (DKIM) на каждый поддомен
   • 1 MX-запись (Mail-From) на каждый поддомен
   • 1 TXT-запись (SPF, v=spf1 include:amazonses.com ~all) на каждый поддомен
5. При желании добавьте DMARC TXT-запись на корневом домене (рекомендуется).
6. Вернитесь в Settings → Email Domains и нажмите Check Verification.

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

• Автоматическая проверка: первая проверка запускается примерно через 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, чтобы запустить сборку. После завершения откройте редактор, чтобы проверить и опубликовать пейвол.

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

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

2. Вставьте URL вашего пейвола с плейсхолдерами в качестве query-параметров. Adapty Mail подставляет их для каждого получателя, чтобы страница оформления покупки могла идентифицировать посетителя. Пример:

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

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

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

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

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

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

1. В Adapty Mail перейдите в Campaigns и нажмите Create.
2. Задайте название кампании.
3. В выпадающем списке Web paywall выберите web-пейвол, добавленный на предыдущем шаге.

4. Нажмите Generate emails.
5. Заполните диалог генерации — тон, язык, необязательный пользовательский промпт (до 2 000 символов) и количество писем (1–15, по умолчанию 4). Подробнее о каждом поле — в разделе Создание кампании.

6. Нажмите Generate. Генерация обычно занимает несколько минут. Если за 5 минут завершить не удалось, система прерывает процесс — попробуйте ещё раз.
7. Просмотрите каждое письмо. В шапке предпросмотра есть Theme toggle (Auto, Light, Dark) — он управляет отображением превью, но сгенерированный контент одинаков во всех режимах. Можно перегенерировать отдельные письма, отредактировать текст или открыть HTML-редактор для точной настройки.

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

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

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

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

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

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

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

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

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

6. Начните отправку

Ваша кампания настроена, но пока не запущена — данные о пользователях ещё не поступают в Adapty Mail. Запуск потока данных — последний шаг, и каждая точка входа из Шага 1 запускается по-своему:

• Adapty: В Adapty Mail перейдите в Settings → Project и нажмите Enable Adapty integration. Кнопка неактивна до завершения шага 5 — подсказка гласит: «Set up at least one flow before enabling Adapty integration». См. Подключение Adapty к Adapty Mail.
• Adapty Mail API: Начните отправлять профили и события транзакций. Профили, отправленные до завершения этой настройки, не получат никаких писем — именно поэтому данный шаг выполняется последним. См. Отправка писем и транзакций через Adapty Mail API.

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

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

Узнайте больше

• Протестируйте флоу: Прогоните тестового пользователя через всю цепочку перед запуском.
• Подключите Adapty к Adapty Mail: Настройка SDK и стратегии получения охвата по email, если приложение пока не собирает адреса.
• Настройте домен отправки: DNS-записи, уровни прогрева и устранение неполадок.
• Настройте чекаут: Анатомия воронки чекаута и персонализация.
• Аналитика кампаний: Отслеживайте доставку, вовлечённость и выручку.
• A/B-тестирование: Тестируйте несколько версий последовательности.