menu
Is this helpful?

# 自动采集

OpenHarmony SDK 支持包括安装、启动、关闭等在内事件的自动采集。

# 一、介绍

TE 系统提供自动化收集数据的接口,您可根据业务需求自行选择需要自动收集的数据。

目前支持的自动采集事件类型有:

  1. 安装事件:记录 APP 被安装的行为
  2. 启动事件:包括打开 APP 和从后台打开APP
  3. 关闭事件:包括关闭 APP 和App进入后台
  4. 浏览事件:用户在 APP 中浏览页面(Ability)
  5. 崩溃事件:APP 发生崩溃时记录崩溃信息(native层的崩溃暂不支持)

接下来将会详细介绍每种数据的采集方法

# 二、开启自动采集

您可以调用enableAutoTrack,打开自动采集功能:

//APP安装事件 TDAutoTrackEventType.APP_INSTALL
//APP启动事件 TDAutoTrackEventType.APP_START
//APP关闭事件 TDAutoTrackEventType.APP_END
//APP浏览页面事件 TDAutoTrackEventType.APP_VIEW_SCREEN
//APP崩溃事件 TDAutoTrackEventType.APP_CRASH
TDAnalytics.enableAutoTrack(TDAutoTrackEventType.APP_START | TDAutoTrackEventType.APP_INSTALL | TDAutoTrackEventType.APP_END | TDAutoTrackEventType.APP_VIEW_SCREEN | TDAutoTrackEventType.APP_CRASH)

# 三、详细介绍

# 3.1 安装事件

APP 安装事件将会记录 APP 的实际安装,在 APP 启动时上报,事件触发时间是 APP 安装后首次启动的时间,APP 升级并不会触发安装事件,而删除重装后会上报安装事件。

  • 事件名:ta_app_install

# 3.2 启动事件

APP 启动事件将会在用户开启 APP,或从后台唤醒 APP 时触发,详细的事件介绍如下:

  • 事件名:ta_app_start
  • 预置属性:#resume_from_background,布尔型,表示 APP 是用户开启还是从后台唤醒,取值为 true 表示从后台唤醒,false 为直接开启。
  • 通过ApplicationStateChangeCallback中的onApplicationForeground回调来触发

# 3.3 关闭事件

APP 关闭事件将会在用户关闭 APP,或将 APP 调至后台时触发,详细的事件介绍如下:

  • 事件名:ta_app_end
  • 预置属性:#duration,数值型,表示该次 APP 访问(自启动至结束)的时长,单位是秒。
  • 通过ApplicationStateChangeCallback中的onApplicationBackground回调来触发

# 3.4 浏览页面事件

APP 浏览页面事件会在用户浏览页面(Ability)时触发,详细的事件介绍如下:

  • 事件名:ta_app_view
  • 预置属性:

#screen_name,字符串型,为Ability的简单类名

# 3.5 崩溃事件

当 APP 出现未捕获异常时,会上报 APP 崩溃事件

  • 事件名:ta_app_crash
  • 预置属性:#app_crashed_reason,字符型,记录崩溃时的堆栈轨迹
  • 通过ErrorObserver的onUnhandledException来监听,暂不支持native的崩溃采集。