菜单

预置事件

安装

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

安装事件的 _event_name 为 _appInstall。

启动

iOS 应用每次打开、或从后台进入前台时,自动报送该事件。

启动事件的 _event_name 为 _appStart。

退出

iOS 应用退出、或退到后台时,自动报送该事件。

退出事件的 _event_name 为 _appEnd。

 

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

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

- (void)setPresetEvent:(SEPresetEventType)eventType withProperties:(NSDictionary*)properties;
 
参数名称 参数含义 参数类型 是否必传
eventType 预置事件枚举:
SEPresetEventTypeAppInstall(安装事件)
SEPresetEventTypeAppStart(启动事件)
SEPresetEventTypeAppEnd(退出事件)

SEPresetEventTypeAppAll

(全部预置事件,即包含安装、启动、退出事件)
SEPresetEventType
properties 自定义属性 NSDictionary

注:

  1. 设置预置事件自定义属性的方法可以在热力引擎SDK初始化之前设置,这样设置的属性会适用于所有后续SDK产生的预置事件,如果在SDK初始化之后在设置,在此之前产生的预置事件会不包含这些设置的自定义属性。
  2. 预置事件设置的自定义属性不会被缓存,每次设置都会覆盖前一次的设置,多次设置同一个预置事件只有最后一次生效。
  3. 如果设置了 SEPresetEventType 的枚举为 SEPresetEventTypeAppInstall,会覆盖通过SEPresetEventTypeAppInstall、SEPresetEventTypeAppStart、SEPresetEventTypeAppEnd 这三种枚举设置的自定义属性,如果多次设置,只有最后一次生效。
  4. 给预置事件设置的自定义属性支持清空,可以调用对应的枚举清空,如下:[[SolarEngineSDK sharedInstance] setPresetEvent:SEPresetEventTypeAppStart withProperties:nil], 上述方法可以用来清空启动事件的自定义属性,安装与退出事件只需更改对应的枚举值即可。
  5. 另外,热力引擎 SDK 也支持全局清除预置事件的自定义属性,如下:[[SolarEngineSDK sharedInstance] setPresetEvent:SEPresetEventTypeAll withProperties:nil]
    上述方法可以清空所有预置事件的自定义属性,通过 SEPresetEventTypeAppInstall、SEPresetEventTypeAppStart、SEPresetEventTypeAppEnd 这三种枚举设置的自定义属性会被一并清空。

调用示例:

[[SolarEngineSDK sharedInstance] setPresetEvent:SEPresetEventTypeAppStart withProperties:@{ 
    @"Key1": @"Value1",
    @"Key2": @"Value2"
}];
最近修改: 2024-09-26Powered by