尺寸：video

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

網址參數

分析 API 報表支援下列 URL 參數。

網址參數
參數 描述 必填 值 預設
account 您要報告的帳戶 是 一個或多個帳戶ID作為逗號分隔的列表 無
dimensions 要報告的維度 是 一個或多個維度作為逗號分隔列表（某些組合無效 - 使用 此處的交互式工具 確定組合是否有效） 無
where 用於指定報告的過濾器 否 {dimension}=={value} - 一個或多個以分號分隔的列表。該值將是該維度主要指標的一個或多個值。例如：video==video_idcountry=country-code、或viewer=viewer_id（在最後一種情況下，viewer_id 的形式將根據您是自己捕獲和發送某種 viewer_id，還是根據分析系統生成的值而有所不同）。 無
limit 退貨數量 否 正整數 +10
offset 要跳過的項目數 否 正整數 0
sort 用於排序項目的字段 否 請求返回的任何字段 video_view
fields 要返回的字段 否 根據您要報告的維度而變化 視頻，video_view
format 格式化以返回結果 否 json（默認）|格式 | xlxs json
reconciled 如果包含，會將結果限制為歷史數據或實時數據。分析資料來自多個來源：有些是由播放程式傳送，但其他資料則是從 CDN 和 Video Cloud 系統收集。為了盡快提供分析，我們會在可用時立即開始提供「即時」資料，然後在收集和處理所有來源的資料後稍後調整分析。完全處理後的數據稱為已協調 否 真實|假 真正
from 請求的日期範圍的開始 否 下列其中一項：
  • ISO 8601 日期 (YYYY-MM-DD)
  • 以毫秒為單位的紀元時間（例如：1659641316719 [= 2022 年 8 月 4 日星期四 7:28:36.719 PM GMT]）。請參閱 大紀元時間轉換器。
  • 一個字符串：from=alltime
  • +/-以天（d），週（w）或月（m）為單位的相對日期-例如：from=-6m&to=%2B2w（從 6 個月前到 2 週之後的時間段-請注意，+ 符號需要被 URI 編碼為%2B）

參與端點或如果 reconciled=false，則只允許過去 32 天內的日期。

 -30d
to 請求的日期範圍的結尾 否 下列其中一項：
  • ISO 8601 日期 (YYYY-MM-DD)
  • 以毫秒為單位的紀元時間（例如：1659641316719 [= 2022 年 8 月 4 日星期四 7:28:36.719 PM GMT]）。請參閱 大紀元時間轉換器。
  • 一個字符串：to=now
  • +/-以天（d），週（w）或月（m）為單位的相對日期-例如：from=-6m&to=%2B2w（從 6 個月前到 2 週之後的時間段-請注意，+ 符號需要被 URI 編碼為%2B）

參與端點或如果 reconciled=false，則只允許過去 32 天內的日期。

 現在

可用字段

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

  • ad_mode_begin -玩家進入廣告模式的次數
  • ad_mode_complete -播放器完成廣告模式的次數
  • bytes_delivered -傳送至用戶端電腦的播放器和相關媒體的位元組總數
  • engagement_score -視頻的訂婚分數
  • play_request -要求播放視訊的總次數
  • play_rate -影片的平均播放率 (影片觀看次數除以曝光次數)
  • video -視頻ID
  • video_duration -視頻時長（如果已報告）
  • video_engagement_1 -影片 1% 點的觀看次數
  • video_engagement_100 -100% 影片持續時間點的總觀看次數
  • video_engagement_25 -影片持續時間 25% 的總觀看次數
  • video_engagement_50 -影片持續時間 50% 的總觀看次數
  • video_engagement_75 -在視頻時長的75％時的觀看總數<
  • video_impression -視頻加載到播放器中的總次數
  • 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要么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
示例響應 
{
	“item_count”：123、
	“項目”： [
		{
			“視頻”："2180741085001",
			“video_view”：1
		}，
		{
			“視頻”："4446941108001",
			“video_view”：1
		}，
		{
			“視頻”："2535301903001",
			“video_view”：1
		}，
		{
			“視頻”："5323136098001",
			“video_view”：1
		}，
		{
			“視頻”："1732474228567874935",
			“video_view”：1
		}，
		{
			“視頻”："1723783757463121178",
			“video_view”：1
		}，
		{
			“視頻”："4454620114001",
			“video_view”：1
		}，
		{
			“視頻”："5271819050001",
			“video_view”：1
		}，
		{
			“視頻”："2026627035001",
			“video_view”：1
		}，
		{
			“視頻”："4446941103001",
			“video_view”：2
		}
	]、
	“概括”： {
		“video_view”：+45136
	}
 }