1、安装
- 每次安装后首次打开自动报送该事件。
- 安装事件的 _event_name 为 _appInstall「小游戏为_mpInstall」
2、启动
- Android应用每次重新启动(需要距离上次退出超过30s)、或退出后台30s再进入前台时,自动报送该事件。
- 小游戏/iOS应用每次打开、或退出后台后再进入前台时,自动报送该事件。
- 启动事件的 _event_name 为 _appStart「小游戏为_mpStart」
3、退出
- Android应用退出、或退到后台超过30s时,自动报送该事件。
- 小游戏/iOS应用退出时,自动报送该事件。
- 退出事件的 _event_name 为 _appEnd「小游戏为_mpEnd」
为预置事件添加自定义属性
支持开发者对启动、安装、退出三个预置事件设置自定义属性,通过这些自定义属性,开发者可以更方便的统计和分析数据。
方法示例
public static void setPresetEvent(PresetEventType eventType, Dictionary<string, object> properties)
参数相关:
参数名称 | 参数含义 | 参数类型 | 是否必传 |
eventType | 预置事件枚举,具体如下: Install(安装事件) Start(启动事件) End(退出事件) All(安装、启动、退出事件) |
PresetEventType
|
是 |
properties | 预置事件自定义属性 | Dictionary<string, object> | 否 |
调用示例
Dictionary<string, object> properties = new Dictionary<string, object>();
properties.Add("K1", "V1");
properties.Add("K2", "V2");
properties.Add("K3", 2);
SolarEngine.Analytics.setPresetEvent(PresetEventType.all, properties);
// 调用 setPresetEvent API 后,SDK 产生的 Install、Start 和End 事件都会带上 properties 里的自定义属性。
注:
1、设置预置事件自定义属性的方法需要事件产生之前设置,为安装事件添加自定义属性需要在初始化之前设置
2、同一个预置事件的自定义属性只有最后一次生效
3、 PresetEventType.all会同时作用于安装、启动、退出
4、清除指定预置事件设置的自定义属性
SolarEngineManager.getInstance().setPresetEvent(PresetEventType.Start,null)
5、给预置事件设置的自定义属性不支持开发者传入"_"下划线开头的 key 值,SDK 会默认丢弃该条属性。