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

尺寸: video

在本主題中,您將了解 Analytics API video 尺寸。 的 video 維度通過視頻提供分析。 注意:如果您希望包含任何“視頻”。 字段(例如 video.name)中,您的客戶憑據必須包含CMS:視頻讀取權限。 另請注意,雖然您無法返回 video.custom_fields,您可以返回 video.custom_fields.{field_name}.

網址參數

Analytics API 報告支持以下URL參數。

URL參數
參數 產品描述 需要的 價值 默認
account 您要報告的帳戶 一個或多個帳戶ID作為逗號分隔的列表 沒有
dimensions 要報告的維度 一或多個維度,以逗號分隔列表(某些組合無效) 沒有
where 用於指定報告的過濾器 沒有 {dimension} == {value}-一個或多個作為用分號分隔的列表 沒有
limit 退貨數量 沒有 正整數 10
offset 要跳過的項目數 沒有 正整數 0
sort 用於排序項目的字段 沒有 請求的有效字段 video_view
fields 要返回的字段 沒有 根據您要報告的維度而變化 video_view
format 格式化以返回結果 沒有 json | csv | l JSON
reconciled 如果包含,則將結果限制為歷史或實時數據 沒有 真實| 假
from 請求的日期範圍的開始 沒有 ISO 8601日期(YYYY-MM-DD),紀元時間(以毫秒為單位),字符串alltime或相對日期(-1m); 參與度終結點僅允許使用過去32天內的日期,或者如果對帳=否,則只允許使用。 現在30天前
to 請求的日期範圍的結尾 沒有 ISO 8601日期(YYYY-MM-DD),紀元時間(以毫秒為單位),現在的字符串或相對數據(+ 7d); 參與度終結點僅允許使用過去32天內的日期,或者如果對帳=否,則只允許使用。 現在

可用字段

可以為維度返回以下字段。

  • ad_mode_begin -的次數 player 進入廣告模式
  • ad_mode_complete -的次數 player 完整的廣告模式
  • bytes_delivered -發送給客戶端計算機的總字節數 player 及相關媒體
  • engagement_score -視頻的參與度得分
  • play_request -請求播放視頻的總次數
  • play_rate -視頻的平均播放率(視頻觀看次數除以展示次數)
  • video -視頻ID
  • video_duration -視頻時長(如果已報告)
  • video_engagement_1 -視頻觀看次數的百分之一
  • video_engagement_100 -在視頻時長的100%處的觀看總數
  • video_engagement_25 -在視頻時長的25%處的觀看總數
  • video_engagement_50 -在視頻時長的50%處的觀看總數
  • video_engagement_75 -在視頻時長的75%時的觀看總數<
  • video_impression -視頻加載到的總次數 players
  • video_name -時間範圍內最近一次展示時的視頻名稱
  • video_percent_viewed -所有視頻觀看次數佔視頻觀看百分比。 例如,如果在此期間有兩個視圖,而在一個視圖中查看的百分比為78%,而在另一個視圖中為59%,則 video_percent_viewed 返回將是 137.
  • video_seconds_viewed -每個視頻觀看的平均觀看秒數
  • video_view -視頻播放開始的次數
  • video.reference_id -視頻的參考ID
  • video.name -視頻的當前名稱
  • video.description -視頻的當前描述
  • video.complete -視頻處理是否完成
  • video.created_at -創建視頻的日期/時間
  • video.duration -視頻的當前時長
  • video.economics -是否為視頻啟用了廣告
  • video.long_description -視頻的詳細說明
  • video.state -該視頻當前是否 ACTIVE or INACTIVE
  • video.tags -視頻的標籤
  • video.updated_at -上次修改視頻的日期/時間
  • video.custom_fields.{field_name} -名為“”的視頻的自定義字段的值 {field_name}
  • video_download_request -已啟用離線播放的視頻的下載請求數
  • video_download_complete -啟用離線播放的視頻被完全下載的次數
  • video_download_cancellation -啟用離線播放的視頻的下載次數被取消(包括在下載完成之前關閉頁面的次數)
  • video_download_error -由於發生錯誤,無法離線下載視頻的下載次數

篩選值

用作過濾器時,維可以縮小結果範圍。

過濾值:視頻ID(以逗號分隔的列表)或video.q == {視頻字段}:{值}

組合尺寸

要查看可以與之組合的尺寸,以及可以用於組合的字段,請參見 維度和字段.

索取範例

尺寸要求

    https://analytics.api.brightcove.com/v1/data?accounts=1752604059001&dimensions=video

篩選要求

    https://analytics.api.brightcove.com/v1/data?accounts=1752604059001&dimensions=video&where=video==4093643993001,1754276206001

響應

    Response will appear here when you test a request

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