iOS SDK 接入文档

一、适用范围

蝉大师平台作为国内的第三方移动广告监测平台，为了能够更好的帮助广告主能够更精准的评估每次的广告投放效果，以及帮助广告网络能够做广告系统的投放优化或业务数据的完善。

本文档适用于使用Objective C来开发的产品,目前兼容iOS7.0以上操作系统的设备。

二、接入指南

第一步： 获取AppKey

• 注册/登录蝉大师账号
• 在左侧菜单栏点击应用管理 --> 添加应用
• 添加成功后进入集成SDK 即可看到每个应用对应的唯一AppKey

第二步：下载SDK

https://track.chandashi.com/ios_client.zip

第三步：导入SDK（cocos2d开发需导入ios文件夹下）

• 在选项TARGETS--> Build Phases-->Link Binary With Libraries-->Add Other，选择Security.framework，CoreTelephony.framework
• 如果是cocos2d开发，需额外添加 MediaPlayer.framework 和 GameController.framework
• Build Settings ->Other Linker Flags 添加 -ObjC；

第四步：集成SDK

在AppDelegate的

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(nullable NSDictionary *)launchOptions;

中加入下面两行代码:

[ChanSDK registerKey:@"Key"]; 必须，Key是蝉大师注册得到的

[ChanSDK setChannel:@"iOS"]; 选填，channel是游戏即将上线的商店

第五步：测试与调试

确认key填写正确后，就可以测试了。

[ChanSDK setEnableLog:YES];可以开启调试，查看是否获取到统计数据并成功上传

返回结果:(error=0代表成功，没有错误)

{
   error = 0;
   result =     {
      bid = 1552;
   };
}

三、事件接口

• 注册汇报：蝉大师支持注册事件汇报。渠道注册率是评估渠道质量的一个重要标准。

[ChanSDK userRegister:@"用户id"];

• 支付成功汇报：支付信息的汇报，对渠道质量提供多个衡量指标，如新增付费，总付费，付费率等。

[ChanSDK userPay:@"交易号"
        account:@"用户id"
        payType:ChanPayTypeAlipay
   currencyType:ChanCurrencyTypeDollar
 currencyAmount:0.65];

四、验证接入状态

集成成功后，应用管理页面的集成状态会变成“已集成”，激活数据10分钟左右在前台可以看到。

五、苹果市场上架

App Store 禁止不使用广告而采集 IDFA 的 APP 上架, 所以上架的时候需要勾选如下IDFA选项

六、技术支持

如果您有任何问题，我们的技术支持工程师会第一时间给您提供帮助，

可以通过如下方式联系：

• 技术支持QQ：329575813