分析API

分析画面で閲覧可能な情報を取得するためのAPI

HTTPリクエスト
GET https://ovp-s-api.smartstream.ne.jp/v1/merchants/:merchant_id/aggregations?<query>
URLパラメータ
フィールドタイプ説明サンプル必要性
merchant_idStringマーチャントIDnttsmc必須
クエリパラメータ
フィールドタイプ説明サンプル
media_idStringメディアID*****
targetString取得情報の種類下表参照
intervalString取得期間の単位下表参照
groupString取得情報の分類方法下表参照
fromString取得開始日時20180101000000
toString取得終了日時20181231235959
取得方法の種類(target)について
フィールド説明
play_count再生数(回)
device_count端末数
session_countセッション数
play_time再生時間(秒)
average_play_time平均再生時間(秒)
player_countプレイヤー表示数(回)
key_delivery_countDRMキー取得数(回)

targetを省略した場合はデフォルト値のplay_countが適用される。

取得期間の単位(interval)について
フィールド説明
month月毎
day日毎
hour時間毎
minute分毎

intervalを省略した場合はデフォルト値のdayが適用される。 DRMキー取得数のみ、時間毎、分毎の取得ができない。

取得情報の分類方法(group)について
フィールド説明
all統合
country国別
playerプレイヤー別
siteサイト別
deviceデバイス別
osOS別
percentage割合

groupを省略した場合はallが適用される。 DRMキー取得数のみ、all以外の取得ができない。

レスポンス
フィールド説明
date取得対象日時
group取得情報の分類

レスポンスの例

HTTP/1.1 200 OK
{
  [
    {
      "date": "2018/12/01 14:34",
      "all": 10
    },
    {
      "date": "2018/12/01 14:35",
      "all": 12
    },
    ...
  ]
}