用戶分析數據接口
用戶分析數據接口
微信公眾平臺于2015年1月6日啟動了數據接口的邀請內測。通過數據接口，開發(fā)者可以獲取與公眾平臺官網統(tǒng)計模塊類似但更靈活的數據，還可根據需要進行高級處理。
在公眾號登錄授權機制的權限集劃分中，用戶分析數據接口屬于用戶管理權限。
向所有公眾號開發(fā)者開放數據接口的時間將另行通知。
請注意：
1、接口側的公眾號數據的數據庫中僅存儲了2014年12月1日之后的數據，將查詢不到在此之前的日期，即使有查到，也是不可信的臟數據； 2、請開發(fā)者在調用接口獲取數據后，將數據保存在自身數據庫中，即加快下次用戶的訪問速度，也降低了微信側接口調用的不必要損耗。 |
用戶分析數據接口指的是用于獲得公眾平臺官網數據統(tǒng)計模塊中用戶分析數據的接口，具體接口列表如下（暫無用戶屬性數據接口）：
| 接口名稱 | 最大時間跨度 | 接口調用地址（必須使用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
}
//后續(xù)還有ref_date在begin_date和end_date之間的數據
]
}正常情況下，獲取累計用戶數據接口的返回JSON數據包如下：
{
"list": [
{
"ref_date": "2014-12-07",
"cumulate_user": 1217056
},
//后續(xù)還有ref_date在begin_date和end_date之間的數據
]
}返回參數說明
| 參數 | 說明 |
|---|---|
| ref_date | 數據的日期 |
| user_source | 用戶的渠道，數值代表的含義如下： 0代表其他合計 1代表公眾號搜索 17代表名片分享 30代表掃描二維碼 43代表圖文頁右上角菜單 51代表支付后關注（在支付完成頁） 57代表圖文頁內公眾號名稱 75代表公眾號文章廣告 78代表朋友圈廣告 |
| new_user | 新增的用戶數量 |
| cancel_user | 取消關注的用戶數量，new_user減去cancel_user即為凈增用戶數量 |
| cumulate_user | 總用戶量 |
錯誤時微信會返回錯誤碼等信息，具體錯誤碼查詢，請見：全局返回碼說明
微信后臺數據分析
微信數據后臺有那些數據指標？
微信后臺數據從人、圖文和消息以及接口方面做了簡單的數據匯總展現，每個指標都可選擇不同的時間節(jié)點查看變化趨勢，系統(tǒng)默認設置有7天、14天和30天3個節(jié)點。具體指標參見下圖：