1. MTA HTML5统计API文档

1.1. 通用

1.1.1. 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。

1.1.2. 返回参数说明

字段 含义
code 返回码
v2 表示当前api的版本号
class 提供的接口类别

1.1.3. 返回码示例

成功

{
    code:0,
    info:"success",
  -data:{
          -20160921:{
                  pv:"100492539",
                  uv:"8227032",
                  vv:"67535349",
                  iv:"9826284"
          }
      }
}

失败

{
    code:60002,
    info:"wrong sign",
    data:[]
}

1.2. 应用趋势

1.2.1. 应用历史趋势

（1）功能说明

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

（2）URL

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

（3）HTTP请求方式

POST

参数

类型 含义 备注
appid 整数 应用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数 

1.3. 访客分析

1.3.1. 实时访客

（1）功能说明

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

（2）URL

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

（3）HTTP请求方式

POST | GET

参数

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

1.3.2. 新老访客比

（1）功能说明

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

（2）URL

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

（3）HTTP请求方式

POST | GET

参数

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

1.3.3. 用户画像

（1）功能说明

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

（2）URL

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

（3）HTTP请求方式

POST | GET

参数

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

可查询指标

指标 指标解释 计算方式
sex 性别
age 年龄
grade 学历
profession 职业 -

1.4. 客户端分析

1.4.1. 地区数据

（1）功能说明

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

（2）URL

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

（3）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数 -

1.4.2. 省市数据

功能说明 按天查询省市下有流量的城市的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数 -

1.4.3. 运营商

（1）功能说明

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

（2）URL

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

（3）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数 -

1.4.4. 终端属性列表

（1）功能说明

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

（2）URL

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

（3）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数 -

1.4.5. 终端信息

（1）功能说明

按天查询终端信息数据。

（2）URL

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

（3）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数 -

1.5. 页面分析

1.5.1. 页面排行

（1）功能说明

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

（2）URL

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

（3）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数 -

1.5.2. 性能监控

（1）功能说明

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

（2）URL

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

（3）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 页面渲染时长 页面开始构建元素到全部展示的过程所消耗的时间

1.5.3. 访问深度

（1）功能说明

按天查询用户访问深度。

（2）URL

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

（3）HTTP请求方式

POST | GET

参数

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

1.6. 来源分析

1.6.1. 外部链接

（1）功能说明

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

（2）URL

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

（3）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数 -

1.6.2. 入口页面

（1）功能说明

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

（2）URL

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

（3）HTTP请求方式

POST | GET

参数

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

1.6.3. 离开页面

（1）功能说明

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

（2）URL

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

（3）HTTP请求方式

POST | GET

参数

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

1.7. 自定义事件

1.7.1. 自定义事件

（1）功能说明

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

（2）URL

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

（3）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数 -

1.8. 渠道效果统计

1.8.1. 渠道效果分析

（1）功能说明

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

（2）URL

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

（3）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数 -

1.9. 附录

1.9.1. 省市字典

省市 对应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

1.9.2. 市字典

市 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

1.9.3. 终端属性

终端名称 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

1.9.4. 性能监控

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

results matching ""

    No results matching ""