菜单

首次事件

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

 

 

 

上报注册事件首次事件

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

类参数介绍:

 

参数介绍

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

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

string
properties
注册事件属性 table

properties 属性介绍

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

 

调用示例

local SolarEngineSDK = require("SolarEngineSDK")
SolarEngineSDK.trackFirstEvent("_appReg", "test_uniqueId",  {
    registerType = "QQ",
    registerStatus = "success"
    customProperties = {
        test_key = "test"
    }
})

// customProperties 为自定义属性,可以不设置
// 注:开发者传入属性 key 不能为"_"下划线开头,"_"下划线开头为SDK保留字段,开发者设置则直接报错丢弃
 

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

 

 

 

上报自定义事件首次事件

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

类参数介绍:

 

参数介绍

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

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

string
customProperties
自定义属性 table

 

调用示例

SolarEngineSDK.trackFirstEvent("test_name","test_uniqueId" ,{
        test_key = "test"
})

// customProperties 为自定义属性,可以不设置
// 注:开发者传入属性 key 不能为"_"下划线开头,"_"下划线开头为SDK保留字段,开发者设置则直接报错丢弃
 

 

最近修改: 2025-11-25Powered by