为 Adapty Mail 收集用户邮箱

Adapty Mail 需要为每位用户提供一个稳定的 customer_user_id 和邮箱地址，才能完成投递。在启动营销活动之前，请在应用代码中完成这两项配置。

收集用户邮箱

每个用户需要向 Adapty 传递两个值：用于标识用户的稳定 customer_user_id，以及邮箱本身。标识必须先行——没有它，Adapty 就无法找到对应的用户画像来关联邮箱。

  1. 标识用户。 传入一个稳定的 ID——可以是你的后端用户 ID、Firebase UID 或类似标识——方式有两种：在 SDK 启动时通过 .activate() 的 customerUserId 参数传入，或者在登录等时机调用 Adapty.identify()。无论哪种方式，都必须在展示任何付费墙之前完成设置。 平台指南：iOS、Android、React Native、Flutter、Unity、Kotlin Multiplatform、Capacitor。

  2. 传递电子邮件。 用户提供电子邮件后，立即通过 updateProfile 的 email 参数将其发送给 Adapty。 平台指南：iOS、Android、React Native、Flutter、Unity、Kotlin Multiplatform、Capacitor。

  • 始终传递稳定的 customer_user_id，切勿使用匿名标识符。如果用户卸载并重新安装应用，Adapty 会使用此 ID 将重新安装与现有用户画像关联，并将购买记录归因到正确的用户。
  • 在收集并向 Adapty 发送邮箱地址之前，请务必获得用户的明确同意。您有责任遵守 GDPR、CAN-SPAM 以及目标市场的相关法规。
验证您的邮箱覆盖率

实现收集功能后，在 Adapty 中检查覆盖情况：

  1. 前往 Customers → Profiles。
  2. 筛选已设置邮箱的用户画像。

在启动首个活动之前，至少让活跃用户中有 30–50% 的邮箱覆盖率。不必等到 100%——达到 30% 即可启动。之后提供邮箱的用户，一旦符合条件，会自动加入正在进行的活动。

电子邮件收集策略

大多数应用默认不会收集电子邮件。请根据你的应用现状选择合适的方案。

策略最适合工作原理
现有身份验证任何形式的登录应用您已经获取了邮箱地址——在用户完成身份验证后将其传递给 Adapty。请参阅下方的身份验证方式参考，了解从哪里读取邮箱。
付费墙前的邮箱门槛无身份验证的应用——健康、健身、占星、图片编辑类在用户引导与付费墙之间添加一个单独的邮箱输入界面。由于用户已经投入了时间，转化率通常在 70–90% 之间。
网页付费墙编辑工具结账SDK 工作量最小；在网页端采集邮箱网页付费墙编辑工具的第一屏会收集用户邮箱并传递给 Adapty——适用于在应用内门槛上线前，通过活动链接访问的用户。
用户引导步骤基于问卷的用户引导（健身、营养、教育类）在用户引导的第 2–3 步放置邮箱输入。以价值交付的方式进行说明（如”我们将把您的个性化方案发送至您的邮箱”），并避免让该步骤可跳过。
服务端 API 导入在其他平台上已有邮箱列表的应用使用 更新用户画像 接口，通过 email 和 external_profile_id 将记录与现有用户画像进行匹配。

限制条件

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