You need to enable JavaScript to run this app.
导航
iOS端预置事件及属性
最近更新时间:2025.06.17 11:08:32首次发布时间:2025.06.17 10:25:15
我的收藏
有用
有用
无用
无用

背景信息
  • 环境说明:当前DataFinder为您提供多种环境,各个环境支持的预置事件和预置属性列表略有差异,您可根据您当前的环境查看对应环境支持的预置事件和预置属性能力。如果您不确定您当前使用的是哪种环境,可参见SaaS云原生/非云原生&私有化环境
  • 事件/属性类型说明:当前为您介绍的是各个端支持的“预置事件”和“预置事件属性”,除此之外,DataFinder还支持预置事件公共属性、预置用户属性,各类型的属性介绍请参见预置属性总表
  • 上报机制:详情请参见产品逻辑:数据上报&缓存策略

SaaS-云原生环境

应用启动事件(app_lauch)

事件名

事件开关

事件说明

事件属性

属性展示名

属性描述

属性值类型

数据来源

是否自动上报

属性开关控制

app_launch

默认采集,支持云控设置黑名单的方式关闭采集。仅Android端V6.17.1+版本支持;iOS端V6.17.3+版本支持;且云控功能当前仅SaaS-云原生环境及私有化环境支持。

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

$is_first_time

是否首次访问

每个用户的第一次launch事件会添加该属性值为true,其他launch该属性取值为false。

注意

该属性当前默认为“隐藏”状态(早期的历史项目可能还是“启动”状态),您无法直接使用此属性,如果需要使用时,建议使用事件公共属性“$is_first_day”作为事件是否首日触发的属性

string

SDK 内部

session_id

会话ID

会话ID,由SDK随机生成。

string

SDK 内部

session_duration

本次打开应用的会话时长

session 时长,基于设备位于前台的时长求和统计,单位为秒,在app_launch里无该属性或值为0。

int

SDK 内部

$page_title

页面标题

页面标题

string

应用页面信息

$page_key

页面名称

页面名称

string

应用页面信息

$resume_from_background

是否从后台恢复

是否从后台恢复

string

SDK 内部

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

事件名

事件开关

事件说明

事件属性名

属性展示名

属性描述

属性值类型

数据来源

是否自动上报

属性开关控制

$app_launch_passively

被动启动

$resume_from_background

是否从后台恢复

是否从后台恢复

string

SDK 内部处理

应用退出事件(app_terminate)

事件名

事件开关

事件说明

事件属性

属性展示名

属性描述

属性值类型

数据来源

是否自动上报

属性开关控制

app_terminate

默认采集,支持云控设置黑名单的方式关闭采集。仅Android端V6.17.1+版本支持;iOS端V6.17.3+版本支持;且云控功能当前仅SaaS-云原生环境及私有化环境支持。

应用退出

session_id

会话ID

会话ID是由SDK随机生成。

string

SDK 内部

session_duration

本次打开应用的会话时长

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

int

SDK 内部

$page_title

页面标题

页面标题

string

应用页面信息

$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 内部采集

SaaS-非云原生环境

应用启动事件(app_lauch)

事件名

事件开关

事件说明

事件属性名

属性展示名

属性描述

属性值类型

采集端数据来源

是否自动上报

属性开关控制

app_launch

默认采集,支持云控设置黑名单的方式关闭采集。仅Android端V6.17.1+版本支持;iOS端V6.17.3+版本支持;且云控功能当前仅SaaS-云原生环境及私有化环境支持。

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

$is_first_time

是否首次访问

每个用户的第一次launch事件会添加该属性值为true,其他launch该属性取值为false。

注意

该属性当前默认为“隐藏”状态(早期的历史项目可能还是“启动”状态),您无法直接使用此属性,如果需要使用时,建议使用事件公共属性“$is_first_day”作为事件是否首日触发的属性

string

SDK 内部

session_id

会话ID

会话ID,由SDK随机生成。

string

SDK 内部

session_duration

本次打开应用的会话时长

session 时长,基于设备位于前台的时长求和统计,单位为秒,在app_launch里无该属性或值为0。

int

SDK 内部

$page_title

页面标题

页面标题

string

应用页面信息

$page_key

页面名称

页面名称

string

应用页面信息

$resume_from_background

是否从后台恢复

是否从后台恢复

string

SDK 内部

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

事件名

事件开关

事件说明

事件属性名

属性展示名

属性描述

属性值类型

数据来源

是否自动上报

属性开关控制

$app_launch_passively

被动启动

$resume_from_background

是否从后台恢复

是否从后台恢复

string

SDK 内部处理

应用退出事件(app_terminate)

事件名

事件开关

事件说明

事件属性名

属性展示名

属性描述

属性值类型

数据来源

是否自动上报

属性开关控制

app_terminate

默认采集,支持云控设置黑名单的方式关闭采集。仅Android端V6.17.1+版本支持;iOS端V6.17.3+版本支持;且云控功能当前仅SaaS-云原生环境及私有化环境支持。

应用退出

session_id

会话ID

会话ID是由SDK随机生成。

string

SDK 内部

session_duration

本次打开应用的会话时长

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

int

SDK 内部

$page_title

页面标题

页面标题

string

应用页面信息

$page_key

页面名称

页面名称

string

应用页面信息

应用崩溃事件($crash)

事件名

事件开关

事件说明

属性

事件属性

属性展示名

属性描述

属性值类型

数据来源

是否自动上报

属性开关控制

$crash

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

应用崩溃

$os_version

$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

$app_version

软件版本

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

string

SDK 内部采集

$device_model

$device_model

设备机型

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

string

SDK 内部采集

$resolution

$resolution

分辨率

分辨率

string

SDK 内部采集

$app_channel

$app_channel

渠道

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

string

SDK 内部采集

$cpu

$cpu

CPU架构

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

string

SDK 内部采集

$session_duration

$session_duration

使用时长(毫秒)

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

int

SDK 内部采集

$is_backstage

$is_backstage

是否后台

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

string

SDK 内部采集

$crash_thread

$crash_thread

崩溃线程

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

string

SDK 内部采集

$crash_process

$crash_process

崩溃进程

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

string

SDK 内部采集

$rom

$rom

ROM

ROM

string

SDK 内部采集

$detailed_stack

$detailed_stack

详细堆栈

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

string

SDK 内部采集

私有化

应用启动事件(app_lauch)

事件名

事件开关

事件说明

属性

事件属性名

属性展示名

属性描述

属性值类型

数据来源

是否自动上报

属性开关控制

app_launch

默认采集,支持云控设置黑名单的方式关闭采集。仅Android端V6.17.1+版本支持;iOS端V6.17.3+版本支持;且云控功能当前仅SaaS-云原生环境及私有化环境支持。

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

$page_title

$page_title

页面标题

页面标题

string

应用页面信息

$page_key

$page_key

页面名称

页面名称

string

应用页面信息

$resume_from_background

$resume_from_background

是否从后台恢复

是否从后台恢复

string

SDK 内部

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

事件名

事件开关

事件说明

事件属性名

属性展示名

属性描述

属性值类型

数据来源

是否自动上报

属性开关控制

$app_launch_passively

被动启动

$resume_from_background

是否从后台恢复

是否从后台恢复

string

SDK 内部处理

应用退出事件(app_terminate)

事件名

事件开关

事件说明

属性

事件属性名

属性展示名

属性描述

属性值类型

采集端数据来源

是否自动上报

属性开关控制

app_terminate

默认采集,支持云控设置黑名单的方式关闭采集。仅Android端V6.17.1+版本支持;iOS端V6.17.3+版本支持;且云控功能当前仅SaaS-云原生环境及私有化环境支持。

应用退出

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 内部采集

SaaS-非云原生 海外BytePlus环境

应用启动事件(app_lauch)

事件名

事件开关

事件说明

事件属性名

属性展示名

属性描述

属性值类型

数据来源

是否自动上报

属性开关控制

app_launch

默认采集,支持云控设置黑名单的方式关闭采集。仅Android端V6.17.1+版本支持;iOS端V6.17.3+版本支持;且云控功能当前仅SaaS-云原生环境及私有化环境支持。

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

$is_first_time

是否首次访问

每个用户的第一次launch事件会添加该属性值为true,其他launch该属性取值为false。

注意

该属性当前默认为“隐藏”状态(早期的历史项目可能还是“启动”状态),您无法直接使用此属性,如果需要使用时,建议使用事件公共属性“$is_first_day”作为事件是否首日触发的属性

string

SDK 内部

session_id

会话ID

会话ID,由SDK随机生成。

string

SDK 内部

session_duration

本次打开应用的会话时长

session 时长,基于设备位于前台的时长求和统计,单位为秒,在app_launch里无该属性或值为0。

int

SDK 内部

$page_title

页面标题

页面标题

string

应用页面信息

$page_key

页面名称

页面名称

string

应用页面信息

$resume_from_background

是否从后台恢复

是否从后台恢复

string

SDK 内部

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

事件名

事件开关

事件说明

事件属性名

属性展示名

属性描述

属性值类型

数据来源

是否自动上报

属性开关控制

$app_launch_passively

被动启动

$resume_from_background

是否从后台恢复

是否从后台恢复

string

SDK 内部处理

应用退出事件(app_terminate)

事件名

事件开关

事件说明

事件属性名

属性展示名

属性描述

属性值类型

数据来源

是否自动上报

属性开关控制

app_terminate

默认采集,支持云控设置黑名单的方式关闭采集。仅Android端V6.17.1+版本支持;iOS端V6.17.3+版本支持;且云控功能当前仅SaaS-云原生环境及私有化环境支持。

应用退出

session_id

会话ID

会话ID是由SDK随机生成。

string

SDK 内部

session_duration

本次打开应用的会话时长

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

int

SDK 内部

$page_title

页面标题

页面标题

string

应用页面信息

$page_key

页面名称

页面名称

string

应用页面信息

应用崩溃事件($crash)

事件名

事件开关

事件说明

属性

事件属性

属性展示名

属性描述

属性值类型

数据来源

是否自动上报

属性开关控制

$crash

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

应用崩溃

$os_version

$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

$app_version

$app_version

软件版本

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

string

SDK 内部采集

$device_model

$device_model

设备机型

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

string

$resolution

$resolution

分辨率

分辨率

string

$app_channel

$app_channel

渠道

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

string

$cpu

$cpu

CPU架构

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

string

$session_duration

$session_duration

使用时长(毫秒)

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

int

SDK 内部采集

$is_backstage

$is_backstage

是否后台

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

string

SDK 内部采集

$crash_thread

$crash_thread

崩溃线程

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

string

SDK 内部采集

$crash_process

$crash_process

崩溃进程

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

string

SDK 内部采集

$rom

$rom

ROM

ROM

string

$detailed_stack

$detailed_stack

详细堆栈

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

string

SDK 内部采集