---
metadata:
  - name: generator
    content: Diplodoc Platform v5.70.0
alternate:
  - https://appmetrica.yandex.by/docs/en/data-collection/about-profiles.md
  - https://appmetrica.yandex.by/docs/ru/data-collection/about-profiles.md
  - https://appmetrica.yandex.by/docs/zh/data-collection/about-profiles.md
  - href: https://appmetrica.yandex.by/docs/zh/data-collection/about-profiles.md
    type: text/markdown
    title: Markdown version
  - href: https://appmetrica.yandex.by/docs/zh/llms.txt?revision=r22089357
    rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://appmetrica.yandex.by/docs/zh/llms.txt?revision=r22089357

# 用户配置文件

配置文件包含应用用户的特征——属性。您可以在[配置文件报告](https://appmetrica.yandex.by/docs/zh/mobile-reports/profile-report.md)中分析它们，并将其用于其他报告的分段。

{% note warning %}

例如，事件记录订阅生效，而配置文件属性存储其当前类型。当传输新的属性值时，先前的值会被替换。配置文件不会取代事件历史。

{% endnote %}

## 有哪些属性 {#attribute-types}

#|
||
**属性** | **如何出现**
||
||
系统
|
SDK 确定有关设备、应用和其他系统特征的信息
||
||
预定义自定义
|
开发人员配置受支持属性的传输，例如年龄或通知权限状态
||
||
自有自定义
|
您在控制台中创建属性并配置其值的发送，例如订阅类型或忠诚度级别
||
|#

## 如何配置配置文件 {#send}

1. 确定分析需要哪些用户特征：例如，订阅类型或忠诚度级别。
1. 对于每个特征，描述可能的值和更新时刻。
1. 在**设置** → **配置文件属性**部分创建自有属性：设置名称和类型，然后点击**添加**。对于已提供的属性，此步骤不是必需的。
1. 将描述传递给开发人员，并商定如何识别用户。新自有属性可以在创建后约 30 分钟传输。

{% note warning %}

不要传输用户的机密信息。

{% endnote %}

## 如何检查结果 {#check-result}

打开[测试配置文件卡片](https://appmetrica.yandex.by/docs/zh/mobile-reports/profile-list.md#profile-card)，检查标识符和属性值。更改测试属性并确保值已更新。然后在配置文件报告中检查分组。

如果特征没有出现，请开发人员检查与配置文件的关联以及值的传输。对于自有属性，还要确保它已在控制台中创建。

## 了解更多 {#learn-more}

- [用户配置文件](https://appmetrica.yandex.by/docs/zh/mobile-reports/profile-report.md)
- [配置文件报告](https://appmetrica.yandex.by/docs/zh/mobile-reports/profile-report.md)
- [配置文件列表](https://appmetrica.yandex.by/docs/zh/mobile-reports/profile-list.md)

属性是用户特征。开发人员将其与所需的配置文件关联，并配置更新，以便报告显示当前值。

{% cut "面向开发人员：配置文件标识符和属性" %}

下载面向开发人员的说明（TXT）：{% file src="../../_assets/instructions/profiles-developer-zh.txt" name="profiles-developer-zh.txt" type="text/plain; charset=utf-8" %}

### 自定义配置文件属性 {#profile-attributes}

自定义属性分为预定义属性和自有属性。要收集它们，您需要在 AppMetrica SDK 中配置发送。

#### 预定义属性 {#pre-defined}

对任何应用的用户都很典型且已在 AppMetrica SDK 中预先支持的属性：

**ProfileId**

用户配置文件标识符。接受任意字符串值。如果未配置 `ProfileId` 发送，则预定义属性不会显示在 AppMetrica Web 界面中。

**性别**

用户配置文件性别。可能的值：`男`、`女`、`其他`。

**年龄**

用户配置文件的出生日期或年龄。

**允许推送**

用户配置文件的通知状态。该状态指示用户是否允许接收通知。

**姓名**

用户配置文件的姓名。AppMetrica 还有系统**性别**和**年龄**，它们使用 [Crypta](https://yandex.ru/company/technologies/crypta) 技术自动确定。

要收集预定义配置文件属性，您需要在 AppMetrica SDK 中配置其发送。更多信息请参阅[配置配置文件属性发送](#profile-settings)部分。

#### 自有属性 {#custom}

未预先支持且可能因应用类型而异的属性。自有属性的名称和类型在应用设置中手动设置。

AppMetrica 允许您配置发送最多 100 个以下类型的自有属性：

**String**

接受任意字符串值。例如，订阅类型：`免费`、`试用`、`高级`。

**Number** {#number}

接受数值。例如，屏幕上的小部件数量：`1`、`2`、`3`、`4`。

**Bool**

接受二进制逻辑值。例如，是否存在付费订阅：`true`、`false`。

**Counter** {#counter}

通过加法或减法操作设置。例如，已完成的关卡数量：`+1`。

要收集自有配置文件属性，您需要在应用设置中添加它们，并在 AppMetrica SDK 中配置其发送。更多信息请参阅[配置配置文件属性发送](#profile-settings)部分。

### 如何配置属性发送 {#profile-settings}

1. **定义标识符。** 在 SDK 中配置 `ProfileId` 的传输。如果标识符仅在库初始化后出现，则可能保留技术配置文件，并出现带有已传输 ID 的新配置文件。了解更多——[关于配置文件标识符](#send-attributes)。
1. **创建自有属性。** 打开**设置 → 配置文件属性**，指定名称和类型，点击**添加**。对于预定义属性，此步骤不是必需的。
1. **配置发送。** 将名称、类型和更新条件传递给开发人员。新自有属性可以在控制台创建后约 30 分钟传输。

#### 面向开发人员：发送属性 {#send-attributes}

- [Android](https://appmetrica.yandex.by/docs/zh/sdk/android/analytics/android-operations.md#send-attribute-profile)
- [iOS](https://appmetrica.yandex.by/docs/zh/sdk/ios/analytics/ios-operations.md#send-attribute-profile)
- [Flutter](https://appmetrica.yandex.by/docs/zh/sdk/flutter/analytics/flutter-operations.md#send-attribute-profile)
- [React Native](https://appmetrica.yandex.by/docs/zh/sdk/react-native/analytics/react-native-operations.md#send-attribute-profile)
- [Unity](https://appmetrica.yandex.by/docs/zh/sdk/unity/analytics/unity-operations.md#send-attribute-profile)

{% endcut %}

<!-- source: zh/_includes/feedback-button.md -->
如果您没有找到所需答案，可以通过反馈表单提交您的问题。 请尽可能详细地描述问题。 如果可能，请附上截图。

<a href="../troubleshooting/feedback-new">
  <span class="button">联系支持</span>
</a>

<a href="../troubleshooting/feedback-docs">
  <span class="button">为文档提出改进建议</span>
</a>
<!-- endsource: zh/_includes/feedback-button.md -->
