为 Adapty Mail 收集用户邮箱

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

收集用户邮箱

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

  1. 识别用户。 传入一个稳定的 ID——你的后端用户 ID、Firebase UID 或类似标识——可以在 SDK 启动时通过 .activate() 的 customerUserId 参数传入，也可以稍后（例如在登录时）调用 Adapty.identify() 完成。无论哪种方式，该 ID 都必须在展示任何付费墙之前设置好。 平台指南：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% 之间。
Web 付费墙编辑工具结账SDK 工作量最小；邮箱在 Web 端采集Web 付费墙编辑工具的第一个页面会收集邮箱并将其传递给 Adapty——适用于在应用内入口上线之前通过点击推广活动进入的用户。
用户引导步骤基于问答的用户引导（健身、营养、教育）在用户引导的第 2–3 步放置邮箱输入。用价值传递的方式进行引导（例如”我们将通过邮件发送您的个性化计划”），并避免让该步骤可跳过。
Adapty Mail API从服务器发送邮件，无需 Adapty SDK将用户画像发送到 Adapty Mail API 的 保存用户画像 端点。请参阅通过 Adapty Mail API 发送邮件和交易。

限制条件

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