イントロダクション

Exit Gamesのアナリティクス・サービスバックエンドAPIの説明です。 ご不明点は [email protected] までメールでお問い合わせください。 アナリティクスAPIはHTTPサービスで、Photon CloudアプリケーションデータやPhoton Serverライセンスの利用状況を測定できます。 利用可能なエンドポイントについては、 APIリファレンス を参照してください。

パラメータの説明

共通APIパラメータ

これらは様々なリクエストに共通して使用されます。
パラメータ 型 説明 
appid
 string クエリが作成されるアプリケーションカウンターデータのIDです。Photon Cloudのダッシュボードから取得してください。 
hash
 string クエリが作成されるライセンスカウンターデータのハッシュです。Photon Serverのダッシュボードから取得してください。 
region
 string クエリを作成するリージョンのリージョントークンです。 利用可能なリージョントークンについては、 リージョンドキュメントを参照してください。 
{parameters}
 URL parameters string オプションのクエリstringパラメータです（下記を参照してください）。

オプションのクエリStringパラメータ

APIリクエストの精度を上げるための、オプションのパラメータです。
パラメータ 型 説明 
start
 string

クエリ対象のデータの開始時間を指定してください。UTCタイムスタンプとして渡されます: YYYY-MM-DD[Thh:mm:ss]。
オプション部分[Thh:mm:ss] を省略すると、渡した日付の協定世界時(UTC) 午前0時から自動的に開始します。

開始時間を全く渡さない場合、過去24時間のデータがクエリされます。

 
end
 string クエリ対象のデータの終了時間を指定してください。
クエリ対象のデータの終了時間を省略すると、データは"now"で終了します。 		 
width
 number

画像リクエストのみに適用されます。ピクセル単位の幅で、最大1600ピクセルまで指定可能です。1600ピクセルを超えた場合にはエラーが返されます。

 
height
 number

画像リクエストのみに適用されます。ピクセル単位の高さで、最大1600ピクセルまで指定可能です。1600ピクセルを超えた場合にはエラーが返されます。

Photon Cloudアプリケーション

利用可能なカウンター

カウンター名 説明 
TrafficMultiplayer
 Realtimeアプリケーション上で送受信するトラフィックの合計（平均）です。 
TrafficChat
 Chatアプリケーション上で送受信するトラフィックの合計（最大）です。 
Rooms
 同時に開いているルームの数（最大）です。 
Channels
 同時に開いているチャネルの数（最大）です。 
Messages
 開いているすべてのゲームでの1秒ごとのメッセージ数（最大）です。 
Ccu
 アプリケーションのCCU数。ルームやロビーのユーザー数の総計（最大）です。 
Rejects
 プランのCCU数を超過したため拒否されたプレイヤーの数（最大）です。 
DisconnectRate
 1秒ごとおよびルームごとの、クライアントからのリクエストではない切断の比率（最大）です。 
MessagesPerRoom
 1秒ごとおよびルームごとのメッセージ数（最大）です。 
MessagesPerChannel
 1秒ごとおよびチャネルごとのメッセージ数（最大）です。 
MessagesPerCcu
 1秒ごとおよびCCUごとのメッセージ数（最大）です。

バルクデータリクエスト /bulkdata/app

サンプル

リクエストで設定した各クエリ記述（各id)に対して、レスポンスでは各idにマッピングされたエントリーを取得できます。
リクエスト レスポンス 
[
  {
    "id": "europe",
    "appid": "5e1fb724-7139-4b96-aa67-9d4c37b27bb0",
    "cloud": "public",
    "cluster": "default",
    "region": "eu",
    "template": "Ccu"
  },
  {
    "id": "usa",
    "appid": "e83b9029-cc93-4d1c-a9c4-9bbc73ea1f68",
    "cloud": "public",
    "cluster": "default",
    "region": "us",
    "template": "Ccu"
  }
]
 
{
  "europe": 0,
  "usa": 3748.37
}

バルクXportリクエスト /bulkxport/app

サンプル

リクエストで設定した各クエリ記述（各id)に対して、レスポンスでは各idにマッピングされたエントリーを取得できます。
リクエスト レスポンス 
[
  {
    "id": "europe",
    "appid": "5e1fb724-7139-4b96-aa67-9d4c37b27bb0",
    "cloud": "public",
    "cluster": "default",
    "region": "eu",
    "template": "Ccu"
  },
  {
    "id": "usa",
    "appid": "e83b9029-cc93-4d1c-a9c4-9bbc73ea1f68",
    "cloud": "public",
    "cluster": "default",
    "region": "us",
    "template": "Ccu",
    "xporttime": "time"
  }
]
 
{
  "europe": {
    "ds2": [
      11722,
      12242,
      12818,
      13020,
      ...
    ]
  },
  "usa": {
    "ds2": [
      1934,
      7802,
      8144,
      8897,
      ...
    ],
    "time": [
      1.4987268e+09,
      1.4987286e+09,
      1.4987304e+09,
      1.4987322e+09,
      ...
    ]
  }
}

バルクデータおよびXportリクエスト /bulk/app

サンプル

リクエストで設定した各クエリ記述（各id)に対して、レスポンスでは各idにマッピングされたエントリーを取得できます。
リクエスト レスポンス 
[
  {
    "id": "europe",
    "appid": "5e1fb724-7139-4b96-aa67-9d4c37b27bb0",
    "cloud": "public",
    "cluster": "default",
    "region": "eu",
    "template": "Ccu"
  },
  {
    "id": "usa",
    "appid": "e83b9029-cc93-4d1c-a9c4-9bbc73ea1f68",
    "cloud": "public",
    "cluster": "default",
    "region": "us",
    "template": "Ccu",
    "xporttime": "time"
  }
]
 
{
  "europe": {
    "data": 18622,
    "xport": {
      "ds2": [
        11722,
        12242,
        12818,
        13020,
        ...
      ]
    }
  },
  "usa": {
    "data": 15285,
    "xport": {
      "ds2": [
        1934,
        7802,
        8144,
        8897,
        ...
      ],
      "time": [
        1.4987268e+09,
        1.4987286e+09,
        1.4987304e+09,
        1.4987322e+09,
        ...
      ]
    }
  }
}

PhotonServerライセンス

利用可能なカウンター

カウンター名 説明 
Servers
 実行中のインスタンス数です。各インスタンスは単一のハードウェアIDから構成されます。 
CCU
 ライセンスに接続されたCCUの総計です。

バルクデータリクエスト /bulkdata/license

サンプル

リクエストで設定した各クエリ記述（各id)に対して、レスポンスでは各idにマッピングされたエントリーを取得できます。
リクエスト レスポンス 
[
  {
    "id": "ccu",
    "hash": "0xc648c47f82c70b723f0225e12b8ce4f2",
    "template": "Ccu"
  },
  {
    "id": "servers",
    "hash": "0xc648c47f82c70b723f0225e12b8ce4f2",
    "template": "Servers"
  }
]
 
{
  "ccu": 765,
  "servers": 3
}