從分析 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允許GET
和POST
,後者用於在請求正文中傳遞一些數據,而不是傳遞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確實具有date 和date_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分析中不可用的其他指標數量。