变现广告展示事件
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);