更新日期:2024-04-12QuickAD+iOS接入文档
PlayAds.framework,整合模拟器和真机架构的静态库framework
支持平台:iPod Touch,iPhone,iPad。系统要求:iOS7.0+,
支持框架: armv7 arm64 i386 x86_64
环境要求:xcode8.0+
添加SDK
将SDK文件PlayAds.framework拖放导入工程;选择正确的target
在Build Settings->Linking->Other Linking Flags 中配置 –ObjC
如果在编译时报错找不到framework头文件,需要手动配置一下framework搜索路径,比如demo中的相对路径配置
iOS端的广告系统数据统计一共有六个接口,供外部使用的接口类为PlayAdsManager,各接口使用说明如下:
初始化的接口,在进入游戏的时候首先调用
原型:+ (void)initPlayAdsWithProductCode:(NSString *)productCode;
参数说明:
字段 | 类型 | 说明 |
productCode | NSString | 产品码,在Quick后台申请 |
使用示例:
[PlayAdsManager initPlayAdsWithProductCode:@"8cf0c4ea388c7d53435c1e361949f154"];
登录成功的上报接口
原型:+ (void)onLoginUid:(NSString *)uid username:(NSString *)name
参数说明:
字段
字段 | 类型 | 说明 |
uid | NSString | 用户Id |
name | NSString | 用户名 |
使用示例:
[PlayAdsManager onLoginUid:@"123456" username:@"name"];
备注:登录成功或者切换账号成功,都需要调用onLoginUid:username接口。若切换账号成功未调用onLoginUid:usernam接口,可能导致后台uid统计错误。
游戏激活上报接口
原型:+ (void)onActivationWithUserUid:(NSString *)uid roleId:(NSString *)roleId
参数说明:
字段 | 类型 | 说明 |
uid | NSString | 用户Id |
roleId | NSString | 角色Id |
使用示例:
[PlayAdsManager onActivationWithUserUid:@"123456" roleId:@"name"];
备注:游戏激活,按需调用,统计游戏激活观察点,不是打开app的设备数, uid 、roleId 可以为nil。
上传角色信息的上报接口Id
原型:+ (void)updateRoleInfo:(PlayAdsRoleInfo *)roleInfo isCreate:(BOOL)isCreateRole;
参数说明:
字段 | 类型 | 说明 |
isCreateRole | BOOL | 是否为创建角色 |
roleInfo.uid | NSString | 登录的用户uid |
roleInfo.roleId | NSString | 角色Id,如果没有可填uid |
roleInfo.roleName | NSString | 角色名称,如果没有可填角色Id |
roleInfo.roleLevel | int | 角色等级,可选 |
roleInfo.serverId | NSString | 区服Id,可选 |
roleInfo.serverName | NSString | 区服名称,可选 |
roleInfo.balance | float | 角色余额,可选 |
roleInfo.vipLevel | int | 角色的Vip等级,可选 |
roleInfo.partyName | NSString | 所在的帮派名称,可选 |
使用示例:
PlayAdsRoleInfo *roleInfo = [PlayAdsRoleInfo roleInfo]; roleInfo.uid = @"123456"; roleInfo.userName = @"name"; roleInfo.roleId = @"111111"; roleInfo.roleName = @"roleName"; roleInfo.serverName = @"serverName"; roleInfo.roleLevel = 2; roleInfo.vipLevel = 3; [PlayAdsManager updateRoleInfo:roleInfo isCreate:NO];
备注:需要在创建游戏角色、进入游戏和角色升级3个地方调用此接口,缺一不可。尤其用户角色信息有变化 (如升级) 时必须调用。当创建角色时isCreateRole字段值为true,其它情况为false。
支付成功的上报接口
原型:+ (void)congziOverInfo:(PlayAdsOrderInfo *)orderInfo roleInfo:(PlayAdsRoleInfo *)role;
参数说明:
字段 | 类型 | 说明 |
orderInfo.amount | NSString | 订单总金额 |
orderInfo.orderNo | NSString | 游戏支付的订单号 |
orderInfo.goodsId | NSString | 商品Id |
orderInfo.goodsName | NSString | 商品名称 |
orderInfo.currency | NSString | 币种 |
role | PlayAdsRoleInfo | 角色信息 |
使用示例:
PlayAdsOrderInfo *orderInfo = [PlayAdsOrderInfo orderInfo]; orderInfo.orderNo = [NSString stringWithFormat:@"%.0f",[NSDate timeIntervalSinceReferenceDate]]; orderInfo.goodsId = @"120baoshi"; orderInfo.goodsName = @"120宝石"; orderInfo.amount = 12; orderInfo.currency = @"CNY"; PlayAdsRoleInfo *roleInfo = [PlayAdsRoleInfo roleInfo]; roleInfo.uid = @"123456"; roleInfo.userName = @"name"; roleInfo.roleId = @"111111"; roleInfo.roleName = @"roleName"; roleInfo.serverName = @"serverName"; roleInfo.roleLevel = 2; roleInfo.vipLevel = 3; [PlayAdsManager congziOverInfo:orderInfo roleInfo:roleInfo];
李先生:13880511661
QQ:48157910
赵先生:15390049857
QQ:1077535763
孙女士:13551010407
QQ:1799614139
QQ群:698731538