事件

最近更新 2026/10/05

1. 功能简介

历史情况

• 在历史的数据模型中，数据上报后直接生成事件，事件属性 等资产，并且用于报表/看板等资产的搭建
• 无法支持多源数据的接入，并且在数据上报前无法进行分析场景的资产搭建

查看原图

历史数据模型: 上报数据直接用于分析功能

超层模型

• 增加超层模型后，在来源数据与分析功能的使用中间增加了隔离层，解除了二者强依赖关系
• 可支持多源数据的接入，并通过超层对象设置其连接关系
• 在数据实际产生前，超层对象能够以占位形式存在，便于同时进行报表看板的搭建工作
• 需要进行项目迁移时，分析层的资产内容可基于超层进行迁移，并在迁移后灵活调整可能存在的异常连接关系

查看原图

超层模型: 通过超层对象连接来源数据后再用于分析

注意

为了在超层模型基础上区分说明 "事件" 与其来源的 "上报事件"或"跨源事件"，本文将 "事件" 强调为 "超层事件"，将"上报事件"和"跨源事件" 统称为 "来源事件"

分析使用

• 列表选择: 历史系统中的事件列表均为 "上报事件" ，升级为超层模型后，事件列表中均为 "超层事件"，扩展了可支持的数据源，同时使用体验与之前保持一致
• 模型查询: 完成报表的创建后，AE系统将会根据超层事件的来源，自动识别并读取 上报数据 或 跨源数据 进行计算，与之前的使用体验保持一致
• SQL查询: 由于SQL查询的高度自定义场景，用户需要在查询时需要结合来源填写真实的 from xxx 语句，并根据原始表中的数据编写查询SQL语句

业务场景举例

• 客户A 直接上报数据，生成了超层事件 "用户注册"
• 客户A 创建了跨源配置，生成了超层事件 "后端订单完成"
• 在报表中查询 "用户注册" 的 "总次数" 时，系统会读取 AE内的事件表，计算并获得结果
• 在报表中查询 "后端订单完成" 的 "总次数" 时，系统则会读取 外部的数据表，计算并获得结果

2. 使用说明

自动监听逻辑

• 当有新的事件上报时，AE系统会自动监听并创建+连接同名的超层事件

• 当用户创建了 "跨源配置(事件表)" 时，AE系统同样会读取配置中的事件，然后自动创建超层事件并关联

• 在自动创建并关联时的逻辑

  • 若没有同名的超层事件，则系统自动创建并关联超层事件
  • 若已有同名的超层事件，但该超层事件没有选择 "事件来源"，则系统更新这个超层事件的来源
  • 若已有同名的超层事件，并且已经设置了 "事件来源"，则需用户手动确认事件名称与来源关系

列表页

• 新增逻辑

  • 自动新增: AE系统会监听 上报事件/跨源事件 的新增，并为其创建超层事件，建立连接关系
  • 手动创建: 在数据未上报前，使用者也可手动创建需要的超层事件，以便于报表看板的先行搭建

列表管理页 说明

1. 查看 / 管理来源事件（进入「来源事件管理」页面）。
2. 批量管理超层事件的显示名。
3. 创建新的超层事件或虚拟事件。
4. 筛选超层事件的显示状态。
5. 可搜索事件名、显示名、备注。
6. 超层事件的事件名、显示名、备注。
7. 超层事件来源的数据类型：未连接、上报事件、跨源事件、虚拟事件。
8. 是否可用于实时运营。

• 字段说明表如下

字段名	说明
事件名	以字母开头，可含字母、数字、下划线，最多60个字符
事件显示名	支持中英文，最多 60个字符
备注	支持中英文，最多 60个字符
事件数据类型	事件连接的数据来源类型 未连接 = 尚未与来源数据连接 上报事件 = 与上报数据中的事件连接 跨源事件 = 与跨源数据中的事件连接 虚拟事件 = 基于超层事件创建的虚拟事件
昨日事件量	仅当数据类型为"上报事件"时有效， 展示昨日上报的事件数据量
实时可用状态	是否可用于触发式运营的触发规则及实时预警 可用：该事件可用于触发式运营的触发规则及实时预警 不可用：当事件为虚拟事件或连接跨源数据时，无法被用于实时相关的任务
连接状态	当前事件是否已和来源数据连接
数据状态	数据连接的可用状态是否正常
操作	编辑 = 编辑元事件的基本信息 创建副本 = 基于当前元事件的信息创建副本事件 隐藏/显示 = 将事件的显示状态设置为不可见/可见 删除 = 删除当前元事件

新建事件

新建超层事件 说明

1. 「事件名」需以字母开头，内容仅支持字母、数字、下划线，最多 60 个字符。
2. 「事件显示名」最多 60 个字符。
3. 「事件来源」：选择事件的来源，可从跨源事件列表或上报事件列表中选择；点击「清空事件来源」会清空当前的来源信息，会影响已使用该事件的报表和看板。
4. 「备注」最多 60 个字符。
5. 可搜索已关联的超层事件属性名及显示名。
6. 当前项目的超层事件属性列表，点击选择需要关联的属性，选择后系统自动读取显示名、数据类型、备注。
7. 删除已经关联的超层事件属性。
8. 取消或保存当前的配置信息。

另外，「+ 事件属性关联」可添加 1 条事件属性作为关联；「从来源中同步属性关联」：选择来源事件后，系统自动读取来源事件中已经连接的事件属性，并覆盖当前配置。

项目初期需要创建的资产数量较多时, 可使用 事件与属性的批量编辑 功能

3. 主要功能权限说明

涉及的权限如下：

权限 ID	功能	操作权限	功能明细
19	元数据管理	查看	查看事件、事件属性、用户属性列表、数据表预览
20	元数据管理	编辑	编辑原始事件、事件属性、用户属性的显示名
21	元数据管理	编辑	编辑虚拟事件、维度表、虚拟属性
5000	元数据管理	编辑	管理事件/事件属性列表、设置数据连接关系、查看上报/跨源的资产信息

图中各入口对应的权限：

1. 进入页面：权限 ID 19。
2. 管理来源事件（「来源事件管理」入口）：权限 ID 5000。
3. 编辑显示名（批量管理显示名）：权限 ID 20。
4. 创建超层事件：权限 ID 5000。
5. 创建虚拟事件：权限 ID 21。
6. 行内编辑显示名、备注：权限 ID 20。
7. 行上的编辑、连接设置、删除（编辑超层事件）：权限 ID 5000。

虚拟事件行上的编辑为权限 ID 21。

4. 参数限制

• 单个项目内可创建 500个超层事件

5. 常见问题

• 上报数据中存在 "战斗胜利" 和 "战斗失败" 两个事件，能否用超层事件将其合并为 "战斗结束" ?

  • 由于涉及查询时的分区问题，超层事件仅支持选择1个来源事件，无法将两个事件合并为1个
  • 对于该需求场景，可以直接使用AE系统中的 "虚拟事件" 功能实现

• 能否批量创建事件、事件属性并设置关联关系？

  • 可以。通过 "批量导入导出" 功能导入 EXCEL，即可批量创建事件、事件属性并设置关联关系，详见 事件与属性的批量编辑