Adapty Mail 入门指南

本指南将帮助您设置 Adapty Mail 并启动第一个邮件流程。

设置分为六个部分：

配置您的 Adapty SDK
设置发送域名
创建网页付费墙
用 AI 生成营销活动
启动流程
开启发送

如果您是通过 Adapty 注册 Adapty Mail 的，系统会自动根据项目的商店 URL 创建您的品牌档案。随时打开 Brand 查看或完善它——详见品牌。如果您是独立注册的，请在生成营销活动或网页付费墙之前，先在同一页面上设置您的品牌。

开始之前

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

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 从您自己的域名发送邮件。只需添加一次 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 中重新输入域名即可开启新的窗口期。

有关各记录类型和域名预热的详细信息，请参阅设置发件域名。

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 中重新输入域名即可开启新的验证窗口。

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

选项 A：用 AI 生成

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

所有前提条件变为绿色后，点击 Generate 打开生成对话框：

Environment：选择 Production 或 Sandbox。Sandbox 使用你的 Stripe 测试模式产品，是开发和本地环境的安全默认选项。
Plans：最多选择 3 个 Stripe 方案（每个方案对应一个产品 + 价格）。这些是生成的付费墙在结账时向用户展示的优惠内容。

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

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

选项 A：使用 AI 生成

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

4. 用 AI 生成营销活动

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

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

点击 Generate emails。
填写生成对话框——语气、语言、可选的自定义提示词（最多 2,000 个字符）以及邮件数量（1–15 封，默认 4 封）。各字段的说明请参阅创建营销活动。

点击 Generate。生成通常需要几分钟。如果系统在 5 分钟内无法完成，将会超时——遇到这种情况请重试。
预览每封邮件。预览头部有一个 Theme toggle（Auto、Light、Dark），用于控制预览的渲染方式——生成的内容在各模式下完全相同。你可以重新生成单封邮件、编辑文案，或打开 HTML 编辑器进行精细调整。

点击 Create 保存营销活动。活动将保存为草稿，尚未开始发送——活动只有在关联到流程后才会生效（下一步操作）。活动编辑器中没有单独的”发布”操作。

5. 启动流程

流程将一个触发器（如订阅到期等事件）与一个市场细分相关联，并向该市场细分发送你选择的活动。Adapty Mail 内置五种固定触发器，每种触发器都有其专属的流程视图。

在 Adapty Mail 中，进入 Flows，然后打开你想配置的触发器：
- Never purchased —— 已注册但尚未完成购买的用户。
- Renewal cancelled —— 已关闭自动续期但订阅仍在有效期内的用户。
- Billing issue —— 付款失败、银行卡被拒或已过期，或处于宽限期。
- Expired —— 订阅已到期且访问权限已失效。
- Refunded —— 购买后申请退款的用户。
关于每个触发器的目标定位与文案风格建议，请参阅流程。
点击 Create 打开对话框。

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

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

你可以在同一个触发器中添加多个”市场细分 → 活动”行，它们按优先级顺序执行。All Users 行（如果使用）必须排在最后（优先级最低），用于捕获所有未被更具体市场细分匹配到的用户。

6. 启用发送

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

此步骤仅在完成第 5 步后才可操作。在你启动任意流程之前，Settings → Integrations 中的 Enable 按钮处于禁用状态，悬停提示为 “Set up at least one flow before enabling Adapty integration.”

在 Adapty Mail 中，进入 Settings → Integrations。
点击 Enable Adapty integration（如果之前已设置过集成，则点击 Enable）。

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

Settings 中的 Adapty integration 开关与登录 Adapty Mail 的 Adapty 合作伙伴工作区不同。合作伙伴工作区负责创建您的账户（以及通过 Adapty 注册时的品牌）。此处的集成开关控制的是事件同步——需要为每个项目单独开启。

故障排除

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

了解更多

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