设置用户属性

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

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

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

  • 年龄
  • 性别
  • 兴趣

准备工作

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

设置用户属性

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

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

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

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

Web 模块化 API

import { getAnalytics, setUserProperties } from "firebase/analytics";

const analytics = getAnalytics();
setUserProperties(analytics, { favorite_food: 'apples' });
analytics_set_user_properties.js

Web 命名空间型 API

firebase.analytics().setUserProperties({favorite_food: 'apples'});
index.js

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