"用户互动策略平台" / 帮助文档 / 系统配置 / 数据采集 / Android数据采集

3.1.10 Android数据采集

一、集成Android SDK

1.下载SDK

点击下载sdk包，并将sdk包复制到您项目的app/libs目录下：

2.引入SDK

在主 module 的 build.gradle 文件中添加 SDK 依赖：

dependencies {
   implementation fileTree(dir: 'libs', include: ['*.jar', '*.aar'])
}

点击重新构建项目(Sync Project with Gradle Files)，让SDK包能正常依赖：

二、初始化Android SDK

1.获取项目参数及接收地址

登录系统，点击【触点设置】-【触点管理】-【Android SDK】即可设置查看相关参数，如图示：

2.初始化SDK

在application的onCreate进行SDK的初始化:

 public void onCreate() {
        super.onCreate();
        Ty.enableLog(true);           //是否打开日志
        Ty.enableEncrypt(true);       //数据是否加密
        Ty.ignoreAutoTrackFragments(Arrays.<Class<Fragment>>asList(new Class[]{TestFragment.class}));

        Ty.initSDK(
                this, "http://xxx.xx.xx.xxx/appsdk/callback/encrypt",    //数据上报的url
                "2c9*************0000",                                  //App Key  
                "bdd*************761c",                                  //App Secret   
                "testAPP"                                                //targetId  
        );

    }

三、SDK埋点对接

1.设置事件全局属性

在某处设置一次，会自动上报到所有事件中，若某具体事件有相同字段，会覆盖全局变量 eg：在登录时设置一个全局变量，userId = 987654321，对应的代码为：

Ty.setGlobalVariables(getApplication(), "userId","987654321");

2.设置事件自定义属性

可以在每个需要采集数据的事件中，设置多个自定义属性

UserEventData userEventData = new UserEventData
                    .Builder()
                    .setProp("key","value")           //设置自定义属性格式
                    .setProp("gender","女")           //自定义属性1 
                    .setProp("nickname","Yuki")       //自定义属性2 
                    .build();

3.设置用户ID

若用户有多个身份id，比如loginId、custId、mobile 等，可以设置多个用户ID，系统会自动做身份合并，统一绑定到用户

UserEventData userEventData = new UserEventData
                    .Builder()
                    .setId(new TouchId("loginId", "987654321"))       //设置loginId
                    .setId(new TouchId("custId", "10001"))            //设置custId
                    .setId(new TouchId("mobile", "19876543210"))      //设置mobile
                    .build();

4.自定义事件上报示例

此处以登录时上报数据为例：

//登录按钮的监听事件
login.setOnClickListener(new View.OnClickListener() {
           @Override
           public void onClick(View v) {

               UserEventData userEventData = new UserEventData
                       .Builder()
                       .setId(new TouchId("loginId", "987654321"))           //设置用户ID——loginId
                       .setId(new TouchId("mobile", "19876543210"))          //设置用户ID——mobile

                       .setProp("gender", "女")                               //设置自定义属性——性别 
                       .setProp("nickname", "Yuki")                           //设置自定义属性——昵称 
                       .build();

               //设置全局变量（根据需要设置）
               Ty.setGlobalVariables(getApplication(), "test", "这是全局变量-登录时上报");

               Ty.push(getApplicationContext(),
                       "login",                 //事件类型，用于区分不同的事件
                       userEventData,
                       new PushCallBack() {
                           //成功回调
                           @Override
                           public void onSuccess() {

                           }

                           //失败回调
                           @Override
                           public void onFail(String code, String msg) {

                           }
                       });
           }
       });

四、查看实时上报数据

登录系统，点击【触点设置】-【实时数据】即可查看实时上报的数据，如图示：

Android数据采集