Show Menu
トピック×

Analytics 2.0 API を使用した同時視聴者の JSON レポートデータの取得

Analytics 2.0 API を使用して、同時視聴者レポートデータを取得できます。
  1. UI に組み込まれた任意のセグメントを使用してデータをフィルタリングします。特定のコンテンツ ID でフィルタリングするには、新しいセグメントを作成します。
  2. リクエスト本文の elements -> id metrics/concurrent_viewers_visitors に設定します。
  3. 十分な量のデータをリクエストします。
    • レポートで指定したデータ範囲で、ビデオセッション終了時に、すべての同時ビューアデータを取得します​ ​ある日に開始し、真夜中以降(つまり翌日)に終了するセッションを考慮する必要があります。
    • 分析で、リクエストで意図した期間より 1 日分多いデータをリクエストしますが、 意図したデータのみを使用します。
1 日分のデータに対するリクエストペイロードの例は、次のようになります。リクエストは 2 日間連続でおこなわれますが、レポートでは、最初の日のみを使用します。

リクエストのサンプル

{
    "rsid": "[YOUR_RSID]",
    "locale": "en_US",
    "dimension": "variables/daterangeminute",
    "globalFilters": [
        {
            "dateRange": "2020-09-02T00:00/2020-09-03T00:00",
            "type": "dateRange"
        }
    ],
    "metricContainer": {
        "metrics": [
            {
                "columnId": "column1",
                "id": "metrics/concurrent_viewers_visitors"
            }
        ]
    },
    "settings": {
        "dimensionSort": "asc",
        "limit": "2000",
        "page": 0
  }
}

応答のサンプル

{
   "totalPages":1,
   "firstPage":true,
   "lastPage":true,
   "numberOfElements":1440,
   "number":0,
   "totalElements":1440,
   "columns":{
      "dimension":{
         "id":"variables/daterangeminute",
         "type":"time"
      },
      "columnIds":[
         "column1"
      ]
   },
   "rows":[
      {
         "itemId":"12008020000",
         "value":"00:00 2020-09-02",
         "data":[
            123.0
         ]
      },
      {
         "itemId":"12008020001",
         "value":"00:01 2020-09-02",
         "data":[
            143.0
         ]
      },
      {
         "itemId":"12008020002",
         "value":"00:02 2020-09-02",
         "data":[
            167.0
         ]
      },

      ...
      {
         "itemId":"12008022359",
         "value":"23:59 2020-09-02",
         "data":[
            768.0
         ]
      }
   ],
   "summaryData":{
      "filteredTotals":[
         17124.0
      ],
      "totals":[
         18453.0
      ]
   }
}