常見問題集:分析 API

以下是關於分析 API 的一些常見問題。如需有關影片雲工作室分析模組的一些常見問題的解答,請參閱常見問題集:分析模塊

日期範圍

如何獲得特定日期的數據?
fromto值設置為該日期。例如:from=2013-05-12&to=2013-05-12 .此外,您可以通過以下方式查詢date方面,它可以與其他尺寸相結合。
Analytics 模塊和應該為我Analytics API提供相同日期範圍的相同數據嗎?
是的,但是如果您比較的是相對較新的數據,並且在不同的時間從Studio和API獲取數據,則它們可能會有所不同:
  1. 數據不到3天。少於 3 天的分析資料為暫時性資料,可能隨時變更。
  2. 在小於32天的時間裡查看同一時期的數據,在小於32天的時候再查看一次。32 天後,數據被移動到一個單獨的「歷史」存儲庫,並在這一點上丟棄一些數據,特別是詳細的參與數據。這意味著諸如參與度分數之類的計算字段可能會略有變化,因為該計算是針對粒度較小的數據進行的。

數據粒度

最近的Google Analytics(分析)數據的粒度是多少?
對於最近 32 天(包括當天),Analytics API報告一小時的粒度,因為它會將值儲存到每小時值區中。但是,當前時間仍在填充中,因此,當您要求輸入當前時間中的數據時,與小時相比,這可以使API具有更精細的外觀。

例如:

  1. 如果您要求 3 小時前 9:15 和 9:20 的資料,如果它們落在同一個小時的時段中,您可能會獲得相同的值;但是,它們可能會有所不同,因為所有分析資料都是暫時的,並且可能會有所變更,直到調和為止。
  2. 如果您要求10分鐘前的數據,然後等待5分鐘,然後再次詢問,即使它在同一存儲桶中,您也可能會獲得不同的值,因為該存儲桶仍在更新中。
分析數據的刷新間隔是多少?
/ data端點當前在兩次查詢之間被緩存5分鐘,因此對於最近一小時的流量列表而言,5分鐘的間隔是最小的延遲,這將使您有一個工作增量。
歷史分析數據的粒度是多少?
對於早於過去 32 天的日期,Analytics API報告全天值。這意味著,如果您要求from=1368334306919&to=1378446336919(從 2013 年 5 月 12 日星期日 04:51:46 格林尼治標準時間至 2013 年 9 月 6 日星期五 05:45:36 格林尼治標準時間),您將獲得與您要求相同的結果from=2013-05-12&to=2013-09-06

項目和領域

判斷一個或多個視頻在一個時段內有多少個視頻流開始的最佳方法是什麼?
只要看一下video_view度量標準-這將永遠等於流開始。您可以在所有報告中看到此指標,摘要中會顯示您在查詢的日期範圍內所有視頻的流媒體開始播放。要查看您帳戶中所有視頻的視頻流開始,您只需運行以下請求:
    https://analytics.api.brightcove.com/v1/data?accounts={account_ids}&dimensions=video&limit=all&offset=0&fields=all
如何退回報告中的所有項目
設置limit的參數報告等於all .
默認情況fields下返回的項目數據是什麼?
默認情況下,僅返回video_view與請求的維度相對應的字段(例如destination_domain)。若要取得其他欄位,fields=field_name1,field_name2請設定為傳回選取的欄位。
如果字段值是什麼意思null
資料欄位的null值表示尚未處理要求的資料。最可能的原因是:
  • 您請求的數據是最近的,尚未處理
  • 您請求的數據很舊,尚未導入到當前的分析系統中
我更改了其中一個視頻的名稱-為什麼我在Google Analytics(分析)數據中看到舊名稱?
對於任何新的分析事件,都會記錄新名稱,但是我們不會在歷史數據中更改名稱-返回的視頻名稱將是查看時的名稱。
為什麼我不總是看到參與度值的整數?
訂婚號可能會返回小數點。原因是參與度已標準化,這意味著它是“ video_percent_viewed *(video_engagement_25 / video_engagement_sum)”的比率,因此,根據為查詢選擇的時間範圍,在它們不完全相除的情況下,您可能會看到浮點數。
如何按玩家過濾結果?

報告

當查看播放器使用的帶寬時,為什麼看到0 GB?
過去,Brightcove曾報告過按播放器劃分的帶寬,因此,對於希望按播放器進行細分的客戶,他們可以使用這些指標來分配帶寬成本。但是,隨著我們朝著清單驅動的交付方式發展(今天是HLS,將來是DASH),分段視頻的性質將使播放器的跟踪帶寬不准確。因此,我們將在利用率報告中按播放器維度棄用帶寬。因此,今後我們建議使用效果報告中玩家所查看的秒數來按玩家分配費用。

我可以從分析報表中排除員工檢視嗎?
沒有簡單的方法可以做到這一點,對於高視頻量的視頻,員工觀看次數可能只佔很小的比例,因此其對分析的影響可以忽略不計。但是,對於您認為這樣做很重要的低流量視頻,最簡單的解決方案是複制您的製作播放器,並讓員工測試/觀看副本上的視頻。然後,您可以使用Analytics(分析)模塊中的“自定義報告”功能或Analytics API,使用過濾器僅在生產播放器上創建報告。