---
title: "Начало работы с Adapty Mail"
description: "Настройте Adapty Mail и запустите первый email-флоу."
---

В этом гайде вы настроите Adapty Mail и запустите первый email-флоу.
:::note
Вы также можете отправлять данные в Adapty Mail со своего сервера без использования SDK. Если у вас уже есть email-адреса пользователей и данные о покупках на бэкенде, или вы импортируете подписчиков из другого источника, см. [Отправка email и транзакций через Adapty Mail API](mail-send-data-via-api).
:::

Настройка состоит из шести частей:
1. [Настройте Adapty SDK](#1-configure-your-adapty-sdk)
2. [Настройте домен отправки](#2-set-up-your-sending-domain)
3. [Создайте веб-пейвол](#3-create-a-web-paywall)
4. [Сгенерируйте кампанию с помощью ИИ](#4-generate-a-campaign-with-ai)
5. [Запустите флоу](#5-launch-a-flow)
6. [Включите отправку](#6-enable-sending)
:::tip
Если вы зарегистрировались в Adapty Mail через Adapty, **профиль бренда** создаётся автоматически на основе URL стора вашего проекта. Откройте **Brand** в любой момент, чтобы просмотреть или уточнить его — см. [Бренд](mail-brand). Если вы регистрировались отдельно, настройте бренд на той же странице перед созданием кампаний или веб-пейволов.
:::
## Перед началом работы \{#before-you-start\}

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

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

## 1. Настройте Adapty SDK \{#1-configure-your-adapty-sdk\}

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

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

Adapty Mail требует от вашего приложения трёх вещей: данных о покупках (чтобы связывать доход с письмом, которое привело к конверсии), стабильного идентификатора пользователя и адресов электронной почты.
1. **Позвольте Adapty отслеживать вашу выручку.** Первый шаг зависит от того, реализованы ли у вас уже встроенные покупки:
   - Если у вас **уже реализованы встроенные покупки через Adapty**, на этом этапе ничего дополнительно делать не нужно.
   - Если у вас **уже реализованы встроенные покупки без Adapty** и вы не планируете переходить на Adapty, установите SDK Adapty для вашей платформы в режиме наблюдателя. На этом этапе достаточно добавить SDK в проект, активировать его с включённым режимом наблюдателя и передавать транзакции. Гайды по платформам: [iOS](implement-observer-mode), [Android](implement-observer-mode-android), [React Native](implement-observer-mode-react-native), [Flutter](implement-observer-mode-flutter), [Unity](implement-observer-mode-unity), [Kotlin Multiplatform](implement-observer-mode-kmp), [Capacitor](implement-observer-mode-capacitor).
   - Если у вас **встроенные покупки ещё не реализованы и вы хотите использовать Adapty**, выполните шаги из [быстрого старта](quickstart), чтобы делегировать обработку покупок Adapty.
Затем [включите уведомления сервера App Store в Adapty](enable-app-store-server-notifications), чтобы получать обновления о доходах напрямую от App Store.

2. **Настройте идентификацию пользователей.** Передайте стабильный идентификатор — ID пользователя из вашего бэкенда, Firebase UID или аналогичный — либо вызвав `Adapty.identify()`, либо передав `customerUserId` в `.activate()` при инициализации SDK. По `customer_user_id` Adapty Mail связывает кампании, клики и покупки с нужным профилем.
Платформенные гайды: [iOS](identifying-users), [Android](android-identifying-users), [React Native](react-native-identifying-users), [Flutter](flutter-identifying-users), [Unity](unity-identifying-users), [Kotlin Multiplatform](kmp-identifying-users), [Capacitor](capacitor-identifying-users).

3. **Собирайте email пользователей.** Как только пользователь указывает email в вашем приложении (например, при регистрации или оформлении покупки), передайте его в Adapty, вызвав `updateProfile` с атрибутом email. Это значение обязательно для каждого получателя кампании.
Гайды по платформам: [iOS](setting-user-attributes), [Android](android-setting-user-attributes), [React Native](react-native-setting-user-attributes), [Flutter](flutter-setting-user-attributes), [Unity](unity-setting-user-attributes), [Kotlin Multiplatform](kmp-setting-user-attributes), [Capacitor](capacitor-setting-user-attributes).

Если ваше приложение пока не собирает email-адреса, см. [Стратегии сбора email](mail-collect-emails#email-collection-strategies).
## 2. Настройте домен для отправки \{#set-up-your-sending-domain\}

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

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**, чтобы начать новое окно.
Подробнее о каждом типе записи и прогреве домена читайте в разделе [Настройка домена отправки](mail-sending-domain).
## 3. Настройте отправляющий домен \{#3-set-up-your-sending-domain\}

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

Подробнее о каждом типе записи и прогреве домена см. в [Настройке отправляющего домена](mail-sending-domain).

### Вариант A: Создание с помощью AI \{#option-a-generate-with-ai\}

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

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

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

:::important
Пейвол должен быть опубликован, прежде чем он сможет обрабатывать трафик оформления заказов. Неопубликованные пейволы возвращают ошибку, когда пользователи переходят по ссылкам email-чекаута.
:::
### Вариант А: Генерация с помощью ИИ \{#option-a-generate-with-ai\}

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

## 4. Создайте кампанию с помощью ИИ \{#generate-a-campaign-with-ai\}

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

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

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

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

8. Нажмите **Create**, чтобы сохранить кампанию.
Кампания сохраняется как **черновик** и пока не отправляется — кампании запускаются только после привязки к флоу (следующий шаг). Отдельной кнопки «Опубликовать» в редакторе кампании нет.
## 5. Запустите флоу \{#5-launch-a-flow\}

Флоу связывает **триггер** (событие, например истечение срока подписки) с **сегментом** и отправляет этому сегменту выбранную **кампанию**. Adapty Mail поставляется с пятью фиксированными триггерами, каждый из которых имеет собственный вид флоу.
1. В Adapty Mail перейдите в **Flows** и откройте триггер, который хотите настроить:
   - **Never purchased** — пользователи, которые зарегистрировались, но ещё не совершили покупку.
   - **Renewal cancelled** — пользователи, отключившие авторенью, у которых ещё активна подписка.
   - **Billing issue** — платёж не прошёл, карта отклонена или истекла, либо наступил льготный период.
   - **Expired** — подписка истекла и доступ потерян.
   - **Refunded** — пользователи, запросившие возврат средств после покупки.

   Подробнее о целях и тональности каждого триггера см. в разделе [Flows](mail-flows).

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

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

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

## 6. Включите отправку \{#enable-sending\}

До этого момента кампания настроена, но не запущена — **интеграция 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 все события подписок — новые подписки, продления, триалы, конверсии, возвраты, проблемы с оплатой. Эти события управляют членством в сегментах, маршрутизацией кампаний и условиями остановки, которые приостанавливают последовательность при конверсии пользователя.

:::note
Переключатель **Adapty integration** в Settings — это *не* то же самое, что партнёрский воркспейс Adapty, через который вы вошли в Adapty Mail. Партнёрский воркспейс — это то, что создало ваш аккаунт и (если вы зарегистрировались через Adapty) ваш бренд. Переключатель интеграции здесь управляет синхронизацией событий — его нужно включать отдельно для каждого проекта.
:::
## Устранение неполадок \{#troubleshooting\}
| Проблема | Решение |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------ |
| Верификация DNS зависла | Убедитесь, что записи совпадают точно — без завершающих точек, с правильными CNAME-таргетами. Подождите 5–10 минут и нажмите **Check Verification** снова |
| Окно верификации истекло | Ваши записи остаются на месте. Повторно введите домен в **Settings → Email Domains**, чтобы начать новое окно |
| Генерация завершилась ошибкой или истекла по таймауту | Проверьте подключение к интернету и попробуйте снова. Если проблема не исчезает, обратитесь в поддержку Adapty |
## Дополнительные материалы \{#learn-more\}

- **[Сбор email-адресов пользователей](mail-collect-emails)**: стратегии получения email-адресов, если приложение их пока не собирает.
- **[Настройка отправляющего домена](mail-sending-domain)**: подробности о DNS-записях, уровнях прогрева и устранении неполадок.
- **[Настройка оформления заказа](mail-checkout)**: структура воронки и персонализация.
- **[Аналитика кампаний](mail-analytics)**: отслеживание доставки, вовлечённости и выручки.
- **[A/B-тестирование](mail-ab-testing)**: тестирование нескольких версий последовательности.