統計URLはプレゼンテーションオブジェクト毎に返されます。
https://orbitvu.co/api/v1/presentations/<id>/statistics/[.json|.xml]返されるデータ
このエンドポイントは特定の統計データへのURLのリストを返します。
結果の例：
{
"countries": "https://orbitvu.co/api/v1/presentations/46/statistics/countries",
"cities": "https://orbitvu.co/api/v1/presentations/46/statistics/cities",
"referers": "https://orbitvu.co/api/v1/presentations/46/statistics/referers",
"views": "https://orbitvu.co/api/v1/presentations/46/statistics/views"
"views2": "https://orbitvu.co/api/v1/presentations/46/statistics/views/2/",
}すべての統計URLは、date_rangeパラメータでフィルタリングできます。 戻り値は次のとおりです。
- countries
特定の日付範囲（ページ分けされた）で国別にグループ化されたプレゼンテーションのviewsの数
結果の例：：
{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"country_name": "Poland",
"country_code": "PL",
"views": 245
}
]
}- cities
特定の日付範囲（ページ分けされた）で国と都市別にグループ化されたプレゼンテーションのviewsの数
結果の例：
{
"count": 1,
"next": null,
"previous": null,
"results": [{
"name": "Pila",
"views": 20,
"country": "Poland",
"country_code": "PL",
"country_name": "Poland"
}]
}- referers
特定の日付範囲（ページ分けされた）でリファラー別にグループ化されたプレゼンテーションのviewsの数
結果の例：
{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"hostname": http://orbitvu.co/001/YmPwz3333DSsiWD9peD9c6/ov3602/3/view",
"views": 10
}
]
}リファラーには追加のフィルタリングオプションがあります。 date_range_start および date_range_end パラメータを使用して特定の日付範囲を指定することができます。
詳細は後述する「フィルタリング」セクションの詳細を参照してください。
- views
特定の日付範囲のビューの数。 このエンドポイントは下位互換性のために用意されており、より多くの情報を提供する views2 エンドポイントを使用することが推奨されます。
結果の例：
[
{
"27-02-2015": 0
},
{
"28-02-2015": 0
},
{
"01-03-2015": 0
},
{
"02-03-2015": 0
},
{
"03-03-2015": 0
},
...
]- views2
特定の日付範囲のビューの数。 views とは異なるフォーマットです。
結果の例：
[
{
"date": "27-02-2015",
"total_views": 0,
"views": 0
},
{
"date": "28-02-2015",
"total_views": 0,
"views": 0
},
{
"date": "01-03-2015",
"total_views": 0,
"views": 0
},
...
]返されるデータの説明：
-
views は現在表示されているプレゼンテーションのビューの数です
- total_views はviewsの合計です
フィルタリング
フィルタリングは、date_rangeパラメータとdate_range_start、date_range_end（リファラーエンドポイントのみ）で行うことができます
可能な値と形式：
- date_rangeの値: last_year, last_month, last_week, years, this_month, this_year, range
- date_rangeのデフォルト値: last_month
- date_range_start と date_range_end の形式: YYYY-mm-dd
rangeの値はリファラーの統計にのみ有効で、追加のクエリ文字列パラメータとしてdate_range_start および date_range_end が指定されている場合にのみ機能します。
years の値は、views と views2 のエンドポイントでのみ有効です。 他の統計については、データは最大１年間保持されます！
返された値は、選択した日付範囲のビューの累積数を定義する辞書のリストです。
例えばlast_weekの場合は次のようになります：
URL: https://orbitvu.co/api/v1/presentations/1233/statistics/views.json?date_range=last_week
上記のURLは説明のために使用されているダミーで、実際にアクセスしても動作しません。
結果の例：
[
{
"13-09-2014": 130
},
{
"14-09-2014": 332
},
{
"15-09-2014": 265
},
{
"16-09-2014": 198
},
{
"17-09-2014": 390
},
{
"18-09-2014": 323
},
{
"19-09-2014": 302
}
]range 付きの referers の場合：
URL: https://orbitvu.co/api/v1/presentations/1234/statistics/referers.json?date_range=range&date_range_start=2015-03-01&date_range_end=2015-04-01
結果の例：
{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"hostname": "http://orbitvu.co/001/YmPwzTdd3DSsiWD9peD9c6/ov3602/3/view",
"views": 0
}
]
}