找出動態廣告插播工作階段 ID 或偵錯鍵

系統會為每個使用者串流提供一個「工作階段 ID」，並於活動結束後保留 48 小時。受監控的工作階段則會保留 60 天。您可在串流播放活動監控器 (SAM) 的「工作階段 ID」欄位中輸入工作階段 ID。透過搜尋結果可以瞭解使用者廣告請求的詳細資料，進而解決影片串流的問題。

我們會在下方探討幾種尋找工作階段 ID 的方式：

• 在使用 IMA SDK 的應用程式中尋找工作階段 ID
• 在檢查 HTTP 流量時尋找工作階段 ID
• 從模擬的 HTTP 要求中尋找工作階段 ID
• 在 SSB 串流請求中尋找工作階段 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 的相關詳細資料：

• Android SDK
• iOS SDK
• tvOS SDK
• HTML5 SDK
• Chromecast SDK
• Roku SDK

許多應用程式開發人員選擇擷取工作階段 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 舉例說明：

1. 在指令列提示中輸入以下指令：

   curl --data "" "http://dai.google.com/ondemand/hls/content/12345/vid/sample-vide/streams"

2. (選用) 導到 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 要求會出現：

1. HTTP GET：這個要求應會傳回狀態碼 302，表示需進行重新導向。
2. 向重新導向網址發出的 HTTP GET 要求。這個網址內含您在「工作階段 ID」欄位中所輸入的工作階段 ID。

當您在行動裝置或 OTT 應用程式中監控 Proxy 工具中的 HTTP 要求時，也可以找到工作階段 ID。

為使用 Chrome 的 SSB 串流請求尋找工作階段 ID

1. 在瀏覽器中載入內容串流網址。

   我們以內容 ID 為 12345，影片 ID 為 sample-video 來舉例說明，載入：
   http://dai.google.com/ondemand/hls/content/12345/vid/sample-video/master.m3u8

2. 在 Chrome 中，載入開發人員工具。
3. 前往開發人員工具的「聯播網」分頁。
4. 篩選包含 dai.google.com 的請求。

5. 對「dai.google.com」網域發出的前兩個請求應該要找到名為「master.m3u8」的檔案：

   第一個請求：302 回應

   

   第二個請求：具有工作階段 ID 的網址

   
6. 複製工作階段 ID 並將其輸入「工作階段 ID」欄位中。

如有任何與 DAI 疑難排解或服務中斷相關的問題，請與發布商支援團隊聯絡。