属性用于描述事件发生时的各维度信息，包括用户信息（user_id）、设备信息（app版本、设备号、ip地址、设备型号等）、业务自定义信息（上报到params的自定义参数）等。属性通常包括事件属性和用户属性，本文为您介绍事件属性的分类类型和操作要点。
基本概念
术语 | 概念介绍 |
|---|---|
事件 | 描述您的用户在产品内触发的一系列动作（比如：点击、滑动、访问页面等），事件采集主要通过应用内埋点来实现，因此也称为“埋点数据”。 |
事件属性 | 在事件触发时，可以采集到事件发生的形式、位置等，用来描述事件的信息，称为事件属性。 |
预置事件 & 预置属性 |
不同数据上报端支持的预置事件列表不同，预置事件列表详情请参见预置属性总表。 |
事件属性分类
事件属性通常可分为一般事件属性、事件公共属性两类。
事件属性分类 | 事件属性应用描述 | 数据上报位置 |
|---|---|---|
一般事件属性 |
| 通常在数据上报时，事件属性会上报在Params中。 |
事件公共属性 |
| 通常在数据上报时，事件公共属性会上报在Header中。 |
新增事件属性
您可以在登记埋点（一般事件）时一并登记事件属性，也可以单独登记事件属性。如果您需要单独登记事件属性或登记事件公共属性，可执行以下操作：
- 选择数据管理 > 元数据管理 > 事件属性，进入事件属性页面。
- 单击新增事件属性按钮，弹出新增事件属性侧拉窗口，设置相关信息后，单击确定按钮完成新增事件属性。
- DataFinder AI Lab为您提供智能填充能力，填写完成属性名称后，您可以单击下方的智能填充，填写部分输入信息后，AI Lab将为您自动生成并填充展示名、数据类型、描述字段。
- 如果您登记一般事件属性（params），不要勾选下方的事件公共属性选择框，直接在关联事件下拉框中选择需要将属性关联到特定事件（有上报这个属性的事件），如果未关联事件，则查询事件时无法使用该事件属性。
- 如果您登记事件公共属性（header），务必勾选事件公共属性，此时不需要关联到特定事件。每一个事件都可以使用事件公共属性。
注意
- 事件属性命名时要具体，谨慎使用泛化的参数名称。反例：如 time（什么的时间？是时间戳还是时长？）、name（什么的名字？）；正例：比如下单时间，建议命名为order_time。
- 如果业务含义相同，尽量复用已经定义的字段，避免随意定义后导致系统中字段泛滥。
- DataFinder SDK 已经预置了常见的设备、时间等通用事件属性，无需重复登记。预置事件列表详情请参见预置属性总表。
上传字典
字典信息用于描述事件属性value值对应的业务含义翻译值，例如：事件属性user_is_login，当value=1时表示用户当前已登录，value=0时表示用户当前未登录。
操作示意图：
点击列表中某条信息字典列的“上传”按钮，您可以在弹窗中上传当前属性的字典表。
验收属性
事件属性列表仅展示已验收/登记的事件属性，未验收属性可点击“验收属性”按钮，在“数据验收”页面查看并完成验收。
您也可以在“数据验收”页面管理事件属性黑名单，将需要的事件属性添加或移出黑名单。
修改属性数据类型
如果您此前登记的数据类型有误或变更了新的类型，可以在列表中修改数据类型字段。
注意
变更类型分兼容变更和非兼容变更， 大类型向小类型转不丢历史数据(比如 string -> int)，小类型往大类型转会丢历史数据(比如 int -> float)。请谨慎选择数据类型。
批量编辑展示名、属性描述
如果您希望批量补全信息，您可以通过DataFinder的AI Lab智能诊断并一键优化，也可以将展示名、属性描述为空的事件筛选出来，打包导出为csv格式文档，在csv文档中填写完整并点击修改信息按钮上传导入，实现批量修改/登记展示、描述信息。
- AI Lab智能诊断优化
- 手动导出后优化
说明
批量导入功能仅支持修改展示名和属性描述，其他字段不支持批量修改。
Q1 如何删除事件属性？
不支持删除已登记/验收的事件属性，如果您不再需要该属性，可以修改状态将其禁用，被禁用的事件属性将不再构建数据，在分析模块不可查。
Q2 事件属性和用户属性的区别是什么？
事件属性记录了描述事件的各种维度信息，例如操作系统、软件版本、软件渠道等，也可以是文章ID文章标题、文章作者等；用户属性是用户自身状态的属性，例如性别、年龄等。
Q3 事件属性验收和新增区别是什么？
新增事件属性和验收事件属性的效果是一样的，都是将事件属性信息注册到数据管理-事件属性列表，从而能够在高级分析使用。差别在于验收属性需要先上报数据，系统检测到上报后才能进行验收；而新增事件属性在数据上报前后都可以进行登记，您可以在埋点设计阶段就将事件属性登记好，这样埋点上线后就不需要验收了，可以直接使用。