---
title: "用户画像/CRM"
description: "在 Adapty 中管理用户画像和 CRM 数据，以增强目标受众细分能力。"
---

用户画像是面向你的用户的 CRM 系统。通过用户画像，你可以：

1. 通过用户画像 ID、Customer User ID、邮箱或交易 ID 查找特定用户。
2. 查看用户的事件时间线，包括账单问题、宽限期及其他[事件](events)。
3. 分析用户属性，如订阅状态、总收入/实际收益等。
4. 为用户授予订阅。

:::note
事件feed中的事件到达看板时会有延迟。新的用户画像和属性变更可能不会立即显示。
:::

  <img src="/assets/shared/img/profiles.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

:::link
要了解 Adapty 如何创建和关联用户画像，请参阅[用户画像的工作原理](how-profiles-work)。
:::

## 查找用户 \{#finding-users\}

在用户画像列表中，你可以通过以下方式搜索特定用户：

- **Profile ID**：Adapty 对该用户的内部标识符（也称为 Adapty ID）。
- **Customer user ID**：你的应用为该用户设置的标识符（如已设置）。
- **Email**：用户的电子邮件地址（如已作为自定义属性传入）。
- **Transaction ID**：购买时产生的应用商店交易 ID。

点击任意一行即可打开该用户的完整用户画像。

## 订阅状态 \{#subscription-state\}

在用户画像列表中，您可以按订阅状态对用户进行筛选和排序。状态值如下：

| 用户**状态** | 描述 |
| :--------------------- | :----------------------------------------------------------- |
| Subscribed | 用户拥有有效订阅，且自动续订已开启。 |
| Auto-renew off | 用户已关闭自动续订，但在订阅期结束前仍可使用高级功能。 |
| Subscription cancelled | 用户已取消订阅，且订阅已完全终止。 |
| Billing issue | 用户在订阅或试用期到期后因账单问题无法完成扣款。 |
| Grace period | 用户当前处于宽限期，原因是在订阅或试用期到期后尝试扣款时发生了账单问题。 |
| Active trial | 用户拥有有效订阅，当前处于试用期。 |
| Trial cancelled | 用户已取消试用，且没有有效订阅。 |
| Never subscribed | 用户从未订阅或开始试用，仍为免费用户。 |

## 用户属性 \{#user-attributes\}

  <img src="/assets/shared/img/ce8df4d-CleanShot_2023-06-26_at_20.32.232x.webp"
  style={{
    border: '1px solid #727272',
    width: '700px',
    display: 'block',
    margin: '0 auto'
  }}
/>

您可以通过 SDK 向 Adapty 发送额外的用户属性。

默认情况下，Adapty 会设置：

| 属性               | 描述                                                         |
| ------------------ | ------------------------------------------------------------ |
| Customer user ID | 您的系统中终端用户的标识符。                                 |
| Adapty ID        | Adapty 内部的终端用户标识符，即 Profile ID。                 |
| IDFA             | 广告主标识符，由 Apple 分配给用户设备。在 iOS 14+ 上需要 App Tracking Transparency (ATT) 权限。Android 不可用。 |
| Country          | 终端用户所在国家/地区。                                      |
| OS               | 终端用户使用的操作系统。                                     |
| Device           | 终端用户可见的设备型号名称。                                 |
| Install date     | 用户在 Adapty 中首次被记录的日期：<ul><li>用户的创建日期。</li><li>如果用户在您集成 Adapty 之前已安装应用，安装日期以其首次交易日期为准。</li><li>如适用，以历史数据导入时提供的日期为准。</li></ul> |
| Created at       | 用户的创建日期。                                             |

请至少发送您的内部用户 ID 或用户邮箱。这样您就可以在用户画像列表中通过这些标识符找到对应用户。

安装 SDK 后，Adapty 会自动从支付队列中收集用户事件，并在用户画像中显示。上表中的属性均会自动收集——您无需手动发送。

### 自定义属性 \{#custom-attributes\}

在用户画像的 **Attributes** 部分，您可以查看通过 SDK 或 API 设置的自定义属性。您也可以使用 **Add attribute** 按钮手动添加属性。

  <img src="/assets/shared/img/378c1fb-add_attribute.webp"
  style={{
    border: '1px solid #727272',
    width: '700px',
    display: 'block',
    margin: '0 auto'
  }}
/>

## 授予订阅 \{#granting-a-subscription\}

在用户画像中，你可以延长活跃订阅的有效期，或授予用户某个访问等级的永久授权——无需用户实际购买。

  <img src="/assets/shared/img/b1d74fd-edit_paid_access_level.webp"
  style={{
    border: '1px solid #727272',
    width: '700px',
    display: 'block',
    margin: '0 auto'
  }}
/>

以下场景中此功能最为实用：
- 在账单或支持问题后对用户进行补偿。
- 执行手动促销活动或 Beta 测试计划。
- 无需真实购买即可测试订阅流程。

要授予访问权限，请打开用户的用户画像，进入 **Access levels** 部分，然后点击 **Edit**。设置到期日期并保存。到期日期必须是未来的时间，且一旦设置后不能缩短。调整活跃订阅的到期日期不会影响正在进行中的付款。

:::note
授予访问权限不会创建 App Store 或 Google Play 购买事件。用户的事件记录和分析数据将与真实购买流程有所不同。
:::

您也可以使用 [Grant access level](api-adapty/operations/grantAccessLevel) API 方法以编程方式授予访问权限。

## 在用户账户之间共享付费访问权限 \{#sharing-paid-access-between-user-accounts\}

:::link
主要文章：[在用户账户之间共享付费访问权限](sharing-paid-access-between-user-accounts)
:::

### 访问等级共享历史 \{#access-sharing-history\}

当访问等级被共享或转让时，用户的用户画像会显示一个指向关联用户画像的链接——即共享访问的用户画像或接收访问的用户画像。要查看关联的用户画像，请在用户的 **Profile** 中，点击访问等级旁边的链接。

  <img src="/assets/shared/img/profile-access-level-origin.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

:::note
虚拟货币余额不像访问等级那样在用户画像之间共享或转移。每个余额仅归属于单个用户画像——详见[余额、用户画像与设备](virtual-currency-balance#balances-profiles-and-devices)。
:::

## 后续步骤 \{#next-steps\}

- 要了解 Adapty 如何创建和关联用户画像，请参阅[用户画像的工作原理](how-profiles-work)。
- 要配置访问共享策略，请参阅[在用户账户之间共享付费访问等级](sharing-paid-access-between-user-accounts)。
- 要以编程方式授予访问权限，请参阅 [授予访问等级](api-adapty/operations/grantAccessLevel) API 方法。