属性管理

最新更新:2025-03-17

属性是用户行为的详细描述数据,包含事件属性、用户属性、设备属性 3 个类型。通过属性进一步描述事件/用户/设备,可以在用户旅程中作为事件的过滤条件进行选择。

属性类型

属性分为事件属性、用户属性、设备属性 3 类,每一类属性还会分为标准、推荐、自定义。

分类 属性类型 说明
事件属性 标准 预先定义好的,由 SDK 自动采集上报的、后台计算产生的事件属性
推荐 预先定义好的,由开发者调接口上报数据的事件属性
自定义 由开发者根据业务需要自由创建、上报的事件属性
设备属性 标准 预先定义好的,由 SDK 自动采集上报的、后台计算产生的设备信息
用户属性 标准 预先定义好的,由 SDK 自动采集上报、后台计算的用户信息
推荐 预先定义好的,由开发者调接口上报数据的事件属性
自定义 由开发者根据业务需要自由创建、上报的用户属性

属性的数据类型

数据类型 说明
STRING 字符串类型,如“用户姓名”一般设置为 STRING 类型
NUMBER 数值类型,支持整数和小数,如“购买次数”一般设置为 NUMBER 类型
BOOL 布尔类型,支持上报true/false,如“是否 VIP 会员”一般设置为 BOOL 类型
DATETIME 日期时间类型,支持上报ISO8601格式的数据。如“账号注册时间”一般设置为 DATETIME 类型
LIST 集合类型,即字符串元素的数组(例 ["特斯拉","大众","奥迪"]),如“兴趣标签”一般设置为 LIST 类型

自定义属性

除了预先定义的标准、推荐属性外,开发者可以根据业务需要自定义创建「事件属性/用户属性」,自定义属性支持 2 种创建方式:页面创建和 API 创建

页面创建

在页面上预先创建属性,可以在页面上逐一创建属性,也可以通过 Excel 批量导入,需要填写的信息如下:

信息 是否必选 说明
属性名称 必填 上报属性的名称,支持小写字母、数字、下划线,必须以字母开头,如:open_app。设置后不可更改。
属性描述 必填 为您的属性添加一个便于理解的注释说明,最多50个字符。设置后允许修改
数据类型 必填

API 创建

调用 API 自由上报,若该属性不存在则会自动进行创建

  • 若事件属性不存在会自动创建并与该事件自动关联。
  • 若该用户属性不存在则会自动创建

事件上报的 API 接口:Android APIiOS APIWeb APIRest API

用户属性上报的 API 接口:Android APIiOS APIWeb APIRest API

属性状态

自定义事件/用户属性创建后,初始状态为可见,您可以根据业务需要调整他的状态

状态 说明
可见 在属性过滤器中可展示,可接收属性上报
隐藏 在属性过滤器中不可展示,可接收属性上报
禁用 在属性过滤器中不可展示,不可接收属性上报

标准属性

EngageLab 预先定义了「事件属性、用户属性、设备属性」名称和描述,数据由 SDK 自动采集上报或后端计算产生。

标准属性不允许编辑、删除,标准属性列表可以在页面上查看,也可以下载 Excel 文件了解

alt text

推荐属性

EngageLab 预先定义了「事件属性、用户属性」,数据由开发者调用接口上报。

我们建议尽量对推荐属性进行上报,有助于后续的分析。

推荐属性不允许编辑、删除,推荐属性列表可以在页面上查看,也可以下载 Excel 文件了解

在文档中心打开
icon
联系销售