事件属性

最近更新 2026/10/02

1. 功能简介

历史情况

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

查看原图

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

超层模型

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

查看原图

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

注意

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

分析使用

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

业务场景举例

• 客户A 直接上报数据，生成了超层事件 "用户注册" ，其中包含事件属性 "渠道"

• 客户A 创建了跨源配置，生成了超层事件 "后端订单完成"，其中也包含事件属性 "渠道"

• 此时查看超层事件属性列表，只会看到1个名称为 "渠道" 的事件属性

• 此时超层事件属性 "渠道" 关联了 2个数据来源，分别是

  • 上报数据中的"用户注册" 事件
  • 跨源数据的 "后端订单完成" 事件

• 在报表中查询 "用户注册" 中 "渠道" 的 "去重数" 时，系统会读取 AE内的事件表内的属性，计算并获得结果

• 在报表中查询 "后端订单完成" 中 "渠道" 的 "去重数" 时，系统则会读取 外部的数据表内的属性，计算并获得结果

2. 使用说明

自动监听逻辑

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

• 当用户创建了 "跨源配置(事件表)" 时，AE系统同样会读取配置中的事件属性，然后自动增加属性的连接配置

• 在自动创建/连接时的逻辑

  • 若没有同名的超层事件属性，则系统自动创建并关联超层事件属性
  • 若已有同名+同类型的超层事件属性，则系统会给超层事件属性增加1条关联信息
  • 若已有同名但不同类型的超层事件属性，则需用户手动确认事件属性与连接关系

列表页

列表管理页 说明

1. 筛选事件属性的显示状态。
2. 事件属性的名称、显示名、备注。
3. 查看 / 管理来源事件属性（进入「来源事件属性管理」页面）。
4. 批量设置事件属性的显示名。
5. 创建新的超层事件属性或虚拟事件属性。
6. 可搜索事件属性名、显示名、备注。
7. 编辑当前的超层事件属性，或设置当前超层事件属性的连接关系。
8. 「更多」菜单：「隐藏」切换显示状态，「创建副本」创建属性的副本，「添加维度表」为属性添加维度表，「删除」删除当前的超层事件属性；对象 / 对象组类型的属性还有「创建子属性」。

• 字段说明表如下

字段名	说明
事件属性名	以字母开头，可含字母、数字、下划线，最多 80个字符
事件属性显示名	支持中英文，最多 80个字符
备注	支持中英文，最多 60个字符
属性类型	事件属性为用于分析模型的基本属性， 可结合其他功能生成虚拟属性、维度属性、汇率属性
数据类型	如: 文本/数值/布尔 等
实时可用状态	是否可用于触发式运营的触发规则及实时预警
连接状态	当前事件是否已和来源数据连接
数据状态	数据连接的可用状态是否正常
操作	编辑 = 编辑事件属性的基本信息 创建副本 = 基于当前的事件属性创建副本 隐藏/显示 = 将事件属性的显示状态设置为不可见/可见 添加维度表 = 为当前属性添加维度表 (不支持对象/对象组类型) 下载/更新/删除维度表 = 对已添加维度表的属性增加对应的操作 创建子属性 = 为对象/对象组类型的属性创建子属性 删除 = 删除当前事件属性

新建事件属性

超层事件属性 新建说明

• 事件关联说明: 若当前的属性A与事件1建立关联，没有与事件2建立关联，则在分析模型中使用时:

  • 选择事件1后，可以在其属性列表中找到属性A
  • 选择事件2后，无法在其属性列表中找到属性A

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

设置事件属性的连接

超层事件属性 来源连接设置

• 属性来源连接说明:

  • 1个超层属性仅能与1个上报属性建立连接关系

  • 1个超层属性在1个跨源数据源内，仅能与1个跨源属性建立连接关联

  • 若属性A与事件1、事件2建立了关联关系，但没有设置来源属性的连接，则:

    • 分析模型在查询时将无法获取计算结果

  • 若属性A与事件1、事件2建立了关联关系，同时与其数据来源中的属性设置了来源连接，则:

    • 查询事件1时，系统会从事件1的来源数据中读取属性A的连接属性并计算
    • 查询事件2时，系统会从事件2的来源数据中读取属性A的连接属性并计算

  • 若存在对象组类型的属性P，其中包含子属性P1，则:

    • 子属性P1的连接属性必须同样为子属性，且其父属性已经和属性P建立了连接关系

3. 主要功能权限说明

涉及的权限如下：

权限 ID	功能	操作权限	功能明细
19	元数据管理	查看	查看事件、事件属性、用户属性列表、数据表预览
20	元数据管理	编辑	编辑原始事件、事件属性、用户属性的显示名
21	元数据管理	编辑	编辑虚拟事件、维度表、虚拟属性
59	元数据管理	查看	导出属性的维度表、下载数据表内容、下载数据表历史内容
89	元数据管理	编辑	新增、编辑文件上传类型数据表、还原文件上传类型数据表的历史版本
5000	元数据管理	编辑	管理事件/事件属性列表、设置数据连接关系、查看上报/跨源的资产信息

图中各入口对应的权限：

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

「更多」菜单和其他行上的操作对应的权限 ID：隐藏事件属性 20，创建事件属性副本 5000，添加维度表属性 89，创建子属性 5000，删除事件属性 5000，更新维度表 89，下载维度表 59，删除维度表 21；虚拟事件属性行上的编辑为 21。

4. 参数限制

• 单个项目内可创建 1,000个超层事件属性

5. 常见问题

• 为什么无法编辑或删除#user_id事件属性?

  • 为了保证分析模型的可用性，个别属性不提供页面上的编辑功能，相关属性及说明如下:
  • #user_id AE系统的用户唯一识别ID，分析模型中用于默认的用户去重数计算
  • #event_name 事件名称，分析模型中用于事件的识别
  • #event_time 事件时间，分析模型中用于事件时间的解析和时区偏移计算
  • #zone_offset 时区偏移，分析模型中用于事件的时区偏移计算
  • #te_event_id 事件唯一识别ID，智能运营实时计算中用于事件的唯一性识别