數據統計接口-圖文分析數據接口
信公眾平臺于2015年1月6日啟動了數據接口的邀請內測。通過數據接口,開發者可以獲取與公眾平臺官網統計模塊類似但更靈活的數據,還可根據需要進行高級處理。
邀請內測期間,為保證服務質量,數據接口僅向第三方平臺開發者開放。在微信開放平臺接入公眾號登錄授權即可成為第三方平臺開發者,第三方平臺可幫助運營者管理公眾號,幫助已授權公眾號調用數據接口。在公眾號登錄授權機制的權限集劃分中,圖文分析數據接口屬于業務通知權限集。
向所有公眾號開發者開放數據接口的時間將另行通知。
請注意:
1、接口側的公眾號數據的數據庫中僅存儲了2014年12月1日之后的數據,將查詢不到在此之前的日期,即使有查到,也是不可信的臟數據;
2、請開發者在調用接口獲取數據后,將數據保存在自身數據庫中,即加快下次用戶的訪問速度,也降低了微信側接口調用的不必要損耗。
圖文分析數據接口指的是用于獲得公眾平臺官網數據統計模塊中圖文分析數據的接口,具體接口列表如下:
***時間跨度是指一次接口調用時***可獲取數據的時間范圍,如***時間跨度為7是指最多一次性獲取7天的數據。access_token的實際值請通過“獲取access_token”來獲取。
接口調用請求說明
圖文分析數據接口(包括接口列表中的所有接口)需要向相應接口調用地址POST以下示例數據包:
- {
- "begin_date": "2014-12-08",
- "end_date": "2014-12-08"
- }
返回說明
正常情況下,獲取圖文群發每日數據接口的返回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
- },
- //后續還會列出所有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": "2014-12-07",
- "ref_hour": 1200,
- "int_page_read_user": 0,
- "int_page_read_count": 0,
- "ori_page_read_user": 4,
- "ori_page_read_count": 25517,
- "share_user": 4,
- "share_count": 96,
- "add_to_fav_user": 1,
- "add_to_fav_count": 3
- }
- //后續還有ref_hour逐漸增大,以列舉1天24小時的數據
- ]
- }
- 正常情況下,獲取圖文分享轉發數據接口的返回JSON數據包如下:
- {
- "list": [
- {
- "ref_date": "2014-12-07",
- "share_scene": 1,
- "share_count": 207,
- "share_user": 11
- },
- {
- "ref_date": "2014-12-07",
- "share_scene": 5,
- "share_count": 23,
- "share_user": 11
- }
- //后續還有不同share_scene(分享場景)的數據,以及ref_date在begin_date和end_date之間的數據
- ]
- }
正常情況下,獲取圖文分享轉發每日數據接口的返回JSON數據包如下:
- {
- "list": [
- {
- "ref_date": "2014-12-07",
- "ref_hour": 1200,
- "share_scene": 1,
- "share_count": 72,
- "share_user": 4
- }
- //后續還有不同share_scene的數據,以及ref_hour逐漸增大的數據。由于***時間跨度為1,所以ref_date此處固定
- ]
- }


























