You need to enable JavaScript to run this app.
导航
鸿蒙端预置事件及属性
最近更新时间:2025.07.14 15:32:16首次发布时间:2025.07.14 15:32:16
我的收藏
有用
有用
无用
无用

背景信息
  • 事件/属性类型说明:当前为您介绍的是各个端支持的“预置事件”和“预置事件属性”,除此之外,DataFinder还支持预置事件公共属性、预置用户属性,各类型的属性介绍请参见预置属性总表
  • 上报机制:详情请参见数据上报&缓存策略

私有化

应用启动事件(app_lauch)

事件名

事件开关

事件说明

属性

事件属性名

属性展示名

属性描述

属性值类型

数据来源

是否自动上报

属性开关控制

app_launch

默认采集,支持云控设置黑名单的方式关闭采集。仅Android端V6.17.1+版本支持;iOS端V6.17.3+版本支持。

App应用启动事件,当用户启动App(进入前台)的时候,产生一个 launch 事件;当切换用户时,会结束上一次会话并重新产生一个新的 launch 事件。

$page_title

$page_title

页面标题

页面标题,鸿蒙端采集不到此属性值。

string

应用页面信息

$page_key

$page_key

页面名称

页面名称

string

应用页面信息

$resume_from_background

$resume_from_background

是否从后台恢复

是否从后台恢复

string

SDK 内部

应用退出事件(app_terminate)

事件名

事件开关

事件说明

属性

事件属性名

属性展示名

属性描述

属性值类型

采集端数据来源

是否自动上报

属性开关控制

app_terminate

默认采集,支持云控设置黑名单的方式关闭采集。仅Android端V6.17.1+版本支持;iOS端V6.17.3+版本支持。

应用退出

session_duration

session_duration

本次打开应用的会话时长

session 时长,基于设备位于前台的时长求和统计,单位为秒。

int

SDK 内部

$page_title

$page_title

页面标题

页面标题,鸿蒙端采集不到此属性值。

string

应用页面信息

$page_key

$page_key

页面名称

页面名称

string

应用页面信息

应用崩溃事件($crash)

事件名

事件开关

事件说明

事件属性名

属性展示名

属性描述

属性值类型

数据来源

是否自动上报

属性开关控制

$crash

受 crash 采集开关影响,鸿蒙高级版支持

应用崩溃

$app_version

软件版本

软件版本值的格式固定为x.x.x,如果上报的软件版本值格式不符合要求,DataFinder会自动转化为x.x.x格式,因此如果出现取值与上报不一致情况,请修改上报数据的格式。

string

SDK 内部采集

$session_duration

使用时长(毫秒)

客户端 $session_duration 仅 crash 事件有,为本次 Session 持续时间,Session 的意思是单次会话,每次 launch 后会有一个 Session 对应

int

SDK 内部采集
1.3.2版本新增

$is_backstage

是否后台

系统崩溃时,是否是在后台运行时崩溃的。

string

SDK 内部采集

$crash_process

崩溃进程

系统崩溃时正在执行的进程信息。

string

SDK 内部采集

$detailed_stack

详细堆栈

系统崩溃时的详细堆栈信息。此属性不支持在分析模块、看板、分群等模块使用,可在用户细查中使用,用于查看详细的崩溃堆栈,辅助定位分析。当堆栈信息字段超过2048会进行截断。

string

SDK 内部采集

全埋点事件(bav2b_)

事件名

事件开关

事件说明

属性

事件属性名

属性展示名

属性描述

属性值类型

采集端数据来源

是否自动上报

属性开关控制

bav2b_page

受全埋点开关影响,全埋点开关默认关闭,全埋点开关开启后即会自动采集此事件

页面访问

page_key

page_key

页面标识

页面唯一标识

string

应用页面信息

refer_page_key

referrer_page_key

string

应用页面信息

is_back

is_back

是否回退

int

SDK 内部统计

page_title

page_title

页面的标题

string

应用页面信息

page_path

page_path

页面的路径

string

应用页面信息

referrer_page_path

referrer_page_path

前向地址

string

应用页面信息

$is_rn

$is_rn

判定是否 RN 页面

int

SDK 内部统计

$rn_root_tag

$rn_root_tag

RN页面唯一编号

int

SDK 内部统计

$bav2b_page_leave

受全埋点开关影响,全埋点开关默认关闭,全埋点开关开启后,还需单独开启leave相关事件的开关:

页面离开

$is_rn

$is_rn

判定是否 RN 页面

int

SDK 内部统计

$rn_root_tag

$rn_root_tag

RN页面唯一编号

int

SDK 内部统计

bav2b_click

受全埋点开关影响,全埋点开关默认关闭,全埋点开关开启后即会自动采集此事件

元素点击

page_key

page_key

页面标识

页面唯一标识

string

应用页面信息

element_path

element_path

控件标识

唯一标识控件,xPath的字符串

string

组件元素信息

positions

positions

元素位置

元素在每层列表中的位置,可能为2-2 0-1

string数组

组件元素信息

texts

texts

元素文案

元素文案,是个数组,数组中每个文案长度上限200字符

string数组

组件元素信息

element_width

element_width

元素宽度

元素宽度,单位同header.resolution

string

组件元素信息

element_height

element_height

元素高度

元素高度,单位同header.resolution

string

组件元素信息

touch_x

touch_x

元素左边界距离

点击位置相对元素左边界的距离,单位同header.resolution

int

组件元素信息

touch_y

touch_y

元素右边界距离

点击位置相对元素上边界的距离,单位同header.resolution

int

组件元素信息

page_title

page_title

页面标题

页面的标题

string

应用页面信息

element_id

element_id

元素ID

元素ID,Android 端默认会获取;iOS 端每个控件一般不会设置 ID,因此 iOS 端默认会不获取。可手动设置

string

组件元素信息

element_type

element_type

元素类型

元素类型,控件的类型,例如 Button

string

组件元素信息

$is_rn

$is_rn

判定是否 RN 页面

int

SDK 内部统计

$is_flutter

$is_flutter

是否使用flutter全埋点

int

SDK 内部统计

$rn_root_tag

$rn_root_tag

RN页面唯一编号

int

SDK 内部统计