グラフィカルおよびテキスト分析データ インターフェイス

# WeChat パブリック プラットフォームは、2015 年 1 月 6 日にデータ インターフェイスの招待制の内部テストを開始しました。データ インターフェイスを通じて、開発者はパブリック プラットフォームの公式 Web サイトの統計モジュールと同様の、より柔軟なデータを取得でき、必要に応じて高度な処理を実行することもできます。

公式アカウントのログイン認証メカニズムの権限セット部門では、画像とテキストの分析データ インターフェイスはグループ送信権限と通知権限に属します。

すべてのパブリック アカウント開発者にデータ インターフェイスを公開する時期は、別途通知されます。

注意:

1、接口侧的公众号数据的数据库中仅存储了2014年12月1日之后的数据，将查询不到在此之前的日期，即使有查到，也是不可信的脏数据；
2、请开发者在调用接口获取数据后，将数据保存在自身数据库中，即加快下次用户的访问速度，也降低了微信侧接口调用的不必要损耗。
3、额外注意，获取图文群发每日数据接口的结果中，只有中间页阅读人数+原文页阅读人数+分享转发人数+分享转发次数+收藏次数 >=3的结果才会得到统计，过小的阅读量的图文消息无法统计。

グラフィック分析データ インターフェイスとは、パブリック プラットフォームの公式 Web サイトのデータ統計モジュールでグラフィック分析データを取得するために使用されるインターフェイスを指します。具体的なインターフェイスのリストは次のとおりです。次のように： ＃＃＃

インターフェイス名	最大タイム スパン	インターフェイス呼び出しアドレス (https を使用する必要があります)
Getグラフィック グループ送信の日次データ (getarticlesummary)	1	https://api.weixin.qq.com/datacube/getarticlesummary?access_token=ACCESS_TOKEN
グループのテキストとグラフィックの合計データを取得 (getarticletotal)	1	https://api.weixin.qq.com/datacube/getarticletotal?access_token=ACCESS_TOKEN
グラフィックおよびテキスト統計データの取得 (getuserread)	3	https://api.weixin.qq.com/datacube/getuserread?access_token=ACCESS_TOKEN
グラフィックおよびテキストのタイムシェアリング統計データを取得する (getuserreadhour)	1	https://api.weixin.qq.com/datacube /getuserreadhour?access_token=ACCESS_TOKEN
画像とテキスト共有転送データの取得 (getusershare)	7	https://api.weixin.qq .com/datacube/getusershare? access_token=ACCESS_TOKEN
画像とテキストの共有とタイムシェアリング データの転送 (getusersharehour)	1	https://api.weixin.qq.com/datacube/getusersharehour?access_token =ACCESS_TOKEN

最大期間とは、インターフェイスが呼び出されたときにデータを取得できる最大の時間範囲を指します。たとえば、最大期間は 7 で、一度に最大 7 日分のデータを取得できることを意味します。 access_tokenの実際の値は「access_tokenの取得」で取得してください。

インターフェイス呼び出しリクエストの説明

グラフィックおよびテキスト分析データ インターフェイス (インターフェイス リスト内のすべてのインターフェイスを含む) は、対応するインターフェイス アドレスを呼び出し、POST する必要があります。次のサンプル データ パケット：

{ 
    "begin_date": "2014-12-08", 
    "end_date": "2014-12-08"
}

呼び出しパラメータの説明

#パラメータ必須かどうか説明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-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
        } 
 	 //后续会列出该日期内所有被阅读过的文章（仅包括群发的文章）在当天的阅读次数等数据
    ]
}

Under通常の場合、画像とテキストを取得する グループ合計データ インターフェイスから返される JSON データ パケットは次のとおりです (詳しくは、各日に対応する値は、その日までの記事の総量です (その日の記事の量ではないことに注意してください)日））。 次のように、グラフィックとテキストの質量分布の毎日のデータの取得 (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,
                    "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
               }, 
	//后续还会列出所有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 データ パケット-sharing データは次のとおりです。

{ 
   {
   "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
       }
 	//后续还有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此处固定
   ]
}

戻りパラメータの説明

#パラメータ説明ref_dateデータの日付は begin_date と end_date の間である必要がありますref_hour000 から 2300 までのデータの時間は、それぞれ [000,100) から [2300,2400)] を表します。つまり、それぞれの最初の時間を表します。 day および最後の 1 時間の日付stat_dategetarticletotal インターフェイスでは、ref_date は記事グループが発行された日付を指し、stat_date はデータ統計の日付を指します。 msgid注意: ここでの msgid は実際には msgid (画像とテキスト メッセージ ID、グループ送信インターフェイスが呼び出された後に返される msg_data_id) で構成されています。 12003_3 のように、12003 はグループで送信されるメッセージの ID である msgid、3 はインデックスです。グループ メッセージには 5 つの記事が含まれていると仮定します (複数の画像やメッセージが存在する可能性があるため)。 3 番目のタイトル title グラフィック メッセージ int_page_read_user グラフィック ページ (グループ テキスト カードをクリックして入力したページの読者の数)int_page_read_count読み取り数グラフィックページの数ori_page_read_user 原文ページ（画像と本文のページで「原文を読む」をクリックして入るページ）の読者数元のテキスト ページがない場合、ここのデータは 0 になります。#share_user# #share_countadd_to_fav_useradd_to_fav_count#画像とテキストの一括送信の合計データ インターフェイスで詳細なフィールドの説明を取得しますintpagefromsessionreadcount パブリック アカウント セッションの読み取り数

ori_page_read_count	元のページの読み取り数
share_scene	共有シーン 1は友人による転送を表します2 は友人を表します 円 3 は Tencent Weibo を表します 255 は他のユーザーが共有する人の数を表します
シェア数
集めた人の数
コレクションの数
intpagefromsessionreaduser パブリック アカウント セッションの数Readers	intpagefromhistmsgreaduser 履歴メッセージ ページの読者数 intpagefromhistmsgreadcount 履歴メッセージ ページの読者数 intpagefromfeedreaduser フレンド サークルの読者数 intpagefromfeedreadcount フレンド サークルの読者の数 intpagefromfriendsreaduser 友達によって転送された読者の数 intpagefromfriendsreadcount 友達によって転送された読者の数 intpagefromotherreaduser 他のシーンからの読者の数 intpagefromotherreadcount他のシーンからの読み取り数 feedsharefromsessionuser 友人のサークルに転送された公開アカウント セッションの人数 feedsharefromsessioncnt 公開アカウント セッションが友人のサークルに転送された回数 feedsharefromfeeduser友達のサークルに転送された友達のサークル内の人の数 feedsharefromfedcnt 友達のサークルが友達のサークルに転送された回数 feedsharefromotheruser 他のシナリオで友達のサークルに転送された人の数 feedsharefromothercnt他のシナリオでフレンド サークルが転送された回数
target_user	受信者の数は通常、ファンの総数とほぼ同じです (ブラックリストやその他の異常な状況によりメッセージを受信できないファンは除外する必要があります) )
user_source	このフィールドは、画像とテキストの読み取りタイムシェアリング データを取得する場合にのみ使用でき、ユーザーが画像とテキストを読み取るために入力する場所を表します。 0: 会話; 1. 友達; 2. モーメント; 3. Tencent Weibo; 4. 履歴メッセージ ページ; 5. その他

WeChat は、次のようなエラー コードを返します。エラー 特定のエラー コードなどの情報については、「グローバル リターン コードの説明」