用戶分析資料介面

##微信公眾平台於2015年1月6日啟動了資料介面的邀請內測。透過數據接口，開發者可以獲得與公眾平台官網統計模組類似但更靈活的數據，還可根據需要進行高級處理。

在公眾號登入授權機制的權限集分割中，使用者分析資料介面屬於使用者管理權限。

向所有公眾號開發者開放資料介面的時間將另行通知。

請注意：

1、介面側的公眾號資料的資料庫中僅儲存了2014年12月1日之後的數據，將查詢不到在此之前的日期，即使有查到，也是不可信的髒數據； 2、請開發者在調用接口獲取數據後，將數據保存在自身數據庫中，即加快下次用戶的存取速度，也降低了微信側介面呼叫的不必要損耗。

#

使用者分析資料接口指的是用於取得公眾平台官網資料統計模組中使用者分析資料的接口，具體介面清單如下（暫無使用者屬性資料介面）：

取得累計使用者資料（getusercumulate）7https://api.weixin.qq.com/datacube/getusercumulate?access_token=ACCESS_TOKEN

介面名稱	最大時間跨度	介面呼叫位址（必須使用https）
取得使用者增減資料（getusersummary）	7	https://api.weixin.qq.com/datacube/getusersummary?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代表其他合計1代表公眾號搜尋17代表名片分享30代表掃描二維碼43代表圖文頁右上角選單51代表付款後關注（在支付完成頁） 57代表圖文頁內公眾號名稱75代表公眾號文章廣告78代表朋友圈廣告
new_user	新增的使用者數量
#cancel_user	取消追蹤的使用者數量，new_user減去cancel_user即為淨增用戶數
cumulate_user	總用戶量

錯誤時微信會傳回錯誤碼等訊息，具體錯誤碼查詢，請見：全域回傳碼說明

#微信後台資料分析

#微信資料後台有那些資料指標？
微信後台資料從人、圖文和訊息以及介面方面做了簡單的資料匯總展現，每個指標都可選擇不同的時間節點查看變化趨勢，系統預設設定有7天、14天和30天3個節點。具體指標請參考下圖：