ユーザー:統計
users > get_stats_for_content_type
ユーザーが（対応する統計情報とともに）表示した動画やチャンネルなどのリストを取得したい場合など、動画やチャンネルなど特定のコンテンツタイプに関するユーザーの統計情報を取得します。
これは、INTER-STREAMのコンテンツ管理インターフェースの[ユーザー]セクションで、一覧画面の統計アイコンから取得できるものと同じ種類の統計です。
リクエストの構築
リクエストURLとGET変数
リクエスト固有のGET変数
| 変数 | 値 | 説明 |
|---|---|---|
| go | users | APIセクション |
| do | get_stats_for_content_type | APIアクション |
| iq | User ID | ユーザーID |
リクエストURLは以下のようになります。必須情報(key, timestamp, salt, signature)を追加することを忘れないでください。
https://....../api.php?go=users&do=get_stats_for_content_type&iq={user_id}&{required information}
POST変数
以下のPOST変数は必須です。
| 変数 | 値 | 説明 |
|---|---|---|
| contentType | (string) Content Type | 利用可能な値："clip", "channel" (動画チャンネル/ページ), "gallery", "news", "event", "interactivity" |
以下のPOST変数はオプションです。
| 変数 | 値 | 説明 |
|---|---|---|
| getHeatmapURL | (int) 0|1 | ヒートマップ画像のURLを含めるかどうか（'contentType="clip"'の場合のみ） |
応答例
リクエストが成功した場合は、以下の内容のレスポンスを受け取ります。
・list：コンテンツタイプの、ユーザーの統計情報のリストを含む配列
コンテンツタイプ:動画のユーザー統計の例）
{
"list": [
{
"id_clip": "1",
"duration": "15",
"is_ad": "0",
"content_title": "Logo Presentation",
"page_views": "22",
"last_played_second": "0",
"complete_playbacks": "4",
"total_playbacks": "27",
"total_play_time": "70",
"heatmap": "998776622222100"
},
{
"id_clip": "43",
"duration": "9",
"is_ad": "0",
"content_title": "Channel Bumper",
"page_views": "1",
"last_played_second": "1",
"complete_playbacks": "0",
"total_playbacks": "14",
"total_play_time": "1",
"heatmap": "100000000"
},
{
"id_clip": "9",
"duration": "150",
"is_ad": "0",
"content_title": "Movie Trailer",
"page_views": "2",
"last_played_second": "0",
"complete_playbacks": "0",
"total_playbacks": "8",
"total_play_time": "26",
"heatmap": "311111111111111111111111000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000"
},
...
]
}
リクエストにハッシュが指定されていない場合など、リクエストが失敗した場合のレスポンス
{
"error" : "REQUEST_ERROR",
"error_long" : "Missing signature"
}
このリクエストは以下のエラーを返す可能性があります。
・REQUEST_ERROR | Invalid User ID
ユーザーIDが1未満かもしくは数値ではありません。
・REQUEST_ERROR | Invalid Content Type [Must be 'clip', 'channel', 'news' or 'gallery']
contentType値が想定外です。
その他のエラー内容に関しては一般的なエラーメッセージを確認してください。
PHPサンプルコード
GETおよびPOSTデータを準備します。
// GET変数
$GET_VARS = array(
"go" => "users",
"do" => "get_stats_for_content_type",
"iq" => 3
);
// POST変数
$POST_VARS = array(
"contentType" => "clip"
);