查看 2022 年 Google I/O 大会上介绍的 Firebase 新动态。了解详情

设置用户属性

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

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

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

  • 年龄
  • 性别
  • 兴趣

准备工作

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

设置用户属性

您可以设置 Analytics 用户属性来描述应用的用户，还可以利用用户属性，方法是：创建自定义定义，然后用其来在报告中进行对比或用作受众群体评估条件。

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

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

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

Java 

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

Kotlin+KTX 

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

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