尺寸:player

在本主題中,您將了解Analytics APIplayer尺寸。的player維提供視頻播放器的分析。

網址參數

分析 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 -影片的平均播放率 (影片觀看次數除以曝光次數)
  • player -玩家 ID
  • player_load -玩家載入的次數
  • player_name
  • video_engagement_1 -影片 1% 點的觀看次數
  • video_engagement_100 -在播放器中播放的視頻持續時間的100%,總觀看次數
  • video_engagement_25 -在播放器中播放的視頻持續時間的25%時的總觀看次數
  • video_engagement_50 -在播放器中播放的視頻持續時間的50%時的總觀看次數
  • video_engagement_75 -在播放器中播放的視頻持續時間的75%時的總觀看次數
  • video_impression -加載到播放器的視頻總數
  • video_percent_viewed -播放器中影片觀看的百分比總和
  • video_seconds_viewed -播放器中觀看影片的總秒數
  • video_view -播放器中視訊播放開始的總時間

篩選值

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

過濾值:播放器ID以逗號分隔列表

組合尺寸

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

索取範例

尺寸要求

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

篩選要求

    https: //analytics.api.brightcove.com/v1/data?accounts=1752604059001&dimensions=player&where=player==qsvobWoRx
示例響應
{
  “item_count”:102、
  “項目”: [
    {
      “video_view”:1、
      “玩家”:“players.brightcove.com/1752604059001/Y4jYJKe82_default”
    },
    {
      “video_view”:1、
      “玩家”:“players.brightcove.com/1752604059001/AGkFatykc_default”
    },
    {
      “video_view”:1、
      “玩家”:“players.brightcove.com/1752604059001/default_default/true”
    },
    {
      “video_view”:2、
      “玩家”:“players.brightcove.com/1752604059001/1OHQdsTAr_default”
    },
    {
      “video_view”:2、
      “玩家”:“players.brightcove.com/1752604059001/HybvHcK_default”
    },
    {
      “video_view”:2、
      “玩家”:“players.brightcove.com/1752604059001/27mn0s7nD_default”
    },
    {
      “video_view”:3、
      “玩家”:“players.brightcove.com/1752604059001/b547079e-00cc-4585-b354-04020a7ed70a_default”
    },
    {
      “video_view”:3、
      “玩家”:“players.brightcove.com/1752604059001/WRgbJgqAe_default”
    },
    {
      “video_view”:3、
      “玩家”:“players.brightcove.com/1752604059001/B1ELWRgeg_default”
    },
    {
      “video_view”:4、
      “玩家”:“players.brightcove.com/1752604059001/YQMkeKRuP_default”
    }
  ]、
  “概括”: {
    “video_view”:+45135
  }
 }