微信公眾平臺數據介面正式對所有認證公眾號開放
經過10多天的微信公眾平臺數據介面內測,現在正式對所有認證公眾號開放了。微信公眾平臺數據介面正式向所有已微信認證(通過資質認證即可)的服務號和訂閱號開放。通過資料介面,公眾號開發者可以便利地獲取更詳細、更靈活的運營資料。
1、使用者分析資料介面
通過該介面可以獲取公眾號的使用者增減資料和累計使用者資料。
2、圖文分析資料介面
通過該介面可以獲取公眾號群發的圖文訊息的閱讀、分享、收藏等資料。
3、訊息分析資料介面
通過該介面可以獲取使用者向公眾號傳送訊息的資料,包括訊息傳送人數、次數,以及訊息釋出次數的分佈等。
4、介面分析資料介面
通過該介面可以獲取公眾號在通過介面響應使用者訊息時的效能資料,包括介面回覆次數、耗時等。
微信公眾平臺數據介面開發者文件
微信公眾平臺於2015年1月6日啟動了資料介面的邀請內測。通過資料介面,開發者可以獲取與公眾平臺官網統計模組類似但更靈活的資料,還可根據需要進行高階處理。
邀請內測期間,為保證服務質量,資料介面僅向第三方平臺開發者開放。在微信開放平臺接入公眾號登入授權即可成為第三方平臺開發者,第三方平 臺可幫助運營者管理公眾號,幫助已授權公眾號呼叫資料介面。在公眾號登入授權機制的許可權集劃分中,使用者分析資料介面屬於使用者管理許可權集。
向所有公眾號開發者開放資料介面的時間將另行通知。
請注意:
1、介面側的公眾號資料的資料庫中僅儲存了2014年12月1日之後的資料,將查詢不到在此之前的日期,即使有查到,也是不可信的髒資料; 2、請開發者在呼叫介面獲取資料後,將資料儲存在自身資料庫中,即加快下次使用者的訪問速度,也降低了微信側介面呼叫的不必要損耗。
使用者分析資料介面指的是用於獲得公眾平臺官網資料統計模組中使用者分析資料的介面,具體介面列表如下(暫無使用者屬性資料介面):
介面名稱 |
最大時間跨度 |
介面呼叫地址(必須使用https) |
---|---|---|
獲取使用者增減資料(getusersummary) |
7 |
https://api.weixin.qq.com/datacube/getusersummary?access_token=ACCESS_TOKEN |
獲取累計使用者資料(getusercumulate) |
7 |
https://api.weixin.qq.com/datacube/getusercumulate?access_token=ACCESS_TOKEN |
最大時間跨度是指一次介面呼叫時最大可獲取資料的時間範圍,如最大時間跨度為7是指最多一次性獲取7天的資料。access_token的實際值請通過“獲取access_token”來獲取。
介面呼叫請求說明
使用者分析資料介面(包括介面列表中的所有介面)需要向相應介面呼叫地址POST以下示例資料包:
{
"begin_date": "2014-12-02",
"end_date": "2014-12-07"
}
呼叫引數說明
引數 |
是否必須 |
說明 |
---|---|---|
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-07",
"user_source": 0,
"new_user": 0,
"cancel_user": 0
}
//後續還有ref_date在begin_date和end_date之間的資料
]
}
正常情況下,獲取累計使用者資料介面的返回JSON資料包如下:
{
"list": [
{
"ref_date": "2014-12-07",
"cumulate_user": 1217056
},
//後續還有ref_date在begin_date和end_date之間的資料
]
}
返回引數說明
引數 |
說明 |
---|---|
ref_date |
資料的日期 |
user_source |
使用者的渠道,數值代表的含義如下: 0代表其他 30代表掃二維碼 17代表名片分享 35代表搜號碼(即微信新增朋友頁的搜尋) 39代表查詢微信公眾帳號 43代表圖文頁右上角選單 |
new_user |
新增的使用者數量 |
cancel_user |
取消關注的使用者數量,new_user減去cancel_user即為淨增使用者數量 |
cumulate_user |
總使用者量 |