---
title: "为 Adapty Mail 收集用户邮箱"
description: "将用户邮箱和稳定标识符传递给 Adapty，以便营销活动能够触达您的用户。"
---

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

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

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

2. **传递电子邮件。** 用户提供电子邮件后，立即通过 `updateProfile` 的 `email` 参数将其发送给 Adapty。
平台指南：[iOS](setting-user-attributes)、[Android](android-setting-user-attributes)、[React Native](react-native-setting-user-attributes)、[Flutter](flutter-setting-user-attributes)、[Unity](unity-setting-user-attributes)、[Kotlin Multiplatform](kmp-setting-user-attributes)、[Capacitor](capacitor-setting-user-attributes)。
:::important
- 始终传递**稳定的** `customer_user_id`，切勿使用匿名标识符。如果用户卸载并重新安装应用，Adapty 会使用此 ID 将重新安装与现有用户画像关联，并将购买记录归因到正确的用户。
- 在收集并向 Adapty 发送邮箱地址之前，请务必获得用户的明确同意。您有责任遵守 GDPR、CAN-SPAM 以及目标市场的相关法规。
:::

<Details>
<summary>验证您的邮箱覆盖率</summary>

实现收集功能后，在 Adapty 中检查覆盖情况：
1. 前往 **Customers → Profiles**。
2. 筛选已设置邮箱的用户画像。

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

</Details>
## 电子邮件收集策略 \{#email-collection-strategies\}

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

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