通知

僅適用於 Google Ad Manager 360。

覆寫串流參數

您可視需求選擇覆寫串流參數。如果您想讓播放器或應用程式在系統請求 HTTP 即時串流或 DASH 播放清單時，覆寫串流建立參數的預設值或覆寫變體的選取順序或預設順序，可以執行這個步驟。您可以從播放器或應用程式傳遞這些參數，以便導入 IMA SDK、伺服器端信標 (SSB) 和 DAI API。

您還可以覆寫其他預設廣告代碼參數。

覆寫變體選項和順序

預設的播放清單順序是由發布商決定。如果沒有指定順序參數，播放清單會依照發布商設定的原始順序傳回。

您可覆寫在建立串流時指定的變體選項和順序參數，以便指定應加入主要播放清單請求的變體子集和變體的順序。如果想要依據讀取內容的使用者來調高某個特定變體的優先級，這項功能會對您非常有幫助。

變體的子集和順序在串流播放時將全程維持一致。使用 IMA SDK 和 DAI API 參數時，系統會接受這些參數並將其視為 adTagParameters 架構的一部分。使用 SSB 時，系統會將參數視為額外的 HTTP GET 參數

參數 串流通訊協定 說明 範例
dai-aor HLS、DASH 要傳回的音訊變體頻寬範圍。如要選取所有較高的頻寬，請單單指定 startBandwidth。如要選取所有較低的頻寬，請單單指定 :endBandwidth (開頭加上冒號「:」)。 dai-aor=60000
dai-dlid HLS、DASH

當您建立隨選影片內容的 CDN 設定時，請定義預設的 CDN 設定以及其他的 CDN 放送設定。如此一來，您就可以設定多個 CDN，並在工作階段開始時，透過鍵/值動態選擇要使用的 CDN。

設定並儲存 CDN 設定後，Ad Manager 會為每個設定指派名稱。這個名稱應該做為 dai-dlid 參數的值傳入串流建立請求。

如果沒有任何名稱傳入請求，Ad Manager 會使用預設的 CDN。

dai-dlid=AaBbC1aaBa0obA1BABaaBA

(AaBbC1aaBa0obA1BABaaBA 是 Ad Manager 中顯示的名稱)。
dai-excl HLS、DASH 要從播放清單中排除的顯示項目。支援 subtitles、codec、audio-lang、subtitle-lang、iframe 和 resolution。您可以使用單一值或包含多個值的逗號分隔清單來排除解析度、音訊轉碼器、視訊轉碼器，以及音訊和/或字幕語言。Codec 前置字元也支援後置字元「*」，這會排除所有具備所提供前置字元的 codec 顯示項目。

dai-excl=subtitles
dai-excl=iframe

單一轉碼器
dai-excl=codec:ec-3

多個轉碼器
dai-excl=codec:ec-3,codec:ac-3

前置字元轉碼器
dai-excl=codec:avc1*

單一語言音訊
dai-excl=audio-lang:en

單一語言字幕
dai-excl=subtitle-lang:en

多個選項
dai-excl=audio-lang:en,
audio-lang:es,
subtitle-lang:en,
subtitle-lang:es

解析度
dai-excl=resolution:480x272
dai-os HLS 放置在主要播放清單頂端的視訊變體頻寬。系統會選取與 startBandwidth 值最接近的變體。如果兩個值等距，系統會選取最低值。當系統提供這個參數而不是 dai-aor，所有僅限音訊的變體都會遭到排除。 dai-os=1700000
dai-ot
                         		 HLS

這項順序類型資訊會說明由 dai-ov 參數指定的值類型，包括表示依照頻寬的「bw」(最接近的比對) 或頻寬 + 解析度 (完全比對) 的排序方法。必須至少指定一個頻寬或解析度。預設值是「bw」。

如果指定了 dai-ot 參數但未指定 dai-ov，播放清單將以原始順序傳回所有變體。

 dai-ot=bw
dai-ot=bw_res
dai-ov HLS

指定媒體播放清單傳回順序的半形逗號分隔值。必須與 dai-ot 搭配使用，而且每個值都應與 dai-ot 參數所述的類型相同。可以使用特殊值「audio」來指定音訊變體。

如果多個變體具有相同的順序值 (例如有兩個變體具有相同的頻寬，但解析度不同)，這些變體之間會維持原始的順序。

dai-ot=bw&dai-ov=2025837,1406061

dai-ot=bw_res&dai-ov=1400000:640x360,audio
dai-sr HLS、DASH 要傳回的視訊變體頻寬範圍。如要選取所有較高的頻寬，請單單指定 startBandwidth。如要選取所有較低的頻寬，請單單指定 :endBandwidth (開頭加上冒號「:」)。 dai-sr=1300000:2500000

其他覆寫參數

參數 串流通訊協定 說明 範例
dai-ah HLS、DASH 指定直播活動是否應套用廣告休播。您必須在直播活動設定中指定廣告休播時間長度。 啟用廣告休播：
dai-ah=1
dai-apto
 (Beta 版) 		 HLS、DASH

用於建立 VOD 和直播活動的廣告連播決策逾時 (以毫秒為單位)。

這個值適用於片中廣告插播的決策，或是發生於串流建立過程的過往廣告插播決策 (並非所有建立串流後出現的未來廣告決策都適用)。但是，只有在使用 EVENT 類型播放清單或 dai-dpb 參數時，才適用於過去的廣告插播。

可設為任何大於 0 且小於或等於 10000 的值。

將這個值設得太低或是太高，可能會對廣告供應或使用者體驗造成影響。

 dai-apto=4000
dai-dpb HLS、DASH

指定是否要為非-SSB 線性串流播放啟用過去的廣告插播裁決功能 (SSB 串流播放會忽略此參數)。如果啟用此功能，過去的廣告插播會透過置中的廣告插播進行裁決。

這個設定可能會對啟動延遲造成影響，而您可透過 dai-apto 參數加以控制。

除非使用者倒轉影片，否則過去的廣告插播會一直是未經瀏覽的廣告，而此舉可能會造成程式碼調用次數增加的情況。

 啟用過去的廣告插播裁決功能：
dai-dpb=true

為 HLS EVENT 類型播放清單停用過去的廣告插播裁決功能：
dai-dpb=false
dai-dvr HLS、DASH 直播內容和廣告的 DVR 時間長度 (以秒為單位)，可讓使用者向後捲動並保持順暢的播放體驗。

這個值目前預設為 100 秒，或是在直播設定期間指定的值。不過，可以為每個直播活動指定新的上限；SSB 最高為 100 秒，而使用 SDK 或 API 則為 1800 秒。如需較大的 DVR 播放時間，請與您的客戶經理聯絡。

指南與用途

傳回的播放清單實際 DVR 時間長度可能或多或少會受到基礎區隔的長度所影響。各個變體可能也會略有不同。

實際倒帶時間的上限值不得大於事件中指定的 DVR 段落值。如果超過，系統將自動為該值設定上限。與 SDK 或 Public API 串流相比，SSB 串流的 DVR 段落值上限也較低。

雖然我們會盡可能傳回相容的資訊清單，但如果指定非常小或非常大的值，都可能會導致播放時發生問題。播放影片時，請搭配完整的 DVR 段落時間範圍仔細測試，確認一切運作正常。

避免在不同的裝置上使用不同的倒帶時間。就成效的觀點來看，為某個裝置設定 30 秒的倒帶時間大小，而為其他裝置設定 31 秒或 35 秒，其實並不適當。因此，建議使用倒帶時間值區 (例如為一組裝置設定 35 秒，為另一組設定 10 分鐘等等)。這個做法可有效提高資源分配和成效。

 dai-dvr=60
dai-emsgv HLS

「事件訊息」版本是串流建立參數，可讓呼叫者指定 Common Media Application Format (通用媒體應用格式，CMAF) 內容的「emsg」版本。

HLS 標準必須使用「emsg」版本 1。

這項設定適用於不支援標準版本 1，且需要版本 0 (例如 Roku) 的平台。
 dai-emsgv=1
dai-pre (Beta 版)  HLS、DASH 指定已啟用片頭廣告的直播是否應在重疊時顯示片頭廣告，而非片中廣告。預設行為是顯示重疊的片中廣告，而非片頭廣告。 dai-pre=1

參數覆寫範例

全部展開  全部收合

選取兩個變體

請求


https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8?dai-ot=bw&dai-ov=2025837,1406061
 

回應


#EXTM3U
#EXT-X-VERSION:3
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=2025837,RESOLUTION=960x540,CODECS="mp4a.40.2,avc1.4d401f"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/2025837.m3u8
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=1406061,RESOLUTION=640x360,CODECS="mp4a.40.2,avc1.4d401f"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/1406061.m3u8
 
選取一個音訊變體和一個視訊變體

請求


https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8?dai-ot=bw&dai-ov=audio,1406061
 

回應


#EXTM3U
#EXT-X-VERSION:3
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=64000,RESOLUTION=480x270,CODECS="mp4a.40.2"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/audio.m3u8
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=1406061,RESOLUTION=640x360,CODECS="mp4a.40.2,avc1.4d401f"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/1406061.m3u8
 
按照頻寬和解析度比對

請求


https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8?dai-ot=bw_res&dai-ov=1400000:640x360,audio
 

回應


#EXTM3U
#EXT-X-VERSION:3
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=1406061,RESOLUTION=640x360,CODECS="mp4a.40.2,avc1.4d401f"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/1406061.m3u8
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=64000,RESOLUTION=480x270,CODECS="mp4a.40.2"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/audio.m3u8
 
按照頻寬範圍比對

請求


https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8?dai-sr=1300000:2500000&dai-aor=60000
 

回應


#EXTM3U
#EXT-X-VERSION:3
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=1406061,RESOLUTION=640x360,CODECS="mp4a.40.2,avc1.4d401f"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/1406061.m3u8
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=2025837,RESOLUTION=960x540,CODECS="mp4a.40.2,avc1.4d401f"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/2025837.m3u8
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=64000,RESOLUTION=480x270,CODECS="mp4a.40.2"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/audio.m3u8
 
指定起始頻寬

請求


https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8?dai-os=1700000
 

回應


#EXTM3U
#EXT-X-VERSION:3
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=1406061,RESOLUTION=640x360,CODECS="mp4a.40.2,avc1.4d401f"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/1406061.m3u8
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=2025837,RESOLUTION=960x540,CODECS="mp4a.40.2,avc1.4d401f"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/2025837.m3u8
 
排除字幕

包含字幕的原始資訊清單


#EXTM3U
#EXT-X-VERSION:3
#EXT-X-MEDIA:TYPE=SUBTITLES,GROUP-ID="subs",LANGUAGE="en",NAME="English",AUTOSELECT=YES,URI="tt-en.m3u8"
#EXT-X-MEDIA:TYPE=SUBTITLES,GROUP-ID="subs",LANGUAGE="de",NAME="Deutsch",AUTOSELECT=YES,URI="tt-de.m3u8"
#EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID="stereo",LANGUAGE="en",NAME="English",DEFAULT=YES,AUTOSELECT=YES,URI="audio.m3u8"
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=889549,RESOLUTION=640x360,CODECS="mp4a.40.2,avc1.4d401f" SUBTITLES="subs"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/889549.m3u8
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=1406061,RESOLUTION=640x360,CODECS="mp4a.40.2,avc1.4d401f" SUBTITLES="subs"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/2025837.m3u8
 

請求


https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8?dai-excl=subtitles
 

回應


#EXTM3U
#EXT-X-VERSION:3
#EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID="stereo",LANGUAGE="en",NAME="English",DEFAULT=YES,AUTOSELECT=YES,URI="audio.m3u8"
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=889549,RESOLUTION=640x360,CODECS="mp4a.40.2,avc1.4d401f" SUBTITLES="subs"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/889549.m3u8
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=1406061,RESOLUTION=640x360,CODECS="mp4a.40.2,avc1.4d401f" SUBTITLES="subs"
https://dai.google.com/linear/hls/event/<asset_key>/encoder/<encoder_id>/session/<session_id>/bandwidth/2025837.m3u8
 
排除轉碼器

帶有 ac-3、eac-3 的原始資訊清單


#EXTM3U
#EXT-X-STREAM-INF:BANDWIDTH=6107776,RESOLUTION=1920x1080,CODECS="avc1.640028,ec-3",AUDIO="AUDIO-EAC3"
https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/6107776.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=2212301,RESOLUTION=960x540,CODECS="avc1.640028,ec-3",AUDIO="AUDIO-EAC3"
https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/2212301.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=6295776,RESOLUTION=1920x1080,CODECS="ac-3,avc1.640028",AUDIO="AUDIO-AC3"
https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/6295776.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=2400301,RESOLUTION=960x540,CODECS="ac-3,avc1.640028",AUDIO="AUDIO-AC3"
https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/2400301.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=6045381,RESOLUTION=1920x1080,CODECS="avc1.640028,mp4a.40.2",AUDIO="AUDIO-AAC"
https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/6045381.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=2149906,RESOLUTION=960x540,CODECS="avc1.640028,mp4a.40.2",AUDIO="AUDIO-AAC"
https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/2149906.m3u8
#EXT-X-MEDIA:TYPE=AUDIO,URI="audio-eac3.m3u8",GROUP-ID="AUDIO-EAC3",LANGUAGE="en",NAME="ENGLISH",AUTOSELECT=YES
#EXT-X-MEDIA:TYPE=AUDIO,URI="audio-ac3.m3u8",GROUP-ID="AUDIO-AC3",LANGUAGE="en",NAME="ENGLISH",AUTOSELECT=YES
#EXT-X-MEDIA:TYPE=AUDIO,URI="audio-aac.m3u8",GROUP-ID="AUDIO-AAC",LANGUAGE="en",NAME="ENGLISH",AUTOSELECT=YES
 

排除一個轉碼器

請求


http://truman.com/ssai/event/<event_code>/master.m3u8?dai-excl=codec:ec-3
 

回應


#EXTM3U
#EXT-X-STREAM-INF:BANDWIDTH=6295776,RESOLUTION=1920x1080,CODECS="ac-3,avc1.640028",AUDIO="AUDIO-AC3"
https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/6295776.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=2400301,RESOLUTION=960x540,CODECS="ac-3,avc1.640028",AUDIO="AUDIO-AC3"
https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/2400301.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=6045381,RESOLUTION=1920x1080,CODECS="avc1.640028,mp4a.40.2",AUDIO="AUDIO-AAC"
https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/6045381.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=2149906,RESOLUTION=960x540,CODECS="avc1.640028,mp4a.40.2",AUDIO="AUDIO-AAC"
https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/2149906.m3u8
#EXT-X-MEDIA:TYPE=AUDIO,URI="audio-ac3.m3u8",GROUP-ID="AUDIO-AC3",LANGUAGE="en",NAME="ENGLISH",AUTOSELECT=YES
#EXT-X-MEDIA:TYPE=AUDIO,URI="audio-aac.m3u8",GROUP-ID="AUDIO-AAC",LANGUAGE="en",NAME="ENGLISH",AUTOSELECT=YES
 

排除多個轉碼器

請求


http://truman.com/ssai/event/<event_code>/master.m3u8?dai-excl=codec:ec-3,codec:ac-3
 

回應


#EXTM3U
#EXT-X-STREAM-INF:BANDWIDTH=6045381,RESOLUTION=1920x1080,CODECS="avc1.640028,mp4a.40.2",AUDIO="AUDIO-AAC"
https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/6045381.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=2149906,RESOLUTION=960x540,CODECS="avc1.640028,mp4a.40.2",AUDIO="AUDIO-AAC"
https://truman.com/ssai/hls/event/<event_code>/encoder/<encoder_id>/session/<session_id>/bandwidth/2149906.m3u8
#EXT-X-MEDIA:TYPE=AUDIO,URI="audio-aac.m3u8",GROUP-ID="AUDIO-AAC",LANGUAGE="en",NAME="ENGLISH",AUTOSELECT=YES
 
如有任何與 DAI 疑難排解或服務中斷相關的問題，請與發布商支援團隊聯絡。

這對您有幫助嗎？

我們應如何改進呢？

還有其他問題嗎？

嘗試以下步驟：

張貼到產品討論社群 向社群成員尋求答案
與我們聯絡 進一步說明相關資訊，我們會盡力協助您
true
開始使用動態廣告插播

這份指南將說明如何在直播、線性和隨選影片內容之間提供流暢的廣告體驗。
參閱指南

搜尋
清除搜尋內容
關閉搜尋
主選單
425930630944196701
true
搜尋說明中心
true
true
true
true
true
148
false
false