菜单

预置事件

1、安装

  • 每次安装后首次打开自动报送该事件。
  • 安装事件的 _event_name 为 _appInstall

2、启动

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

3、退出

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

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

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

方法示例

static void setPresetEvent(ESEPresetEventType EventType, TSharedPtr<FJsonObject> Properties);

参数相关:

参数名称 参数含义  参数类型 是否必传
eventType 预置事件枚举,具体如下:
AppInstall(安装事件)
AppStart(启动事件)
AppEnd(退出事件)
All(安装、启动、退出事件)
PresetEventType
properties 预置事件自定义属性 TSharedPtr<FJsonObject> 

调用示例

TSharedPtr<FJsonObject> PresetProperties = MakeShareable(new FJsonObject);
PresetProperties->SetStringField(TEXT("Preset_key"), TEXT("Preset_value"));
SolarEngine.Analytics.setPresetEvent(PresetEventType.all, properties);

USEAnalytics::setPresetEvent(ESEPresetEventType::All, PresetProperties);

注:

1、设置预置事件自定义属性的方法需要事件产生之前设置,为安装事件添加自定义属性需要在初始化之前设置

2、同一个预置事件的自定义属性只有最后一次生效

3、 PresetEventType.all会同时作用于安装、启动、退出

4、清除指定预置事件设置的自定义属性

USEAnalytics::setPresetEvent(ESEPresetEventType::AppStart, nullptr);

5、给预置事件设置的自定义属性不支持开发者传入"_"下划线开头的 key 值,SDK 会默认丢弃该条属性。

最近修改: 2025-12-01Powered by