You need to enable JavaScript to run this app.
导航
iOS端预置事件及属性
最近更新时间:2025.09.04 11:49:17首次发布时间: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 内部

说明

在DataFinder上最终查询到的app_launch事件是应用启动时,app_launch事件发生在前台时的app_launch事件,即DataFinder有个内置属性is_background用于标注事件是否发生在后台,最终您在分析查询时的app_launch数据为过滤掉is_background=true的数据。
因此,如果您对比使用DataFinder分析工具查询到的app_launch数据,和直接导出DataFinder数据库中的app_launch数据,可能会存在部分差异,原因可能就是DataFinder侧将is_background=true的数据过滤掉导致的。

应用被动启动事件($app_launch_passively)

事件名

事件开关

事件说明

事件属性名

属性展示名

属性描述

属性值类型

数据来源

是否自动上报

属性开关控制

$app_launch_passively

被动启动

$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 采集开关影响,鸿蒙高级版支持

应用崩溃

$os_version

系统版本

系统崩溃时,上报的系统版本。Android:没有
iOS:
NSOperatingSystemVersion version = [NSProcessInfo processInfo].operatingSystemVersion;
systemVersion = [NSString stringWithFormat:@"%zd.%zd",version.majorVersion,version.minorVersion];
if (version.patchVersion > 0) {
systemVersion = [systemVersion stringByAppendingFormat:@".%zd",version.patchVersion];
}

string

SDK 内部采集

$app_version

软件版本

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

string

SDK 内部采集

$device_model

设备机型

设备型号,Android:使用系统 API:Build.MODEL
iOS:systemInfo.machine
鸿蒙:deviceInfo.productModel

string

SDK 内部采集

$resolution

分辨率

分辨率

string

SDK 内部采集

$app_channel

渠道

渠道属性,上报结果为集成SDK时手动设置的app_channel取值。

string

SDK 内部采集

$cpu

CPU架构

系统崩溃时上报的CPU架构信息,便于分析硬件对系统崩溃的影响。

string

SDK 内部采集

$session_duration

使用时长(毫秒)

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

int

SDK 内部采集

$is_backstage

是否后台

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

string

SDK 内部采集

$crash_thread

崩溃线程

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

string

SDK 内部采集

$crash_process

崩溃进程

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

string

SDK 内部采集

$rom

ROM

ROM

string

SDK 内部采集

$detailed_stack

详细堆栈

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

string

SDK 内部采集