将 Adapty 连接到 Adapty Mail
Adapty 是 Adapty Mail 的入口之一——如果您的应用已接入 Adapty SDK，可直接使用此方式。Adapty 会将用户画像、电子邮件地址和订阅事件传递给 Adapty Mail，Adapty Mail 再据此筛选收件人、将每位用户纳入相应流程，并将购买行为归因到驱动该订单的邮件。
如果您的应用未接入 Adapty SDK，可通过服务端发送相同数据——详见通过 Adapty Mail API 发送邮件和交易记录。
为了获取准确的收入数据，最低配置要求是以观察者模式安装 Adapty SDK，并启用 App Store 服务器通知。
Adapty Mail 需要来自您应用的三项信息：购买数据（用于将收入归因到促成转化的邮件）、稳定的用户标识符以及用户邮箱。完成这三项配置后，再在 Adapty Mail 中设置您的域名、结账流程、营销活动和流程，最后开启发送功能。
1. 让 Adapty 追踪您的收入
第一步取决于您是否已经实现了应用内购买：
- 如果您已使用 Adapty 实现了应用内购买，此阶段无需进行任何其他操作。
- 如果您已在不使用 Adapty 的情况下实现了应用内购买，且不打算迁移到 Adapty，请以观察者模式为您的平台安装 Adapty SDK。此阶段您只需将 SDK 添加到项目中，以观察者模式激活它，并上报交易记录。各平台指南：iOS、Android、React Native、Flutter、Unity、Kotlin Multiplatform、Capacitor。
- 如果您尚未实现应用内购买且希望使用 Adapty，请按照快速入门指南完成相关步骤，将购买处理委托给 Adapty。
然后在 Adapty 中启用 App Store 服务器通知，以便直接从 App Store 接收与收入相关的更新。
2. 识别用户
传入一个稳定的 ID——你的后端用户 ID、Firebase UID 或类似标识——可以在 SDK 启动时通过 .activate() 的 customerUserId 参数传入，也可以之后调用 Adapty.identify()（例如在登录时）。无论哪种方式，都要在显示任何付费墙之前完成 ID 设置。Adapty 用它来跨重装和登录保持每个用户对应唯一的用户画像，Adapty Mail 也会将其存储在用户画像的外部 ID 中。Adapty Mail 通过邮箱地址匹配用户，而非通过该 ID。
平台指南：iOS、Android、React Native、Flutter、Unity、Kotlin Multiplatform、Capacitor。
3. 收集用户邮箱
一旦用户在应用中提供了邮箱（例如在注册或结账时），请通过调用 updateProfile 并传入 email 属性，将其传递给 Adapty。每一位活动收件人都需要填写此值。
平台指南：iOS、Android、React Native、Flutter、Unity、Kotlin Multiplatform、Capacitor。
- 始终传递稳定的
customer_user_id，不要使用匿名标识符。如果用户卸载并重新安装了应用，Adapty 会使用此 ID 将重装行为与已有用户画像关联，并将购买记录归因到正确的用户。 - 在收集并向 Adapty 发送电子邮件地址之前，请先获得用户的明确同意。您有责任遵守 GDPR、CAN-SPAM 以及目标市场中的类似法规。如需让 Adapty Mail 在发送营销邮件前对每个新地址进行确认，请开启双重确认订阅。
验证您的邮箱覆盖率
实施收集后，在 Adapty 中检查覆盖率：
- 前往 Customers > Profiles。
- 筛选已设置邮箱的用户画像。
在启动首个活动之前，目标是在活跃用户中至少达到 30–50% 的邮箱覆盖率。无需等到 100%——达到 30% 即可启动。之后提供邮箱的用户，一旦符合条件，将自动加入进行中的活动。
邮件收集策略
大多数应用默认不收集邮箱。请根据你的应用现状选择合适的方案。
| 策略 | 最适用场景 | 工作原理 |
|---|---|---|
| 现有身份验证 | 任何形式的登录应用 | 您已有用户邮箱——在用户完成身份验证后将其传递给 Adapty。 |
| 付费墙前的邮箱门控 | 无身份验证的应用——健康、健身、占星、图片编辑器 | 在用户引导和付费墙之间添加一个邮箱输入页面。由于用户已投入了时间，转化率通常可达 70–90%。 |
| 网页付费墙编辑工具结账 | SDK 工作量最小；在网页端采集邮箱 | 网页付费墙编辑工具的第一个页面会采集邮箱并将其传递给 Adapty——适用于在应用内门控上线前通过活动链接进入的用户。 |
| 用户引导步骤 | 基于问卷的用户引导（健身、营养、教育） | 在用户引导的第 2–3 步放置邮箱输入。将其定位为价值传递（“我们将把您的个性化计划发送至邮箱”），并避免让该步骤可跳过。 |
| Adapty Mail API | 从您的服务器发送邮件，无需 Adapty SDK | 将用户画像发送至 Adapty Mail API 的 保存用户画像 端点。详见通过 Adapty Mail API 发送邮件和事务数据。 |
4. 设置域名、结账页面、活动和流程
要发送邮件，Adapty Mail 需要以下内容：
- 已验证的发件域名
- 供邮件链接跳转的结账页面
- 用于发送的活动
- 决定收件人的流程
请在 Adapty Mail 中完成以上四项配置——参考 开始使用 Adapty Mail 指南中的第 3 至第 8 步。
5. 开启发送功能
开启集成是最后一步：事件开始流入，市场细分开始匹配，邮件开始发送。Mail 项目是否已关联到 Adapty 应用，只会影响开启方式，不影响最终接收到的内容：
-
已关联 Adapty 应用。当你第一次从 Adapty 看板进入 Mail 时，Adapty 会自动为你创建该项目。
在 Adapty Mail 中，前往 Settings > Project，在 Data integration 部分点击 Enable Adapty integration（如果集成已从之前的设置中存在，则点击 Enable）。
-
未关联。您在 Adapty Mail 中自行创建了该项目——无论是使用独立账户，还是您的 Adapty 账户。
Data integration 部分没有 Enable Adapty integration 按钮，但 Adapty 仍然可以向该项目推送数据——只需提供密钥即可。
- 在 Adapty Mail 中，前往 Settings > Project，复制 Secret key。
- 在 Adapty 看板中，前往 Integrations > Adapty Mail，开启集成，将密钥粘贴到 Secret Key 字段，然后保存。
两种路径在 Adapty 中创建的是同一个集成——通过 Adapty Mail 中的按钮操作时，密钥会自动填入。
启用后，Adapty 会将每一个订阅事件——新订阅、续订、试用、转化、退款、账单问题——发送到 Adapty Mail。这些事件会驱动市场细分的成员资格、营销活动路由，以及在用户完成转化时暂停序列的停止条件。
限制
- 匿名用户：如果没有稳定的
customer_user_id，每次重新安装或退出登录时，Adapty 都会为用户生成一个新的用户画像 ID。在用户提供邮箱之前发生的购买，将无法同步到其 Adapty Mail 用户画像，而是继续关联到旧 ID。从那时起，其收入、购买状态和市场细分归属均会出现错误。 - 未提供邮箱的用户：对于没有提供邮箱地址的用户，Adapty Mail 不会为其创建任何用户画像。这类用户无法被排除在投递或分析之外——他们根本不存在于系统中。一旦获得邮箱地址，用户画像即会创建，该用户也随之成为合格的目标用户。