将 Adapty 连接到 Adapty Mail

Adapty 是 Adapty Mail 的入口之一——如果您的应用已接入 Adapty SDK，可直接使用此方式。Adapty 会将用户画像、电子邮件地址和订阅事件传递给 Adapty Mail，Adapty Mail 再据此筛选收件人、将每位用户纳入相应流程，并将购买行为归因到驱动该订单的邮件。

如果您的应用未接入 Adapty SDK，可通过服务端发送相同数据——详见通过 Adapty Mail API 发送邮件和交易记录。

Important

为了获取准确的收入数据，最低配置要求是以观察者模式安装 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 设置。customer_user_id 是 Adapty Mail 将营销活动、点击行为和购买记录关联回正确用户画像的依据。

平台指南：iOS、Android、React Native、Flutter、Unity、Kotlin Multiplatform、Capacitor。

3. 收集用户邮箱

一旦用户在应用中提供了邮箱（例如在注册或结账时），请通过调用 updateProfile 并传入 email 属性，将其传递给 Adapty。每一位活动收件人都需要填写此值。

平台指南：iOS、Android、React Native、Flutter、Unity、Kotlin Multiplatform、Capacitor。

Important

始终传递稳定的 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，在 Adapty Integration 部分点击 Enable Adapty integration（如果此前已配置过集成，则点击 Enable）。在至少有一个流程之前，该按钮将保持禁用状态，提示信息为 “Set up at least one flow before enabling Adapty integration”。

Not linked。此项目是你在 Adapty Mail 中自行创建的——无论是在独立账户上，还是在你的 Adapty 账户上。

Adapty Integration 部分不会显示，但 Adapty 同样可以向该项目推送数据——它只需要密钥即可。

在 Adapty Mail 中，前往 Settings > Project，复制 Secret key。 2. 在 Adapty 看板中，前往 Integrations > Adapty Mail，开启集成，将密钥粘贴到 Secret Key 字段，然后保存。

两种方式创建的是同一个集成——Adapty Mail 中的按钮会自动帮你填入密钥。

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

限制条件

匿名用户：没有稳定 customer_user_id 的用户无法接收推广活动。请在用户创建账户或登录时对其进行识别——从那时起，他们提供的任何邮箱都会与其 Adapty 用户画像进行匹配。
没有邮箱的用户：没有邮箱的用户画像会被排除在推广活动之外，也不会出现在推广活动分析数据中。一旦他们提供了邮箱，便可参与后续推广活动。