开始使用 Adapty Mail

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

设置共分六个部分：

连接您的数据
设置发送域名
创建网页付费墙
使用 AI 生成活动
启动流程
开始发送

Tip

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

开始之前

在开始之前，请确认以下条件已满足：

DNS 访问权限：你可以在根域名下添加记录。
支付方式：你已拥有 Stripe 账户并配置好订阅产品。如需使用其他支付提供商，请自行托管结账流程——详见配置结账。

1. 连接您的数据

Adapty Mail 需要购买历史记录（用于将收益归因到促成转化的邮件）、稳定的用户标识符，以及每位用户的邮件地址。请准备好与您现有数据所在位置相匹配的入口点——您将在第 6 步开启数据流，届时其余的配置已就绪，能够处理传入的数据：

Adapty：如果你的应用运行了 Adapty SDK，请接入用户识别和邮件收集功能。暂时不要启用集成本身——在你配置好流程之前，Adapty Mail 会阻止启用。参见将 Adapty 连接到 Adapty Mail。
Adapty Mail API：如果你的后端是数据来源，请从 Settings 获取密钥并构建请求，但暂时不要发送。在设置完成之前收到的用户画像将不会收到任何内容。参见通过 Adapty Mail API 发送邮件和事务。

您可以同时使用多个入口点。Adapty Mail 会根据 customer_user_id 和邮箱地址对传入数据进行匹配，因此即使同一用户的信息来自多个来源，也只会生成一个用户画像和一条邮件序列。

Important

Adapty Mail 是一款独立产品。即使您的付费墙、订阅或数据分析功能并非由 Adapty 处理，也可以直接使用 Adapty Mail，无需迁移整个技术栈。

2. 设置发件域名

打开 Adapty Mail：点击页眉中的 Adapty 徽标，选择 Mail。

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

在 Adapty Mail 中，前往 Settings → DNS，在 Email domains 部分点击 Add domain。
在 Domain 字段中，输入您的根域名（例如 yourapp.com）。此处仅接受顶级域名——输入 app.yourapp.com 这类子域名会被拒绝。
在 Sending subdomain 字段中，输入邮件发送所用的前缀，或留空以使用 mail。邮件将从 hello@mail.yourapp.com 发出。
点击 Add domain。

在域名注册商处，添加新域名卡片列出的所有 DNS 记录。这些记录分为三组：发送子域名的 DKIM 和 MAIL FROM 记录、用于预热域名的邮箱记录，以及为 go.yourapp.com 提供图片和跟踪链接服务的记录。如需了解每组记录的用途，请参阅添加哪些记录。如需一次性导出所有记录，点击 Export。
可选操作：在根域名上添加建议的 DMARC TXT 记录（推荐）。
点击 Check 立即验证，或关闭卡片让 Adapty Mail 自动轮询 DNS。

验证时机说明：

自动轮询：添加域名 1 分钟后进行首次检查，此后间隔时间翻倍，直至每小时一次，直到找到记录为止。
手动检查：随时点击 Check 触发立即检查。
DNS 传播：通常只需几分钟，极少数情况下最长可达 48 小时。
验证窗口：7 天。若超时，您的 DNS 记录仍会保留——在 Settings → DNS 中重新添加域名，即可开启新的验证窗口。

一个已验证的域名即可开始发送。一个项目最多可添加五个域名，其余的可以稍后再添加。

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

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 开始构建。构建完成后，打开编辑器进行审查并发布。

Important

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

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

选择 Enter URL manually。
粘贴您托管的付费墙 URL，并将占位符作为查询参数添加。Adapty Mail 会为每位收件人替换相应的占位符，以便结账页面识别访客。示例：
```
https://example.com/paywall?email={email}&adapty_profile_id={adapty.external_profile_id}
```
创建页面列出了可用的占位符。请参阅设置结账，了解每个占位符对应的具体内容。
保存并发布。

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

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。

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

Note

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

6. 开始发送

您的营销活动已配置完成，但尚未开始运行——还没有用户数据流入 Adapty Mail。启动数据流是最后一步，第 1 步中的每个入口点启动方式各不相同：

Adapty：在 Adapty Mail 中，进入 Settings → Project 并点击 Enable Adapty integration。在完成第 5 步之前，该按钮处于禁用状态，悬停提示为 “Set up at least one flow before enabling Adapty integration”。请参阅将 Adapty 连接到 Adapty Mail。
Adapty Mail API：开始推送用户画像和交易事件。在完成本步骤设置之前发送的用户画像不会收到任何消息，这也是本步骤放在最后的原因。请参阅通过 Adapty Mail API 发送邮件和交易数据。

从这里开始，符合您市场细分条件的用户一旦触发条件，即可立即收到该活动推送。在向真实用户开放之前，请先使用一个测试用户测试整个流程。

故障排除

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

了解更多

测试你的流程：在正式上线前，让测试用户跑完整个流程。
将 Adapty 连接到 Adapty Mail：SDK 配置，以及在应用尚未收集邮箱时提升邮件覆盖率的策略。
配置发送域名：DNS 记录详情、预热层级及故障排查。
设置结账流程：结账漏斗结构与个性化配置。
营销活动分析：追踪送达率、互动情况和收入数据。
A/B 测试：测试多个序列版本。