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

    從分析 REST API 移轉至布萊特灣分析 API

    本主題提供從 Oooyala 分析 REST API 移至視訊雲端分析 API 的指引。

    簡介

    視頻雲Analytics API與Ooyala Analytics REST API非常相似。

    另請注意,Video Cloud Studio中的Google Analytics(分析)模塊包括強大的功能自定義報告生成器在許多情況下可能根本不需要使用API。

    以下各節對應於兩個API的不同方面:

    驗證

    Brightcove API請求的身份驗證與Ooyala REST API的身份驗證稍有不同。看到Brightcove API請求的身份驗證有關詳細信息。

    報告

    /reports Ooyala Analytics REST API的端點非常接近Brightcove Analytics API/data端點。主要區別在於Ooyala API允許GETPOST,後者用於在請求正文中傳遞一些數據,而不是傳遞URL參數,從而允許使用更長的數據字符串。

    參數

    這兩個API的請求參數相似。下表中對它們進行了詳細說明,以向您顯示差異所在。

    參數
    Ooyala參數 Brightcove參數 文件
    accounts -作為參數包含在多個帳戶的所有報告中 標註、欄位和參數概述
    report_type 沒有,但Brightcove API為參與度和實時分析報告提供了一些其他終結點 概述:分析 API
    start_date from這兩個參數相似,並且都接受以下形式的值YYYY-MM-DD ; Brightcove參數還接受以毫秒為單位的紀元日期和相對日期,例如-3d 標註、欄位和參數概述
    end_date to這兩個參數相似,並且都接受以下形式的值YYYY-MM-DD ; Brightcove參數還接受以毫秒為單位的紀元日期和相對日期,例如-3d 標註、欄位和參數概述
    metrics fields -這兩個參數本質上是相同的; Brighcove API也使用metrics用於實時分析請求;看到指標有關可用的度量標準的信息 標註、欄位和參數概述
    dimensions dimensions -這兩個參數本質上是相同的; Brighcove API也使用metrics用於實時分析請求;看到外型尺寸有關可用尺寸的信息 標註、欄位和參數概述
    filters where -除了名稱,兩個參數本質上是相同的;看到篩選器下面的更多信息 標註、欄位和參數概述
    time_segment 沒有-Brightcove API確實具有datedate_hour尺寸,可以提供類似的時間分段,還可以提供前32天內的互動目標,從而可以觀看視頻的第100部分 標註、欄位和參數概述
    sort sort參數相同,除了Ooyala API允許對多個指標進行排序 標註、欄位和參數概述
    limit limit -參數相同,但Ooyala API參數的上限為1000 標註、欄位和參數概述
    page offset -參數採用不同的值,但在分頁數據集時工作類似 標註、欄位和參數概述
    reconciled -由於分析數據來自不同來源的時間表,因此Brightcove API在仍在更新數據時將最新分析數據放入“未協調”存儲桶中,然後將其傳輸到“歷史”存儲桶中;參數允許您在這些存儲桶之間進行選擇 標註、欄位和參數概述
    bucket_limit -僅適用於Live Analytics請求;和...一起bucket_duration,這些功能在某種程度上類似於Ooyala API time_segment參數 標註、欄位和參數概述
    bucket_duration 標註、欄位和參數概述

    尺寸

    Ooyala和Brightcove Analytics API都將數據分組到稱為“維度”的存儲桶中。它們的使用方式相似,但是API在如何組合多個維度方面有一些不同的規則,而Brightcove擁有更廣泛的維度集。看到支持的尺寸組合有關Brightcove API的詳細信息。下表提供了詳細的比較。

    尺寸
    Ooyala尺寸 亮灣尺寸 文件
    asset video -Brightcove video維度僅涵蓋VOD資產;還有一個live_stream尺寸 視頻尺寸
    country country -尺寸基本相同 國家維度
    region region -尺寸基本相同,除了Brightcove尺寸包括美國各州 區域維度
    dma N/A
    state region -Brightcove API在region尺寸 區域維度
    device_type device_type -尺寸基本相同 設備類型尺寸
    domain destination_domain 目標網域維度
    url device_os -基本相同 設備操作系統尺寸
    os destination_domain -不完全相同,但最接近 目標網域維度
    pcode account 帳戶尺寸
    player_id player 播放器尺寸
    browser_type 瀏覽器類型尺寸
    date 日期維度
    date_hour 日期-小時維度
    device_manufacturer 設備製造商尺寸
    referrer_domain 引薦來源域維度
    search_terms 搜索字詞維度
    social_platform 社交平台維度
    source_type 源類型尺寸

    篩選器

    過濾器在兩個API中的工作原理幾乎相同,分別以下列方式指定:

          
            // Ooyala
            filter={dimension1}=={value1};{dimension2}=={value2}
          
            // Brightcove
            where={dimension1}=={value1};{dimension2}=={value2}
          

    度量

    metrics(對於Brightcove API:fields報告中返回的)取決於Brightcove Analytics API要求的尺寸。您可以使用內嵌的工具尺寸和領域查看可以針對特定維度或維度組合返回哪些字段。

    請注意,雖然Ooyala API未指定所有指標,但會返回所有指標,但是Brightcove API僅返回一小部分默認指標,這些指標會因維度(組合)而異,除非您包括fields在請求中。

    Brightcove字段包含所有Ooyala指標的等效項,但以下各項除外:

    • uniq_plays_requested
    • uniq_displays
    • uniq_video_starts

    光明灣Analytics API還可以返回Ooyala分析中不可用的其他指標數量。