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')

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://www.456.cn/logcount/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.yhxwfx456data.analytics.android.sdk.Yhxwfx456DataAPI;

在Application中初始化SDK：

代码示例

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

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

4. 如何确认接入成功

测试时把 AndroidManifest.xml 中 logflag 的值设为 true，运行 App，打开几个页面。
在 Android Studio 的 Logcat 中搜索「yhxwfx456」：出现「yhxwfx456 logcount send log succ」表示数据已发送成功；出现「yhxwfx456 logcount send log fail」表示发送失败，请检查 appurl 是否与控制台获取的打点地址一致。
登录 456 数据控制台，在「我的应用」中点击该应用的「查看报表」，进入「访问分析」→「用户轨迹」→「实时用户」，能看到这台设备的访问，即为接入成功。如果调用了自定义事件，可在「使用行为」→「事件分析」中查看。
正式发布前，请把 logflag 改回 false，关闭调试日志。

5. 进阶配置（可选）

用户属性设置

代码示例

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

自定义事件设置

代码示例

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

app和H5打通

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

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

代码示例

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

H5端：

代码示例

apph5.html?yhxw456cookie=前面获取的appCookie&yhxw456counttype=app&yhxw456systemtype=android