---
title: "开始使用 Adapty Mail"
description: "设置 Adapty Mail 并启动您的第一个邮件流。"
---

本指南将帮助你完成 Adapty Mail 的设置并启动第一个邮件流。

设置分为六个部分：
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. [用 AI 生成营销活动](#5-generate-a-campaign-with-ai)
6. [启动流程](#6-launch-a-flow)
## 开始之前 \{#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. 将 Adapty Mail 与你的应用数据连接 \{#2-connect-adapty-mail-to-your-app-data\}

SDK 接入完成后，还需在看板中配置两项设置，将你的应用与 Adapty Mail 关联起来，这样产品才能真正使用 SDK 发送的数据。
1. **启用 Adapty 集成。** 在 Adapty Mail 中，前往 **Settings → Integrations**，打开 **Adapty** 集成开关。启用后，Adapty 会将客户产生的所有事件信息同步过来——包括新订阅、续订、试用、转化、退款和账单问题。这些事件直接决定客户所属的市场细分、分配到哪个营销活动，以及是否根据其购买状态停止发送邮件。

   
2. **添加您的 App Store 或 Google Play 链接。** 在 Adapty Mail 中，前往 **Settings → App metadata**，粘贴直接指向应用商店的链接——iOS 使用 `https://apps.apple.com/…id{numbers}`，Android 使用 `https://play.google.com/store/apps/details?id={package}`。
## 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)。
## 4. 创建网页付费墙 \{#4-create-a-web-paywall\}

每封邮件都会链接到一个网页付费墙——即用户点击 CTA 后进入的结账页面。你有两种选择：

- **使用 AI 生成**：由内置的网页付费墙编辑工具为你的应用自动生成一个。
- **使用自己托管的付费墙**：接入你已有的付费墙。

首先，在 Adapty Mail 中前往 **Web Paywalls → Create**。

### 选项 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. 检查生成的付费墙，然后保存并发布。
### 方案 B：使用自托管付费墙 \{#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. 用 AI 生成推广活动 \{#generate-a-campaign-with-ai\}

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

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

4. 点击 **Generate emails**。
5. 在生成对话框中，选择语气和语言。默认情况下，AI 会根据最佳实践和应用上下文自动确定生成的邮件数量。如果你想手动设置数量，点击 **Set number manually** 并进行设置（**1–15**，默认为 4）。

6. 点击 **Generate**。生成通常需要几分钟，如果 5 分钟内无法完成，系统会自动超时——遇到这种情况重试即可。
7. 预览每封邮件。你可以重新生成单封邮件、编辑文案，或打开 HTML 编辑器进行精细调整。

8. 点击 **Create** 保存活动。

活动会保存为**草稿**状态，此时尚未开始发送——只有将活动关联到流程（下一步）后才会正式生效。活动编辑器中没有单独的"发布"操作。
## 6. 启动流程 \{#launch-a-flow\}

流程将**触发器**（如订阅到期等事件）与**目标受众**关联，并向该目标受众发送你选择的**营销活动**。Adapty Mail 内置三个固定触发器，每个触发器对应独立的流程视图。

1. 在 Adapty Mail 中，进入 **Flows**，然后打开要配置的触发器：
   - **Never purchased** — 已注册但尚未购买的用户。
   - **Expired** — 已过期的订阅。
   - **Refunded** — 已退款的购买记录。
2. 点击 **Create** 打开对话框。

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

流程会立即生效，无需单独的启动步骤。从此刻起，符合该市场细分条件的用户一旦触发触发事件，就会开始收到该活动内容。
:::note
同一个触发器下可以添加多行"市场细分 → 活动"映射，系统会按优先级依次匹配。**All Users** 行（如果使用）必须放在最后（优先级最低），用于兜底所有未被更具体市场细分匹配到的用户。
:::

## 故障排查 \{#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)**：测试多个序列版本。