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模板进行了事件设计,那么需要:

  1. 将「自定义事件表」sheet 里的内容复制粘贴到新的「事件表批量创建模板」里,然后在「事件表-元事件」页面上传
  2. 将「用户表」sheet里的内容复制粘贴到「普通属性批量创建模版」里,然后在「用户表-普通属性」页面上传

注意:粘贴时需要注意下列的对应。如果有不需要的字段,可在「字段显示配置」里将该字段取消「启用」或取消「必填」。

3. 管理元事件

在元事件列表页中,可以对已创建的元事件进行搜索、筛选、排序,以及查看、编辑、删除、停止接收数据、启用/禁用、批量修改等操作。

3.1. 元事件列表页

支持对元事件进行搜索、筛选、排序。

3.2. 元事件详情页

展示元事件信息:事件名、事件显示名、挂载维度表个数、属性个数、过去 30 天数据、所拥有的事件属性等信息。

3.3. 停止接收数据

点击「停止接收数据」后,元事件的数据会被拦截。

再点击「接收数据」,元事件开始接收数据。

3.4. 编辑元事件

事件名不支持编辑。

应埋点平台:有数据的选项不允许删除

删除普通属性:「上报数据」为有数据的属性不能被删除

3.5. 批量修改元事件

先搜索、筛选需要修改的元事件(也可以不做筛选),然后将这些元事件下载到 Excel 中。在 Excel 里进行修改后,再上传修改后的文件。

支持修改「事件显示名」、「应埋点平台」、「触发时机」、「备注」信息。

3.6. 导出元事件

在事件表的元事件页面,点击「导出」按钮,可以将事件表中的元事件和事件普通属性导出到 Excel 文件中。

可以选择「导出全部元事件」,或者先对元事件进行筛选,再「导出当前筛选元事件」。

如果需要从一个项目将元数据导出,再向另一个项目导入的话,需保证两个项目的「字段显示配置」里的启用项和必填项一致,否则可能会导致批量创建失败。

3.7. 支持启用/禁用元事件

该功能等于原有的显示/隐藏功能。

禁用该事件后,在标签分群、神策分析、智能运营等应用中,各类下拉组件中都不再展示该事件,之前引用该事件创建出的资源也会不可用。

3.8. 支持删除元事件

已经上报数据的元事件不支持被删除。

4. 权限

拥有「查看事件表」权限,则可进入事件表页面查看元事件。

拥有「管理事件表」权限,则可对事件表的元事件进行管理。