菜单

首次事件

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

 

 

 

上报注册事件首次事件

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

类参数介绍：

 

参数介绍

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

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

 string 是
properties
 注册事件属性 object 是

properties 属性介绍

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

 

调用示例

SEJSONObject properties;
properties.setNumber("registerType", "weixin");
properties.setNumber("registerStatus", "success");
SolarEngineAPI::trackFirstEvent("_appReg", "uniqueID", properties);
// customProperties 为自定义属性，可以不设置
// 注：开发者传入属性 key 不能为"_"下划线开头，"_"下划线开头为SDK保留字段，开发者设置则直接报错丢弃
 

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

 

 

 

上报自定义事件首次事件

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

类参数介绍：

 

参数介绍

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

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

 string 是
properties
 注册事件属性 object 否

properties 属性介绍

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

 

调用示例

SEJSONObject properties;
properties.setNumber("test", "data");
SolarEngineAPI::trackFirstEvent("test_event", "uniqueID", properties);
// customProperties 为自定义属性，可以不设置
// 注：开发者传入属性 key 不能为"_"下划线开头，"_"下划线开头为SDK保留字段，开发者设置则直接报错丢弃
 

 

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