支持 聯繫支持 | 系統狀況 系統狀態

Analytics API: Live 指標

本主題說明了可用於以下方面的分析指標 Live 流。

簡介

的播放指標 Live 由 Brightcove公司 Live 服務可以通過以下方式實時獲得 止痛藥API。 捕獲此數據用於 直播 只要; 不包括VOD播放。

API提供 Live 通過兩個端點流指標:

  • /v1/timeseries
  • /v1/events

兩者都查詢相同的數據集,但匯總結果不同。 本文檔介紹了它們的用法和語法。

指標

這些是通過 Live 端點。 查詢可能請求多個指標。

公制 產品描述
alive_ss_ad_start 服務器端廣告展示次數
ccu 獨特 會議; 不重複計數指紋 + 會議)
fingerprint_count 獨特 設備; 數量不同 指紋 (見下文)
video_impression 視頻加載到的次數 player
video_seconds_viewed 所有觀眾觀看的總秒數
video_view 流開始(非唯一)

獨特 跟踪,我們分配一個 指紋 通過組合(Remote IP + User-Agent + Player)。 請注意,我們不使用設備本身的實際硬件ID,這會降低準確性,但會保持我們的隱私合規性。

梳化床尺寸

支持以下組合 dimensionswhere 過濾鍵:

  • video
  • video, country
  • video, device_type

查詢參數

都選 Live 端點共享一些公共參數,這些參數控制查詢的範圍和分組。

參數 句法 需要的 默認 產品描述
外形尺寸 <dim1>,<dim2>,... Y - 查詢維度(GROUP BY)
度量 <metric1>,<metric2>,... Y - 一個或多個要報告的指標
哪裡 <dim1>=<value1>;... Y - 一個或多個查詢過濾器; 必須包含至少1個視頻
低至 <epoch> N 0 時間範圍開始
<epoch> N 現在 時間範圍結束

時間序列

/v1/timeseries 端點沿時間軸返回一個點列表,其中包含每個時間點所請求度量的值。 點是 1分鐘 存儲桶是默認設置,但可以通過參數進行更改。

在這種情況下,唯一指標(ccu, fingerprint_count)指出 最大值 在每個時段中的任何時候。 所以一個查詢 bucket_duration=1d 將返回每天的最大並發量,而帶有 bucket_limit=1 將在流中的任何點返回最大並發性。

的URI

/v1/timeseries/accounts/$account

附加參數

參數 句法 需要的 默認 產品描述
bucket_duration <n>m (分鐘)
<n>h (小時)
<n>d (天)
N 1m 每個點代表的持續時間。 1d 是24小時,而不是日曆日。
bucket_limit <n> N - 返回點數。 使用任一 bucket_duration or bucket_limit,但不能同時使用。

響應

{
"<metric1>": {
"data": [
  {
    "dimensions": {
        "account": "<account>",
        "<dim1>": "<key1>",
        ...
        "<dimN>": "<keyN>"
      },
    "points": [
      {
        "timestamp": <bucket1>,
        "value": <value1>
      },
      ...,
      {
        "timestamp": <bucketN>,
        "value": <valueN>
      },
    ]
  }
]
},
"<metric2>": {
...
},
...
}

活動

/v1/events 端點返回全部或部分指標的指標總計 Live 視頻流。

在這種情況下,唯一指標(ccu, fingerprint_count)代表 總價值 在查詢範圍內。 例如,沒有 from/to 參數將返回的總數 獨特 整個流的會話(ccu)和/或設備(fingerprint_count)。

的URI

/v1/events/accounts/$account

附加參數

沒有

響應

{
"data": [
{
  "dimensions": {
    "account": "<account>",
    "<dim1>": "<key1>",
    ...
    "<dimN>": "<keyN>"
  },
  "totals": {
    "<metric1>": <value1>,
    ...
    "<metricN>": <valueN>
  }
}
]
}

出口

事件端點還提供了可下載的報告:

/v1/events/accounts/$account/videos/$video/export?format=xlsx

回應是 XLSX 文件 Live 4張紙上的指標:

  • 總結
  • 並髮用戶
  • 按設備類型查看
  • 地理觀點

使用範例

對於所有這些示例,我們將使用 帳戶1234, 視頻5555,並假設當前時間為 UTC下午12:00:00 on 15年2020月XNUMX日.


獲取當前的觀看者計數(CCU) Live 流或頻道

在你的生活中 低至 到至少2分鐘前(11:58 AM),並使用最後一個 在回應中。

/v1/timeseries/accounts/1234?dimensions=video&metrics=ccu&where=video==5555&from=1581767880000


獲取CCU圖形點 Live 過去24小時內的視頻流

放大(1分鐘)

/v1/timeseries/accounts/1234?dimensions=video&metrics=ccu&where=video==5555&from=1581681600000&bucket_duration=1m

縮小(1小時點)

/v1/timeseries/accounts/1234?dimensions=video&metrics=ccu&where=video==5555&from=1581681600000&bucket_duration=1h


每天獲得最高CCU Live 過去7天的頻道

/v1/timeseries/accounts/1234?dimensions=video&metrics=ccu&where=video==5555&from=1581206400000&bucket_duration=1d


在任何情況下,任何時候均可獲得最高CCU Live 流

/v1/timeseries/accounts/1234?dimensions=video&metrics=ccu&where=video==5555&bucket_limit=1


獲取多個的唯一觀看者總數和觀看秒數 Live 流

視頻5555已完成; 數字是最終的。 視頻5556仍處於活動狀態; 數字是運行總數。

/v1/events/accounts/1234?dimensions=video&metrics=fingerprint_count,video_seconds_viewed&where=video==5555,5556


在電視上獲取一個小時的節目的觀看次數和廣告總計 Live 渠道<

節目播出時間為10:00 AM至11:00 AM(UTC)

/v1/events/accounts/1234?dimensions=video&metrics=alive_ss_ad_start,video_view,fingerprint_count&where=video==5555&from=1581760800000&to=1581764399999


在某段時間內按國家/地區獲取觀看次數 Live 流

/v1/events/accounts/1234?dimensions=video,country&metrics=video_view,fingerprint_count&where=video==5555


頁面最後更新於12年2020月XNUMX日