通知

僅適用於 Google Ad Manager 360。

覆寫串流參數

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

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

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

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

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

覆寫變體選項和順序

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

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

變體的子集和順序在串流播放時將全程維持一致。使用 IMA SDKDAI 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 要從播放清單中排除的顯示項目。支援 subtitlescodecaudio-langsubtitle-langiframeresolution。您可以使用單一值或包含多個值的逗號分隔清單來排除解析度、音訊轉碼器、視訊轉碼器,以及音訊和/或字幕語言。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 和直播活動的廣告連播決策逾時 (以毫秒為單位)。

這個值適用於串流建立過程中做出的所有封鎖廣告決策,包含線性片中廣告插播和過往廣告插播決策,以及隨選影片的 VMAP 決策。但是,只有在使用 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 播放時間,請與您的客戶經理聯絡。

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
dai-ad-dlid (Beta 版)  HLS、DASH

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

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

dai-ad-dlid=AaBbC1aaBa0obA1BABaaBA

(AaBbC1aaBa0obA1BABaaBA 是 Ad Manager 中顯示的名稱)。

dai-aup (Beta 版)  HLS、DASH

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

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

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

參數覆寫範例

全部展開  全部收合

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

這對您有幫助嗎?

我們應如何改進呢?
true
開始使用動態廣告插播

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

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