事件属性

1.1 什么是事件属性 #

属性用于描述事件发生时的各维度信息，包括用户信息（user_id）、设备信息（app版本、设备号、ip地址、设备型号等）、业务自定义信息（上报到params的自定义参数）等。

1.2 事件属性分类 #

1. 事件属性： 又称为Params，不同事件有不同的事件属性。同一个埋点可以定义多个属性。以“播放视频”事件为例，它包含如下事件属性：enter_from（动作发生的页面），video_id（视频id）等。

2. 事件公共属性： 又称为Header，每一个事件都会上报的通用属性。Finder SDK会将设备信息类的字段预置到Header中，点击查看详情。

1.3 事件属性状态说明 #

启用：可用的属性，数据会正常更新
  禁用：不可用的属性，数据会被丢弃，系统内不可查
  不显示：数据正常更新，但系统内不可查，通常适用于系统后台消费的属性

2.1 新增事件属性 #

您可以在登记埋点（一般事件）时一并登记事件属性，也可以单独登记事件属性。
如果您需要单独登记事件属性或登记事件公共属性，可点击下方入口：

注意事项：

• 事件属性命名时要具体，谨慎使用泛化的参数名称，反例如 time（什么的时间？是时间戳还是时长？）、name（什么的名字？），正例比如下单时间，建议命名为order_time。

• 如果业务含义相同，尽量复用已经定义的字段，避免随意定义后导致系统中字段泛滥。

• 常见的设备、时间等通用参数，SDK 已经自带，无需重复登记。点击查看预置属性列表

操作示意图：
1.如果您登记一般事件属性（params），不要勾选事件公共属性，需要将属性关联到特定事件（有上报这个属性的事件），如果未关联事件，则查询事件时无法使用该事件属性。
2.如果您登记事件公共属性（header），务必勾选事件公共属性，此时不需要关联到特定事件。每一个事件都可以使用事件公共属性。

2.2 上传字典 #

字典信息用于描述事件属性value值对应的业务含义翻译值，例如：事件属性user_is_login，当value=1时表示用户当前已登录，value=0时表示用户当前未登录。
操作示意图：
点击列表中字典列的“上传”按钮，您可以在弹窗中上传当前属性的字典表。

2.3 验收属性 #

事件属性列表仅展示已验收/登记的事件属性，未验收属性可点击“验收属性”查看并完成验收。
您也可以在“数据验收”页面管理事件属性黑名单，将需要的事件属性添加或移出黑名单。

2.4 修改属性数据类型 #

如果您此前登记的数据类型有误或变更了新的类型，可以在列表中修改数据类型字段。
请注意：变更类型分兼容变更和非兼容变更， 大类型向小类型转不丢历史数据(比如 string -> int)，小类型往大类型转会丢历史数据(比如 int -> float)。请谨慎选择数据类型。

2.5 批量编辑展示名、属性描述 #

如果您希望批量补全信息，你可以将展示名、属性描述为空的事件筛选出来，打包导出为csv格式文档，在csv文档中填写完整并上传导入，实现批量修改/登记展示、描述信息。
注意：批量导入功能仅支持修改展示名和属性描述，其他字段不支持批量修改。

3.1 如何删除事件属性？ #

不支持删除已登记/验收的事件属性，如果您不再需要该属性，您可以修改状态将其禁用，被禁用的事件属性将不再构建数据，在分析模块不可查。

3.2 事件属性和用户属性的区别是什么？ #

事件属性记录了描述事件的各种维度信息，例如操作系统、软件版本、软件渠道等，也可以是文章ID文章标题、文章作者等；用户属性是用户自身状态的属性，例如性别、年龄等。

3.3 事件属性验收和新增区别是什么？ #

新增事件属性和验收事件属性的效果是一样的，都是将事件属性信息注册到数据管理-事件属性列表，从而能够在高级分析使用。差别在于验收属性需要先上报数据，系统检测到上报后才能进行验收；而新增事件属性在数据上报前后都可以进行登记，您可以在埋点设计阶段就将事件属性登记好，这样埋点上线后就不需要验收了，可以直接使用。