调用百度统计 API

百度统计为用户提供了 API 接入的方式,使得用户可以自定义 UI 而无须进入百度统计网站。百度统计存在两种账号体系:百度商业账号和百度账号,前者就是统计早期的用户账号,本文基于百度商业账号,说明如何接入统计 API。

  • 官方 API 文档:https://tongji.baidu.com/api/manual/
  • 白皮书:https://tongji.baidu.com/web/image/百度发布《网站分析白皮书V3.0》.pdf

通用请求头

接口的请求需要向相应 API 通过 POST 的方式发送 JSON 格式的数据,注意 JSON 数据放在请求的 RawBody 中,而不是一般的键对值得 POST 结构。该请求数据的结构分为两个部分,header 部分是用户信息,body 部分 : 对于不同的 API,body 部分有所不同。

String json = "{\"header\": "
		+ "{"
		+ "\"username\": \"xxxxx\", "
		+ "\"password\": \"xxxxx\","
		+ "\"token\": \"xxxx\","
		+ "\"account_type\": 1"
		+ "}"
		+ "}";

String html = HttpBasicRequest.post("https://api.baidu.com/json/tongji/v1/ReportService/getSiteList", json, conn -> {
	conn.addRequestProperty("Content-type", "application/json");
});

请求必须指定 Content-type 为 application/json,否则不能请求。

实现中我们把 header 用 map 定义,然后转换为 JSON 字符串,如下方法所示。

/**
 * 获取请求头
 * 
 * @return
 */
private static String getHeader() {
	Map<String, Object> header = new HashMap<String, Object>() {
		private static final long serialVersionUID = 1L;
		{
			put("username", ConfigService.get("baidu_tongji.api_username"));
			put("password", ConfigService.get("baidu_tongji.api_password"));
			put("token", ConfigService.get("baidu_tongji.api_token"));
			put("account_type", 1);
		}
	};

	return JsonHelper.stringifyMap(header);
}

接着可以传入不同业务需求的 body,body 也是 Map。

private static final String JSON = "{\"header\": %s, \"body\": %s}";

/**
 * 请求 API
 * 
 * @param body
 * @return
 */
private static String getData(Map<String, Object> body) {
	String req = String.format(JSON, getHeader(), JsonHelper.stringifyMap(body));
	String json = HttpBasicRequest.post("https://api.baidu.com/json/tongji/v1/ReportService/getData", req, conn -> {
		conn.addRequestProperty("Content-type", "application/json");
	});

	return "json::" + json;
}

然后进行请求,返回结果 JSON。

获取站点列表

一个百度统计账号下面可以有多个站点。接口 https://api.baidu.com/json/tongji/v1/ReportService/getSiteList 。关键的字段是 siteId,如果已知 siteId 则可不必请求该接口。

获取报告数据

这是核心的 API,接口是 https://api.baidu.com/json/tongji/v1/ReportService/getData 。在这个接口中根据不同的参数来获取各项的报告数据。具体是 body 的 method 字段。

获取网站概况:今日/昨天 pv/uv

用于概括性的提示,生成界面如下。

@GET
@Path("getTimeTrendRpt")
@Produces(MediaType.APPLICATION_JSON)
public String getTimeTrendRpt() {
	Date now = new Date();
	Calendar calendar = Calendar.getInstance();
	calendar.setTime(now);
	calendar.add(Calendar.DAY_OF_MONTH, -1);// 昨天

	String today = formater.format(now), yesterday = formater.format(calendar.getTime());

	Map<String, Object> body = new HashMap<String, Object>() {
		private static final long serialVersionUID = 1L;
		{
			put("site_id", ConfigService.get("baidu_tongji.siteId"));
			put("start_date", yesterday);
			put("end_date", today);
			put("method", "overview/getTimeTrendRpt");
			put("metrics", "pv_count,visitor_count,ip_count,bounce_ratio,avg_visit_time");
		}
	};

	return getData(body);
}

获取网站概况:来源网站、搜索词、入口页面、受访页面

生成界面如下(部分)。

默认是昨天、今天的数据。

@GET
@Path("getCommonTrackRpt")
@Produces(MediaType.APPLICATION_JSON)
public String getCommonTrackRpt() {
	Date now = new Date();
	Calendar calendar = Calendar.getInstance();
	calendar.setTime(now);
	calendar.add(Calendar.DAY_OF_MONTH, -1);// 昨天
	String today = formater.format(now), yesterday = formater.format(calendar.getTime());
	
	Map<String, Object> body = new HashMap<String, Object>() {
		private static final long serialVersionUID = 1L;
		{
			put("site_id", ConfigService.get("baidu_tongji.siteId"));
			put("start_date", yesterday);
			put("end_date", today);
			put("method", "overview/getCommonTrackRpt");
		}
	};

	return getData(body);
}

获取 pv/uv趋势图

获取趋势分析报告中 PV 和 UV 数据,按天粒度。

@GET
@Path("getTrend")
@Produces(MediaType.APPLICATION_JSON)
public String getTrend(@QueryParam("start_date") @NotNull String start_date, @QueryParam("end_date") @NotNull String end_date) {
	Map<String, Object> body = new HashMap<String, Object>() {
		private static final long serialVersionUID = 1L;
		{
			put("site_id", ConfigService.get("baidu_tongji.siteId"));
			put("start_date", start_date);
			put("end_date", end_date);
			put("method", "trend/time/a");
			put("metrics", "pv_count,visit_count");
			put("max_results", "0");
			put("gran", "day");
		}
	};

	return getData(body);
}

本系统基于 vue 的前端。这里需要一个图表组件展示用,我最开始使用 vue2-frappe,但不知为何,可能是样式冲突,加入我的样式就不显示了,DOM 是存在的,我不折腾这组件,于是改为另外一款轻量级的图表组件,更轻量级,而且是国人作品,是为 Laue(https://laue.js.org 、https://github.com/qingwei-li/laue) 。

参数设定

如下图所示
在这里插入图片描述

小结

当前并没有完全整合百度统计的所有 API,而是使用了其最重要的三个接口,在给用户一个初步的展示已经足够了。

展开阅读全文
©️2020 CSDN 皮肤主题: 岁月 设计师: pinMode 返回首页
实付0元
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、C币套餐、付费专栏及课程。

余额充值