使用 Analytics 2.0 API 取得媒體播放時間 JSON 報告資料 get-media-playback-time-spent-json-report-data

您可以使用 Analytics 2.0 API 取得媒體播放時間報告資料。

  1. 使用 UI 上建置的任何區段來篩選資料。若要依據特定內容 ID 進行篩選,請建立新的區段。

  2. 視您想要以秒或分輸出而定,請將請求內文中的 elements -> id 設為 metrics/playback_time_spent_secondsmetrics/playback_time_spent_minutes

  3. 要求足夠的資料量。

    • 您在報表中指定的資料範圍會​_在視訊工作階段結束時_收集所有同時檢閱者資料。
      您必須說明在某一天開始並在午夜後結束 (亦即隔天) 的工作階段。

    • 在要求中要求比目標期間多一天的資料,但在分析中​ 僅使用目標期間的資料

一天資料的範例要求裝載如以下範例所示。要求會連續執行 2 天,但在報表中僅使用第一天的資料。

範例要求

{
    "rsid": "[YOUR_RSID]",
    "locale": "en_US",
    "dimension": "variables/daterangeminute",
    "globalFilters": [
        {
            "dateRange": "2021-09-02T00:00/2021-09-03T00:00",
            "type": "dateRange"
        }
    ],
    "metricContainer": {
        "metrics": [
            {
                "columnId": "column1",
                "id": "metrics/playback_time_spent_minutes"
            }
        ]
    },
    "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 2021-09-02",
         "data":[
            123.0
         ]
      },
      {
         "itemId":"12008020001",
         "value":"00:01 2021-09-02",
         "data":[
            143.0
         ]
      },
      {
         "itemId":"12008020002",
         "value":"00:02 2021-09-02",
         "data":[
            167.0
         ]
      },

      ...
      {
         "itemId":"12008022359",
         "value":"23:59 2021-09-02",
         "data":[
            768.0
         ]
      }
   ],
   "summaryData":{
      "filteredTotals":[
         17124.0
      ],
      "totals":[
         18453.0
      ]
   }
}
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb