プレゼンテーションの統計

各プレゼンテーションオブジェクトの統計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(およびshared_views)の数:

    {
        "count": 1,
        "next": null,
        "previous": null,
        "results": [
            {
                "shared_views": 7,
                "country_name": "Poland",
                "country_code": "PL",
                "views": 245
            }
        ]
    }

    shared_viewsは、現在のプレゼンテーションから作成された共有プレゼンテーションのビューの数です。

    プレゼンテーションの共有は、ORBITVU SUNのCUSTOMサブスクリプションプランでのみ利用可能です。 詳細はお問い合わせください。
     

  • cities
    特定の日付範囲(改ページされた)で国と都市別にグループ化されたプレゼンテーションのviews(およびshared_views)の数: 
{
    "count": 1,
    "next": null,
    "previous": null,
    "results": [{
        "name": "Pila",
        "views": 20,
        "shared_views": 2,
        "country": "Poland",
        "country_code": "PL",
        "country_name": "Poland"
     }]
}
  • referers
    referersで指定した日付範囲(改ページされた)でグループ化されたプレゼンテーションのviews(およびshared_views)の数: 

{
   "count": 1,
   "next": null,
   "previous": null,
   "results": [
       {"shared_views": 0,
        "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",
            "shared_views": 0,
            "total_views": 0,
            "views": 0
        },
        {
            "date": "28-02-2015",
            "shared_views": 0,
            "total_views": 0,
            "views": 0
        },
        {
            "date": "01-03-2015",
            "shared_views": 0,
            "total_views": 0,
            "views": 0
        },
        ...
    ]

    返されたデータ:

    • views は現在表示されているプレゼンテーションのビューの数です
    • shared_views は、現在のプレゼンテーションから共有されたプレゼンテーションのビューの数です
    • total_views は、viewsshared_viewsのビュー数の合計です 。

フィルタリング

フィルタリングは、date_rangeパラメータとdate_range_startdate_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 のエンドポイントでのみ有効です。 他の統計については、データは最大1年間保持されます!

返された値は、選択した日付範囲のビューの累積数を定義する辞書のリストです。 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": [
        {
            "shared_views": 7,
            "hostname": "http://orbitvu.co/001/YmPwzTdd3DSsiWD9peD9c6/ov3602/3/view",
            "views": 0
        }
    ]
}