Menu

First-Time Event

       The first-time event means that the event will only be reported the first time it is triggered on the same device. Only registration event and custom events support this feature. rst in-app ad impression event

1. First-time register event

       Calling the trackFirstEvent function can report a first-time registration event. If the same firstCheckId is called multiple times, only the first call will take effect.

Parameter Parameter MeaningTypeRequired
firstCheckIdFirst-time event verification ID StringYes
eventName_appRegStringYes
properties_appReg event propertiesobjectYes

"properties" description

ParameterParameter MeaningTypeRequired
registerTypeRegister type such as "WeChat", "QQ" and other custom valuesStringYes (No more than 32 characters)
registerStatusRegister status such as "success"StringNo
customPropertiescustom propertiesobjectNo

Code Example

let firstCheckId = "test_uniqueID";
let properties = {
		registerType:"WeChat",
		registerStatus:"success",
		customProperties:{
			test_key1:"1",
			test_key2:2,
		}
}
solarengine.trackFirstEvent(firstCheckId, "_appReg", properties)
// You can choose not to set customProperties.
// Please do not report custom properties starting with "_", otherwise SDK will abandon its value by default.

2. First-time custom event

Code Example

let firstCheckId = "test_uniqueID";
const customProperties = {
            test1: "key1",
            test2: 2,
            test3: [1, "2", { "keyxx": "xx" }],
}
solarengine.trackFirstEvent(firstCheckId, "test_Event", customProperties)
// You can choose not to set customProperties. 
// Please do not report custom properties starting with "_", otherwise SDK will abandon its value by default.


Previous
Duration Events
Next
Set User Property
Last modified: 2025-09-23Powered by