支持 聯繫支持 | 系統狀況 系統狀態
頁面內容

    Analytics API: Live 指標

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

    簡介

    的播放指標 Live 由 Brightcove公司 Live 服務可以通過以下方式實時獲得 Analytics 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=7d


    在任何情況下,任何時候均可獲得最高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


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