预定义事件

变现广告展示事件

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

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

广告展示事件的 _event_name 为 _appImp

参数说明

调用示例

SEAdImpressionEvent event;
event.adType = 1;          // 1：激励视频
event.adPlatform = "csj"; // 穿山甲国内版
event.adAppId = "test_csj_app_id";
event.adId = "test_csj_placement_id";
event.mediationPlatform = "custom"; // 没有聚合平台，设置为custom
event.currencyType = "CNY";             // 人民币
event.adEcpm = 13.14;                 // 广告千次展现的变现收入，单位：元
event.isRendered = true;              // 广告渲染成功
event.customProperties.setString("ad_position", "game_over");
event.customProperties.setString("game_level", "5");
event.customProperties.setString("user_type", "vip");

SolarEngineAPI::track(&event);

应用内购买事件

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

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

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

参数说明

SEJSONObject

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

调用示例

SEPurchaseEvent event;
event.productId = "com.game.coin100";
event.productName = "100金币包";
event.productNum = 1;
event.orderId = "order_" + std::to_string(time(nullptr));
event.payAmount = 6.99;
event.currencyType = "USD";
event.payType = "ApplePay";
event.payStatus = 1; 
event.customProperties.setString("game_level", "5");
event.customProperties.setString("purchase_source", "shop");
event.customProperties.setBool("is_first_purchase", false);
event.customProperties.setString("promotion_code", "SUMMER2024");

SolarEngineAPI::track(&event);

// 注：开发者传入属性 key 不能为"_"下划线开头，"_"下划线开头为SDK保留字段，开发者设置则直接报错丢弃

上报变现广告点击事件

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

类参数说明：

调用示例

SEAdClickEvent event;
event.adType = 1;                
event.adNetworkPlatform = "csj"; 
event.adNetworkPlacementID = "test_csj_placement_id";
event.mediationPlatform = "custom";
event.customProperties.setString("click_position", "reward_button");
event.customProperties.setString("game_level", "5");
event.customProperties.setString("click_time", "after_game_over");

SolarEngineAPI::track(&event);

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

上报注册事件

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

类参数介绍：

调用示例

SERegisterEvent event;
event.registerType = "weixin";
event.registerStatus = "success";
SolarEngineAPI::track(&event);

上报登录事件

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

类参数介绍：

调用示例

SELoginEvent event;
event.loginType = "weixin";
event.loginStatus = "success";
SolarEngineAPI::track(&event);

上报订单事件

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

类参数介绍：

调用示例

event.orderId = "xxxx"
event.payAmount = 29.99;
event.currencyType = "USD";
event.payType = "ApplePay";
event.status = "completed";
event.customProperties.setString("test", "value");
SolarEngineAPI::track(&event);

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

上报自归因事件

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

自归因事件的 `_event_name` 为 _appAttr

参数说明

SEJSONObject

调用示例

SEAppAttrEvent event;
event.adNetwork = "google";
event.subChannel = "paid";
event.adAccountId = "123-456-7890";
event.adAccountName = "Game Marketing Account";
event.adCampaignId = "987654321";
event.adCampaignName = "Global App Install Campaign";
event.adOfferId = "offer_google_123";
event.adOfferName = "Google Play Install";
event.adCreativeId = "creative_google_456";
event.adCreativeName = "Google Play Banner";
event.attributionPlatform = "solar_engine";
event.customProperties.setString("platform", "android");

SolarEngineAPI::track(&event);