Adapty Mail 中的用户画像
用户画像代表项目中的一位客户。Profiles 页面列出 Adapty Mail 已知的所有用户，并展示每个人的购买结果、邮件互动情况及完整的活动记录。用户画像会自动同步：来源包括 Adapty SDK 收集的邮件地址，以及您通过 Adapty Mail API 发送的数据。
要将用户画像分组为可复用的目标受众，用于流程和 A/B 测试，请参阅市场细分。
用户画像如何进入 Adapty Mail
Adapty Mail 会自动从两个来源创建用户画像：
- Adapty SDK：SDK 从你的应用中收集邮箱和购买信息。详见收集用户邮箱。
- Adapty Mail API：你的后端通过服务器间通信发送用户画像和交易数据。详见通过 API 发送数据。
Adapty Mail 通过稳定的
external_profile_id将每封邮件、每次点击和每次购买关联到对应的用户画像。用户画像页面为只读模式。你可以查看用户画像并取消其订阅，但无法创建、编辑或删除它们。这些数据由源应用或 API 负责管理。
用户画像列表
列表按时间倒序排列，每行显示一条用户画像记录。你可以通过搜索框，按邮箱、用户画像 ID 或外部用户画像 ID 查找特定用户画像。
| 列 | 显示内容 |
|---|---|
| Profile | 客户的电子邮件地址，以及向其发送邮件最多的营销活动。 |
| Status | 用户画像的购买状态。请参阅用户画像状态。 |
| Country | 客户所在国家/地区。 |
| Open rate | 所有邮件的打开数除以发送数。若尚未发送任何邮件，则显示破折号。 |
| LTV | 生命周期价值——该用户画像在所有渠道的总收入。 |
| Joined | 用户画像首次进入 Adapty Mail 的时间。 |
| Last activity | 用户画像最近一次与邮件互动（如发送、打开或点击）的时间。 |
Joined 是用户画像首次进入 Adapty Mail 的日期，用作”客户起始日期”。该日期为数据摄入时间，而非您应用中的原始注册日期。
用户画像状态
Status 列显示用户画像的购买状态——即该用户在订阅和一次性购买方面的当前情况。
| 状态 | 含义 |
|---|---|
| Never purchased | 该用户画像未购买任何内容。 |
| Purchased | 该用户画像完成了一次性购买。 |
| Active subscriber | 该用户画像拥有有效订阅。 |
| Cancelling | 自动续订已关闭；访问权限持续至当前周期结束。 |
| Billing issue | 续订付款失败。 |
| Grace period | 付款失败，但访问权限在商店的宽限期内继续有效。 |
| Churned | 订阅已到期，访问权限已终止。 |
| Refunded | 购买已退款。 |
购买状态与邮件订阅状态是相互独立的。一个用户画像可以是活跃订阅者但未订阅您的邮件，也可以是已流失但仍已订阅邮件。邮件状态显示在用户画像页面上，用于控制 Adapty Mail 是否可以向该用户画像发送邮件。
用户画像详情
点击某个用户画像，即可打开其详情页。页面顶部显示邮箱、国家/地区、平台以及”成为客户的日期”。此外还有三个状态标签：购买状态、打开率，以及该用户画像是 Subscribed（已订阅）还是 Unsubscribed（已退订）。
顶部展示五项互动数据：
- Sent：已发送给该用户画像的邮件数量。
- Delivered：邮件服务商成功接收的邮件数量。
- Opened：该用户画像已打开的邮件数量。
- Clicked：该用户画像点击了链接的邮件数量。
- Revenue：两项数值——归因收入和生命周期价值。
归因收入是您的邮件带来的收入：用户与推广活动互动后所产生的购买金额。**终身价值（LTV）**是该用户画像在所有渠道的总收入，无论是否与邮件相关。页头先显示归因收入，再显示 LTV。
Profile 卡片列出了客户的属性：
- Platform：客户的设备平台，例如 iOS 或 Android。
- Country：客户所在的国家/地区。
- Store country：客户的 App Store 或 Google Play 账户所在的国家/地区。
- Gender：客户的性别（如已知）。
- Age：客户的年龄（如提供了生日信息）。
- Profile ID：Adapty Mail 为该用户画像分配的内部标识符。
- External ID：来自您的应用或后端的
external_profile_id。 - Custom attributes：您随用户画像发送的任意键值对。
购买状态
Purchase state 卡片显示用户画像的收入与购买历史。顶部显示生命周期价值，下方最多包含两个区块：
- Subscription：该用户画像的订阅价格、商店、开始日期、续订或到期日期，以及产品 ID。
- One-time purchase：最近一次一次性购买的价格、商店、购买日期和产品 ID。
如果用户画像尚未有任何购买记录，卡片将显示 No purchase yet。 Segments 卡片列出了该用户画像当前匹配的所有市场细分，如果没有匹配项则显示 Not in any segment。成员资格实时计算，始终反映最新的用户画像数据。关于如何创建市场细分，请参阅市场细分。
活动历程
Journey 部分是该用户画像所有活动的时间线，从 Profile created 开始，然后穿插两类事件：
- 邮件事件：发送给该用户画像的每封邮件，包含送达、打开和点击情况。展开某封邮件可查看该用户画像点击的链接，以及该邮件带来的购买记录。
- 交易事件：订阅和一次性购买的关键节点，例如开始、续订、取消、账单问题、到期和退款。
交易事件对应以下历程标签：
event_type | Journey 标签 |
|---|---|
subscription_started | Subscription started |
subscription_renewed | Subscription renewed |
subscription_renewal_cancelled | Renewal cancelled |
subscription_renewal_reactivated | Renewal resumed |
billing_issue_detected | Billing issue |
entered_grace_period | Entered grace period |
subscription_expired | Subscription expired |
subscription_refunded | Subscription refunded |
non_subscription_purchase | One-time purchase |
non_subscription_purchase_refunded | Purchase refunded |
| 这些事件可以通过 Adapty SDK 自动发送到 Adapty Mail，也可以通过 API 手动发送。事件参考请查看发送交易事件。 |
取消订阅用户画像
要停止向某个用户画像发送邮件，打开其页面，点击 …，然后选择 Unsubscribe。Adapty Mail 会将该用户画像标记为已取消订阅，并将其加入屏蔽列表，后续的推广活动和流程都会跳过它。
此操作具有幂等性：已取消订阅的用户画像不会发生任何变化。关于屏蔽机制以及用户画像如何自行取消订阅的完整说明，请参阅取消订阅与屏蔽。
