预定义事件

变现广告展示事件

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

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

广告展示事件的 _event_name 为 _appImp

方法示例

export function trackAdImpressionWithAttributes(adImpressionEventAttribute:SEAdImpressionEventAttribute);

调用示例

let attribute:SEAdImpressionEventAttribute = {

  adNetworkPlatform:"AdMob",
  adType:AdType.Interstitial,
  adNetworkAppID:"AdMob appid",
  adNetworkPlacementID:"AdMob placementid",
  mediationPlatform:"MAX",
  currency:"USD",
  ecpm:1.234, //此处单位为 '元' ,请注意单位转换
  rendered:true,
  customProperties:{"key1":"value1","key2":"value2"}
  // customProperties 为自定义属性，可以不设置
  // 注：开发者传入属性 key 不能为"_"下划线开头，"_"下划线开头为SDK保留字段，开发者设置则直接报错丢弃    
}
SolarEngine.trackAdImpressionWithAttributes(attribute);

应用内购买事件

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

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

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

方法示例

export function trackIAPWithAttributes(iapEventAttribute:SEIAPEventAttribute);

注：支付失败原因 failReason 参数仅在 payStatus 参数为 Failed 支付失败时才会传入，其他状态传""即可。

调用示例

let attribute:SEIAPEventAttribute = {
  productID:"product id",
  productName:"product name",
  productCount:3,
  orderId:"order id",
  payAmount:3.14,
  currency:"USD",
  // const Alipay    = "alipay";
  // const Weixin    = "weixin";
  // const ApplePay  = "applepay";
  // const Paypal    = "paypal";
  payType:Paypal,
  payStatus:SEIAPStatus.Success,
  failReason:"",
  customProperties:{"key":"iap customProperties value"}
// customProperties 为自定义属性，可以不设置
// 注：开发者传入属性 key 不能为"_"下划线开头，"_"下划线开头为SDK保留字段，开发者设置则直接报错丢弃
}
SolarEngine.trackIAPWithAttributes(attribute);

上报变现广告点击事件

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

方法示例

export function trackAdClickWithAttributes(adClickEventAttribute:SEAdClickEventAttribute);

调用示例

let attribute:SEAdClickEventAttribute = {

  adNetworkPlatform: "AdNetwork platform",
  adType:AdType.Interstitial,
  adNetworkPlacementID:"AdNetwork placementid",
  mediationPlatform:"mediation name",
  customProperties:{"key":"adclick customProperties value"}
// customProperties 为自定义属性，可以不设置
// 注：开发者传入属性 key 不能为"_"下划线开头，"_"下划线开头为SDK保留字段，开发者设置则直接报错丢弃
}
SolarEngine.trackAdClickWithAttributes(attribute);

上报注册事件

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

方法示例

export function trackRegisterWithAttributes(registerEventAttribute:SERegisterEventAttribute);

调用示例

let attribute:SERegisterEventAttribute = {

  registerType:"WeChat",
  registerStatus:"success",
  customProperties:{"key":"register customProperties value"}
// customProperties 为自定义属性，可以不设置
// 注：开发者传入属性 key 不能为"_"下划线开头，"_"下划线开头为SDK保留字段，开发者设置则直接报错丢弃
}
SolarEngine.trackRegisterWithAttributes(attribute);

上报登录事件

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

方法示例

export function trackLoginWithAttributes(loginEventAttribute:SELoginEventAttribute);

调用示例

  let attribute:SELoginEventAttribute = {
    loginType:"WeChat",
    loginStatus:"failed",
    customProperties:{"key":"login customProperties value"}
// customProperties 为自定义属性，可以不设置
// 注：开发者传入属性 key 不能为"_"下划线开头，"_"下划线开头为SDK保留字段，开发者设置则直接报错丢弃
  }
  SolarEngine.trackLoginWithAttributes(attribute);

上报订单事件

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

方法示例

export function trackOrderWithAttributes(orderEventAttribute:SEOrderEventAttribute);

调用示例

let attribute:SEOrderEventAttribute = {
  orderID:"order id",
  payAmount:3.1415926,
  currency:"USD",
  payType:Paypal,
  status:"success",
  customProperties:{"key":"order customProperties value"}
// customProperties 为自定义属性，可以不设置
// 注：开发者传入属性 key 不能为"_"下划线开头，"_"下划线开头为SDK保留字段，开发者设置则直接报错丢弃
}
SolarEngine.trackOrderWithAttributes(attribute);

上报自归因事件

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

自归因事件的 `_event_name` 为 _appAttr

方法示例

export function trackAppAttrWithAttributes(appAttrEventAttribute:SEAppAttrEventAttribute);

调用示例

let attribute:SEAppAttrEventAttribute = {
  adNetwork:"toutiao",
  subChannel:"103300",
  adAccountID:"1655958321988611",
  adAccountName:"xxx科技全量18",
  adCampaignID:"1680711982033293",
  adCampaignName:"冲冲冲计划157-1024",
  adOfferID:"1685219082855528",
  adOfferName:"冲冲冲单元406-1024",
  adCreativeID:"1680128668901378",
  adCreativeName:"自动创建20210901178921",
  attributionPlatform:"广告监测平台xxx",
  customProperties:{"customProperties":"app attr customProperties value"}
// customProperties 为自定义属性，可以不设置
// 注：开发者传入属性 key 不能为"_"下划线开头，"_"下划线开头为SDK保留字段，开发者设置则直接报错丢弃
}
SolarEngine.trackAppAttrWithAttributes(attribute);