# WeChat パブリック プラットフォームは、2015 年 1 月 6 日にデータ インターフェイスの招待制の内部テストを開始しました。データ インターフェイスを通じて、開発者はパブリック プラットフォームの公式 Web サイトの統計モジュールと同様の、より柔軟なデータを取得でき、必要に応じて高度な処理を実行することもできます。
グラフィック分析データ インターフェイスとは、パブリック プラットフォームの公式 Web サイトのデータ統計モジュールでグラフィック分析データを取得するために使用されるインターフェイスを指します。具体的なインターフェイスのリストは次のとおりです。次のように： ＃＃＃
最大期間とは、インターフェイスが呼び出されたときにデータを取得できる最大の時間範囲を指します。たとえば、最大期間は 7 で、一度に最大 7 日分のデータを取得できることを意味します。 access_tokenの実際の値は「access_tokenの取得」で取得してください。
グラフィックおよびテキスト分析データ インターフェイス (インターフェイス リスト内のすべてのインターフェイスを含む) は、対応するインターフェイス アドレスを呼び出し、POST する必要があります。次のサンプル データ パケット：
#パラメータ | 必須かどうか | 説明 |
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_hour | 000 から 2300 までのデータの時間は、それぞれ [000,100) から [2300,2400)] を表します。つまり、それぞれの最初の時間を表します。 day および最後の 1 時間の日付 |
stat_date | getarticletotal インターフェイスでは、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 | になります。
| ori_page_read_count | 元のページの読み取り数 |
| share_scene | 共有シーン 1は友人による転送を表します2 は友人を表します 円 3 は Tencent Weibo を表します 255 は他のユーザーが共有する人の数を表します |
#share_user | |
# #share_count | シェア数 | |
add_to_fav_user| 集めた人の数 | |
add_to_fav_count| コレクションの数 | | #画像とテキストの一括送信の合計データ インターフェイスで詳細なフィールドの説明を取得します
| intpagefromsessionreaduser パブリック アカウント セッションの数Readers | intpagefromsessionreadcount パブリック アカウント セッションの読み取り数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 は、次のようなエラー コードを返します。エラー 特定のエラー コードなどの情報については、「グローバル リターン コードの説明」
# を参照してください。
