事件与属性的批量编辑
1. 功能简介
历史情况
- 在历史的数据模型中，数据上报后直接生成事件，事件属性 等资产，并且用于报表/看板等资产的搭建
- 无法支持多源数据的接入，并且在数据上报前无法进行分析场景的资产搭建
历史数据模型: 上报数据直接用于分析功能
超层模型
- 增加超层模型后，在来源数据与分析功能的使用中间增加了隔离层，解除了二者强依赖关系
- 可支持多源数据的接入，并通过超层对象设置其连接关系
- 在数据实际产生前，超层对象能够以占位形式存在，便于同时进行报表看板的搭建工作
- 需要进行项目迁移时，分析层的资产内容可基于超层进行迁移，并在迁移后灵活调整可能存在的异常连接关系
超层模型: 通过超层对象连接来源数据后再用于分析
为了在超层模型基础上区分说明 "事件" 与其来源的 "上报事件"或"跨源事件"，本文将 "事件" 强调为 "超层事件"，将"上报事件"和"跨源事件" 统称为 "来源事件"
批量编辑
- 在完成埋点方案的沟通并等待数据接入时, 业务角色成员可在事件、事件属性、用户属性页面 单个创建对应的资产并用于报表看板的搭建工作
- 为了进一步提升相关资产的创建效率, 当前可通过 "批量导入导出" 功能, 将已沟通的埋点方案、具有相似数据规范项目中的整体资产方案 直接导入或在EXCEL中修改后导入当前项目, 以便于更快地推进后续的看板搭建工作
2. 功能入口
进入 事件、事件属性、用户属性 页面后, 点击右上角的 [管理] 按钮可展开更多功能列表
其中包含了资产配置的导入与导出功能入口
功能入口
各个功能的需要的权限明细如下
| 功能入口 | 权限对应功能名称 | 类别 | 权限对应功能明细 |
|---|---|---|---|
| 导出资产配置 | 元数据管理 | 查看 | 查看事件、事件属性、用户属性列表、数据表预览 |
| 导入资产配置 | 元数据管理 | 编辑 | 管理事件/事件属性列表、设置数据连接关系、查看上报/跨源的资产信息 |
权限配置页面
3. 操作流程
3.1 导出资产配置
点击导出后, 浏览器自动弹出下载窗口, 直接保存EXCEL文件即可
3.2 导入资产配置
⚠ 导入资产配置后, 系统将根据资产名称, 创建、变更 项目内对应资产的类型、显示名、备注等信息
⚠ 若某个信息在配置EXCEL中为空, 系统将同步清空项目内的资产信息, 如: 清空备注、显示名 等
⚠ 对于项目中已存在, 但EXCEL中未填写的资产信息, 系统将不做变更, 即: 不会批量删除EXCEL中不存在的资产
提示弹窗
⚠ 建议在上传资产配置前, 确认其中内容的可用性, 避免上传错误配置后导致需频繁删除资产
点击导入后, 弹窗提示关键信息, 点击 [继续] 进入下一步, 选择需要导入的配置文件
配置文件上传
导入后, 系统将先对EXCEL内容进行解析, 并在确认结果后执行资产配置的导入动作
解析结果确认
导入执行结果
4. EXCEL模板说明
资产导入功能支持<埋点管理>中的EXCEL文件上传, 在埋点方案确认后, 可直接导入方案EXCEL生成事件、属性, 并开始搭建报表看板
4.1 子表清单说明
导出并打开资产配置EXCEL文件后, 其中存在 3张子表
EXCEL子表预览
各个子表作用如下
| 子表名称 | 说明 |
|---|---|
| #事件数据 | 记录事件以及其关联事件属性的信息, 其规范与<埋点管理>功能中的埋点方案表类似 |
| #公共事件属性 | 若某个事件属性与所有的事件关联, 则可以在该表中单独填写, 导入后系统将激活其"公共属性"状态 |
| #用户属性 | 记录用户属性的信息 |
4.2 事件数据表
单个事件的信息以及其关联的事件属性可参照下表填写
| 事件名（必填） | 事件显示名 | 事件说明 | 属性名（必填） | 属性显示名 | 属性类型（必填） | 属性说明 |
|---|---|---|---|---|---|---|
| activity_attend | 参与活动 | 活动奖励领取 | activity_type | 活动类型1 | 文本 | 新手活动等 |
| channel | 来源渠道 | 文本 | IOS/安卓 | |||
| level | 升级后等级 | 数值 | ||||
| platform | 系统平台标识 | 文本 | 平台标识：android，IOS，harmonyOS，PC | |||
| serverid | 区服ID | 数值 | ||||
| vip_level | vip等级 | 数值 | ||||
| #device_id | 文本 | |||||
| #lib | 文本 | |||||
| #lib_version | 文本 | |||||
| #os | 文本 |
事件数据表预览
各字段的说明如下:
| 字段名称 | 说明 |
|---|---|
| 事件名（必填） | 小写字母开头, 内容包含 小写字母、数字、下划线, 长度不大于 60字符 |
| 事件显示名 | 长度不大于 60字符 |
| 事件说明 | 长度不大于 200字符 |
| 属性名（必填） | 小写字母开头, 内容包含 小写字母、数字、下划线(对象组子属性存在英文句号), 长度不大于 80字符 |
| 属性显示名 | 长度不大于 80字符 |
| 属性类型（必填） | 数值、文本、时间、布尔、列表、对象、对象组 |
| 属性说明 | 长度不大于 200字符 |
4.3 公共事件属性表
若属性与所有事件关联, 则在此处填写属性信息即可
⚠ 若某个属性在<事件数据表> 与 <公共事件属性表> 中重复填写, 则视为 "公共事件属性"
| 属性名（必填） | 属性显示名 | 属性类型（必填） | 属性说明 |
|---|---|---|---|
| channel | 渠道 | 文本 | |
| level | 等级 | 数值 | |
| gold_left | 剩余金币 | 数值 |
公共事件属性表预览
各字段的说明如下:
| 字段名称 | 说明 |
|---|---|
| 属性名（必填） | 小写字母开头, 内容包含 小写字母、数字、下划线(对象组子属性存在英文句号), 长度不大于 80字符 |
| 属性显示名 | 长度不大于 80字符 |
| 属性类型（必填） | 数值、文本、时间、布尔、列表、对象、对象组 |
| 属性说明 | 长度不大于 200字符 |
4.4 用户属性表
用户属性信息参考下表填写即可
| 属性名（必填） | 属性显示名 | 属性类型（必填） | 属性说明 |
|---|---|---|---|
| ad | 广告id | 文本 | |
| ad_set | 广告组ID | 文本 | |
| campaign | 广告Campaign | 文本 | |
| channel | 来源渠道 | 文本 | app store,华为应用商城,小米应用商城,vivo,taptap,豌豆荚＝first |
| current_level | 当前等级 | 数值 | |
| first_login_time | 首次登录时间 | 时间 | 首次登录时设置 |
用户属性表预览
各字段的说明如下:
| 字段名称 | 说明 |
|---|---|
| 属性名（必填） | 小写字母开头, 内容包含 小写字母、数字、下划线(对象组子属性存在英文句号), 长度不大于 80字符 |
| 属性显示名 | 长度不大于 80字符 |
| 属性类型（必填） | 数值、文本、时间、布尔、列表、对象、对象组 |
| 属性说明 | 长度不大于 200字符 |