“Sdk-data-android”的版本间的差异

2015年12月3日 (四) 02:36的版本

更新说明

1.0.2版本

  优化无网情况可能导致支付数据丢失的情况

SDK 导入

   【重要】未接入陌陌SDK、陌陌多渠道SDK的游戏才需要接入数据SDK

添加jar包

  将需要的Jar文件添加到项目的libs目录，较新版本的ADT会自动将Jar包添加到项目的Library中。如果你ADT不支持这个特性，请在Eclipse中右键点击jar文件，
  在弹出的菜单中选择”Build Path”-->”Add To Build Path”即可。
  需要添加的Jar包：statisticSDK_beta_1.0.0_20150805.jar，陌陌数据统计接口SDK
  

添加so文件

  在项目的libs目录下新建armeabi文件夹，把需要的so文件复制到这里。即：libstatisticSDK.so
  
  

AndroidManifest 配置

  将下面的权限复制至AndroidManifest.xml清单文件中的manifest节点下。
  
  <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" /> 
  <uses-permission android:name="android.permission.INTERNET" /> 
  <uses-permission android:name="android.permission.WRITE_SETTINGS" /> 
  <uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" /> 
  <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
  <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> 
  <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />

接口调用

登录相关的接口

在登录成功的地方添加代码：

  //用户相关数据统计接口
  StatisticSDK.statisticUser(String appId, String userId,String channelId, Context context);
  
  说明:appId 为应用的 ID,需要向陌陌工作人员获取;
           userId 为登录的用户 ID;
           channelId 为渠道 ID,需要向陌陌工作人员获取;
           context 为程序的上下文。

支付相关的接口

在支付成功的地方添加代码：

  //支付相关数据统计的接口
  StatisticSDK.statisticPay(String appId, String channelId, String tradeNo, float tradeFee, String propId, Context context);
  
  说明:appId 为应用的 ID,需要向陌陌工作人员获取; 
           channelId 为渠道 ID,需要向陌陌工作人员获取; 
           tradeNo 为支付成功回调的交易号;
           tradeFee 为支付金额(注:金额应该为 double类型); 
           propId 为道具 ID;
           context 为程序的上下文。

退出的接口

在程序退出的地方添加代码：

  StatisticSDK.exit();

channelId 对应关系

  Y1——百度
  Y2——UC
  Y3——小米
  Y4——豌豆荚
  Y5——360
  Y6——棱镜
  Y7——安智
  Y8——OPPO
  Y9——魅族
  Y10——益玩
  Y11——联想
  Y12——华为
  Y13——拇指玩
  Y14——金立
  Y15——优酷
  Y16——酷派
  Y17——搜狗
  Y18——PPTV
  Y19——4399
  Y20——37玩
  Y21——当乐
  Y22——178
  Y23——PPS
  Y24——17173
  Y25——HTC
  Y26——应用宝
  Y27——三星应用商店
  Y28——应用汇
  Y29——沃友玩
  Y30——沃友玩_bad
  Y31—— 叉叉助手
  Y32—— 酷狗
  Y33—— 靠谱助手
  Y34——vivo
  Y35——联通
  Y36——暴风影音
  Y37——陌陌
  Y38——琵琶网
  Y39——玉米助手
  Y40——酷我
  Y41——乐视
  Y42——快用
  Y43——XY
  Y44——新浪
  Y45——猎宝
  Y46——itools
  Y47——虫虫
  Y48——游龙
  Y49——爱思
  Y50——同步推
  Y51——PP助手
  Y52——海马
  Y53——i苹果
  Y54——乐8

注：如果游戏接入棱镜，同时需要接入陌陌数据SDK，需要将棱镜的渠道号转为陌陌对应的channelId。 棱镜获取渠道号的方法为：String channelId = XMUtil.getChannelLabel(Context context);

SDK Data iOS接入说明

1.0.0版本功能介绍

   1. 登录统计；
   2. 支付统计；
   3. 在线时长统计；
   4. 注销；

SDK 导入

   【重要】未接入陌陌SDK、陌陌多渠道SDK的游戏才需要接入数据SDK

添加framework

设置Other Linker Flags

   在项目Target对应的Build Settings里搜索找到Other Linker Flags设置项，设置值为-ObjC，参考截图：

   

设置C++ Standard Library

   C++ Standard Library的值参照下图设置或者改为Compiler Default。

   

基本API配置

  使用SDK接口前，需要先引用对应模块的头文件；也可以一次性引入所有的SDK头文件，方式参考如下： 
  
   

接口调用

注册接口

在程序的入口AppDelegate类didFinishLaunchingWithOptions方法中添加代码：

  //DataSDK初始化接口
  + (BOOL)registerWithAppKey:(NSString *)appkey channelId:(NSString *)channelId;

   说明: appkey 由陌陌分配的appID,作为app的唯一标识,请找运营获取。
               channelId 游戏当前接入渠道的标识.

登录统计接口

在登录成功的地方添加代码：

  //用户相关数据统计接口
  - (void)loginStatisticWithUserId:(NSString *)userId;
  
  说明: userId 为登录的用户 ID;

  //支付相关数据统计的接口
  - (void)payStatisticWithUserId:(NSString *)userId
                      tradeNo:(NSString *)tradeNo
                    productId:(NSString *)productId
                     tradeFee:(double)tradeFee;
  
  说明:
           userId      为登录的用户 ID;
           tradeNo   为支付成功回调的交易号;
           propId     为道具 ID;
            tradeFee  为支付金额(注:金额应该为 double类型); 

  //用户注销或切换账号接口
  - (void)logout;

  说明：注销接口主要是暂停在线时长统计 

注：如果游戏接入棱镜，同时需要接入陌陌数据SDK，需要将棱镜的渠道号转为陌陌对应的channelId。 棱镜获取渠道号的方法为：String channelId = XMUtil.getChannelLabel(Context context);