"用户互动策略平台" / 帮助文档 / 系统配置 / 数据采集 / 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) {
}
});
}
});
四、查看实时上报数据
登录系统,点击【触点设置】-【实时数据】即可查看实时上报的数据,如图示: