首次事件功能是指在同一个设备中只有首次调用时该事件才会上报,支持的事件类型有注册事件和自定义事件。
上报注册事件首次事件
调用 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保留字段,开发者设置则直接报错丢弃