菜单

首次事件

首次事件功能是指在同一个设备中只有首次调用时该事件才会上报,支持的事件类型有注册事件和自定义事件。

 

 

 

上报注册事件首次事件

调用 trackFirstEvent 方法可以上报注册事件首次事件,相同的firstCheckId多次调用只有第一次生效

类参数介绍:

 

参数介绍

参数名称 参数含义 参数类型 是否必传
firstCheckId
标识首次事件的唯一ID string
eventName

注册事件名称:_appReg (固定字段)

string
properties
注册事件属性 object

properties 属性介绍

参数名称 参数含义 参数类型 是否必传
registerType 注册类型如 "WeChat"、"QQ" 等自定义值 string 是,不超过 32 字符
registerStatus 注册状态 如 "success" string
customProperties 自定义属性 object

 

调用示例

let firstCheckId = "test_uniqueID";
let properties = {
		registerType:"WeChat",
		registerStatus:"success",
		customProperties:{
			test_key1:"1",
			test_key2:2,
		}
}
solarengine.trackFirstEvent(firstCheckId, "_appReg", properties)
// customProperties 为自定义属性,可以不设置
// 注:开发者传入属性 key 不能为"_"下划线开头,"_"下划线开头为SDK保留字段,开发者设置则直接报错丢弃
 

首次事件功能是指在同一个设备中只有首次调用时该事件才会上报,支持的事件类型有注册事件和自定义事件。

 

 

 

上报自定义事件首次事件

调用 trackFirstEvent 方法可以上报注册事件首次事件,相同的firstCheckId多次调用只有第一次生效

类参数介绍:

 

参数介绍

参数名称 参数含义 参数类型 是否必传
firstCheckId
标识首次事件的唯一ID string
eventName

自定义事件名称(不能以_开头)

string
properties
注册事件属性 object

properties 属性介绍

参数名称 参数含义 参数类型 是否必传
registerType 注册类型如 "WeChat"、"QQ" 等自定义值 string 是,不超过 32 字符
registerStatus 注册状态 如 "success" string
customProperties 自定义属性 object

 

调用示例

let firstCheckId = "test_uniqueID";
const customProperties = {
            test1: "key1",
            test2: 2,
            test3: [1, "2", { "keyxx": "xx" }],
}
solarengine.trackFirstEvent(firstCheckId, "test_Event", customProperties)
// customProperties 为自定义属性,可以不设置
// 注:开发者传入属性 key 不能为"_"下划线开头,"_"下划线开头为SDK保留字段,开发者设置则直接报错丢弃
 

 

最近修改: 2025-04-09Powered by