数据统计

1、数据统计说明

数据统计说明（不分国内海外）

注意

数据统计在UnionSDK中会默认上报启动、登录、支付等数据到数据OSS平台，且不分国内海外。如果游戏需要接入其他更详细的数据上报到数据统计平台，请阅读数据统计接入文档。

1.1、国内海外数据统计接口是否唯一？

信息

数据统计接口为统一接口，国内和海外相同。

根据传入参数、meta-data配置参数的不同会上报数据到不同平台。

1.2、国内数据统计需上报到那些平台？

信息

目前数据统计国内默认只有数据统计平台。

1.3、海外数据统计需上报到那些平台？

信息

目前数据统计海外默认只有数据统计平台，如果需要上报到adjust和Firebase，需要运营在开放平台配置三合一表格，研发无需额外接入

2、数据统计接入

2.1 新手引导（选接二级）

import com.dh.DHSDKHelper;

import java.util.HashMap;

// 特别注意：参数值类型无特殊说明均为字符串
HashMap<String, Object> data = new HashMap<>();

// 必传参数
data.put("track_platform", "dianhun");  // 固定值，无需修改
data.put("zid", "1");  // 大区ID，若游戏无大区概念，则填1作为初始大区编号，和游戏服务器日志传值保持一致
data.put("sid", "1");  // 大区的下一级，若游戏无服概念，则填1作为初始服编号，和游戏服务器日志传值保持一致
data.put("role_id", "1696674719");  // 角色ID，游戏内唯一（不同区服之间也不允许重复），建议纯数字。若游戏无角色概念，则填账号id
data.put("step_id", "10000");  // 引导步骤ID
data.put("step_state", "2");  // 引导步骤状态 1：进行中 2：已完成（不含跳过）3：跳过

// 可选参数
data.put("step_type", "pvp");  // 引导步骤分类
data.put("role_level", "10");  // 角色等级
data.put("vip_level", "10");  // 角色VIP等级
data.put("step_param", "H001");  // 引导步骤参数
data.put("extend_param_json", "{\"kills\":\"10\",\"deaths\":\"2\",\"assistant\":\"3\"}");  // 扩展参数，JSON格式字符串

/**
 * @param activity    上下文
 * @param eventName   事件名称
 * @param eventValue  事件数据
 */
DHSDKHelper.getInstance().getAnalysis().trackEvent(activity, "guidestep", data);

2.2 按钮日志（选接二级）

import com.dh.DHSDKHelper;

import java.util.HashMap;

// 特别注意：参数值类型无特殊说明均为字符串
HashMap<String, Object> data = new HashMap<>();

// 必传参数
data.put("track_platform", "dianhun");  // 固定值，无需修改
data.put("button_id", "match_001");  // 按钮ID

// 可选参数
data.put("button_type", "match");  // 按钮分类
data.put("page_id", "main_page");  // 按钮所在界面ID，用于分析用户操作路径
data.put("opt_param", "10");  // 操作参数，比如是跳转到另外一个页面，就填写结果页ID；匹配按钮则可以填匹配时间
data.put("zid", "1");  // 大区ID，若游戏无大区概念，则填1作为初始大区编号
data.put("sid", "1");  // 大区的下一级，若游戏无服概念，则填1作为初始服编号
data.put("role_id", "1696674719");  // 角色ID，游戏内唯一（不同区服之间也不允许重复），建议纯数字。若游戏无角色概念，则填账号id
data.put("extend_param_json", "{\"online_durt_tot\":\"12020\"}");  // 扩展参数，JSON格式字符串

/**
 * @param activity    上下文
 * @param eventName   事件名称
 * @param eventValue  事件数据
 */
DHSDKHelper.getInstance().getAnalysis().trackEvent(activity, "button", data);

2.3 自定义日志（选接二级）

import com.dh.DHSDKHelper;

import java.util.HashMap;

// 特别注意：参数值类型无特殊说明均为字符串
HashMap<String, Object> data = new HashMap<>();

// 必传参数
data.put("track_platform", "dianhun");  // 固定值，无需修改
data.put("event", "levelUp");  // 自定义事件名

// 可选参数
data.put("opt_obj", "pay_btn");  // 操作对象，如果是按钮点击事件，则对应按钮ID
data.put("opt_res", "real_page");  // 操作结果
data.put("opt_reason", "login");  // 操作原因
data.put("zid", "1");  // 大区ID，若游戏无大区概念，则填1作为初始大区编号
data.put("sid", "1");  // 大区的下一级，若游戏无服概念，则填1作为初始服编号
data.put("role_id", "1696674719");  // 角色ID，游戏内唯一（不同区服之间也不允许重复），建议纯数字。若游戏无角色概念，则填账号id
data.put("extend_param_json", "{\"kills\":\"0\",\"deaths\":\"0\",\"assistant\":\"0\"}");  // 扩展参数

/**
 * @param activity    上下文
 * @param eventName   事件名称
 * @param eventValue  事件数据
 */
DHSDKHelper.getInstance().getAnalysis().trackEvent(activity, "custom", data);

3、流程统计上报

警告

新版三合一接口，包括日志上报、adjust、Firebase

信息

eventName: 事件ID（运营提供），格式为：六位数字::字符串，如：000000::SDK_CLIENT_LAUNCH

eventValue: 必须包含三个必填字段(track_platform, log, log_level)和任意自定义键值对

流程统计及日志游戏启动就可以上报，无需调用SDK初始化，其他数据统计使用此接口需要SDK初始化。

import com.dh.DHSDKHelper;

import java.util.HashMap;

// 特别注意：参数值类型无特殊说明均为字符串
HashMap<String, Object> data = new HashMap<>();

// 必传参数
data.put("track_platform", "log"); // 固定
data.put("log", "dianhun test");  // 必填，自定义日志内容
data.put("log_level", "d");  // d：普通日志 or 流程统计；e：异常日志

// 可选参数
data.put("key", "value"); // 可选，自定义参数，key和value均可自定义

/**
 * @param activity    上下文
 * @param eventName   事件名称
 * @param eventValue  事件数据
 */
DHSDKHelper.getInstance().getAnalysis().trackEvent(activity, "000000::XXX_XXX_XXX", data);