Android 接入 - 456数据开发文档

快速开始

1

注册账号

创建站点获取打点地址和站点编号

2

下载 SDK

集成 Android SDK 到您的App

3

验证接入

验证数据是否正常上报

4

查看数据看板

实时查看访客数据

1. 注册账号

登录 456 数据控制台，在「站点管理」中创建站点，获取您的打点地址和站点编号。

2. 下载Android SDK

请点击这里下载Android SDK并集成到您的App中

将下载的 jar 放入工程的 `libs` 目录，在模块 `build.gradle` 中依赖：

代码示例

implementation files('libs/456_android_v1.0.jar.jar')

3. 初始化 SDK

在 AndroidManifest.xml 中声明网络相关权限：

代码示例

<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.READ_PHONE_STATE"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>

在同一文件的 application 节点内写入控制台获取的其他参数：

代码示例

<meta-data
    android:name="website"
    android:value="1000000X" />
<meta-data
    android:name="channel"
    android:value="360phone" />
<meta-data
    android:name="appurl"
    android:value="https://up.456.com/logcount.html"/>
<meta-data
    android:name="custompage"
    android:value="Test1Activity|Test2Activity|Test3Activity" />
<meta-data
    android:name="autoclick"
    android:value="false" />
<meta-data
    android:name="starttime"
    android:value="30" />
<meta-data
    android:name="anrtime"
    android:value="0" />
<meta-data
    android:name="logflag"
    android:value="true" />

在程序的入口Application引入：

代码示例

import com.yhxwfxdata.analytics.android.sdk.YhxwfxDataAPI;

在Application中初始化SDK：

代码示例

public class MyApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        initYhxwfxDataAPI(this);//初始化app456类
    }

    private void initYhxwfxDataAPI(Application application) {//app456初始化方法       
        YhxwfxDataAPI.init(application);
    }
}

3. 进阶配置（可选）

用户属性设置

代码示例

 try{
	JSONObject eventData = new JSONObject();
	eventData.put("userid", "321");//userid不可更改
	eventData.put("username", "Leo");//username不可更改
	eventData.put("sex", "男");//sex自定义
	eventData.put("age", "28");//age自定义
	YhxwfxDataAPI.getInstance().trackUserSet(eventData);
}
catch (Exception e){
	e.printStackTrace();
}

自定义事件设置

代码示例

 try{
    JSONObject eventProperty = new JSONObject();
    eventProperty.put("商品id", "12876");
    eventProperty.put("价格", "88");
    YhxwfxDataAPI.getInstance().trackEvent("event", "购物", "加入购物车", eventProperty);
}
catch (Exception e){
    e.printStackTrace();
}

app和H5打通

App使用SDK ，采集到数据后，发往H5，H5 收到 App 发送的数据后，设置用户的Cookie,这样就保持了用户唯一识别标识的统一。

App端通过以下方法获取App中的用户唯一识别标识：

代码示例

String appCookie = YhxwfxDataAPI.getInstance().getUserCookie();

H5端：

代码示例

apph5.html?yhxwcookie=前面获取的appCookie&yhxwcounttype=app&yhxwsystemtype=android