在开发个人博客的时候，用到了腾讯移动分析(mta)，相比其他数据统计平台来说我喜欢她的简洁高效，易上手，同时文档也比较全面，提供了数据接口供用户调用。
在看了mta演示demo和后，我就决定使用 .net core将其html5统计api进行封装，以供博客直接调用，省去各种鉴权生成sign的操作。
首先需要在mta官网进行html5应用创建，当然她还支持小程序和移动app。
然后就可以看到如上图的应用管理界面，如果你不打算使用其api接口，直接拿到统计代码嵌入在自己网站中即可，不出意外10分钟左右即可查看网站部分指标的实时数据，次日可以查看昨日的全部数据。
接下来继续，在调用mta接口之前需要先生成sign，
双方维护同一份私钥，在发起请求的时候，发起方(合作方)将当前的请求参数数组，按照key值进行排序，然后’key=value’拼接到加密串后，进行md5的编码。接收方以同样的处理方式，对ts小于或等于30分钟的请求进行处理，sign一致则合法，否则失败。
有了这段算法描述，利用c#代码实现如下：
/// <summary>
/// 生成sign
/// </summary>
/// <param name="keyvalues"></param>
/// <returns></returns>
public static string ggeneratesign(this dictionary<string, string> keyvalues)
{
keyvalues.add("app_id", mtaconfig.app_id);
idictionary<string, string> sortedparams = new sorteddictionary<string, string>(keyvalues);
var iterator = sortedparams.getenumerator();
var sb = new stringbuilder();
while (iterator.movenext())
{
var key = iterator.current.key;
var value = iterator.current.value;
if (key.isnotnullorempty() && value.isnotnullorempty())
{
sb.append(key).append("=").append(value);
}
}
return (mtaconfig.secret_key + sb.tostring()).md5();
}
将参数放入一个字典，并按照key值进行排序。因为所有接口都需要参数app_id，所以将其默认添加进去，不在额外当做参数。
.md5()是一个扩展方法，将字符串按照md5方式加密
拿到sign后就可以调用接口了，因为是封装，那么将所有接口都保存为静态变量，代码如下
#region 应用趋势 /// <summary> /// 应用历史趋势 /// 每天的pv\uv\vv\iv数据 /// </summary> public static string ctr_core_data = "https://mta.qq.com/h5/api/ctr_core_data"; /// <summary> /// 应用实时小时数据 /// 当天每小时的pv\uv\vv\iv数据 /// </summary> public static string ctr_realtime = "https://mta.qq.com/h5/api/ctr_realtime/get_by_hour"; /// <summary> /// 应用心跳数据 /// 当前pv\uv\vv\iv心跳数据数据 /// </summary> public static string ctr_realtime_heartbeat = "https://mta.qq.com/h5/api/ctr_realtime/heartbeat"; #endregion #region 访客分析 /// <summary> /// 实时访客 /// 在24小时内的实时访客信息 /// </summary> public static string ctr_user_realtime = "https://mta.qq.com/h5/api/ctr_user_realtime"; /// <summary> /// 新老访客比 /// 按天查询当天新访客与旧访客的数量 /// </summary> public static string ctr_user_compare = "https://mta.qq.com/h5/api/ctr_user_compare"; /// <summary> /// 用户画像 /// 查询用户画像数据，包含性别比例、年龄分布、学历分布、职业分布，数据为pv量 /// </summary> public static string ctr_user_portrait = "https://mta.qq.com/h5/api/ctr_user_portrait"; #endregion #region 客户端分析 /// <summary> /// 地区数据 /// 按天查询地区的pv\uv\vv\iv量 /// </summary> public static string ctr_area = "https://mta.qq.com/h5/api/ctr_area/get_by_area"; /// <summary> /// 省市数据 /// 按天查询省市下有流量的城市的pv\uv\vv\iv量 /// </summary> public static string ctr_area_province = "https://mta.qq.com/h5/api/ctr_area/get_by_province"; /// <summary> /// 运营商 /// 按天查询运营商的pv\uv\vv\iv量 /// </summary> public static string ctr_operator = "https://mta.qq.com/h5/api/ctr_operator"; /// <summary> /// 终端属性列表 /// 按天查询对应属性的终端信息数据 /// </summary> public static string ctr_client_para = "https://mta.qq.com/h5/api/ctr_client/get_by_para"; /// <summary> /// 终端信息 /// 按天查询终端信息数据 /// </summary> public static string ctr_client_content = "https://mta.qq.com/h5/api/ctr_client/get_by_content"; #endregion #region 页面分析 /// <summary> /// 页面排行-当天实时列表 /// 查询当天所有url的pv\uv\vv\iv数据 /// </summary> public static string ctr_page_realtime = "https://mta.qq.com/h5/api/ctr_page/list_all_page_realtime"; /// <summary> /// 页面排行-离线列表 /// 按天查询所有url的pv\uv\vv\iv数据 /// </summary> public static string ctr_page_offline = "https://mta.qq.com/h5/api/ctr_page/list_all_page_offline"; /// <summary> /// 页面排行-指定查询部分url /// 按天查询url的pv\uv\vv\iv数据。 /// </summary> public static string ctr_page_url = "https://mta.qq.com/h5/api/ctr_page"; /// <summary> /// 性能监控 /// 按天查询对应省市的访问延时与解析时长 /// </summary> public static string ctr_page_speed = "https://mta.qq.com/h5/api/ctr_page_speed"; /// <summary> /// 访问深度 /// 按天查询用户访问深度 /// </summary> public static string ctr_page_depth = "https://mta.qq.com/h5/api/ctr_depth"; #endregion #region 来源分析 /// <summary> /// 外部链接 /// 按天查询外部同站链接带来的流量情情况 /// </summary> public static string ctr_source_out = "https://mta.qq.com/h5/api/ctr_source_out"; /// <summary> /// 入口页面 /// 按天查询用户最后访问的进入次数与跳出率 /// </summary> public static string ctr_page_land = "https://mta.qq.com/h5/api/ctr_page_land"; /// <summary> /// 离开页面 /// 按天查询最后访问页面的离次数 /// </summary> public static string ctr_page_exit = "https://mta.qq.com/h5/api/ctr_page_exit"; #endregion #region 自定义事件 /// <summary> /// 自定义事件 /// 按天查询自定义事件的pv\uv\vv\iv /// </summary> public static string ctr_custom = "https://mta.qq.com/h5/api/ctr_custom"; #endregion #region 渠道效果统计 /// <summary> /// 渠道效果统计 /// 按天查询渠道的分析数据 /// </summary> public static string ctr_adtag = "https://mta.qq.com/h5/api/ctr_adtag"; #endregion
接下来对照文档生成url的查询参数，然后访问接口拿到返回数据
/// <summary>
/// 生成url查询参数
/// </summary>
/// <param name="keyvalues"></param>
/// <returns></returns>
public static string ggeneratequery(this dictionary<string, string> keyvalues)
{
var sign = keyvalues.ggeneratesign();
var query = "?";
keyvalues.foreach(x =>
{
query += $"{x.key}={x.value}&";
});
return $"{query}sign={sign}";
}
/// <summary>
/// 获取mta接口返回数据
/// </summary>
/// <param name="keyvalues"></param>
/// <returns></returns>
public static async task<string> getmtadata(this dictionary<string, string> keyvalues, string api)
{
var url = $"{api}{keyvalues.ggeneratequery()}";
// hwrequest()和hwrequestresult()是扩展方法，可以选择自己熟悉http请求方法
var hwr = url.hwrequest();
string result = hwr.hwrequestresult();
return await task.fromresult(result);
}
到这里基本上就结束了，只需对照mta文档传入对应的参数即可拿到返回的数据了。
以其中一个接口为例，应用历史趋势，获取每天的pv、uv、vv、iv数据
/// <summary>
/// 应用历史趋势
/// 每天的pv\uv\vv\iv数据
/// </summary>
/// <param name="start_date">开始时间（y-m-d）</param>
/// <param name="end_date">结束时间（y-m-d）</param>
/// <param name="idx">查询指标(pv,uv,vv,iv)，使用“,”间隔</param>
/// <returns></returns>
public async task<string> ctr_core_data(string start_date, string end_date, string idx)
{
var keyvalues = new dictionary<string, string>
{
{ "start_date", start_date },
{ "end_date", end_date },
{ "idx", idx }
};
return await keyvalues.getmtadata(mtaconfig.ctr_core_data);
}
在controller中进行调用
/// <summary>
/// 应用历史趋势
/// 每天的pv\uv\vv\iv数据
/// </summary>
/// <param name="start_date">开始时间（y-m-d）</param>
/// <param name="end_date">结束时间（y-m-d）</param>
/// <param name="idx">查询指标(pv,uv,vv,iv)，使用“,”间隔</param>
/// <returns></returns>
[httpget]
[route("ctr_core_data")]
public async task<dynamic> ctr_core_data(string start_date, string end_date, string idx)
{
var result = await _mtaservice.ctr_core_data(start_date, end_date, idx);
return result.deserializefromjson<dynamic>();
}
查询结果看下图
详细代码可参考：https://github.com/meowv/blog/tree/master/src/meowvblog.mta
黄山市民网：https://www.huangshanshimin.com/
