一、SDK简述

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，各接口使用说明如下：

3.1.初始化（必接）

初始化的接口，在进入游戏的时候首先调用

原型：+ (void)initPlayAdsWithProductCode:(NSString *)productCode;

参数说明：

字段	类型	说明
productCode	NSString	产品码，在Quick后台申请

使用示例：

[PlayAdsManager initPlayAdsWithProductCode:@"8cf0c4ea388c7d53435c1e361949f154"];

3.2.登录（必接）

登录成功的上报接口

原型：+ (void)onLoginUid:(NSString *)uid username:(NSString *)name

参数说明：

字段

字段	类型	说明
uid	NSString	用户Id
name	NSString	用户名

使用示例：

[PlayAdsManager onLoginUid:@"123456" username:@"name"];

备注：登录成功或者切换账号成功，都需要调用onLoginUid:username接口。若切换账号成功未调用onLoginUid:usernam接口，可能导致后台uid统计错误。

3.3.激活（必接）

游戏激活上报接口

原型：+ (void)onActivationWithUserUid:(NSString *)uid roleId:(NSString *)roleId

参数说明：

字段	类型	说明
uid	NSString	用户Id
roleId	NSString	角色Id

使用示例：

[PlayAdsManager onActivationWithUserUid:@"123456" roleId:@"name"];

备注：游戏激活，按需调用，统计游戏激活观察点，不是打开app的设备数, uid 、roleId 可以为nil。

3.4.角色信息（必接）

上传角色信息的上报接口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。

3.5.充值（必接）

支付成功的上报接口

原型：+ (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];