通知

適用於具備進階合約且符合規定的 Google Ad Manager 360 發布商和合作夥伴。

覆寫串流參數

您可視需求選擇覆寫串流參數。

如果想讓播放器或應用程式覆寫下列設定，就可以執行這項動作：

  • 串流建立參數的預設值
  • 請求 HLS 或 DASH 播放清單時，變體的選取順序或預設順序

您可以從播放器或應用程式傳遞這些參數，以便導入 IMA SDK、伺服器端信標 (SSB) 和 DAI API。

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

覆寫變體選項和順序

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

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

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

參數 串流通訊協定 說明 範例
dai-aor HLS、DASH

要傳回的音訊變體頻寬範圍。

  • 如要選取所有較高的頻寬，請單單指定 startBandwidth。
  • 如要選取所有較低的頻寬，請只指定 :endBandwidth (開頭加上半形冒號「:」)。

dai-aor=123:456
dai-aor=12
dai-aor=:456
dai-dlid HLS、DASH

為影片素材資源建立 CDN 設定時，請指定預設的 CDN 設定和其他的 CDN 放送設定。這樣您就能設定多個 CDN，並在工作階段開始時，透過鍵/值動態選擇要使用的 CDN。

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

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

注意：如果單一內容有多個放送位置不同的 CDN，可以為 dai-dlid 設定多個值。

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-excl=resolution:
400-500x200-300

  • 篩除寬度介於 400 到 500 (含) 之間，且高度介於 200 到 300 之間的顯示項目

dai-excl=resolution:
400-500x

  • 篩除寬度介於 400 到 500 (含) 之間的顯示項目

dai-excl=resolution:
x200-300

  • 篩除高度介於 200 到 300 (含) 之間的顯示項目

dai-excl=resolution:
200-x500-

  • 篩除寬度 >= 200 且高度 >= 500 的顯示項目

dai-excl=resolution:
-500x

  • 濾除寬度 <= 500 的顯示項目
 

多個解析度/解析度範圍：

dai-excl=resolution:480x,resolution:
x-100

  • 篩除寬度為 480
    或高度 <= 100 的顯示項目。
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
 (測試版) 		 HLS、DASH

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

這個值適用於串流建立過程中做出的所有封鎖廣告決策，包含線性片中廣告插播和過往廣告插播決策，以及隨選影片的 VMAP 決策。但是，只有在使用 EVENT 類型播放清單或 dai-dpb 參數時，才適用於過去的廣告插播。

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

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

預設值為 5000 (5 秒)。建立串流的整體逾時時間為 8 秒或 dai-apto + 4 秒。

 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 (測試版)  HLS、DASH 指定已啟用片頭廣告的直播是否應在重疊時顯示片頭廣告，而非片中廣告。預設行為是顯示重疊的片中廣告，而非片頭廣告。 dai-pre=1
dai-ad-dlid (測試版)  HLS、DASH

指定您在 Google Ad Manager 預先設定的外部 CDN 專屬名稱，以便在直播內容中放送廣告。

進一步瞭解如何透過外部 CDN 放送廣告。

dai-ad-dlid=AaBbC1aaBa0obA1BABaaBA

(AaBbC1aaBa0obA1BABaaBA 是 Ad Manager 中顯示的名稱)。
dai-aup (測試版)  HLS、DASH

指定任意網址前置字元，指向用來建構廣告區隔網址的外部 CDN，以便在直播內容中放送廣告。

進一步瞭解如何透過外部 CDN 放送廣告。

 dai-aup=https://domain.com/path-c1/path-c2

參數覆寫範例

全部展開  全部收合

選取兩個變體

要求


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
立即運用個人化提示，開闢收益來源！

前往 Google Ad Manager 的最佳化提示頁面，查看有助全力提升收益的個人化建議。

立即解鎖

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