supersdk

文档中心

文档中心

下载文档

广告模块

注意:相同事件 ID(event_id)请勿重复接入!


触发广告事件

接口描述:触发广告事件

接口调用:

[SuperSDK invoke:BCORE_MODULE_ADVERT funcName:BCORE_FUNC_TRACK parameters:@{@"event_id" : @"广告事件 ID"}];

海外广告埋点

打开游戏埋点

说明:在 AppDelegate 的 - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions 中调用,且必须在调用 SuperSDK 初始化接口后调用

[SuperSDK invoke:BCORE_MODULE_ADVERT funcName:BCORE_FUNC_TRACK parameters:@{
                                                                                @"event_id" : @"ad_open"    // 广告事件 ID
                                                                            }];

登录事件埋点

说明:在登录成功后调用,如果登录成功不能拿到角色信息,应在拿到角色信息后,进入游戏前调用

[SuperSDK invoke:BCORE_MODULE_ADVERT funcName:BCORE_FUNC_TRACK parameters:@{ 
                                                                                @"event_id" : @"ad_login",   // 广告事件 ID
                                                                                @"event_value" : @"玩家账号",  // 玩家账号 uid
                                                                            }];

FB 激活事件埋点

说明:在 AppDelegate 的 - (void)applicationDidBecomeActive:(UIApplication *)application 中调用;如果接入了 SuperSdk 的激活生命周期事件并且接入 YouZuGTA 渠道,则不需要再调用,因为 SuperSDK 激活事件中已经调用了。

[SuperSDK invoke:BCORE_MODULE_ADVERT funcName:BCORE_FUNC_TRACK parameters:@{ 
                                                                                @"event_id" : @"ad_fb_open" // 广告事件 ID                                                                                  
                                                                            }];

创角事件埋点

说明:在创角成功后调用

NSDictionary *parameters = @{
                                 @"event_id" : @"ad_createrole",         // 广告事件 ID
                                 @"event_value" : @"玩家账号"             // 玩家账号 uid
                            };
[SuperSDK invoke:BCORE_MODULE_ADVERT funcName:BCORE_FUNC_TRACK parameters:parameters];

升级事件埋点

说明:在每次玩家等级升级成功后调用

NSDictionary *parameters = @{
                                 @"event_id" : @"ad_levelup",           // 广告事件 ID
                                 @"event_value" : @"1"                  // 角色等级
                            };
[SuperSDK invoke:BCORE_MODULE_ADVERT funcName:BCORE_FUNC_TRACK parameters:parameters];

有效等级事件埋点

说明:有效等级事件上报,有效等级以广告部门为准,假如有效等级为 6,即你要在 1,2,3,4,5,6 等级的时候,调用

NSDictionary *parameters = @{
                                 @"event_id" : @"ad_effectivelevel",    // 广告事件 ID
                                 @"event_value" : @"1"                  // 角色等级
                            };
[SuperSDK invoke:BCORE_MODULE_ADVERT funcName:BCORE_FUNC_TRACK parameters:parameters];

七日留存事件埋点

说明:是希望安装当日为第 1 日,在之后的 2,3,4,5,6 都有登录,第 7 天再登录成功时触发,所以一般领取 7 日登陆奖励或签到第 7 天调用

[SuperSDK invoke:BCORE_MODULE_ADVERT funcName:BCORE_FUNC_TRACK parameters:@{ 
                                                                                @"event_id" : @"ad_7retention" // 广告事件 ID    
                                                                            }];

首次支付事件埋点

说明:在首次充值成功后调用,也可放在领取首充礼包时触发

[SuperSDK invoke:BCORE_MODULE_ADVERT funcName:BCORE_FUNC_TRACK parameters:@{ 
                                                                                @"event_id" : @"ad_firstpay"   // 广告事件 ID    
                                                                            }];

支付事件埋点

说明:每次支付成功后,调用

NSDictionary *parameters = @{
                                 @"event_id" : @"ad_pay",               // 广告事件 ID
                                 @"event_value"  : @"648"               // 本次消费金额
                            };
[SuperSDK invoke:BCORE_MODULE_ADVERT funcName:BCORE_FUNC_TRACK parameters:parameters];

自定义事件埋点

说明:按广告部门要求,自定义一些埋点事件,调用方式和上面已确定埋点调用一样,只不过,埋点的事件 ID 会变更、也可能包含其他参数;具体埋点事件 ID 和调用时机,以广告部门说明为准。

NSDictionary *parameters = @{
                                 @"event_id" : @"广告部门指定的自定义事件埋点" // 广告事件 ID
                            };
[SuperSDK invoke:BCORE_MODULE_ADVERT funcName:BCORE_FUNC_TRACK parameters:parameters];

辅助常量一览

字符串常量 实际字符串 描述
BCORE_MODULE_ADVERT advert 广告模块名称
BCORE_FUNC_TRACK track 触发广告事件方法名