微信图文分析数据接口

由 如此轻盈 创建，Carrie 最后一次修改 2016-09-27 图文分析数据接口微信公众平台于2015年1月6日启动了数据接口的邀请内测。通过数据接口，开发者可以获取与公众平台官网统计模块类似但更灵活的数据，还可根据需要进行高级处理。在公众号登录授权机制的权限集划分中，图文分析数据接口属于群发与通知权限。向所有公众号开发者开放数据接口的时间将另行通知。请注意：1、接口侧的公众号数据的数据库中仅存储了2014年12月1日之后的数据，将查询不到在此之前的日期，即使有查到，也是不可信的脏数据；2、请开发者在调用接口获取数据后，将数据保存在自身数据库中，即加快下次用户的访问速度，也降低了微信侧接口调用的不必要损耗。3、额外注意，获取图文群发每日数据接口的结果中，只有中间页阅读人数+原文页阅读人数+分享转发人数+分享转发次数+收藏次数 >=3的结果才会得到统计，过小的阅读量的图文消息无法统计。图文分析数据接口指的是用于获得公众平台官网数据统计模块中图文分析数据的接口，具体接口列表如下：接口名称最大时间跨度接口调用地址（必须使用https）获取图文群发每日数据（getarticlesummary）1https://api.weixin.qq.com/datacube/getarticlesummary?access_token=ACCESS_TOKEN获取图文群发总数据（getarticletotal）1https://api.weixin.qq.com/datacube/getarticletotal?access_token=ACCESS_TOKEN获取图文统计数据（getuserread）3https://api.weixin.qq.com/datacube/getuserread?access_token=ACCESS_TOKEN获取图文统计分时数据（getuserreadhour）1https://api.weixin.qq.com/datacube/getuserreadhour?access_token=ACCESS_TOKEN获取图文分享转发数据（getusershare）7https://api.weixin.qq.com/datacube/getusershare?access_token=ACCESS_TOKEN获取图文分享转发分时数据（getusersharehour）1https://api.weixin.qq.com/datacube/getusersharehour?access_token=ACCESS_TOKEN最大时间跨度是指一次接口调用时最大可获取数据的时间范围，如最大时间跨度为7是指最多一次性获取7天的数据。access_token的实际值请通过“获取access_token”来获取。接口调用请求说明图文分析数据接口（包括接口列表中的所有接口）需要向相应接口调用地址POST以下示例数据包：{     "begin_date": "2014-12-08",     "end_date": "2014-12-08"}调用参数说明参数是否必须说明access_token是调用接口凭证begin_date是获取数据的起始日期，begin_date和end_date的差值需小于“最大时间跨度”（比如最大时间跨度为1时，begin_date和end_date的差值只能为0，才能小于1），否则会报错end_date是获取数据的结束日期，end_date允许设置的最大值为昨日返回说明正常情况下，获取图文群发每日数据接口的返回JSON数据包如下：{     "list": [         {             "ref_date": "2014-12-08",             "msgid": "10000050_1",             "title": "12月27日 DiLi日报",             "int_page_read_user": 23676,             "int_page_read_count": 25615,             "ori_page_read_user": 29,             "ori_page_read_count": 34,             "share_user": 122,             "share_count": 994,             "add_to_fav_user": 1,             "add_to_fav_count": 3        }   //后续会列出该日期内所有被阅读过的文章（仅包括群发的文章）在当天的阅读次数等数据    ]}正常情况下，获取图文群发总数据接口的返回JSON数据包如下（请注意，details中，每天对应的数值为该文章到该日为止的总量（而不是当日的量））。 额外需要注意获取图文群发每日数据（getarticlesummary）和获取图文群发总数据（getarticletotal）的区别如下：1、前者获取的是某天所有被阅读过的文章（仅包括群发的文章）在当天的阅读次数等数据。2、后者获取的是，某天群发的文章，从群发日起到接口调用日（但最多统计发表日后7天数据），每天的到当天的总等数据。例如某篇文章是12月1日发出的，发出后在1日、2日、3日的阅读次数分别为1万，则getarticletotal获取到的数据为，距发出到12月1日24时的总阅读量为1万，距发出到12月2日24时的总阅读量为2万，距发出到12月1日24时的总阅读量为3万。{    "list": [        {            "ref_date": "2014-12-14",            "msgid": "202457380_1",            "title": "马航丢画记",            "details": [                {                    "stat_date": "2014-12-14",                    "target_user": 261917,                    "int_page_read_user": 23676,                    "int_page_read_count": 25615,                    "ori_page_read_user": 29,                    "ori_page_read_count": 34,                    "share_user": 122,                    "share_count": 994,                    "add_to_fav_user": 1,                    "add_to_fav_count": 3,                    "int_page_from_session_read_user": 657283,                     "int_page_from_session_read_count": 753486,                     "int_page_from_hist_msg_read_user": 1669,                     "int_page_from_hist_msg_read_count": 1920,                     "int_page_from_feed_read_user": 367308,                     "int_page_from_feed_read_count": 433422,                     "int_page_from_friends_read_user": 15428,                     "int_page_from_friends_read_count": 19645,                     "int_page_from_other_read_user": 477,                     "int_page_from_other_read_count": 703,                     "feed_share_from_session_user": 63925,                     "feed_share_from_session_cnt": 66489,                     "feed_share_from_feed_user": 18249,                     "feed_share_from_feed_cnt": 19319,                     "feed_share_from_other_user": 731,                     "feed_share_from_other_cnt": 775               }, //后续还会列出所有stat_date符合“ref_date（群发的日期）到接口调用日期”（但最多只统计7天）的数据           ]       },//后续还有ref_date（群发的日期）在begin_date和end_date之间的群发文章的数据   ]}正常情况下，获取图文统计数据接口的返回JSON数据包如下：{    "list": [        {            "ref_date": "2014-12-07",            "int_page_read_user": 45524,            "int_page_read_count": 48796,            "ori_page_read_user": 11,            "ori_page_read_count": 35,            "share_user": 11,            "share_count": 276,            "add_to_fav_user": 5,            "add_to_fav_count": 15       }, //后续还有ref_date在begin_date和end_date之间的数据   ]}正常情况下，获取图文统计分时数据接口的返回JSON数据包如下：{    {   "list": [       {           "ref_date": "2015-07-14",            "ref_hour": 0,            "user_source": 0,            "int_page_read_user": 6391,            "int_page_read_count": 7836,            "ori_page_read_user": 375,            "ori_page_read_count": 440,            "share_user": 2,            "share_count": 2,            "add_to_fav_user": 0,            "add_to_fav_count": 0       },        {           "ref_date": "2015-07-14",            "ref_hour": 0,            "user_sourc