MTA HTML5统计API文档

通用

sig生成算法

双方维护同一份私钥,在发起请求的时候,发起方(合作方)将当前的请求参数数组,按照key值进行排序,然后'key=value'拼接到加密串后,进行md5的编码。接收方(H5轻应用统计)以同样的处理方式,对ts<=30分钟的请求进行处理,sig一致则合法,否则失败。如下为php的对应的sig生成算法举例:

    $secret_key  =  '3023IU&^_W(5#@';
    ksort($params);
	foreach ($params as $key => $value) {
	    $secret_key.= $key.'='.$value;
	}
	$sign = md5($secret_key);
	return $sign; 


$params 为所有请求的参数数组,key为参数名,value为值。

secret_key为注册成功后每个app对应返回的secret_key。


返回参数说明

字段 含义
code 返回码
0代表成功,其他返回码代表失败
info 错误信息,code>0的时候,返回具体的错误信息。

data

 code为0的时候,返回接口对应的数据;

 code不为0的时候为空数组。




返回码示例

成功


失败



应用趋势

应用历史趋势

功能说明

应用每天的pv\uv\vv\iv数据。


URL

http://mta.qq.com/h5/api/ctr_core_data


HTTP请求方式

POST


参数


类型
含义
备注
app_id
整数
应用ID
应用注册时生成的ID。
start_date
字符串
开始时间
开始时间(Y-m-d)
end_date
字符串
结束时间
结束时间(Y-m-d)
idx
字符串
指标列表
可选值详见附录(指标字典),使用“,”间隔查询指标
sign
字符串
验证串
见示例生成过程

可查询指标

指标
指标解释
计算方式
pv
页面被打开的次数
个页面被打开一次,计为1次访问
uv
访客1天内去除重复访问次数

1天内相同访客访问次数只计1次访问

vv
访客1天内访问次数
从访客来到您网站到最终关闭网站的所有页面离开,计为1次访问
iv
1天内访问的IP数



访客分析

实时访客

功能说明

应用在24小时内的实时访客信息。


URL

http://mta.qq.com/h5/api/ctr_user_realtime


HTTP请求方式

POST | GET


参数


含义
备注
app_id
整数
应用ID
应用注册时生成的ID。
page
整数
页码
每页200条记录
sign
字符串
验证串
见示例生成过程
     



新老访客比

功能说明

按天查询当天新访客与旧访客的数量。


URL

http://mta.qq.com/h5/api/ctr_user_compare


HTTP请求方式

POST | GET


参数


类型
含义
备注
app_id
整数
应用ID
应用注册时生成的ID。
start_date
字符串
开始时间
开始时间(Y-m-d)
end_date
字符串
结束时间
结束时间(Y-m-d)
sign
字符串
验证串
见示例生成过程



用户画像

功能说明

在H5统计平台查询用户画像数据,包含性别比例、年龄分布、学历分布、职业分布。接口的数据为pv量。


URL

http://mta.qq.com/h5/api/ctr_user_portrait


HTTP请求方式

POST | GET


参数


类型
含义
备注
app_id
整数
应用ID
应用注册时生成的ID。
start_date
字符串
开始时间
开始时间(Y-m-d)
end_date
字符串
结束时间
结束时间(Y-m-d)
idx
字符串
指标列表
可选值详见附录(指标字典),使用“,”间隔查询指标
sign
字符串
验证串
见示例生成过程

可查询指标

指标
指标解释
计算方式
sex
性别

age
年龄
grade 学历
profession 职业


客户端分析         

地区数据

功能说明

按天查询地区的pv\uv\vv\iv量。


URL

http://mta.qq.com/h5/api/ctr_area/get_by_area


HTTP请求方式

POST | GET


参数


类型
含义
备注
app_id
整数
应用ID
应用注册时生成的ID。
type_ids
字符串
城市id
可选值详见附录(省市字典,市字典),使用“,”间隔多个
start_date
字符串
开始时间
开始时间(Y-m-d)
end_date
字符串
结束时间
结束时间(Y-m-d)
idx
字符串
指标列表
可选值详见附录(指标字典),使用“,”间隔查询指标
sign
字符串
验证串
见示例生成过程

可查询指标

指标
指标解释
计算方式
pv
页面被打开的次数
个页面被打开一次,计为1次访问
uv
访客1天内去除重复访问次数

1天内相同访客访问次数只计1次访问

vv
访客1天内访问次数
从访客来到您网站到最终关闭网站的所有页面离开,计为1次访问
iv
1天内访问的IP数



省市数据

功能说明

按天查询省市下有流量的城市的pv\uv\vv\iv量。


URL

http://mta.qq.com/h5/api/ctr_area/get_by_province


HTTP请求方式

POST | GET


参数


类型
含义
备注
app_id
整数
应用ID
应用注册时生成的ID。
type_ids
字符串
省市id
可选值详见附录(省字典,市字典),使用“,”间隔多个
start_date
字符串
开始时间
开始时间(Y-m-d)
end_date
字符串
结束时间
结束时间(Y-m-d)
idx
字符串
指标列表
可选值详见附录(指标字典),使用“,”间隔查询指标
sign
字符串
验证串
见示例生成过程

可查询指标

指标
指标解释
计算方式
pv
页面被打开的次数
个页面被打开一次,计为1次访问
uv
访客1天内去除重复访问次数

1天内相同访客访问次数只计1次访问

vv
访客1天内访问次数
从访客来到您网站到最终关闭网站的所有页面离开,计为1次访问
iv
1天内访问的IP数



运营商

功能说明

按天查询运营商的pv\uv\vv\iv量。


URL

http://mta.qq.com/h5/api/ctr_operator


HTTP请求方式

POST | GET


参数


类型
含义
备注
app_id
整数
应用ID
应用注册时生成的ID。
start_date
字符串
开始时间
开始时间(Y-m-d)
end_date
字符串
结束时间
结束时间(Y-m-d)
type_ids 字符串 运营商ID
可选值详见附录(运营商),使用“,”间隔查询id
idx
字符串
指标列表
可选值详见附录(指标字典),使用“,”间隔查询指标
sign
字符串
验证串
见示例生成过程

可查询指标

指标
指标解释
计算方式
pv
页面被打开的次数
个页面被打开一次,计为1次访问
uv
访客1天内去除重复访问次数

1天内相同访客访问次数只计1次访问

vv
访客1天内访问次数
从访客来到您网站到最终关闭网站的所有页面离开,计为1次访问
iv
1天内访问的IP数



终端属性列表

功能说明

按天查询对应属性的终端信息数据。


URL

http://mta.qq.com/h5/api/ctr_client/get_by_para


HTTP请求方式

POST | GET


参数


类型
含义
备注
app_id
整数
应用ID
应用注册时生成的ID。
start_date
字符串
开始时间
开始时间(Y-m-d)
end_date
字符串
结束时间
结束时间(Y-m-d)
type_id 整数 终端属性
可选值详见附录(终端属性)
idx
字符串
指标列表
可选值详见附录(指标字典),使用“,”间隔查询指标
sign
字符串
验证串
见示例生成过程

可查询指标

指标
指标解释
计算方式
pv
页面被打开的次数
个页面被打开一次,计为1次访问
uv
访客1天内去除重复访问次数

1天内相同访客访问次数只计1次访问

vv
访客1天内访问次数
从访客来到您网站到最终关闭网站的所有页面离开,计为1次访问
iv
1天内访问的IP数



终端信息

功能说明

按天查询终端信息数据。


URL

http://mta.qq.com/h5/api/ctr_client/get_by_content


HTTP请求方式

POST | GET 


参数


类型
含义
备注
app_id
整数
应用ID
应用注册时生成的ID。
start_date
字符串
开始时间
开始时间(Y-m-d)
end_date
字符串
结束时间
结束时间(Y-m-d)
type_id 整数 终端属性
可选值详见附录(终端属性)
type_contents
字符串 终端名称 可选值为终端属性列表返回的client值,必须经过url编码,使用“,”间隔查询
idx
字符串
指标列表
可选值详见附录(指标字典),使用“,”间隔查询指标
sign
字符串
验证串
见示例生成过程

可查询指标

指标
指标解释
计算方式
pv
页面被打开的次数
个页面被打开一次,计为1次访问
uv
访客1天内去除重复访问次数

1天内相同访客访问次数只计1次访问

vv
访客1天内访问次数
从访客来到您网站到最终关闭网站的所有页面离开,计为1次访问
iv
1天内访问的IP数



页面分析

页面排行

功能说明

按天查询url的pv\uv\vv\iv数据。


URL

http://mta.qq.com/h5/api/ctr_page


HTTP请求方式

POST | GET


参数


类型
含义
备注
app_id
整数
应用ID
应用注册时生成的ID。
start_date
字符串
开始时间
开始时间(Y-m-d)
end_date
字符串
结束时间
结束时间(Y-m-d)
urls 字符串 url地址
url地址,多个使用逗号“,”间隔,必须经过url编码
idx
字符串
指标列表
可选值详见附录(指标字典),使用“,”间隔查询指标
sign
字符串
验证串
见示例生成过程

可查询指标

指标
指标解释
计算方式
pv
页面被打开的次数
个页面被打开一次,计为1次访问
uv
访客1天内去除重复访问次数

1天内相同访客访问次数只计1次访问

vv
访客1天内访问次数
从访客来到您网站到最终关闭网站的所有页面离开,计为1次访问
iv
1天内访问的IP数



性能监控

功能说明

按天查询对应省市的访问延时与解析时长。


URL

http://mta.qq.com/h5/api/ctr_page_speed


HTTP请求方式

POST | GET


参数


类型
含义
备注
app_id
整数
应用ID
应用注册时生成的ID。
start_date
字符串
开始时间
开始时间(Y-m-d)
end_date
字符串
结束时间
结束时间(Y-m-d)
type_contents
字符串
省市id/运营商id/页面地址

省市可选值详见附录(省市);

运营商可选值详见附录(运营商);

页面url需要url编码;

使用“,”间隔查询

type 字符串 类别 可选值详见附录(性能监控)
idx
字符串
指标列表
可选值详见附录(指标字典),使用“,”间隔查询指标
sign
字符串
验证串
见示例生成过程

可查询指标

指标
指标解释
计算方式
visitor_speed
访问延时
用户访问总时长的的平均值
dns_speed
DNS解析时长

域名服务器解析时间

tcp_speed
TCP链接时长
TCP与服务器端建立连接花费时长
request_speed
首字节时长
接收到服务器响应再减去发出HTTP请求的时间
resource_speed
资源下载时长
页面所有onload计算范围内的资源加载结束后到文档开始进行dom对象解析的时间
dom_speed
页面渲染时长
页面开始构建元素到全部展示的过程所消耗的时间



访问深度

功能说明

按天查询用户访问深度。


URL

http://mta.qq.com/h5/api/ctr_depth


HTTP请求方式

POST | GET


参数



类型
含义
备注
app_id
整数
应用ID
应用注册时生成的ID。
start_date
字符串
开始时间
开始时间(Y-m-d)
end_date
字符串
结束时间
结束时间(Y-m-d)
sign
字符串
验证串
见示例生成过程



来源分析

外部链接

功能说明

按天查询外部同站链接带来的流量情情况。


URL

http://mta.qq.com/h5/api/ctr_source_out


HTTP请求方式

POST | GET


参数


类型
含义
备注
app_id
整数
应用ID
应用注册时生成的ID。
urls 字符串 url地址 url地址,多个使用逗号“,”间隔,必须经过url编码。
start_date
字符串
开始时间
开始时间(Y-m-d)
end_date
字符串
结束时间
结束时间(Y-m-d)
idx
字符串
指标列表
可选值详见附录(指标字典),使用“,”间隔查询指标
sign
字符串
验证串
见示例生成过程

可查询指标

指标
指标解释
计算方式
pv
页面被打开的次数
个页面被打开一次,计为1次访问
uv
访客1天内去除重复访问次数

1天内相同访客访问次数只计1次访问

vv
访客1天内访问次数
从访客来到您网站到最终关闭网站的所有页面离开,计为1次访问
iv
1天内访问的IP数



入口页面

功能说明

按天查询用户最后访问的进入次数与跳出率。


URL

http://mta.qq.com/h5/api/ctr_page_land


HTTP请求方式

POST | GET


参数


类型
含义
备注
app_id
整数
应用ID
应用注册时生成的ID。
urls 字符串 url地址 url地址,多个使用逗号“,”间隔,必须经过url编码。
start_date
字符串
开始时间
开始时间(Y-m-d)
end_date
字符串
结束时间
结束时间(Y-m-d)
sign
字符串
验证串
见示例生成过程



离开页面

功能说明

按天查询最后访问页面的离次数。


URL

http://mta.qq.com/h5/api/ctr_page_exit


HTTP请求方式

POST | GET


参数


类型
含义
备注
app_id
整数
应用ID
应用注册时生成的ID。
urls 字符串 url地址 url地址,多个使用逗号“,”间隔,必须经过url编码。
start_date
字符串
开始时间
开始时间(Y-m-d)
end_date
字符串
结束时间
结束时间(Y-m-d)
sign
字符串
验证串
见示例生成过程





自定义事件

自定义事件

功能说明

按天查询自定义事件的pv\uv\vv\iv。


URL

http://mta.qq.com/h5/api/ctr_custom


HTTP请求方式

POST | GET


参数


类型
含义
备注
app_id
整数
应用ID
应用注册时生成的ID。
custom
字符串
自定义事件id

多个自定义事件ID需使用逗号“,”间隔,必须经过url编码。

start_date
字符串
开始时间
开始时间(Y-m-d)
end_date
字符串
结束时间
结束时间(Y-m-d)
idx
字符串
指标列表
可选值详见附录(指标字典),使用“,”间隔查询指标
sign
字符串
验证串
见示例生成过程

可查询指标

指标
指标解释
计算方式
pv
页面被打开的次数
个页面被打开一次,计为1次访问
uv
访客1天内去除重复访问次数

1天内相同访客访问次数只计1次访问

vv
访客1天内访问次数
从访客来到您网站到最终关闭网站的所有页面离开,计为1次访问
iv
1天内访问的IP数



渠道效果统计

渠道效果分析

功能说明

按天查询渠道的分析数据。


URL

http://mta.qq.com/h5/api/ctr_adtag


HTTP请求方式

POST | GET


参数


类型
含义
备注
app_id
整数
应用ID
应用注册时生成的ID。
start_date
字符串
开始时间
开始时间(Y-m-d)
end_date
字符串
结束时间
结束时间(Y-m-d)
adtags 字符串 渠道id
多个使用逗号间隔“,”如:weixin,weixin.p1.p2。必须经过url编码
idx
字符串
指标列表
可选值详见附录(指标字典),使用“,”间隔查询指标
sign
字符串
验证串
见示例生成过程

可查询指标

指标
指标解释
计算方式
pv
页面被打开的次数
个页面被打开一次,计为1次访问
uv
访客1天内去除重复访问次数

1天内相同访客访问次数只计1次访问

vv
访客1天内访问次数
从访客来到您网站到最终关闭网站的所有页面离开,计为1次访问
iv
1天内访问的IP数



附录

省市字典

省市 对应ID
全国 -1
北京 10
上海 11
天津 12
重庆 13
香港 14
澳门 15
河北省 16
山西省 17
内蒙古 18
辽宁省 19
吉林省 20
黑龙江省 21
江苏省 22
浙江省 23
安徽省 24
福建省 25
江西省 26
山东省 27
河南省 28
湖北省 29
湖南省 30
广东省 31
广西省 32
海南省 33
四川省 34
贵州省 35
云南省 36
西藏 37
陕西省 38
甘肃省 39
青海省 40
宁夏省 41
新疆 42
台湾省 43


市字典

ID ID ID ID
石家庄 1601 乌兰察布
1813 牡丹江 2108 天台 2316
沧州
1602 兴安盟 1814 七台河 2109 温岭
2317
承德
1603 巴彦淖尔 1815 双鸭山
2110 仙居
2318
秦皇岛
1604 锡林郭勒盟
1816 齐齐哈尔
2111 台州
2319
唐山
1605 阿拉善盟
1817 伊春
2112 嘉兴
2320
保定
1606 沈阳
1901 绥化
2113 湖州
2321
廊坊
1607 大连
1902 南京
2201 衢州
2322
邢台
1608 本溪
1903 苏州
2202 金华
2323
衡水
1609 阜新
1904 扬州
2203 合肥
2401
张家口
1610 葫芦岛
1905 无锡
2204 黄山
2402
邯郸
1611 盘锦
1906 南通
2205 芜湖
2403
任丘
1612 铁岭
1907 常州
2206 蚌埠
2404
太原
1701 丹东
1908 连云港
2207 淮南
2405
长治 1702 锦州
1909 徐州
2208 马鞍山
2406
大同 1703 营口
1910 镇江
2209 淮北
2407
阳泉 1704 鞍山
1911 淮安
2210 铜陵
2408
朔州 1705 辽阳
1912 宿迁
2211 安庆
2409
临汾 1706 抚顺
1913 泰州
2212 滁州
2410
晋城 1707 朝阳
1914 太仓
2213 阜阳
2411
沂州 1708 长春
2001 盐城
2214 宿州
2412
运城 1709 白城
2002 杭州
2301 巢湖
2413
晋中 1710 白山
2003 宁波
2302 六安
2414
吕梁 1711 吉林
2004 温州
2303 亳州
2415
呼和浩特 1801 辽源
2005 丽水
2304 池州
2416
包头 1802 四平
2006 奉化
2305 宣城
2417
赤峰 1803 通化
2007 宁海
2306 福州
2501
鄂尔多斯 1804 松原
2008 临海
2307 厦门
2502
呼伦贝尔 1805 延边
2009 三门
2308 泉州
2503
临河 1806 哈尔滨
2101 绍兴
2309 漳州
2504
阿拉善左旗 1807 大庆
2102 舟山
2310 三明
2505
乌兰浩特 1808 大兴安岭
2103 义乌
2311 莆田
2506
通辽 1809 鹤岗
2104 北仑
2312 南平
2507
乌海 1810 黑河
2105 慈溪
2313 龙岩
2508
集宁
1811 鸡西
2106 象山
2314 宁德
2509
锡林浩特 1812 佳木斯
2107 余姚
2315 南昌
2601


ID ID ID ID
九江
2602 驻马店
2809 岳阳
3009 贺州
3206
赣州
2603 商丘
2810 常德
3010 玉林
3207
景德镇
2604 新乡
2811 益阳
3011 河池
3208
萍乡
2605 信阳
2812 永州
3012 桂林
3209
新余
2606 许昌
2813 怀化
3013 钦州
3210
吉安
2607 周口
2814 娄底
3014 防城港
3211
宜春
2608 南阳
2815 吉首
3015 贵港
3212
抚州
2609 洛阳
2816 湘西
3016 来宾
3213
上饶
2610 平顶山
2817 云浮
3101 崇左
3214
鹰潭
2611 漯河
2818 广州
3102 海口
3301
济南
2701 武汉
2901 深圳
3103 三亚
3302
青岛
2702 十堰
2902 珠海
3104 五指山
3303
烟台
2703 宜昌
2903 东莞
3105 琼海
3304
威海
2704 黄石
2904 佛山
3106 儋州
3305
潍坊
2705 襄樊
2905 潮州
3107 文昌
3306
德州
2706 荆州
2906 番禺
3108 万宁
3307
滨州
2707 荆门
2907 汕头
3109 东方
3308
东营
2708 鄂州
2908 湛江
3110 临高县
3309
聊城
2709 孝感
2909 中山
3111 乐东黎族自治县
3310
菏泽
2710 黄冈
2910 惠州
3112 保亭黎族苗族自治县
3311
济宁
2711 咸宁
2911 河源
3113 定安县
3312
临沂
2712 随州
2912 韶关
3114 屯昌县
3313
淄博
2713 恩施
2913 梅州
3115 昌江黎族自治县
3314
泰安
2714 仙桃
2914 汕尾
3116 澄迈县
3315
枣庄
2715 天门
2915 江门
3117 琼中黎族苗族自治县
3316
日照
2716 潜江
2916 阳江
3118 白沙黎族自治县
3317
莱芜
2717 神农架林区
2917 茂名
3119 陵水黎族自治县
3318
郑州
2801 长沙
3001 肇庆
3120 成都
3401
安阳
2802 张家界
3002 清远
3121 内江
3402
济源
2803 株洲
3003 揭阳
3122 峨眉山
3403
鹤壁
2804 韶山
3004 南宁
3201 绵阳
3404
焦作
2805 衡阳
3005 柳州
3202 宜宾
3405
开封
2806 郴州
3006 北海
3203 泸州
3406
濮阳
2807 湘潭
3007 百色
3204 攀枝花
3407
三门峡
2808 邵阳
3008 梧州
3205 自贡
3408

ID ID ID ID
资阳
3409 思茅
3609 庆阳
3909 伊犁
4217
崇州
3410 临沧
3610 定西
3910 克孜勒苏柯
4218
德阳
3411 丽江
3611 陇南
3911 博尔塔拉
4219
南充
3412 文山
3612 临夏
3912 塔城
4220
广元
3413 个旧
3613 甘南
3913 巴音郭楞
4221
遂宁
3414 楚雄
3614 金昌
3914 阿勒泰
4222
乐山
3415 德宏
3615 西宁
4001 台北
4301
广安
3416 怒江
3616 海东
4002 台中
4302
达州
3417 红河
3617 海北
4003 台南
4303
巴中
3418 迪庆
3618 黄南
4004 高雄
4304
雅安
3419 林芝
3701 果洛
4006 云林
4305
眉山
3420 拉萨
3702 海西
4007 南投
4306
阿坝
3421 那曲
3703 玉树
4008 台东
4307
甘孜
3422 昌都
3704 海南
4009 嘉义
4308
凉山
3423 山南
3705 银川
4101 基隆
4309
贵阳
3501 日喀则
3706 石嘴山
4102 宜兰
4310
六盘水
3502 阿里
3707 吴忠
4103 屏东
4311
遵义
3503 西安
3801 固原
4104 彰化
4312
安顺
3504 宝鸡
3802 中卫
4105 新竹
4314
铜仁
3505 铜川
3803 乌鲁木齐
4201 桃园
4314
毕节
3506 咸阳
3804 克拉玛依
4202 澎湖
4315
兴义
3507 渭南
3805 石河子
4203 花莲
4316
凯里
3508 延安
3806 图木舒克
4204 苗栗
4317
都匀
3509 汉中
3807 吐鲁番
4205

黔东南
3510 榆林
3808 哈密
4206

黔南
3511 安康
3809 和田
4207

黔西南
3512 商洛
3810 喀什
4208

香格里拉
3601 兰州
3901 昌吉
4209

昆明
3602 白银
3902 阿图什
4210

西双版纳
3603 天水
3903 库尔勒
4211

大理
3604 嘉峪关
3904 博乐
4212

曲靖
3605 武威
3905 伊宁
4213

玉溪
3606 张掖
3906 阿拉尔
4214

保山
3607 平凉
3907 阿克苏
4215

昭通
3608 酒泉
3908 五家渠
4216

终端属性

终端名称 type_id
浏览器 1
操作系统 2
分辨率 4
屏幕颜色 5
语言 6
时区 9
平台 10

运营商

运营商 type_id
电信 1
联通 2
移动 3
长城宽带 4
铁通 5
教育 6
天威 7
电信通 8
网通 9
香港运营商 10
方正 11
歌华有线 12
东方有线 13
其他 0

性能监控

运营商 type_id
省市 area
proxy
页面测速 url


目录

回到顶部