Menu

Preset Events

AppInstall

Automatically report the event upon the first opening after install.

The  _event_name of install event is _appInstall.

AppStart

Automatically report the event when the Android app restarts (after being inactive for more than 30 seconds since the last exit) or when it is brought back to the foreground after being in the background for 30 seconds.

The  _event_name of appstart  is _appStart.

AppEnd

Automatically report the event when Android app is exited or sent to the background for more than 30 seconds.

The _event_name of append is _appEnd.

Add Custom Preset Event Properties

       SolarEngine SDK supports developers to set custom properties for three preset events: appStart, appInstall, and appEnd:

ParameterDescriptionTypeRequired
eventTypePreset events, e.g.
0: AppInstall
1: AppStart
2: AppEnd
3: All
numberYes
propertiesCustom preset event properties sent by the developerobjectNo

Sample Code

let customProperties = {
    test1:"key1",
    test2:2,
    test3:[1,"2"]
}
solarengine.setPresetEventProperties(3,customProperties);

// After setPresetEvent API is called,  _appInstall, _appStart and _appEnd will have all the sent properties.

Note:

  1. Custom properties should be set before events are triggered, and properties for appInstall event should be added before SDK initialization.
  2. Only the last setting will take effect if multiple properties are made for the same preset event.

3.  Custom properties cannot start with an underscore "_". The SE SDK will abandon properties like this.


Previous
Preset Event Properties
Next
Predefined Events
Last modified: 2025-09-23Powered by