追蹤內容播放
核心播放追蹤涵蓋媒體載入、開始、暫停、繼續、完成和工作階段結束。 緩衝和搜尋追蹤雖然並非為強制性,但也是完整播放實作的核心元件。
播放器事件
實作步驟
- 識別使用者何時觸發播放 (使用者點按播放或自動播放觸發)。 建立具有內容名稱、ID、長度、資料流型別和媒體型別的媒體物件。 如需欄位定義,請參閱內容名稱、內容識別碼、內容長度、資料流型別以及內容型別。
- 可選擇附加中繼資料:標準中繼資料(節目、季度、集數等) 和自訂內容資料變數。 如需標準中繼資料金鑰參考,請參閱節目、季、集數、型別和網路。
- 呼叫工作階段開始以開始追蹤工作階段。 這會載入資料和中繼資料,並開始QoS測量的開始時間。 SessionStart會追蹤要播放的意圖,而不是第一個影格。
- 當熒幕上呈現內容的第一個畫面格時,撥打播放。
- 播放器暫停時,呼叫暫停開始。 繼續播放時再次呼叫播放。 沒有單獨的繼續事件。
- 當檢視器到達內容結尾時,呼叫工作階段完成。
- 播放器解除安裝或檢視器放棄內容而未到達結尾時,呼叫工作階段結束。 SessionEnd會立即關閉工作階段;之後將無法追蹤其他事件。
SessionEnd 會標記追蹤工作階段的結尾。 如果成功觀看工作階段至完成,請在SessionEnd之前呼叫SessionComplete。 在SessionEnd之後會忽略任何其他追蹤呼叫,新工作階段的SessionStart除外。核心播放
下列範例顯示從工作階段開始到內容完成和工作階段結束的完整工作階段流程。
如需依平台的實作詳細資料,請參閱工作階段開始、播放、暫停開始、工作階段完成以及工作階段結束。
緩衝
緩衝開始訊號表示播放器正在等待資料。 在BufferStart (XDM型API)之後傳送播放事件時推斷為緩衝結束。 在行動SDK上,也需明確呼叫BufferComplete。
如需實作詳細資料,請參閱緩衝開始。
搜尋
搜尋開始訊號表示檢視器正在拖曳。 搜尋結束之後接著播放,以繼續播放內容。
如需實作詳細資料,請參閱暫停開始 (搜尋開始)和播放 (搜尋結束)。
處理應用程式中斷
媒體應用程式中的播放作業可以透過多種方式中斷。 例如,當使用者按下暫停鍵、應用程式進入背景或接到電話時。 無論原因為何,追蹤指示保持不變:
- 當應用程式中斷(進入背景、媒體暫停等)時,呼叫PauseStart。
- 當應用程式返回前景及/或媒體恢復播放時,呼叫播放。
暫停的工作階段應該何時結束? 如果應用程式不允許背景播放,請立即呼叫PauseStart ,然後在背景執行約一分鐘後呼叫SessionEnd 。 應用程式無法從背景繼續傳送暫停Ping,而且讓工作階段無限期開啟會造成不良體驗。 如果應用程式不支援背景播放(音訊應用程式、視訊播客應用程式),請在背景中繼續傳送Ping。
在漫長的背景期間之後重新啟動:如果應用程式在背景執行的時間夠長,工作階段已過期(30分鐘未活動),請呼叫SessionEnd以完全關閉任何延遲的工作階段,然後在檢視器返回時呼叫SessionStart以開始新的工作階段。
繼續非作用中工作階段
如果在10分鐘內未收到任何事件,或播放點在30分鐘內未移動,工作階段會自動過期。 如果使用者在工作階段過期之後回訪,請再次呼叫SessionStart以開啟新的工作階段。
跨裝置繼續(跨裝置移交):當檢視器在裝置之間傳輸播放時(例如,從電話轉換到電視),請使用繼續旗標在Analytics報表中將工作階段拼接在一起:
- 在 來源裝置 上,當檢視器啟動轉換時,請呼叫SessionEnd。 不要呼叫SessionComplete — 內容尚未完成。
- 在 目的地裝置 上,呼叫SessionStart並將恢復旗標設為
true,並從來源裝置傳遞相同的內容中繼資料和播放點位置。
設定繼續旗標會使Analytics遞增內容繼續,而非媒體開始,做為切換的第二個階段。
手動繼續先前關閉的工作階段:如果應用程式儲存使用者資料並且可以繼續先前關閉的工作階段,請在工作階段開始時設定繼續旗標。 如需所有平台的實作詳細資料,請參閱工作階段開始。