Android SDK 接入文档

一、适用范围

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

本文档适用于使用Android来开发应用的产品，目前兼容Android2.2及以上操作系统的设备。

二、接入指南

第一步： 获取AppKey

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

第二步：下载SDK

Android Studio：https://track.chandashi.com/android_client2.0.0.zip

eclipse：https://track.chandashi.com/android_client2.0.0_jar.zip

第三步：导入SDK

SDK适用于 Android 2.3.3（API Level 10）及以上的设备。
Android Studio导入：

• 右键点击项目名称，选择Open Module Settings，点击右上角＋按钮，选择Import .JAR/.AAR Package，选择AAR包。
• 添加完成后，再选中项目，选择 Dependencies,点击下面的＋，选择Module Dependency, 选择cdsdk，点击ok。

eclipse导入：

• 引用压缩包中的所有jar包。

接入方法说明：
1、应用中所有 Activity 继承基类 CdsBaseActivity。CdsBaseActivity 类代 码如下：

public class CdsBaseActivity extends Activity {

boolean cdsIsActive = true;

@Override

protected void onResume() {

     super.onResume();

     CdsdkStatistics.getInstance().startST(this);

    if(!cdsIsActive){

        CdsdkStatistics.getInstance().startHeartBeat();

        this.cdsIsActive = true;

    }

}

 @Override

 protected void onStop() {

     super.onStop();  
     if(!CdsdkStatistics.getInstance().isRunningForeground()){

         CdsdkStatistics.getInstance().stopST(this);

         this.cdsIsActive = false;

     }

 }

}

注：如果程序不能继承了CdsBaseActivity，也可继承其他Activity，需要仿照CdsBaseActivity，包含以下内容，但是得保证都继承一个activity ，代码里面所有 activity 都继承自一个基类 activity。

2、初始化
方法一：在mainactivity中CdsdkStatistics.init(getApplication());在AndroidManifest.xml中配置

<meta-data android:name="CDSDK_ST_CHANNEL" android:value="渠道名" ></meta-data>

<meta-data android:name="CDSDK_ST_APPKEY" android:value="appkey" ></meta-data>

方法二：直接在mainactivity初始化

CdsdkStatistics.init(getApplication(),”appkey”,”渠道名”);

三、其他接口

1. 通用事件汇报

CdsdkStatistics.getInstance().general("事件名");

1. 注册汇报

CdsdkStatistics.getInstance().regist(“用户id");

1. 支付成功汇报

CdsdkStatistics.getInstance().paymentComplete(“交易号",”用户id”,”付费类型","货币类型",金额);

四、冲突解决

cdsdk中引用了okHttp,okio等第三方包,集成sdk时可能遇到冲突,提供以下包解决问题:

无okhttp版：https://track.chandashi.com/android_client2.0.0_no_okhttp.zip

无okhttp，okio版：https://track.chandashi.com/android_client2.0.0_no_okhttp_okio.zip

使用以上包时,需要在build.gradle下,添加以下代码:

android {

    ...

    packagingOptions{
        exclude 'META-INF/maven/com.squareup.okhttp3/okhttp/pom.properties';
        exclude 'META-INF/maven/com.squareup.okhttp3/okhttp/pom.xml';
        exclude 'META-INF/maven/com.squareup.okio/okio/pom.properties';
        exclude 'META-INF/maven/com.squareup.okio/okio/pom.xml';
    }

    ...
}

五、验证接入状态

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

六、技术支持

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

可以通过如下方式联系：

• 技术支持QQ：329575813