开始使用 Adapty Mail

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

设置分为六个部分：

配置 Adapty SDK
将 Adapty Mail 连接到应用数据
设置发件域名
创建网页付费墙
用 AI 生成营销活动
启动流程

开始之前

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

DNS 访问权限：你可以为根域名添加记录。
Web 支付服务商：你已拥有 Stripe、Paddle 或 PayPal 账户，并已配置好订阅产品。

1. 配置 Adapty SDK

Adapty Mail 是一款独立产品。即使你的付费墙、订阅或数据分析并非由 Adapty 管理，也可以单独使用它——无需迁移整个技术栈。

若要获取准确的收入数据，最低配置要求是以观察者模式安装 Adapty SDK，并开启 App Store 服务器通知。

Adapty Mail 需要从你的应用获取三项信息：购买数据（用于将收入归因到促成转化的邮件）、稳定的用户标识符，以及用户邮箱地址。

让 Adapty 追踪您的收入。 第一步取决于您是否已经实现了应用内购买：
- 如果您已使用 Adapty 实现了应用内购买，此阶段无需进行任何其他操作。
- 如果您已在没有 Adapty 的情况下实现了应用内购买，且不打算迁移到 Adapty，请以观察者模式为您的平台安装 Adapty SDK。此阶段您只需将 SDK 添加到项目中，以观察者模式激活它，并上报交易记录。各平台指南：iOS、Android、React Native、Flutter、Unity、Kotlin Multiplatform、Capacitor。
- 如果您尚未实现应用内购买且希望使用 Adapty，请按照快速入门指南完成相关步骤，将购买处理委托给 Adapty。然后在 Adapty 中启用 App Store 服务器通知，以便直接从 App Store 接收收入相关的更新。
设置用户识别。 传入一个稳定的 ID——你的后端用户 ID、Firebase UID 或类似标识——可以通过调用 Adapty.identify()，或在 SDK 启动时将 customerUserId 传入 .activate()。customer_user_id 是 Adapty Mail 将活动、点击和购买与正确用户画像进行匹配的依据。平台指南：iOS、Android、React Native、Flutter、Unity、Kotlin Multiplatform、Capacitor。
收集用户邮箱。 用户在应用中提供邮箱后（例如注册或结账时），调用 updateProfile 并传入邮箱属性，将其同步到 Adapty。推送活动的每位收件人都需要填写该值。平台指南：iOS、Android、React Native、Flutter、Unity、Kotlin Multiplatform、Capacitor。

如果你的应用尚未收集邮箱，请参阅邮箱收集策略。

2. 将 Adapty Mail 与你的应用数据连接

SDK 接入完成后，还需在看板中配置两项设置，将你的应用与 Adapty Mail 关联起来，这样产品才能真正使用 SDK 发送的数据。

启用 Adapty 集成。 在 Adapty Mail 中，前往 Settings → Integrations，打开 Adapty 集成开关。启用后，Adapty 会将客户产生的所有事件信息同步过来——包括新订阅、续订、试用、转化、退款和账单问题。这些事件直接决定客户所属的市场细分、分配到哪个营销活动，以及是否根据其购买状态停止发送邮件。
添加您的 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. 配置发送域名

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

在 Adapty Mail 中，前往 Settings → Email Domains。
输入你的根域名（例如 yourapp.com），然后点击 Preview。系统只接受顶级域名——输入 app.yourapp.com 这类子域名时会被拒绝。

Adapty 会自动生成两个发送子域名（mail.yourapp.com 和 email.yourapp.com）。点击 Confirm 查看所需的 DNS 记录。

在您的域名注册商处，添加显示的 10 条 DNS 记录（每个子域名各 5 条）：
- 每个子域名添加 3 条 CNAME 记录（DKIM）
- 每个子域名添加 1 条 MX 记录（Mail-From）
- 每个子域名添加 1 条 TXT 记录（SPF，v=spf1 include:amazonses.com ~all）
可选：在根域名上添加一条 DMARC TXT 记录（推荐）。
返回 Settings → Email Domains，点击 Check Verification。

验证时间一览：

自动轮询：提交后约 5 分钟进行首次检查，之后间隔逐渐延长至每小时一次，直到记录验证通过。
手动检查：随时点击 Check Verification 触发立即检查。
DNS 传播：通常只需几分钟，极少数情况下最长可达 48 小时。
验证窗口期：7 天。若超时，DNS 记录仍会保留——在 Settings → Email Domains 中重新输入域名即可开启新的验证窗口。

关于各记录类型和域名预热的详细说明，请参阅设置发件域名。

4. 创建网页付费墙

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

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

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

选项 A：使用 AI 生成

选择 Generate with AI。
点击 Log in to the paywall builder。网页付费墙编辑工具将在新标签页中打开。如果你尚未登录，请使用 Adapty 账号登录。
在编辑工具中，启用你的支付服务商集成（Stripe、Paddle 或 PayPal）。详情请参阅网页付费墙配置。
返回 Adapty Mail，点击 Proceed to generation。
检查生成的付费墙，然后保存并发布。

方案 B：使用自托管付费墙

选择 Enter URL manually。
粘贴您托管的付费墙 URL。该 URL 必须以查询参数的形式包含 {email} 和 {external_profile_id} 占位符 —— Adapty Mail 会为每位收件人填入对应的值，以便结账页面识别访客身份。示例：
```
https://example.com/paywall?email={email}&profile={external_profile_id}
```
保存并发布。

付费墙必须先发布，才能承接结账流量。未发布的付费墙在用户点击邮件结账链接时会返回错误。

有关结账漏斗结构和个性化工作原理，请参阅设置结账。

5. 用 AI 生成推广活动

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

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

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

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

点击 Create 保存活动。

活动会保存为草稿状态，此时尚未开始发送——只有将活动关联到流程（下一步）后才会正式生效。活动编辑器中没有单独的”发布”操作。

6. 启动流程

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

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

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

流程会立即生效，无需单独的启动步骤。从此刻起，符合该市场细分条件的用户一旦触发触发事件，就会开始收到该活动内容。

同一个触发器下可以添加多行”市场细分 → 活动”映射，系统会按优先级依次匹配。All Users 行（如果使用）必须放在最后（优先级最低），用于兜底所有未被更具体市场细分匹配到的用户。

故障排查

问题	解决方案
DNS 验证卡住	检查记录是否完全匹配——无尾随点、CNAME 目标正确。等待 5–10 分钟，然后再次点击 Check Verification
验证窗口已过期	您的记录仍然有效。在 Settings → Email Domains 中重新输入域名，开启新的验证窗口
生成失败或超时	检查您的网络连接后重试。如果问题依然存在，请联系 Adapty 支持团队

了解更多

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