设置用户属性

iOS+ Android Web Flutter

用户属性是为描述您的各个细分用户群而定义的属性，例如语言首选项或地理位置。这些用户属性可用于定义您的应用的受众群体。本指南将介绍如何在您的应用中设置用户属性。

Analytics 会自动记录一些用户属性，您无需为此添加任何代码。如果您需要收集其他数据，可以为每个项目设置各种用户属性，最多可设置 25 种。请注意，用户属性名称区分大小写。即便您设置的两个用户属性只是名称的大小写不同，Analytics 也会将它们当成两个完全不同的用户属性来记录。

您不得使用 Google 预留的少数几个用户属性名称：

• 年龄
• 性别
• 兴趣

准备工作

确保您已按照 Analytics 使用入门中的说明设置了您的项目，并且可以访问 Analytics。

设置用户属性

您可以设置 Analytics 用户属性来描述应用的用户。还可以创建自定义设置，然后在报告中用这些设置进行对比或用作受众群体评估条件，通过这种方式来使用用户属性。

如需设置用户属性，请按以下步骤操作：

1. 在 Firebase 控制台的 Analytics 的自定义设置页面中，为用户属性创建自定义设置。如需了解详情，请参阅自定义维度和指标。
2. 使用 setUserProperty() 方法在您的应用中设置用户属性。

下面的示例展示了如何添加一个假设的“最喜欢的食物”属性，将 mFavoriteFood 中的值分配给活跃用户：

Kotlin

firebaseAnalytics.setUserProperty("favorite_food", food)
MainActivity.kt

Java

mFirebaseAnalytics.setUserProperty("favorite_food", food);
MainActivity.java

注意：注册属性后，系统可能需要几个小时的时间才能将通过该属性收集到的数据纳入报告中。当新数据可用时，该用户属性可用作报告过滤条件或受众群体定义。

您可以在 Firebase 控制台的 Analytics 的自定义设置页面中访问这些数据。该页面会显示您已为应用定义的用户属性列表。您可以在 Google Analytics 提供的多份报告比较中使用这些属性。详细了解信息中心。

注意：Analytics 报告信息中心内的数据会全天定时刷新。