设置用户属性

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

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

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

  • 年龄
  • 性别
  • 兴趣

准备工作

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

设置用户属性

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

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

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

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

Web 模块化 API

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

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

Web 命名空间型 API

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

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