---
title: "Adapty Mail 入门指南"
description: "设置 Adapty Mail 并启动你的第一个电子邮件流程。"
---

本指南将带你完成 Adapty Mail 的设置，并启动你的第一个电子邮件流程。
:::note
您也可以从自己的服务器直接向 Adapty Mail 发送数据，无需使用 Adapty SDK。如果您已在后端保存了用户邮件和购买记录，或者需要从其他来源导入订阅者，请参阅[通过 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. [用 AI 生成营销活动](#4-generate-a-campaign-with-ai)
5. [启动流程](#5-launch-a-flow)
6. [开启发送](#6-enable-sending)
:::tip
如果您是通过 Adapty 注册 Adapty Mail 的，系统会自动根据项目的商店 URL 创建您的**品牌档案**。随时打开 **Brand** 查看或完善它——详见[品牌](mail-brand)。如果您是独立注册的，请在生成营销活动或网页付费墙之前，先在同一页面上设置您的品牌。
:::
## 开始之前 \{#before-you-start\}

在开始之前，请确认以下内容已就绪：

- **DNS 访问权限**：你可以为根域名添加记录。
- **Web 支付服务商**：你已拥有 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，请以观察者模式为您的平台安装 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 管理。
然后[在 Adapty 中启用 App Store 服务器通知](enable-app-store-server-notifications)，以便直接从 App Store 接收收入相关的更新。

2. **设置用户标识。** 传入一个稳定的 ID —— 可以是你的后端用户 ID、Firebase UID 或类似标识 —— 通过调用 `Adapty.identify()` 或在 SDK 启动时将 `customerUserId` 传入 `.activate()` 来完成。`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. **收集用户邮箱。** 当用户在应用中提供邮箱（例如注册或结账时），通过调用 `updateProfile` 并传入邮箱属性将其同步至 Adapty。每位活动收件人都需要填写该值。
平台指南：[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)。

如果您的应用尚未收集电子邮件，请参阅[电子邮件收集策略](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**。系统仅接受顶级域名，`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. 配置发送域名 \{#set-up-your-sending-domain\}

Adapty Mail 使用你自己的域名发送邮件。只需添加一次 DNS 记录，所有营销活动都将使用同一个已验证的域名。

1. 在 Adapty Mail 中，前往 **Settings → Email Domains**。
2. 输入你的根域名（例如 `yourapp.com`），然后点击 **Preview**。系统只接受顶级域名——输入 `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\}

页面会显示一份**前提条件**清单，每项都带有内联按钮——请按顺序逐项完成，然后回来生成。清单涵盖登录付费墙编辑工具、连接 Stripe、添加产品以及查看结果等步骤。完整操作流程请参阅[设置结账](mail-checkout)。

所有前提条件变为绿色后，点击 **Generate** 打开生成对话框：
- **Environment**：选择 **Production** 或 **Sandbox**。Sandbox 使用你的 Stripe 测试模式产品，是开发和本地环境的安全默认选项。
- **Plans**：最多选择 **3 个 Stripe 方案**（每个方案对应一个产品 + 价格）。这些是生成的付费墙在结账时向用户展示的优惠内容。

点击 **Generate** 开始构建。构建完成后，打开编辑器进行审查并发布。

:::important
付费墙必须先发布，才能处理结账流量。未发布的付费墙在用户点击邮件结账链接时会返回错误。
:::
### 选项 A：使用 AI 生成 \{#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. 用 AI 生成营销活动 \{#generate-a-campaign-with-ai\}

AI 会为你生成完整的邮件序列——包括文案、设计、主视觉图片以及个性化结账链接，全部根据你的品牌量身定制。

1. 在 Adapty Mail 中，进入 **Campaigns** 并点击 **Create**。
2. 设置营销活动名称。
3. 在 **Web paywall** 下拉菜单中，选择你在上一步添加的网页付费墙。

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** —— 购买后申请退款的用户。

   关于每个触发器的目标定位与文案风格建议，请参阅[流程](mail-flows)。

2. 点击 **Create** 打开对话框。

3. 在对话框中：
   - 选择一个**市场细分**（例如，选择 **All Users** 以定向所有触达此触发器的用户，或根据用户画像属性创建新的市场细分）。
   - 将内容类型保持为 **Campaign**（A/B 测试选项详见 [A/B 测试](mail-ab-testing)）。
   - 选择你在第 4 步中保存的 **Campaign**。
4. 点击 **Save**。

流程会立即生效——无需单独的启动步骤。从此时起，符合该市场细分条件的用户一旦触达触发事件，就会开始收到该营销活动的消息。
:::note
你可以在同一个触发器中添加多个"市场细分 → 活动"行，它们按优先级顺序执行。**All Users** 行（如果使用）必须排在最后（优先级最低），用于捕获所有未被更具体市场细分匹配到的用户。
:::

## 6. 启用发送 \{#enable-sending\}

到目前为止，你的推送活动已配置完毕，但尚未真正触发——负责将订阅事件同步到 Adapty Mail 的 **Adapty 集成** 仍处于关闭状态。启用它是最后一步：事件开始流入，市场细分开始匹配，邮件开始发送。

此步骤仅在完成第 5 步后才可操作。在你启动任意流程之前，**Settings → Integrations** 中的 **Enable** 按钮处于禁用状态，悬停提示为 *"Set up at least one flow before enabling Adapty integration."*
1. 在 Adapty Mail 中，进入 **Settings → Integrations**。
2. 点击 **Enable Adapty integration**（如果之前已设置过集成，则点击 **Enable**）。

启用后，Adapty 会将所有订阅事件——新订阅、续订、试用、转化、退款、账单问题——发送到 Adapty Mail。这些事件将驱动市场细分的成员资格、营销活动路由，以及在用户完成转化时暂停序列的停止条件。

:::note
**Settings** 中的 **Adapty integration** 开关与登录 Adapty Mail 的 Adapty 合作伙伴工作区**不同**。合作伙伴工作区负责创建您的账户（以及通过 Adapty 注册时的品牌）。此处的集成开关控制的是事件同步——需要为每个项目单独开启。
:::
## 故障排除 \{#troubleshooting\}
| 问题 | 解决方案 |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------ |
| DNS 验证卡住 | 检查记录是否完全匹配——无末尾点号，CNAME 目标正确。等待 5–10 分钟后，再次点击 **Check Verification** |
| 验证窗口已过期 | 您的记录仍然有效。在 **Settings → Email Domains** 中重新输入您的域名以开始新的验证窗口 |
| 生成失败或超时 | 检查您的网络连接并重试。如果问题持续存在，请联系 Adapty 支持团队 |
## 了解更多 \{#learn-more\}

- **[收集用户邮箱](mail-collect-emails)**：如果你的应用尚未收集邮箱，可参考这些策略提升覆盖率。
- **[设置发送域名](mail-sending-domain)**：DNS 记录详情、预热层级及故障排查。
- **[设置结账流程](mail-checkout)**：结账漏斗结构与个性化配置。
- **[营销活动分析](mail-analytics)**：追踪送达率、互动数据和收入。
- **[A/B 测试](mail-ab-testing)**：测试多个序列版本。