1. 概述
元事件是被分析对象在产品内触发的一系列动作，如对于电商行业，需要分析用户的 login、add_to_cart、pay_order 等动作。
元事件的数据上报后，便可在神策分析、神策智能运营等产品中使用，分析用户行为，实现精准运营。
2. 创建元事件
创建元事件时，支持哪些字段，以及字段的必填选填由「字段显示配置」控制
创建元事件需填写以下信息：
| 分类 | 字段 | 说明 |
|---|
| 元事件 | 事件名 | 事件在系统内的唯一标识 - 不能为空，不能超过 100 个字符，必须以英文开头，默认仅支持字母、数字、下划线、不支持其他字符
- 同一事件表内，事件名不能重名
|
| 事件显示名 | 事件在使用过程中的显示名称 - 不能为空，不能超过 100 个字符或汉字
- 同一事件表内，事件显示名不能重名
|
| 应埋点平台 | 表明此事件需要埋点上报的端，可多选 |
| 触发时机 | 描述什么时候触发这个事件的数据上报。便于研发理解，确保上报数据的时机是正确的。 例如：是在点击按钮的时候上报，还是已进入页面后即上报。 |
| 事件截图 | 可以上传事件截图来更好的表示该事件所在的位置，便于其他同学更好的查找、理解埋点。 |
| 备注 | 帮助业务同学更好理解的信息 |
| 事件属性 | 属性名 | 仅可命名为英文，是属性在系统内的唯一标识。 - 「属性名」不能为空，不能超过 100 个字符，以英文开头，默认仅支持大小写字母、数字、下划线、不支持其他字符，不能与预留字段名相同。
- 同一张表内，属性名不能重名（包括虚拟属性）
|
| 属性显示名 | 属性在使用过程中的显示名称。 - 不能为空，不能超过 100 个字符或汉字，同一张表内属性显示名不能重名（包括虚拟属性）
|
| 数据类型 | 必填单选 - 只支持Bool/String/Datetime/List/Number
|
| 单位/格式备注 | 长度限制 16 个字符以内 |
| 属性示例/说明 | 长度限制 200 个字符以内 |
可以通过以下两种方式创建元事件。
2.1. 界面创建元事件
进入事件表中，点击「元事件」tab，进入元事件列表页，点击右上角的「创建元事件」按钮，选择「创建元事件」选项，填写相关信息，即可创建元事件。
2.2. 通过 Excel 批量上传
点击「事件表-元事件」右上角的「创建元事件」按钮，选择「通过 Excel 批量上传」，在此可以下载「事件表批量创建模版」，按照模版格式填写需要创建的事件信息后，可上传文件批量创建元事件和事件属性。
注意：此功能只支持创建元数据，不支持对已存在的元数据进行更新，如需更新元数据，请使用「批量修改」功能。
模版中支持的字段为「字段显示配置」里被「启用」的字段，必填的字段为「字段显示配置」里被设置为「必填」的字段，如需修改，请到系统中修改本项目的「字段显示配置」。
填写模版时，事件名、事件显示名、属性名、属性显示名等信息的命名需要符合系统要求。
事件和属性的命名规则
- 「事件名」不能为空，不能超过 100 个字符，必须以英文开头，默认仅支持字母、数字、下划线、不支持其他字符。
- 「事件显示名」不能为空，不能超过 100 个字符或汉字。
- 「应埋点平台」只支持填写“Android/iOS/JavaScript/小程序/服务端/其它”。
- 「属性名」不能为空，不能超过 100 个字符，必须以英文开头，默认仅支持大小写字母、数字、下划线、不支持其他字符，不能与预留字段名相同。
- 「属性显示名」不能为空，不能超过 100 个字符或汉字。
- 「数据类型」必须为 “Bool/String/Datetime/List/Number”中的一种。
填写完所需元数据后，保存文件，将文件上传到神策系统中，核对信息无误后，点击「确定创建」按钮，即可批量创建元事件和事件属性。
如果使用了之前老的数据采集需求模版.xlsx模板进行了事件设计，那么需要：
- 将「自定义事件表」sheet 里的内容复制粘贴到新的「事件表批量创建模板」里，然后在「事件表-元事件」页面上传
- 将「用户表」sheet里的内容复制粘贴到「普通属性批量创建模版」里，然后在「用户表-普通属性」页面上传
注意：粘贴时需要注意下列的对应。如果有不需要的字段，可在「字段显示配置」里将该字段取消「启用」或取消「必填」。
3. 管理元事件
在元事件列表页中，可以对已创建的元事件进行搜索、筛选、排序，以及查看、编辑、删除、停止接收数据、启用/禁用、批量修改等操作。
3.1. 元事件列表页
支持对元事件进行搜索、筛选、排序。
3.2. 元事件详情页
展示元事件信息：事件名、事件显示名、挂载维度表个数、属性个数、过去 30 天数据、所拥有的事件属性等信息。
3.3. 停止接收数据
点击「停止接收数据」后，元事件的数据会被拦截。
再点击「接收数据」，元事件开始接收数据。
3.4. 编辑元事件
事件名不支持编辑。
应埋点平台：有数据的选项不允许删除
删除普通属性：「上报数据」为有数据的属性不能被删除
3.5. 批量修改元事件
先搜索、筛选需要修改的元事件（也可以不做筛选），然后将这些元事件下载到 Excel 中。在 Excel 里进行修改后，再上传修改后的文件。
支持修改「事件显示名」、「应埋点平台」、「触发时机」、「备注」信息。
3.6. 导出元事件
在事件表的元事件页面，点击「导出」按钮，可以将事件表中的元事件和事件普通属性导出到 Excel 文件中。
可以选择「导出全部元事件」，或者先对元事件进行筛选，再「导出当前筛选元事件」。
如果需要从一个项目将元数据导出，再向另一个项目导入的话，需保证两个项目的「字段显示配置」里的启用项和必填项一致，否则可能会导致批量创建失败。
3.7. 支持启用/禁用元事件
该功能等于原有的显示/隐藏功能。
禁用该事件后，在标签分群、神策分析、智能运营等应用中，各类下拉组件中都不再展示该事件，之前引用该事件创建出的资源也会不可用。
3.8. 支持删除元事件
已经上报数据的元事件不支持被删除。
4. 权限
拥有「查看事件表」权限，则可进入事件表页面查看元事件。
拥有「管理事件表」权限，则可对事件表的元事件进行管理。
