video
尺寸。 的 video
維度通過視頻提供分析。 注意:如果您希望包含任何“視頻”。 字段(例如 video.name
)中,您的客戶憑據必須包含CMS:視頻讀取權限。 另請注意,雖然您無法返回 video.custom_fields
,您可以返回 video.custom_fields.{field_name}
.網址參數
Analytics API 報告支持以下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天內的日期 engage端點或如果已協調=否。 | 現在30天前 |
to |
請求的日期範圍的結尾 | 沒有 | ISO 8601日期(YYYY-MM-DD),紀元時間(以毫秒為單位),現在的字符串或相對數據(+ 7d); 僅允許過去32天內的日期 engage端點或如果已協調=否。 | 現在 |
可用字段
可以為維度返回以下字段。
ad_mode_begin
-的次數 player 進入廣告模式ad_mode_complete
-的次數 player 完整的廣告模式bytes_delivered
-總字節數delive紅色到客戶端計算機 player 及相關媒體engagement_score
- “ engage視頻的得分play_request
-請求播放視頻的總次數play_rate
-視頻的平均播放率(視頻觀看次數除以展示次數)video
-視頻IDvideo_duration
-視頻時長(如果已報告)video_engagement_1
-視頻觀看次數的百分之一video_engagement_100
-在視頻時長的100%處的觀看總數video_engagement_25
-在視頻時長的25%處的觀看總數video_engagement_50
-在視頻時長的50%處的觀看總數video_engagement_75
-在視頻時長的75%時的總觀看次數video_impression
-視頻加載到的總次數 playersvideo_name
-時間範圍內最近一次展示時的視頻名稱video_percent_viewed
-所有視頻觀看次數佔視頻觀看百分比。 例如,如果在此期間有兩個視圖,而在一個視圖中查看的百分比為78%,而在另一個視圖中為59%,則video_percent_viewed
返回將是 137.video_seconds_viewed
-每個視頻觀看的總秒數video_view
-視頻播放開始的次數video.reference_id
-視頻的參考IDvideo.name
-視頻的當前名稱video.description
-視頻的當前描述video.complete
-視頻處理是否完成video.created_at
-創建視頻的日期/時間video.duration
-視頻的當前時長video.economics
-是否為視頻啟用了廣告video.long_description
-視頻的詳細說明video.state
-該視頻當前是否ACTIVE
orINACTIVE
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