菜单

预定义事件

 

变现广告展示事件

App内变现广告展示时,报送该事件,用于进行广告展示及变现收入分析。

使用ROI分析功能、自定义分析变现指标时,为必须报送事件。

广告展示事件的 _event_name 为 _appImp

参数说明

参数名称 参数含义 参数类型 是否必传
adPlatform 变现平台,前面为应传值,后面为平台名称
csj:穿山甲国内版
pangle:穿山甲国际版
tencent:腾讯优量汇
baidu:百度百青藤
kuaishou:快手
oppo:OPPO
vivo:vivo
mi:小米
huawei:华为
applovin:Applovin
sigmob:Sigmob
mintegral:Mintegral
oneway:OneWay
vungle:Vungle
facebook:Facebook
admob:AdMob
unity:UnityAds
is:IronSource
adtiming:AdTiming
klein:游可赢
fyber:Fyber
chartboost:Chartboost
adcolony:Adcolony
string 是
adType 展示广告的类型
1:激励视频
2:开屏
3:插屏
4:全屏视频
5:Banner
6:信息流
7:短视频信息流
8:大横幅
9:视频贴片
10:中等尺寸横幅
0:其它
int 是
adAppId 变现平台的应用 ID string 否
adId 变现平台的变现广告位 ID string 是
mediationPlatform 聚合平台标识,常见聚合平台枚举如下,若您使用的聚合平台不在如下枚举值,您可以自定义命名,并控制字符数在32位。没有聚合平台标识,请设置为 "custom"。
max
ironsource
admob
hyperbid
topon
cas
Tradplus
Tobid
string 是
adEcpm 广告ECPM(广告千次展现的变现收入,0或负值表示没传),单位:元 double 是
currencyType 展示收益的货币种类,遵循《ISO 4217国际标准》如 CNY、USD string 是
isRendered 广告是否渲染成功,具体枚举值如下: 例如:成功时,只需要传入 YES YES:成功
NO:失败
如果不需要统计该指标,请传 YES
boolean 是
customProperties 自定义属性, json字符串 object 否

调用示例

let properties = {
		adPlatform:"csj",
		adType:1,
		adAppId:"应用ID",
		adId:"广告位ID",
		mediationPlatform:"custom",
		adEcpm: 13.14,
		currencyType: "USD",
		isRendered:true,
		customProperties:{
			test_key1:"1",
			test_key2:2,
		}
	}
solarengine.trackAdImpression(properties);

 

 

应用内购买事件

App 内付费购买时,报送该事件,用于进行购买及内购收入分析。

该事件为用于付费预测模型训练的关键事件,使用系统提供的预测服务时,为必须报送事件。

应用内购买事件的 _event_name 为 _appPur。

参数说明

参数名称 参数含义 参数类型 是否必传
orderId 本次购买由系统生成的订单 ID string 否,投放荣耀商推、网易有道、豆瓣和oppo时必填
payAmount 本次购买支付的金额,单位:元 double 是
currencyType 支付的货币类型,遵循《ISO 4217国际标准》,如 CNY、USD string 是
payType 支付方式:如 alipay、weixin、applepay、paypal 等 string 否
productId 购买商品的ID string 否
productName 商品名称 string 否
productNum 购买商品的数量 Int 否
payStatus 支付状态
1: 成功
2: 失败
3: 恢复购买
int 是
failReason 支付失败的原因 string 否
customProperties 自定义属性 object 否

注:支付失败原因 failReason 参数仅在 paystatus 参数为 2 支付失败时才会传入,其他状态传""即可。

调用示例

let properties = {
		orderId:"se_demo_007",
		payAmount:6.99,
		currencyType:"CNY",
		payType:"weixin",
		productId:"se_demo_00001",
		productName: "se_demo_name",
		productNum: 1,
		payStatus: 1,
		failReason:"test_failReason",
		customProperties:{
			test_key1:"1",
			test_key2:2,
		}
	}
solarengine.trackPurchase(properties);	
// customProperties 为自定义属性,可以不设置
// 注:开发者传入属性 key 不能为"_"下划线开头,"_"下划线开头为SDK保留字段,开发者设置则直接报错丢弃

 

 

上报变现广告点击事件

调用 此方法可以上报变现广告点击事件

类参数说明:

参数名称 参数含义 参数类型 是否必传
adPlatform 变现平台,前面为应传值,后面为平台名称
csj:穿山甲国内版
pangle:穿山甲国际版
tencent:腾讯优量汇
baidu:百度百青藤
kuaishou:快手
oppo:OPPO
vivo:vivo
mi:小米
huawei:华为
applovin:Applovin
sigmob:Sigmob
mintegral:Mintegral
oneway:OneWay
vungle:Vungle
facebook:Facebook
admob:AdMob
unity:UnityAds
is:IronSource
adtiming:AdTiming
klein:游可赢
fyber:Fyber
chartboost:Chartboost
adcolony:Adcolony
string 是
adType 展示广告的类型
1:激励视频
2:开屏
3:插屏
4:全屏视频
5:Banner
6:信息流
7:短视频信息流
8:大横幅
9:视频贴片
0:其它
int 是
adId 变现平台的变现广告位 ID string 是
mediationPlatform 聚合平台标识,常见聚合平台枚举如下,若您使用的聚合平台不在如下枚举值,您可以自定义命名,并控制字符数在32位。没有聚合平台标识,请设置为 "custom"。
max
ironsource
admob
hyperbid
topon
cas
Tradplus
Tobid
string 是
customProperties 自定义属性说明见目录:4.自定义属性 object 否

调用示例

let properties = {
		adPlatform:"mtg",
		adType: 2,
		adId: "广告位ID",
		mediationPlatform: "custom",
		customProperties:{
			test_key1:"1",
			test_key2:2,
		}
solarengine.trackAdClick(properties);	
// customProperties 为自定义属性,可以为空
// 注:开发者传入属性 key 不能为"_"下划线开头,"_"下划线开头为SDK保留字段,开发者设置则直接报错丢弃
 

 

上报注册事件

调用 trackRegister 方法可以上报注册事件

类参数介绍:

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

调用示例

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

 

上报登录事件

调用 trackLogin 方法可以上报登录事件

类参数介绍:

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

调用示例

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

 

上报订单事件

调用 trackOrder 方法可以上报订单事件

类参数介绍:

参数名称 参数含义 参数类型 是否必传
orderId 订单 ID string 否,不超过 128 字符,投放荣耀商推、网易有道、豆瓣和oppo时必填
payAmount 订单金额,单位:元 double 是
currencyType 展示货币类型,遵循《ISO 4217国际标准》,如 CNY、USD string 是
payType 支付方式:如 alipay、weixin、applepay、paypal 等 string 否,不超过 32 字符
status 订单状态 string 是
customProperties 自定义属性说明见目录:4.自定义属性 object 否

调用示例

let properties = {
		orderId: "订单ID",
		payAmount: 15.6,
		currencyType:"USD",
		payType: "aliPay",
		status: "success",
		customProperties:{
			test_key1:"1",
			test_key2:2,
		}
	}
solarengine.trackOrder(properties);	
// customProperties 为自定义属性,可以不设置
// 注:开发者传入属性 key 不能为"_"下划线开头,"_"下划线开头为SDK保留字段,开发者设置则直接报错丢弃
 

 

上报自归因事件

增加归因安装事件,支持统计归因数据,满足客户使用三方归因或者自归因之后的结果数据回传到自定义分析,上报时机支持开发者自定义触发

自归因事件的 `_event_name` 为 _appAttr

参数说明

参数名称 参数含义 参数类型 是否必传
adNetwork 投放广告的渠道 ID,需要与发行平台匹配 string 是
subChannel 投放广告的子渠道 string 否
adAccountId 投放广告的投放账号 ID string 否
adAccountName 投放广告的投放账号名称 string 否
adCampaignId 投放广告的广告计划 ID string 否
adCampaignName 投放广告的广告计划名称 string 否
adOfferId 投放广告的广告单元 ID string 否
adOfferName 投放广告的广告单元名称 string 否
adCreativeId 投放广告的广告创意 ID string 否
adCreativeName 投放广告的广告创意名称 string 否
attributionPlatform 监测平台 string 是
customProperties 开发者传入的自定义属性 object 否

调用示例

let properties = {
		adNetwork: "adNetwork",
		subChannel: "subChannel",
		adAccountId:  "adAccountId",
		adAccountName:  "adAccountName",
		adCampaignId:  "adCampaignId",
		adCampaignName:  "adCampaignName",
		adOfferId:  "adOfferId",
		adOfferName:  "adOfferName",
		adCreativeId: "adCreativeId",
		adCreativeName:  "adCreativeName",
		attributionPlatform: "attributionPlatform",
		customProperties:{
			test_key1:"1",
			test_key2:2,
		}
	}
solarengine.trackAppAttr(properties);	
最近修改: 2025-08-11Powered by