メッセージ分析データインターフェース

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

公式アカウントのログイン認証メカニズムの権限セット部門では、メッセージ分析データ インターフェイスはメッセージ管理権限に属します。

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

注意:

1、接口侧的公众号数据的数据库中仅存储了2014年12月1日之后的数据，将查询不到在此之前的日期，即使有查到，也是不可信的脏数据；
2、请开发者在调用接口获取数据后，将数据保存在自身数据库中，即加快下次用户的访问速度，也降低了微信侧接口调用的不必要损耗。

メッセージ分析データ インターフェイスとは、パブリック プラットフォームの公式 Web サイトのデータ統計モジュールでメッセージ分析データを取得するために使用されるインターフェイスを指します。具体的なインターフェイスのリストは次のとおりです。以下のように (メッセージ キーワード データはまだ利用できません) インターフェイス):

# #メッセージ配信タイムシェアリングデータの取得 (getupstreammsghour)1https://api.weixin.qq.com/datacube/getupstreammsghour?access_token=ACCESS_TOKENメッセージ送信週データの取得 (getupstreammsgweek)30https://api.weixin.qq.com/datacube/getupstreammsgweek?access_token=ACCESS_TOKENメッセージ送信月データの取得 (getupstreammsgmonth)30https://api.weixin.qq.com/datacube/getupstreammsgmonth?access_token=ACCESS_TOKENメッセージ送信配信データの取得 (getupstreammsgdist)15https://api.weixin.qq.com/datacube/getupstreammsgdist?access_token=ACCESS_TOKEN

インターフェイス名	最大タイム スパン	インターフェイス呼び出しアドレス (https を使用する必要があります)
Getプロファイル データを送信するメッセージ (getupstreammsg)	7	https://api.weixin.qq.com/datacube/getupstreammsg?access_token=ACCESS_TOKEN
メッセージ送信配布週データの取得 (getupstreammsgdistweek)	30	https://api.weixin.qq.com/datacube/getupstreammsgdistweek?access_token=ACCESS_TOKEN
メッセージ送信分布月次データの取得 (getupstreammsgdistmonth)	30	https://api.weixin.qq.com/datacube/getupstreammsgdistmonth?access_token=ACCESS_TOKEN

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

週次データと月次データについて、月次・週次定期データの日付は、月・週の初日（毎月1日または月曜日）となりますのでご注意ください。特定の月/週が経過した後にインターフェイスを呼び出すことによってのみ、その期間のデータを取得できます。たとえば、(begin_date および end_date) として (11 月 1 日 - 11 月 5 日) を使用して 12 月 1 日に月次データ取得インターフェイスを呼び出すと、11 月 1 日の月次データ (つまり、11 月の月次データ) を取得できます。

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

メッセージ分析データ インターフェイス (インターフェイス リスト内のすべてのインターフェイスを含む) は、次のサンプル データ パケットを対応するインターフェイス呼び出しアドレスに POST する必要があります。 :

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

コールパラメータの説明

#パラメータ必須かどうか説明access_tokenはい呼び出しインターフェイス資格情報begin_date は、 がデータを取得する開始日です。begin_date と end_date の違いは次のとおりです。 「最大「期間」」未満 (たとえば、最大期間が 1 の場合、begin_date と end_date の差は 0 から 1 未満までのみ可能)、そうでない場合は、エラーが報告されます end_date データを取得する の終了日です。end_date に許可される最大値は昨日です

返信手順

メッセージ送信概要データ インターフェイスを取得するには、対応するインターフェイス アドレスを呼び出して次のデータ パケットを POST する必要があります:

{ 
   "list": [ 
       { 
           "ref_date": "2014-12-07", 
           "msg_type": 1, 
           "msg_user": 282, 
           "msg_count": 817
       }
	//后续还有同一ref_date的不同msg_type的数据，以及不同ref_date（在时间范围内）的数据
   ]
}

To getメッセージ配信タイムシェアリング データ インターフェイスの場合は、次のデータ パケットを対応するインターフェイス呼び出しアドレスに POST する必要があります:

{ 
   "list": [ 
       { 
           "ref_date": "2014-12-07", 
           "ref_hour": 0, 
           "msg_type": 1, 
           "msg_user": 9, 
           "msg_count": 10
       }
	//后续还有同一ref_hour的不同msg_type的数据，以及不同ref_hour的数据，ref_date固定，因为最大时间跨度为1
   ]
}

次のように、メッセージ送信週次データ インターフェイスの返された JSON データ パケットを取得します:

{ 
   "list": [ 
       { 
           "ref_date": "2014-12-08", 
           "msg_type": 1, 
           "msg_user": 16, 
           "msg_count": 27
       }
		//后续还有同一ref_date下不同msg_type的数据，及不同ref_date的数据
   ]
}

次のように、メッセージ送信月次データ インターフェイスの返された JSON データ パケットを取得します:

{ 
   "list": [ 
       { 
           "ref_date": "2014-11-01", 
           "msg_type": 1, 
           "msg_user": 7989, 
           "msg_count": 42206
       }
	//后续还有同一ref_date下不同msg_type的数据，及不同ref_date的数据
   ]
}

次のように、メッセージ送信配信データ インターフェイスの返された JSON データ パケットを取得します:

{ 
   "list": [ 
       { 
           "ref_date": "2014-12-07", 
           "count_interval": 1, 
           "msg_user": 246
       }
	//后续还有同一ref_date下不同count_interval的数据，及不同ref_date的数据
   ]
}

次のように、配信週次データを送信するメッセージ インターフェースの返された JSON データ パケットを取得します。

{ 
   "list": [ 
       { 
           "ref_date": "2014-12-07", 
           "count_interval": 1, 
           "msg_user": 246
       }
	//后续还有同一ref_date下不同count_interval的数据，及不同ref_date的数据
   ]
}

メッセージを取得します。 配信月次データを送信するインターフェースの返される JSON データ パケットは、次のとおりです。

{ 
   "list": [ 
       { 
           "ref_date": "2014-12-07", 
           "count_interval": 1, 
           "msg_user": 246
       }
	//后续还有同一ref_date下不同count_interval的数据，及不同ref_date的数据
   ]
}

戻りパラメータの説明

#パラメータ説明ref_dateデータの日付は begin_date と end_date の間である必要がありますref_hour000 から 2300 までのデータの時間は、それぞれ [000,100) から [2300,2400)] を表します。つまり、それぞれの最初の時間を表します。 msg_type メッセージ タイプ。意味は次のとおりです。 msg_user上流にメッセージを送信した (公開アカウントに送信された) ユーザーの数msg_countアップストリームに送信されたメッセージの総数count_interval金額の配布間隔その日に送信されたメッセージの数、0 は「0」を表し、1 は「1 ～ 5」を表し、2 は「6 ～ 10 回」を表し、3 は「10 回以上」を表します int_page_read_countori_page_read_user になります。

エラーが発生した場合、WeChat はエラー コードとその他の情報を返します。具体的なエラー コードの問い合わせについては、グローバル リターン コードの説明を参照してください。

	1 はテキストを表します 2 は画像を表します 3 は音声を表します 4 はビデオを表します 6 は表しますサードパーティ アプリケーションのメッセージ (リンク メッセージ)
写真と本文ページの閲覧数
元の本文ページ（「オリジナルを読む」をクリックして入るページ）の閲覧者数元のテキスト ページがない場合、ここのデータは 0