系統會為每個使用者串流提供一個「工作階段 ID」,並於活動結束後保留 48 小時。受監控的工作階段則會保留 60 天。您可在串流播放活動監控器 (SAM) 的「工作階段 ID」欄位中輸入工作階段 ID。透過搜尋結果可以瞭解使用者廣告請求的詳細資料,進而解決影片串流的問題。
我們會在下方探討幾種尋找工作階段 ID 的方式:
使用偵錯鍵來查看活動或解決影片串流的問題 (Beta 版)
此外,您也可以使用偵錯鍵查看活動或解決影片串流的問題。
您可以為任何串流或工作階段設定或傳遞不重複的鍵,以便使用 SAM 排除串流的錯誤。如果您在多個工作階段中使用相同的鍵,則只能搜尋最新的工作階段並進行偵錯。
- 使用 IMA SDK 請求的串流:請參閱 SDK 文件,瞭解如何透過 API 呼叫來設定鍵。
- 未使用 IMA SDK (SSB) 請求的串流:請使用
dai-sam-id
參數來傳遞偵錯鍵。例如:
https://dai.google.com/linear/hls/event/.../master.m3u8?dai-sam-id=abcdef-0a1b-12a3
鍵不能包含任何個人識別資訊。
在使用 IMA SDK 的應用程式中尋找工作階段 ID
當您使用 IMA SDK 建立影片串流,可以呼叫方法來取得工作階段 ID。請參閱在每個平台的 SDK 上取得 ID 的相關詳細資料:
許多應用程式開發人員選擇擷取工作階段 ID 並加以記錄,以便用於解決串流相關問題。
在查看使用者串流中的廣告放送詳情時,工作階段 ID 至關重要,因此在應用程式中導入方法或隱藏功能以輕鬆顯示 ID,將對您很有幫助。
在檢查 HTTP 流量時尋找工作階段 ID
您可以透過採用 IMA SDK 的應用程式監控 Proxy 工具中的 HTTP 要求。
當您使用 IMA SDK 請求動態廣告插播 (DAI) 影片串流,有兩個 HTTP 要求會出現:
- HTTP
POST
:這個要求應會傳回狀態碼 201,代表已建立新的串流。 - HTTP
GET
:向stream_manifest
欄位中的網址發出的請求。*
其他資訊會在 JSON 結構中傳回,包括 stream_id
。這就是您必須在「工作階段 ID」欄位中輸入的工作階段 ID。
從模擬的 HTTP 要求中尋找工作階段 ID
只要在指令列提示中使用 curl
,再加上隨選即播影片串流網址中的內容 ID 和影片 ID,即可模擬 SDK HTTP 要求序列。
我們以內容 ID 為 12345
,影片 ID 為 sample-video
舉例說明:
- 在指令列提示中輸入以下指令:
curl --data "" "http://dai.google.com/ondemand/hls/content/12345/vid/sample-vide/streams"
-
(選用) 導到
python -mjson.tool
以查看排版美觀的版本。
輸出範例 *
{
"duration": 784,
"stream_id": "19b40be0-7942-44ca-97e0-fc7b27f14029",
"stream_manifest": "https://dai.google.com/ondemand/hls/content/12345/vid/sample-video/CHS/streams/19b40be0-7942-44ca-97e0-fc7b27f14029/master.m3u8",
"stream_type": "on_demand",
"subtitles": [ ... ],
"time_events_url": "https://dai.google.com/ondemand/hls/content/12345/vid/sample-video/CHS/streams/19b40be0-7942-44ca-97e0-fc7b27f14029/time-events.json"
}
* 您可以使用 stream_manifest
網址來測試 HLS 播放器中的播放 (例如,Safari 網路瀏覽器)。
在 SSB 串流請求中尋找工作階段 ID
當您使用 SSB 請求動態廣告插播 (DAI) 影片串流時,有兩個 HTTP 要求會出現:
- HTTP
GET
:這個要求應會傳回狀態碼 302,表示需進行重新導向。 - 向重新導向網址發出的 HTTP
GET
要求。這個網址內含您在「工作階段 ID」欄位中所輸入的工作階段 ID。
當您在行動裝置或 OTT 應用程式中監控 Proxy 工具中的 HTTP 要求時,也可以找到工作階段 ID。
為使用 Chrome 的 SSB 串流請求尋找工作階段 ID
-
在瀏覽器中載入內容串流網址。
我們以內容 ID 為
12345
,影片 ID 為sample-video
來舉例說明,載入:
http://dai.google.com/ondemand/hls/content/12345/vid/sample-video/master.m3u8
- 在 Chrome 中,載入開發人員工具。
- 前往開發人員工具的「聯播網」分頁。
- 篩選包含
dai.google.com
的請求。 -
對「dai.google.com」網域發出的前兩個請求應該要找到名為「master.m3u8」的檔案:
第一個請求:302 回應
第二個請求:具有工作階段 ID 的網址
- 複製工作階段 ID 並將其輸入「工作階段 ID」欄位中。