数据统计接口-消息分析数据接口
创始人
2025-01-10 14:01:12
0次

微信公众平台于2015年1月6日启动了数据接口的邀请内测。通过数据接口,开发者可以获取与公众平台官网统计模块类似但更灵活的数据,还可根据需要进行高级处理。

邀请内测期间,为保证服务质量,数据接口仅向第三方平台开发者开放。在微信开放平台接入公众号登录授权即可成为第三方平台开发者,第三方平台可帮助运营者管理公众号,帮助已授权公众号调用数据接口。在公众号登录授权机制的权限集划分中,消息分析数据接口属于消息与菜单权限集。

向所有公众号开发者开放数据接口的时间将另行通知。

请注意:

1、接口侧的公众号数据的数据库中仅存储了2014年12月1日之后的数据,将查询不到在此之前的日期,即使有查到,也是不可信的脏数据;
2、请开发者在调用接口获取数据后,将数据保存在自身数据库中,即加快下次用户的访问速度,也降低了微信侧接口调用的不必要损耗。

消息分析数据接口指的是用于获得公众平台官网数据统计模块中消息分析数据的接口,具体接口列表如下(暂无消息关键词数据接口):

接口名称 ***时间跨度 接口调用地址(必须使用https)
获取消息发送概况数据(getupstreammsg) 7 https://api.weixin.qq.com/datacube/getupstreammsg?access_token=ACCESS_TOKEN
获取消息分送分时数据(getupstreammsghour) 1 https://api.weixin.qq.com/datacube/getupstreammsghour?access_token=ACCESS_TOKEN
获取消息发送周数据(getupstreammsgweek) 30 https://api.weixin.qq.com/datacube/getupstreammsgweek?access_token=ACCESS_TOKEN
获取消息发送月数据(getupstreammsgmonth) 30 https://api.weixin.qq.com/datacube/getupstreammsgmonth?access_token=ACCESS_TOKEN
获取消息发送分布数据(getupstreammsgdist) 15 https://api.weixin.qq.com/datacube/getupstreammsgdist?access_token=ACCESS_TOKEN
获取消息发送分布周数据(getupstreammsgdistweek) 30 https://api.weixin.qq.com/datacube/getupstreammsgdistweek?access_token=ACCESS_TOKEN
获取消息发送分布月数据(getupstreammsgdistmonth) 30 https://api.weixin.qq.com/datacube/getupstreammsgdistmonth?access_token=ACCESS_TOKEN

***时间跨度是指一次接口调用时***可获取数据的时间范围,如***时间跨度为7是指最多一次性获取7天的数据。access_token的实际值请通过“获取access_token”来获取。

关于周数据与月数据,请注意:每个月/周的周期数据的数据标注日期在当月/当周的***天(当月1日或周一)。在某一月/周过后去调用接口, 才能获取到该周期的数据。比如,在12月1日以(11月1日-11月5日)作为(begin_date和end_date)调用获取月数据接口,可以获取 到11月1日的月数据(即11月的月数据)。

接口调用请求说明

消息分析数据接口(包括接口列表中的所有接口)需要向相应接口调用地址POST以下示例数据包:

{ 
    "begin_date": "2014-12-07", 
    "end_date": "2014-12-08"
}

调用参数说明

参数 是否必须 说明
access_token 是 调用接口凭证
begin_date 是 获取数据的起始日期,begin_date和end_date的差值需小于“***时间跨度”(比如***时间跨度为1时,begin_date和end_date的差值只能为0,才能小于1),否则会报错
end_date 是 获取数据的结束日期,end_date允许设置的***值为昨日

返回说明

获取消息发送概况数据接口需要向相应接口调用地址POST以下数据包:


  1. {  
  2.    "list": [  
  3.        {  
  4.            "ref_date": "2014-12-07",  
  5.            "msg_type": 1,  
  6.            "msg_user": 282,  
  7.            "msg_count": 817 
  8.        } 
  9.     //后续还有同一ref_date的不同msg_type的数据,以及不同ref_date(在时间范围内)的数据 
  10.    ] 
  11. } 

获取消息分送分时数据接口需要向相应接口调用地址POST以下数据包:

 
  1. {  
  2.    "list": [  
  3.        {  
  4.            "ref_date": "2014-12-07",  
  5.            "ref_hour": 0,  
  6.            "msg_type": 1,  
  7.            "msg_user": 9,  
  8.            "msg_count": 10 
  9.        } 
  10.     //后续还有同一ref_hour的不同msg_type的数据,以及不同ref_hour的数据,ref_date固定,因为***时间跨度为1 
  11.    ] 
  12. } 
  13.  
  14. 获取消息发送周数据接口的返回JSON数据包如下: 
  15.  
  16. {  
  17.    "list": [  
  18.        {  
  19.            "ref_date": "2014-12-08",  
  20.            "msg_type": 1,  
  21.            "msg_user": 16,  
  22.            "msg_count": 27 
  23.        } 
  24.         //后续还有同一ref_date下不同msg_type的数据,及不同ref_date的数据 
  25.    ] 
  26. } 

获取消息发送月数据接口的返回JSON数据包如下:


  1. {  
  2.    "list": [  
  3.        {  
  4.            "ref_date": "2014-11-01",  
  5.            "msg_type": 1,  
  6.            "msg_user": 7989,  
  7.            "msg_count": 42206 
  8.        } 
  9.     //后续还有同一ref_date下不同msg_type的数据,及不同ref_date的数据 
  10.    ] 
  11. } 

获取消息发送分布数据接口的返回JSON数据包如下:


  1. {  
  2.    "list": [  
  3.        {  
  4.            "ref_date": "2014-12-07",  
  5.            "count_interval": 1,  
  6.            "msg_user": 246 
  7.        } 
  8.     //后续还有同一ref_date下不同count_interval的数据,及不同ref_date的数据 
  9.    ] 
  10. } 

获取消息发送分布周数据接口的返回JSON数据包如下:


  1. {  
  2.    "list": [  
  3.        {  
  4.            "ref_date": "2014-12-07",  
  5.            "count_interval": 1,  
  6.            "msg_user": 246 
  7.        } 
  8.     //后续还有同一ref_date下不同count_interval的数据,及不同ref_date的数据 
  9.    ] 
  10. } 

获取消息发送分布月数据接口的返回JSON数据包如下:


  1. {  
  2.    "list": [  
  3.        {  
  4.            "ref_date": "2014-12-07",  
  5.            "count_interval": 1,  
  6.            "msg_user": 246 
  7.        } 
  8.     //后续还有同一ref_date下不同count_interval的数据,及不同ref_date的数据 
  9.    ] 
  10. } 

返回参数说明

参数 说明
ref_date 数据的日期,需在begin_date和end_date之间
ref_hour 数据的小时,包括从000到2300,分别代表的是[000,100)到[2300,2400),即每日的第1小时和***1小时
msg_type 消息类型,代表含义如下:

1代表文字 2代表图片 3代表语音 4代表视频 6代表第三方应用消息(链接消息)

msg_user 上行发送了(向公众号发送了)消息的用户数
msg_count 上行发送了消息的消息总数
count_interval 当日发送消息量分布的区间,0代表 “0”,1代表“1-5”,2代表“6-10”,3代表“10次以上”
int_page_read_count 图文页的阅读次数
ori_page_read_user 原文页(点击图文页“阅读原文”进入的页面)的阅读人数,无原文页时此处数据为0

错误时微信会返回错误码等信息,具体错误码查询,请见:全局返回码说明

相关内容

热门资讯

PHP新手之PHP入门 PHP是一种易于学习和使用的服务器端脚本语言。只需要很少的编程知识你就能使用PHP建立一个真正交互的...
网络中立的未来 网络中立性是什... 《牛津词典》中对“网络中立”的解释是“电信运营商应秉持的一种原则,即不考虑来源地提供所有内容和应用的...
各种千兆交换机的数据接口类型详... 千兆交换机有很多值得学习的地方,这里我们主要介绍各种千兆交换机的数据接口类型,作为局域网的主要连接设...
粉嫩如何诠释霸道 东芝M805... “霸道粉”是个什么玩意东芝M805拿过来的时候,笔者扑哧笑了,不是笑这款笔记本,而是笑这款产品的颜色...
如何利用交换机和端口设置来管理... 在网络管理中,总是有些人让管理员头疼。下面我们就将介绍一下一个网管员利用交换机以及端口设置等来进行D...
什么是大数据安全 什么是大数据... 在《为什么需要大数据安全分析》一文中,我们已经阐述了一个重要观点,即:安全要素信息呈现出大数据的特征...
全面诠释网络负载均衡 负载均衡的出现大大缓解了服务器的压力,更是有效的利用了资源,提高了效率。那么我们现在来说一下网络负载...
如何允许远程连接到MySQL数... [[277004]]【51CTO.com快译】默认情况下,MySQL服务器仅侦听来自localhos...
只需三步,让你掌握阿尔法路由器... 请参照以下阿尔法路由器设置方法,通过浏览器进入及设置宽带路由器。经过这三个步骤的设置,基本上能够熟悉...
30分钟搞定iOS自定义相机 最近公司的项目中用到了相机,由于不用系统的相机,UI给的相机切图,必须自定义才可以。就花时间简单研究...