文档反馈
问问助手- 环境说明：当前DataFinder为您提供多种环境，各个环境支持的预置事件和预置属性列表略有差异，您可根据您当前的环境查看对应环境支持的预置事件和预置属性能力。如果您不确定您当前使用的是哪种环境，可参见SaaS云原生/非云原生&私有化环境。
- 事件/属性类型说明：当前为您介绍的是各个端支持的“预置事件”和“预置事件属性”，除此之外，DataFinder还支持预置事件公共属性、预置用户属性，各类型的属性介绍请参见预置属性总表。
- 上报机制：详情请参见产品逻辑：数据上报&缓存策略。
应用启动事件（app_launch）
事件名 | 事件开关 | 事件说明 | 事件属性 | 属性展示名 | 属性描述 | 属性值类型 | 数据来源 | 是否自动上报 | 属性开关控制 |
|---|---|---|---|---|---|---|---|---|---|
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_terminate）
事件名 | 事件开关 | 事件说明 | 事件属性 | 属性展示名 | 属性描述 | 属性值类型-SaaS云原生 | 数据来源 | 是否自动上报 | 属性开关控制 |
|---|---|---|---|---|---|---|---|---|---|
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）
事件名 | 事件开关 | 事件说明 | 事件属性名 | 属性展示名 | 属性描述 | 属性值类型-SaaS云原生 | 数据来源 | 是否自动上报 | 属性开关控制 |
|---|---|---|---|---|---|---|---|---|---|
$crash | 受 crash 采集开关影响，鸿蒙高级版支持 | 应用崩溃 | $app_version | 软件版本 | 软件版本值的格式固定为x.x.x，如果上报的软件版本值格式不符合要求，DataFinder会自动转化为x.x.x格式，因此如果出现取值与上报不一致情况，请修改上报数据的格式。 | 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 内部采集 | 是 | 无 | |||
$detailed_stack | 详细堆栈 | 系统崩溃时的详细堆栈信息。此属性不支持在分析模块、看板、分群等模块使用，可在用户细查中使用，用于查看详细的崩溃堆栈，辅助定位分析。当堆栈信息字段超过2048会进行截断。 | string | SDK 内部采集 | 是 | 无 |
应用启动事件（app_launch）
事件名 | 事件开关 | 事件说明 | 事件属性名 | 属性展示名 | 属性描述 | 属性值类型-SaaS非云原生 | 采集端数据来源 | 是否自动上报 | 属性开关控制 |
|---|---|---|---|---|---|---|---|---|---|
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_terminate）
事件名 | 事件开关 | 事件说明 | 事件属性名 | 属性展示名 | 属性描述 | 属性值类型-SaaS非云原生 | 数据来源 | 是否自动上报 | 属性开关控制 |
|---|---|---|---|---|---|---|---|---|---|
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）
事件名 | 事件开关 | 事件说明 | 事件属性名 | 属性展示名 | 属性描述 | 属性值类型-SaaS云原生 | 数据来源 | 是否自动上报 | 属性开关控制 |
|---|---|---|---|---|---|---|---|---|---|
$crash | 受 crash 采集开关影响，鸿蒙高级版支持 | 应用崩溃 | $app_version | 软件版本 | 软件版本值的格式固定为x.x.x，如果上报的软件版本值格式不符合要求，DataFinder会自动转化为x.x.x格式，因此如果出现取值与上报不一致情况，请修改上报数据的格式。 | 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 内部采集 | 是 | 无 | |||
$detailed_stack | 详细堆栈 | 系统崩溃时的详细堆栈信息。此属性不支持在分析模块、看板、分群等模块使用，可在用户细查中使用，用于查看详细的崩溃堆栈，辅助定位分析。当堆栈信息字段超过2048会进行截断。 | string | SDK 内部采集 | 是 | 无 |
应用启动事件（app_launch）
事件名 | 事件开关 | 事件说明 | 属性 | 事件属性名 | 属性展示名 | 属性描述 | 属性值类型-私有化 | 数据来源 | 是否自动上报 | 属性开关控制 |
|---|---|---|---|---|---|---|---|---|---|---|
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 内部 | 是 | 无 |
说明
在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_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）
事件名 | 事件开关 | 事件说明 | 事件属性名 | 属性展示名 | 属性描述 | 属性值类型-SaaS云原生 | 数据来源 | 是否自动上报 | 属性开关控制 |
|---|---|---|---|---|---|---|---|---|---|
$crash | 受 crash 采集开关影响，鸿蒙高级版支持 | 应用崩溃 | $app_version | 软件版本 | 软件版本值的格式固定为x.x.x，如果上报的软件版本值格式不符合要求，DataFinder会自动转化为x.x.x格式，因此如果出现取值与上报不一致情况，请修改上报数据的格式。 | 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 内部采集 | 是 | 无 | |||
$detailed_stack | 详细堆栈 | 系统崩溃时的详细堆栈信息。此属性不支持在分析模块、看板、分群等模块使用，可在用户细查中使用，用于查看详细的崩溃堆栈，辅助定位分析。当堆栈信息字段超过2048会进行截断。 | string | SDK 内部采集 | 是 | 无 |
应用启动事件（app_launch）
事件名 | 事件开关 | 事件说明 | 事件属性名 | 属性展示名 | 属性描述 | 属性值类型 | 数据来源 | 是否自动上报 | 属性开关控制 |
|---|---|---|---|---|---|---|---|---|---|
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 | 应用页面信息 | 是 | 无 | |||
$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）
事件名 | 事件开关 | 事件说明 | 事件属性名 | 属性展示名 | 属性描述 | 属性值类型-SaaS云原生 | 数据来源 | 是否自动上报 | 属性开关控制 |
|---|---|---|---|---|---|---|---|---|---|
$crash | 受 crash 采集开关影响，鸿蒙高级版支持 | 应用崩溃 | $app_version | 软件版本 | 软件版本值的格式固定为x.x.x，如果上报的软件版本值格式不符合要求，DataFinder会自动转化为x.x.x格式，因此如果出现取值与上报不一致情况，请修改上报数据的格式。 | 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 内部采集 | 是 | 无 | |||
$detailed_stack | 详细堆栈 | 系统崩溃时的详细堆栈信息。此属性不支持在分析模块、看板、分群等模块使用，可在用户细查中使用，用于查看详细的崩溃堆栈，辅助定位分析。当堆栈信息字段超过2048会进行截断。 | string | SDK 内部采集 | 是 | 无 |