串流媒體事件

串流媒體追蹤的運作方式是將一系列事件呼叫傳送至Adobe資料收集端點，每個都代表播放器狀態的轉變。 每個事件都屬於工作階段開始呼叫所開啟的活動工作階段。 工作階段會在到期時自動關閉，或可以使用工作階段結束呼叫立即關閉。

事件分為六個類別（工作階段、播放、廣告、章節、播放器狀態和品質），每個類別各涵蓋媒體體驗的不同層面。

工作階段事件

工作階段事件適用於任何型別的媒體追蹤，包括：隨選影片、直播串流、播客和有聲書。 它們定義追蹤工作階段本身的邊界。 最重要的工作階段事件是工作階段開始，因為幾乎所有其他事件型別都取決於它產生的工作階段識別碼。 當使用者起始工作階段時（例如當他們按下「播放」或播放器開始自動播放時），將它當作第一個事件傳送。

工作階段開啟後，請使用工作階段完成或工作階段結束來指示檢視體驗的結束方式。 當檢視器到達內容的自然結尾（視訊結束、播客集結尾，或有聲書的最後一個章節結束）時，傳送工作階段完成。 工作階段完成不會關閉工作階段；工作階段會保持開啟狀態，直到自然過期為止，因此系統仍會擷取任何尾隨事件（例如最終Ping）。

如果檢視器在到達結束之前離開，請傳送工作階段結束以立即關閉工作階段。 只有在未發生其他事件時（例如，當播放器損毀或頁面解除安裝時），才會結束傳送工作階段。 工作階段結束是硬性關閉：傳送後，工作階段會終止，且無法在其下追蹤進一步事件。 在大多數情況下，允許工作階段自然過期會比較安全。 例如檢視器無限期暫停、應用程式移至背景，或內容無法載入。

如果在10分鐘內未收到任何事件，或在30分鐘內未偵測到播放點移動，工作階段會自動過期。 如果符合任一條件且檢視器回到內容，您必須先呼叫「工作階段開始」以開啟新的工作階段，才能傳送任何其他事件。

播放事件

播放事件會在整個工作階段中追蹤媒體播放器中的狀態轉變。 它們構成事件串流的核心，並套用至任何內容型別。

主要播放事件是播放。 呼叫工作階段開始後，「播放」會指出內容已開始播放，無論是初始開始、自動播放觸發或回到播放狀態。 暫停開始表示使用者已暫停播放。 沒有專用的繼續事件；當檢視器繼續時，請再次傳送「播放」。 在緩衝停止後，Play的運作方式相同 — 當播放器停止等候資料時，傳送緩衝開始，然後在緩衝解析時跟隨Play。

在主要內容播放期間每10秒傳送Ping，在廣告播放期間每1秒傳送一次。 Ping會保持工作階段進行中，並記錄播放點移動。 在行動SDK上，Ping會自動傳送；在所有其他平台上，都必須手動傳送。

當播放器的最適化位元速率演演算法切換至不同的品質等級時，傳送位元速率變更。 在QoE資料中包含新的位元速率值可啟用「平均位元速率」報表。

廣告事件

廣告事件會追蹤媒體工作階段中的廣告。 常見的案例包括在影片開始前插入前段廣告、在長格式影片或即時資料流期間插入中段廣告，以及在內容結束後的後段廣告。 單一廣告插播可以包含一或多個個別廣告。

每個廣告插播會遵循相同結構。 廣告插播開始開啟插播，而廣告插播完成關閉它。 這兩個事件當作書擋，將所有個別廣告事件換行。 在插播中，當每個廣告開始播放時，傳送廣告開始。 如果廣告播放到其完整長度，則以廣告完成進行追蹤，或如果檢視者選取略過按鈕，則以廣告略過進行。 省略任一書擋會導致插播中的所有廣告事件遭到忽略，且廣告持續時間會錯誤歸因於主要內容。

下列範例顯示包含三個廣告的單一廣告插播的正確事件順序，檢視器已略過第三個廣告：

章節事件

章節事件是選用專案，可追蹤工作階段中的已命名內容區段。 它們很適合將內容自然地分成獨立部分。 常見的範例包括有聲書的章節、紀錄片的動作、影片課程的課程，或播客集的區段。 當您想要瞭解檢視者在區段層級的參與時（例如識別對象傾向於略過的章節），請使用章節事件。

當章節開始時，傳送章節開始。 如果檢視器觀看至章節結尾，請傳送章節完成。 如果檢視器搜尋超過章節界限而未觀看其完成，請改為傳送章節略過。 在關閉章節時，必須先完成章節或跳過章節，新章節才能開啟；章節不能重疊。

播放器狀態事件

播放器狀態事件會追蹤檢視者在整個工作階段中與播放器控制項互動的方式。 這類變數有助於瞭解協助工具功能的使用情形，例如檢視器啟用隱藏式字幕或靜音的頻率。 此外，還可呈現全熒幕或內嵌檢視、子母畫面多工作業等檢視行為模式。

五個可追蹤的狀態為： fullscreen、mute、closedCaptioning、pictureInPicture和inFocus。 當播放器進入其中任一狀態時，傳送狀態開始，當播放器退出時，傳送狀態結束。 可同時啟用多個狀態；檢視器可同時處於全熒幕和靜音狀態，且同一事件呼叫可結束多個狀態。

錯誤事件

錯誤事件會在工作階段期間記錄播放失敗 — 失敗的資料流要求、轉碼器錯誤或外部傳遞失敗。 每當發生有意義的錯誤時，就傳送它。 錯誤事件不會關閉工作階段；播放可以繼續，並在相同工作階段下追蹤後續事件。 如果錯誤無法復原，請在工作階段結束之後明確關閉工作階段。