SDK 集成

SDK 最低兼容系统版本 Android 4.0，即 Android SDK 14 及以上版本

1. 接入SDK

1. 下载 SDK 点击下载
2. 解压后把 jar包和os文件拷贝到工程指定目录中

2. AppId 和权限配置

在 AndroidMainfest.xml 文件中添加：

    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
    <uses-permission android:name="android.permission.INTERNET" />
    <application
    ...
    >
        <meta-data
            android:name="TRACKSDK_APPID"
            android:value="应用AppId" />
    </application>

3. 初始化 TrackSDK

1. 继承 Application 并重写 onCreate 方法进行初始化

   @Override
   public void onCreate() {
      super.onCreate();
      TrackSDK.init(this);
   }
   

4. 获取绑定数据和渠道ID

//可多次调用获取，data有可能是null,请做好非空判断
TrackSDK.getBindData(context,new TrackSDK.Callback() {
    @Override
    public void onValue(@Nullable BindData data) {
        ...
    }
});

//只在应用安装后第一次调用时执行，覆盖安装后调用不会执行，data有可能是null,请做好非空判断
TrackSDK.getBindDataOnce(context,new TrackSDK.Callback() {
    @Override
    public void onValue(@Nullable BindData data) {
        ...
    }
});

5. 触发事件

• 触发注册事件，用于渠道统计分析

  //用户唯一标识最大长度在128个字符以内，例如：使用md5加密用户ID作为用户唯一标识
  TrackSDK.onRegister(context, "用户唯一标识");
  

• 触发自定义事件

  //事件ID需要登陆控制进行查看，【控制台->管理->事件管理】
  TrackSDK.onEvent(context, "事件ID");
  
  //有些场景可能需要事件值，例如：用户充值事件，需要统计充值金额
  TrackSDK.onEvent(context, "事件ID" , 100.10f);
  

6. 混淆配置

请使用keep选项指定不对SDK进行混淆，确保SDK正常工作。在混淆配置文件 proguard-rules.pro 中添加：

-keep class com.tracksdk.** { *; }