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

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

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

1. [Настройте Adapty SDK](#1-configure-your-adapty-sdk)
2. [Подключите Adapty Mail к данным вашего приложения](#2-connect-adapty-mail-to-your-app-data)
3. [Настройте отправляющий домен](#3-set-up-your-sending-domain)
4. [Создайте веб-пейвол](#4-create-a-web-paywall)
5. [Сгенерируйте кампанию с помощью ИИ](#5-generate-a-campaign-with-ai)
6. [Запустите флоу](#6-launch-a-flow)

## Перед началом работы \{#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 требует от вашего приложения трёх вещей: данные о покупках (чтобы атрибутировать выручку письму, которое привело к конверсии), стабильный идентификатор пользователя и email-адреса пользователей.

1. **Позвольте Adapty отслеживать вашу выручку.** Первый шаг зависит от того, реализованы ли у вас уже встроенные покупки:
   - Если вы **уже реализовали встроенные покупки через Adapty**, на этом этапе ничего дополнительно делать не нужно.
   - Если вы **уже реализовали встроенные покупки без Adapty** и не планируете мигрировать на Adapty, установите Adapty SDK для вашей платформы в режиме наблюдателя. На этом этапе достаточно добавить 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 — 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. Подключите Adapty Mail к данным вашего приложения \{#2-connect-adapty-mail-to-your-app-data\}

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

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

   

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. Настройте отправляющий домен \{#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).

## 4. Создайте веб-пейвол \{#4-create-a-web-paywall\}

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

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

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

### Вариант А: Генерация с помощью ИИ \{#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. Просмотрите сгенерированный пейвол, затем сохраните и опубликуйте его.

### Вариант Б: Использование собственного пейвола \{#option-b-use-your-own-hosted-paywall\}

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

   ```
   https://example.com/paywall?email={email}&profile={external_profile_id}
   ```
3. Сохраните и опубликуйте.

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

Подробнее о структуре воронки оформления заказа и персонализации см. в [Настройке оформления заказа](mail-checkout).

## 5. Сгенерируйте кампанию с помощью ИИ \{#5-generate-a-campaign-with-ai\}

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

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

4. Нажмите **Generate emails**.
5. В диалоге генерации выберите тон и язык. По умолчанию ИИ сам определяет количество писем, исходя из лучших практик и контекста приложения. Если вы хотите задать количество писем самостоятельно, нажмите **Set number manually** и укажите его (**1–15**, по умолчанию 4).

6. Нажмите **Generate**. Генерация обычно занимает несколько минут. Если за 5 минут она не завершится, произойдёт таймаут — в этом случае попробуйте снова.
7. Просмотрите каждое письмо. Вы можете перегенерировать отдельные письма, отредактировать текст или открыть HTML-редактор для детальной настройки.

8. Нажмите **Create**, чтобы сохранить кампанию.

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

## 6. Запустите флоу \{#6-launch-a-flow\}

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

1. В Adapty Mail перейдите в **Flows**, затем откройте нужный триггер:
   - **Never purchased** — пользователи, которые зарегистрировались, но ещё ничего не купили.
   - **Expired** — истёкшие подписки.
   - **Refunded** — возвращённые покупки.
2. Нажмите **Create**, чтобы открыть диалог.

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

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

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

## Устранение неполадок \{#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)**: тестирование нескольких версий последовательности.