微信小程序消息分析数据接口怎么调用
这篇文章主要讲解了"微信小程序消息分析数据接口怎么调用",文中的讲解内容简单清晰,易于学习与理解,下面请大家跟着小编的思路慢慢深入,一起来研究和学习"微信小程序消息分析数据接口怎么调用"吧!
请注意:
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以下数据包:
{ "list": [ { "ref_date": "2014-12-07", "msg_type": 1, "msg_user": 282, "msg_count": 817 } //后续还有同一ref_date的不同msg_type的数据,以及不同ref_date(在时间范围内)的数据 ] }
获取消息分送分时数据接口需要向相应接口调用地址POST以下数据包:
{ "list": [ { "ref_date": "2014-12-07", "ref_hour": 0, "msg_type": 1, "msg_user": 9, "msg_count": 10 } //后续还有同一ref_hour的不同msg_type的数据,以及不同ref_hour的数据,ref_date固定,因为***时间跨度为1 ] } 获取消息发送周数据接口的返回JSON数据包如下: { "list": [ { "ref_date": "2014-12-08", "msg_type": 1, "msg_user": 16, "msg_count": 27 } //后续还有同一ref_date下不同msg_type的数据,及不同ref_date的数据 ] }
获取消息发送月数据接口的返回JSON数据包如下:
{ "list": [ { "ref_date": "2014-11-01", "msg_type": 1, "msg_user": 7989, "msg_count": 42206 } //后续还有同一ref_date下不同msg_type的数据,及不同ref_date的数据 ] }
获取消息发送分布数据接口的返回JSON数据包如下:
{ "list": [ { "ref_date": "2014-12-07", "count_interval": 1, "msg_user": 246 } //后续还有同一ref_date下不同count_interval的数据,及不同ref_date的数据 ] }
获取消息发送分布周数据接口的返回JSON数据包如下:
{ "list": [ { "ref_date": "2014-12-07", "count_interval": 1, "msg_user": 246 } //后续还有同一ref_date下不同count_interval的数据,及不同ref_date的数据 ] }
获取消息发送分布月数据接口的返回JSON数据包如下:
{ "list": [ { "ref_date": "2014-12-07", "count_interval": 1, "msg_user": 246 } //后续还有同一ref_date下不同count_interval的数据,及不同ref_date的数据 ] }
返回参数说明
参数 | 说明 |
---|---|
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 |
感谢各位的阅读,以上就是"微信小程序消息分析数据接口怎么调用"的内容了,经过本文的学习后,相信大家对微信小程序消息分析数据接口怎么调用这一问题有了更深刻的体会,具体使用情况还需要大家实践验证。这里是,小编将为大家推送更多相关知识点的文章,欢迎关注!