免費(fèi)AI編程助手
微信圖文分析數(shù)據(jù)接口
2019-03-14 12:12 更新
微信公眾平臺(tái)于2015年1月6日啟動(dòng)了數(shù)據(jù)接口的邀請(qǐng)內(nèi)測(cè)。通過數(shù)據(jù)接口，開發(fā)者可以獲取與公眾平臺(tái)官網(wǎng)統(tǒng)計(jì)模塊類似但更靈活的數(shù)據(jù)，還可根據(jù)需要進(jìn)行高級(jí)處理。
在公眾號(hào)登錄授權(quán)機(jī)制的權(quán)限集劃分中，圖文分析數(shù)據(jù)接口屬于群發(fā)與通知權(quán)限。
向所有公眾號(hào)開發(fā)者開放數(shù)據(jù)接口的時(shí)間將另行通知。
請(qǐng)注意：
1、接口側(cè)的公眾號(hào)數(shù)據(jù)的數(shù)據(jù)庫(kù)中僅存儲(chǔ)了2014年12月1日之后的數(shù)據(jù)，將查詢不到在此之前的日期，即使有查到，也是不可信的臟數(shù)據(jù)； 2、請(qǐng)開發(fā)者在調(diào)用接口獲取數(shù)據(jù)后，將數(shù)據(jù)保存在自身數(shù)據(jù)庫(kù)中，即加快下次用戶的訪問速度，也降低了微信側(cè)接口調(diào)用的不必要損耗。 3、額外注意，獲取圖文群發(fā)每日數(shù)據(jù)接口的結(jié)果中，只有中間頁(yè)閱讀人數(shù)+原文頁(yè)閱讀人數(shù)+分享轉(zhuǎn)發(fā)人數(shù)+分享轉(zhuǎn)發(fā)次數(shù)+收藏次數(shù) >=3的結(jié)果才會(huì)得到統(tǒng)計(jì)，過小的閱讀量的圖文消息無法統(tǒng)計(jì)。
圖文分析數(shù)據(jù)接口指的是用于獲得公眾平臺(tái)官網(wǎng)數(shù)據(jù)統(tǒng)計(jì)模塊中圖文分析數(shù)據(jù)的接口，具體接口列表如下：
| 接口名稱 | 最大時(shí)間跨度 | 接口調(diào)用地址（必須使用https） |
|---|---|---|
| 獲取圖文群發(fā)每日數(shù)據(jù)（getarticlesummary） | 1 | https://api.weixin.qq.com/datacube/getarticlesummary?access_token=ACCESS_TOKEN |
| 獲取圖文群發(fā)總數(shù)據(jù)（getarticletotal） | 1 | https://api.weixin.qq.com/datacube/getarticletotal?access_token=ACCESS_TOKEN |
| 獲取圖文統(tǒng)計(jì)數(shù)據(jù)（getuserread） | 3 | https://api.weixin.qq.com/datacube/getuserread?access_token=ACCESS_TOKEN |
| 獲取圖文統(tǒng)計(jì)分時(shí)數(shù)據(jù)（getuserreadhour） | 1 | https://api.weixin.qq.com/datacube/getuserreadhour?access_token=ACCESS_TOKEN |
| 獲取圖文分享轉(zhuǎn)發(fā)數(shù)據(jù)（getusershare） | 7 | https://api.weixin.qq.com/datacube/getusershare?access_token=ACCESS_TOKEN |
| 獲取圖文分享轉(zhuǎn)發(fā)分時(shí)數(shù)據(jù)（getusersharehour） | 1 | https://api.weixin.qq.com/datacube/getusersharehour?access_token=ACCESS_TOKEN |
最大時(shí)間跨度是指一次接口調(diào)用時(shí)最大可獲取數(shù)據(jù)的時(shí)間范圍，如最大時(shí)間跨度為7是指最多一次性獲取7天的數(shù)據(jù)。access_token的實(shí)際值請(qǐng)通過“獲取access_token”來獲取。
接口調(diào)用請(qǐng)求說明
圖文分析數(shù)據(jù)接口（包括接口列表中的所有接口）需要向相應(yīng)接口調(diào)用地址POST以下示例數(shù)據(jù)包：
{
"begin_date": "2014-12-08",
"end_date": "2014-12-08"
}調(diào)用參數(shù)說明
| 參數(shù) | 是否必須 | 說明 |
|---|---|---|
| access_token | 是 | 調(diào)用接口憑證 |
| begin_date | 是 | 獲取數(shù)據(jù)的起始日期，begin_date和end_date的差值需小于“最大時(shí)間跨度”（比如最大時(shí)間跨度為1時(shí)，begin_date和end_date的差值只能為0，才能小于1），否則會(huì)報(bào)錯(cuò) |
| end_date | 是 | 獲取數(shù)據(jù)的結(jié)束日期，end_date允許設(shè)置的最大值為昨日 |
返回說明
正常情況下，獲取圖文群發(fā)每日數(shù)據(jù)接口的返回JSON數(shù)據(jù)包如下：
{
"list": [
{
"ref_date": "2014-12-08",
"msgid": "10000050_1",
"title": "12月27日 DiLi日?qǐng)?bào)",
"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
}
//后續(xù)會(huì)列出該日期內(nèi)所有被閱讀過的文章（僅包括群發(fā)的文章）在當(dāng)天的閱讀次數(shù)等數(shù)據(jù)
]
}正常情況下，獲取圖文群發(fā)總數(shù)據(jù)接口的返回JSON數(shù)據(jù)包如下（請(qǐng)注意，details中，每天對(duì)應(yīng)的數(shù)值為該文章到該日為止的總量（而不是當(dāng)日的量））。 額外需要注意獲取圖文群發(fā)每日數(shù)據(jù)（getarticlesummary）和獲取圖文群發(fā)總數(shù)據(jù)（getarticletotal）的區(qū)別如下：
1、前者獲取的是某天所有被閱讀過的文章（僅包括群發(fā)的文章）在當(dāng)天的閱讀次數(shù)等數(shù)據(jù)。 2、后者獲取的是，某天群發(fā)的文章，從群發(fā)日起到接口調(diào)用日（但最多統(tǒng)計(jì)發(fā)表日后7天數(shù)據(jù)），每天的到當(dāng)天的總等數(shù)據(jù)。例如某篇文章是12月1日發(fā)出的，發(fā)出后在1日、2日、3日的閱讀次數(shù)分別為1萬(wàn)，則getarticletotal獲取到的數(shù)據(jù)為，距發(fā)出到12月1日24時(shí)的總閱讀量為1萬(wàn)，距發(fā)出到12月2日24時(shí)的總閱讀量為2萬(wàn)，距發(fā)出到12月1日24時(shí)的總閱讀量為3萬(wàn)。
{
"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
},
//后續(xù)還會(huì)列出所有stat_date符合“ref_date（群發(fā)的日期）到接口調(diào)用日期”（但最多只統(tǒng)計(jì)7天）的數(shù)據(jù)
]
},
//后續(xù)還有ref_date（群發(fā)的日期）在begin_date和end_date之間的群發(fā)文章的數(shù)據(jù)
]
}正常情況下，獲取圖文統(tǒng)計(jì)數(shù)據(jù)接口的返回JSON數(shù)據(jù)包如下：
{
"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
},
//后續(xù)還有ref_date在begin_date和end_date之間的數(shù)據(jù)
]
}正常情況下，獲取圖文統(tǒng)計(jì)分時(shí)數(shù)據(jù)接口的返回JSON數(shù)據(jù)包如下：
{
{
"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_source": 1,
"int_page_read_user": 1,
"int_page_read_count": 1,
"ori_page_read_user": 0,
"ori_page_read_count": 0,
"share_user": 0,
"share_count": 0,
"add_to_fav_user": 0,
"add_to_fav_count": 0
},
{
"ref_date": "2015-07-14",
"ref_hour": 0,
"user_source": 2,
"int_page_read_user": 3,
"int_page_read_count": 3,
"ori_page_read_user": 0,
"ori_page_read_count": 0,
"share_user": 0,
"share_count": 0,
"add_to_fav_user": 0,
"add_to_fav_count": 0
},
{
"ref_date": "2015-07-14",
"ref_hour": 0,
"user_source": 4,
"int_page_read_user": 42,
"int_page_read_count": 100,
"ori_page_read_user": 0,
"ori_page_read_count": 0,
"share_user": 0,
"share_count": 0,
"add_to_fav_user": 0,
"add_to_fav_count": 0
}
//后續(xù)還有ref_hour逐漸增大,以列舉1天24小時(shí)的數(shù)據(jù)
]
}正常情況下，獲取圖文分享轉(zhuǎn)發(fā)數(shù)據(jù)接口的返回JSON數(shù)據(jù)包如下：
{
"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
}
//后續(xù)還有不同share_scene（分享場(chǎng)景）的數(shù)據(jù)，以及ref_date在begin_date和end_date之間的數(shù)據(jù)
]
}正常情況下，獲取圖文分享轉(zhuǎn)發(fā)每日數(shù)據(jù)接口的返回JSON數(shù)據(jù)包如下：
{
"list": [
{
"ref_date": "2014-12-07",
"ref_hour": 1200,
"share_scene": 1,
"share_count": 72,
"share_user": 4
}
//后續(xù)還有不同share_scene的數(shù)據(jù)，以及ref_hour逐漸增大的數(shù)據(jù)。由于最大時(shí)間跨度為1，所以ref_date此處固定
]
}返回參數(shù)說明
| 參數(shù) | 說明 |
|---|---|
| ref_date | 數(shù)據(jù)的日期，需在begin_date和end_date之間 |
| ref_hour | 數(shù)據(jù)的小時(shí)，包括從000到2300，分別代表的是[000,100)到[2300,2400)，即每日的第1小時(shí)和最后1小時(shí) |
| stat_date | 統(tǒng)計(jì)的日期，在getarticletotal接口中，ref_date指的是文章群發(fā)出日期， 而stat_date是數(shù)據(jù)統(tǒng)計(jì)日期 |
| msgid | 請(qǐng)注意：這里的msgid實(shí)際上是由msgid（圖文消息id，這也就是群發(fā)接口調(diào)用后返回的msg_data_id）和index（消息次序索引）組成， 例如12003_3， 其中12003是msgid，即一次群發(fā)的消息的id； 3為index，假設(shè)該次群發(fā)的圖文消息共5個(gè)文章（因?yàn)榭赡転槎鄨D文），3表示5個(gè)中的第3個(gè) |
| title | 圖文消息的標(biāo)題 |
| int_page_read_user | 圖文頁(yè)（點(diǎn)擊群發(fā)圖文卡片進(jìn)入的頁(yè)面）的閱讀人數(shù) |
| int_page_read_count | 圖文頁(yè)的閱讀次數(shù) |
| ori_page_read_user | 原文頁(yè)（點(diǎn)擊圖文頁(yè)“閱讀原文”進(jìn)入的頁(yè)面）的閱讀人數(shù)，無原文頁(yè)時(shí)此處數(shù)據(jù)為0 |
| ori_page_read_count | 原文頁(yè)的閱讀次數(shù) |
| share_scene | 分享的場(chǎng)景 1代表好友轉(zhuǎn)發(fā) 2代表朋友圈 3代表騰訊微博 255代表其他 |
| share_user | 分享的人數(shù) |
| share_count | 分享的次數(shù) |
| add_to_fav_user | 收藏的人數(shù) |
| add_to_fav_count | 收藏的次數(shù) |
| 獲取圖文群發(fā)總數(shù)據(jù)接口中的詳細(xì)字段解釋 | intpagefromsessionreaduser 公眾號(hào)會(huì)話閱讀人數(shù) |
| target_user | 送達(dá)人數(shù)，一般約等于總粉絲數(shù)（需排除黑名單或其他異常情況下無法收到消息的粉絲） |
| user_source | 在獲取圖文閱讀分時(shí)數(shù)據(jù)時(shí)才有該字段，代表用戶從哪里進(jìn)入來閱讀該圖文。0:會(huì)話;1.好友;2.朋友圈;3.騰訊微博;4.歷史消息頁(yè);5.其他 |
錯(cuò)誤時(shí)微信會(huì)返回錯(cuò)誤碼等信息，具體錯(cuò)誤碼查詢，請(qǐng)見：全局返回碼說明
以上內(nèi)容是否對(duì)您有幫助：
更多建議：