菜单

预置事件

安装

每次安装后首次打开自动报送该事件。

安装事件的 _event_name 为 _appInstall

启动

Android应用每次重新启动(需要距离上次退出超过30s)、或退出后台30s再进入前台时,自动报送该事件。

启动事件的 _event_name 为 _appStart

退出

Android应用退出、或退到后台超过30s时,自动报送该事件。

退出事件的 _event_name 为 _appEnd

 

为预置事件添加自定义属性

支持开发者对启动、安装、退出三个预置事件设置自定义属性,通过这些自定义属性,开发者可以更方便的统计和分析数据。

方法示例

export function setPreSetEventWithProperties(eventType:PresetEventType, properties:Object);

参数相关:

参数名称 参数含义 参数类型 是否必传
eventType

预置事件枚举,具体如下:
INSTALL(安装事件)
START(启动事件)
END(退出事件)

PresetEventType
properties 预置事件自定义属性 Object

调用示例

let eventType:PresetEventType = PresetEventType.START|PresetEventType.INSTALL;
let properties = { ... };
SolarEngine.setPreSetEventWithProperties(eventType,properties);
// 调用 setPreSetEventWithProperties  API 后,SDK 产生的 _appInstall、_appStart 和 _appEnd 事件都会带上 properties 里的自定义属性。

注:

  1. 设置预置事件自定义属性的方法可以在热力引擎 SDK 初始化之前设置,这样设置的属性会适用于所有后续 SDK 产生的预置事件,如果在 SDK 初始化之后再设置,在此之前产生的预置事件会不包含这些设置的自定义属性。
  2. 预置事件设置的自定义属性不会被缓存,每次设置都会覆盖前一次的设置,多次设置同一个预置事件只有最后一次生效。
  3. 给预置事件设置的自定义属性不支持开发者传入"_"下划线开头的 key 值,SDK 会默认丢弃该条属性。
  4. 给预置事件设置的自定义属性支持清空,可以调用对应的枚举清空,如下:

 

let eventType:PresetEventType = PresetEventType.START|PresetEventType.INSTALL|PresetEventType.END
let properties = {};
SolarEngine.setPreSetEventWithProperties(eventType,properties);

 

最近修改: 2024-11-12Powered by