---
title: "Adapty Mail 中的用户画像"
description: "查看项目中的每位客户——包括其属性、购买状态、邮件互动情况及完整的活动记录。"
---

**用户画像**代表项目中的一位客户。**Profiles** 页面列出 Adapty Mail 已知的所有用户，并展示每个人的购买结果、邮件互动情况及完整的活动记录。用户画像会自动同步：来源包括 Adapty SDK 收集的邮件地址，以及您通过 Adapty Mail API 发送的数据。
:::tip
要将用户画像分组为可复用的目标受众，用于流程和 A/B 测试，请参阅[市场细分](mail-segments)。
:::
## 用户画像如何进入 Adapty Mail \{#how-profiles-get-into-adapty-mail\}

Adapty Mail 会自动从两个来源创建用户画像：

- **Adapty SDK**：SDK 从你的应用中收集邮箱和购买信息。详见[收集用户邮箱](mail-collect-emails)。
- **Adapty Mail API**：你的后端通过服务器间通信发送用户画像和交易数据。详见[通过 API 发送数据](mail-send-data-via-api)。
Adapty Mail 通过稳定的 `external_profile_id` 将每封邮件、每次点击和每次购买关联到对应的用户画像。用户画像页面为只读模式。你可以查看用户画像并取消其订阅，但无法创建、编辑或删除它们。这些数据由源应用或 API 负责管理。
## 用户画像列表 \{#the-profiles-list\}

列表按时间倒序排列，每行显示一条用户画像记录。你可以通过搜索框，按邮箱、用户画像 ID 或外部用户画像 ID 查找特定用户画像。
| 列 | 显示内容 |
| --- | --- |
| Profile | 客户的电子邮件地址，以及向其发送邮件最多的营销活动。 |
| Status | 用户画像的购买状态。请参阅[用户画像状态](#profile-status)。 |
| Country | 客户所在国家/地区。 |
| Open rate | 所有邮件的打开数除以发送数。若尚未发送任何邮件，则显示破折号。 |
| LTV | 生命周期价值——该用户画像在所有渠道的总收入。 |
| Joined | 用户画像首次进入 Adapty Mail 的时间。 |
| Last activity | 用户画像最近一次与邮件互动（如发送、打开或点击）的时间。 |
:::important
**Joined** 是用户画像首次进入 Adapty Mail 的日期，用作"客户起始日期"。该日期为数据摄入时间，而非您应用中的原始注册日期。
:::

### 用户画像状态 \{#profile-status\}

**Status** 列显示用户画像的购买状态——即该用户在订阅和一次性购买方面的当前情况。
| 状态 | 含义 |
| --- | --- |
| Never purchased | 该用户画像未购买任何内容。 |
| Purchased | 该用户画像完成了一次性购买。 |
| Active subscriber | 该用户画像拥有有效订阅。 |
| Cancelling | 自动续订已关闭；访问权限持续至当前周期结束。 |
| Billing issue | 续订付款失败。 |
| Grace period | 付款失败，但访问权限在商店的宽限期内继续有效。 |
| Churned | 订阅已到期，访问权限已终止。 |
| Refunded | 购买已退款。 |
:::note
购买状态与邮件订阅状态是相互独立的。一个用户画像可以是**活跃订阅者**但**未订阅**您的邮件，也可以是**已流失**但仍**已订阅**邮件。邮件状态显示在用户画像页面上，用于控制 Adapty Mail 是否可以向该用户画像发送邮件。
:::
## 用户画像详情 \{#profile-details\}

点击某个用户画像，即可打开其详情页。页面顶部显示邮箱、国家/地区、平台以及"成为客户的日期"。此外还有三个状态标签：购买状态、打开率，以及该用户画像是 **Subscribed**（已订阅）还是 **Unsubscribed**（已退订）。

顶部展示五项互动数据：

- **Sent**：已发送给该用户画像的邮件数量。
- **Delivered**：邮件服务商成功接收的邮件数量。
- **Opened**：该用户画像已打开的邮件数量。
- **Clicked**：该用户画像点击了链接的邮件数量。
- **Revenue**：两项数值——归因收入和生命周期价值。
:::note
**归因收入**是您的邮件带来的收入：用户与推广活动互动后所产生的购买金额。**终身价值（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\}

**Purchase state** 卡片显示用户画像的收入与购买历史。顶部显示生命周期价值，下方最多包含两个区块：

- **Subscription**：该用户画像的订阅价格、商店、开始日期、续订或到期日期，以及产品 ID。
- **One-time purchase**：最近一次一次性购买的价格、商店、购买日期和产品 ID。

如果用户画像尚未有任何购买记录，卡片将显示 **No purchase yet**。
**Segments** 卡片列出了该用户画像当前匹配的所有市场细分，如果没有匹配项则显示 **Not in any segment**。成员资格实时计算，始终反映最新的用户画像数据。关于如何创建市场细分，请参阅[市场细分](mail-segments)。
## 活动历程 \{#the-activity-journey\}

**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 手动发送。事件参考请查看[发送交易事件](mail-send-data-via-api#send-transaction-events)。

## 取消订阅用户画像 \{#unsubscribe-a-profile\}

要停止向某个用户画像发送邮件，打开其页面，点击 **...**，然后选择 **Unsubscribe**。Adapty Mail 会将该用户画像标记为已取消订阅，并将其加入屏蔽列表，后续的推广活动和流程都会跳过它。

此操作具有幂等性：已取消订阅的用户画像不会发生任何变化。关于屏蔽机制以及用户画像如何自行取消订阅的完整说明，请参阅[取消订阅与屏蔽](mail-suppression)。