跨源事件表
本文档仅对 "跨源事件表" 配置中的 特有字段、资产清单中的特有逻辑 进行说明
跨源资产配置功能的通用说明请参考: 跨源资产配置功能说明
1. 基本信息
在AE规范的事件表数据结构中, 包含一些关键的数据列, 这些关键数据列将影响后续分析模型的功能使用
如: $part_event、#event_time、$part_date 等
而其他的列则是自定义的事件属性, 如下表样例中的 channel、role_level、amount
| #user_id | $part_event | #event_time | #zone_offset | $part_date | channel | role_level | amount |
|---|---|---|---|---|---|---|---|
| 张三 | login | 2025-10-29 10:25:59 | 8 | 2025-10-29 | 抖音 | ||
| 李四 | level_up | 2025-10-09 04:00:48 | 8 | 2025-10-09 | 47 | ||
| 王五 | payment | 2025-10-20 10:29:16 | 0 | 2025-10-20 | 70 | 166 | |
| 马六 | battle_win | 2025-10-08 15:56:31 | -4 | 2025-10-08 | 83 |
AE事件表样例
在将外部数据源设置为跨源事件表时, 需转换为AE规范的格式, 并在 跨源配置字段 中进行设置
其他作为事件属性的列则可根据业务需求, 在 资产列表 中进行设置
⚠ 已在 跨源配置字段 设置的列不需要在 资产列表 中重复作为资产设置
| uid | action | ts | timezone | pt | channel | role_level | amount |
|---|---|---|---|---|---|---|---|
| 张三 | login | 2025-10-26 04:21:54 | 8 | 2025-10-26 | 抖音 | ||
| 李四 | level_up | 2025-10-09 15:22:26 | 8 | 2025-10-09 | 77 | ||
| 王五 | payment | 2025-10-15 06:28:51 | 0 | 2025-10-15 | 54 | 166 | |
| 马六 | battle_win | 2025-10-21 19:23:40 | -4 | 2025-10-21 | 71 |
外部数据源样例
2. 跨源配置字段说明
2.1 主体信息
设置数据源中等同于 AE事件表内 #user_id 的数据列, 在样例数据中为: uid
对于 广告归因事件、聚合数据事件 等与用户行为无关的数据, 此处留空即可
⚠ 若项目数据涉及 "上报事件与跨源事件混用"、"跨源用户属性与跨源事件下钻" 等复杂场景, 请在接入前期与 ThinkingAI 方成员确认数据状态以及处理方案
主体列_预览
2.2 事件名称信息
设置数据源中等同于 AE事件表内 $part_event 信息的读取方式
🔵 读取列值
直接选择数据源中记录事件名称的数据列
在样例数据中为:
action⚠建议在数据源中将该列作为分区键, 以便于提升查询性能
事件名称_读取列值预览
🔵 固定值
若数据源中仅有1个事件的数据, 且没有记录事件名称的列, 则此处选择 固定值
同时在 "事件名称" 字段中填写对应的名称, 如: user_login
事件名称_固定值预览
2.3 事件时间信息
设置数据源中等同于 AE事件表内 #event_time 信息的读取方式
🔵 读取列值
直接选择数据源中记录事件时间的数据列, 数据类型需为 时间
在样例数据中为:
ts
事件时间_读取列值预览
🔵 自定义SQL
若数据源中以 文本、数值时间戳 等形式记录了事件时间信息, 则需要通过SQL函数将其转换为时间类型
如: try_cast( "ts" as timestamp )
其余复杂场景可参考: 跨源配置复杂场景及SQL样例
事件时间_自定义SQL预览
2.4 事件时区信息
设置数据源中等同于 AE事件表内 #zone_offset 信息的读取方式
🔵 读取列值
直接选择数据源中记录事件时区的数据列, 数据类型需为 数值
在样例数据中为:
timezone
事件时区_读取列值预览
🔵 固定值
若数据源内的数据均来自同一个时区, 如服务器按照东八区采集的日志, 此时设置为对应的时区即可
事件时区_固定值预览
🔵 自定义SQL
若数据源内用其他形式记录了时区信息, 则需要通过SQL函数将其转换为数值类型
如: try_cast( substr( 'UTC+8' , 4 , 9 ) as double ) /* 使用时将 'UTC+8' 替换为列名 */
其余复杂场景可参考: 跨源配置复杂场景及SQL样例
事件时区_自定义SQL预览
2.5 数据分区方式
设置数据源中等同于 AE事件表内 $part_date 信息的读取方式
🔵 日期信息列
直接选择数据源中记录日期分区的数据列, 数据类型需为 文本
在样例数据中为:
pt⚠建议在数据源中将该列作为分区键, 以便于提升查询性能
🔵 自定义下推逻辑
若数据源的采用其他形式进行分区, 则需要使用自定义下推逻辑, 将查询时前端的日期范围作为变量, 并编写对应的下推逻辑SQL
详细说明可参考: 跨源配置复杂场景及SQL样例
3. 跨源资产清单配置说明
在跨源事件表配置中, 对于资产的配置存在 事件属性、事件、事件与属性匹配关系 三类, 需分别配置
跨源事件表中多种类型的资产预览
3.1 事件属性
3.1.1 资产数据类型
跨源事件属性的资产支持以下类型:
文本、数值、布尔、时间、列表、对象、对象组
关于取值方式的复杂场景可参考: 跨源配置复杂场景及SQL样例
跨源事件属性数据类型预览
3.1.2 公共属性
在配置跨源事件属性时, 可在扩展信息中将某个属性设置为 "公共属性"
设置后, 该属性将与当前配置的所有事件建立匹配关系 (不影响其他跨源配置)
跨源事件属性的公共属性预览
3.2 事件
⚠ 在事件资产中使用 "扫描资产" 前, 需完成配置字段中的 "事件名称信息" 配置
扫描后, 资产列表中的第一列将会展示扫描到的事件名称, 此时可修改输出事件的显示名和备注
- 若输出的事件与原始值一致, 则在 "原始事件列表" 中留空即可 (如下图 payment )
- 若需要将多个事件合并为一个事件, 则需要用英文括号与单引号填写需合并的事件列表 (如下图 battle_end )
- 若需修改单个事件的输出名称, 则在原始事件列表中填写只包含 1 个事件的列表即可 (如下图 activity_attend )
事件资产配置预览
3.3 事件与属性匹配关系
在分析模型中, 选择某个 事件A 后, 可进一步对该事件内的 属性B 进行筛选或计算, 同时不会出现与之无关的 属性C
这一逻辑称为 "事件与属性的匹配关系", 该逻辑可便于业务人员识别事件数据之间的关联, 提升操作效率
AE系统中事件与属性关系预览
在AE系统中, 通过上报方式入库的数据, 可在ETL环节解析每个事件与属性的关系
但在跨源映射的数据中, 系统无法自动识别外部数据源的关系, 因此需在配置中进行指定
事件与属性关系配置预览
在配置时, 可先 "下载全映射关系表" , 系统将读取已配置的 "事件属性" 和 "事件名" 并生成全映射关系数据。另外, 点击 "一键设置全映射关系" 可直接将事件属性与事件设置为全映射关系
然后在数据中删除不需要的数据, 导出 UTF-8格式的CSV文件 (如何导出UTF-8格式的CSV文件?)
| 输出事件名 | 输出属性名 |
|---|---|
| event_a | prop_a |
| event_a | prop_b |
| event_a | prop_c |
| event_b | prop_a |
| event_b | prop_b |
处理后的匹配关系预览
完成后, 点击 "上传匹配关系", 上传对应文件, 并按流程操作
解析完成后, 系统弹窗提示上传和解析结果
⚠ 若在配置中未设置匹配关系, 可能影响事件后续在分析模型中的使用, 此时页面会弹窗提示
匹配关系异常弹窗预览