不使用 IMA SDK 導入 Ad Exchange 需求的代碼式影片廣告解決方案的功能目前是 Beta 版,可能未開放給您的聯播網使用。如需詳細資訊,請與您的帳戶管理員聯絡。
以下是一部分的 VAST 廣告代碼網址參數。如果這些參數未整合到 IMA SDK 中,則適合用於網站的代碼式影片廣告解決方案。
請參閱必須用於應用程式的參數清單,或是必須用於和建議用於程式輔助的參數清單。
跳至清單中的特定參數
參數 |
詳細說明 |
correlator
(Correlator)
|
「Correlator」參數接受由同一次網頁瀏覽的多個請求共用的變數值。這個參數可用來執行競爭排除設定,就算環境中沒有 Cookie 也無妨。
如果您使用 IMA SDK,SDK 會自動設定 Correlator 值。要是播放器嘗試設定 Correlator 值,SDK 會將該值換成自己的值。
如果未使用 IMA SDK,請務必將這個值設為真正隨機且不會在多次網頁瀏覽重複使用的正整數值。
使用範例
correlator=4345645667
必要與否
必須用於網站和應用程式
建議用於程式輔助營利
|
description_url
(內容描述網址)
|
「說明網址」參數接受的變數值必須能描述網頁上播放的影片。使用 1 至 3 個段落概述網頁內容。舉例來說,您可以動態拼接預先定義區塊中 description_url 的網頁內容。進一步瞭解如何提供專屬的內容描述網址。
description_url 值必須針對網頁影片播放器和連網電視/OTT 裝置進行網址編碼;如果是行動應用程式內影片播放器,則不必經過編碼。
IMA SDK 不會自動設定這個參數,您必須手動設定。
使用範例
網址編碼:
description_url=
https%3A%2F%2Fwww.sample.com%2Fgolf.html
未編碼:
description_url=
https://www.sample.com/golf.html
必要與否
必須用於網頁、應用程式和 Ad Exchange
建議用於程式輔助營利
|
env
(環境)
|
「環境」參數接受常數值,以表示串流內請求,或請求特別源自某個影片播放器。
可能的值包括 instream (可用於影片和音訊廣告) 或 vp (只能用於影片廣告)。
使用範例
影片和/或音訊廣告:
env=instream
僅限影片廣告:
env=vp
必要與否
必須用於網站和應用程式
|
gdfp_req
(Ad Manager 架構指標)
|
「Ad Manager 結構定義指示器」參數接受常數值,以指出使用者處於 Ad Manager 架構。
使用範例
gdfp_req=1
規定
必須用於網站和應用程式
|
iu
(廣告單元)
|
「廣告單元」參數接受變數值,但該值應設為目前的廣告單元,並採用下列格式:
/network_code/.../ad_unit
使用範例
iu=/6062/videodemo
規定
必須用於網站和應用程式
|
output
(廣告輸出格式)
|
「廣告輸出格式」參數接受常數值,但該值應設為廣告的輸出格式。
針對已為聯播網設定的預設 VAST 版本,請使用 output=vast 。對於特定的廣告代碼或網站的某些部分,您可請求特定的 VAST 或 VMAP 版本。
如果您的影片播放器使用 IMA SDK,影片廣告請求的輸出參數將一律設為 output=xml_vast4 。因為 SDK 與舊版相容,這樣做不會對可靠性造成風險;無論任何第三方廣告伺服器放送哪個 VAST 版本,都沒問題。
使用 output=vmap 將您為聯播網啟用的預設 VMAT 版本傳回 (例如 VMAP 1)。如果您在 VMAP 中傳回 VAST,則可以採用 xml_vmap1_vast3 或 xml_vmap1_vast4 來指定要傳回的 VAST 版本。
使用範例
您聯播網的預設 VAST 設定:
output=vast
VAST 4:
output=xml_vast4
您聯播網的預設 VMAP 設定:
output=vmap
VMAP 1:
output=xml_vmap1
VMAP 1,傳回 VAST 4:
output=xml_vmap1_vast4
必要與否
必須用於網站和應用程式
|
plcmt
(刊登位置)
|
刊登位置參數接受常數值。根據 IAB 規格的指引,這個值可用於指出串流內廣告空間是宣告為「串流內廣告」還是「隨播內容」。
針對非串流內廣告請求,系統會根據宣告的廣告空間格式,自動替買方填入這個欄位,並會覆寫任何串流內廣告或隨播內容宣告。
使用範例
串流內廣告請求:
plcmt=1
隨播內容請求:
plcmt=2
必要與否
必須用於網站和程式輔助營利
|
sz
(大小)
|
「大小」參數接受變數值,但該值應設為主影片廣告版位的大小。
如有多個大小,請使用直立線 (| ) 做為分隔字元。
請勿在大小後面加上「v 」。
使用範例
sz=400x300
必要與否
必須用於網站和應用程式
如果只請求 ad_type=audio ,則此參數為選用。
|
unviewed_position_start
(延遲曝光)
|
「延遲曝光」參數接受常數值,以指出影片的延遲曝光次數。
使用範例
unviewed_position_start=1
必要與否
必須用於網站和應用程式
|
url
(網址)
|
「網址」參數接受變數值,但該值應設為傳送請求的完整網址。這個必要值可協助買方辨識及瞭解此請求的來源脈絡。在可行範圍內,這個值應能動態填入廣告請求。
在網頁上,這是顯示影片播放器的網頁網址。如果您使用 IMA SDK,SDK 會自動設定網址值。要是播放器設定了這個值,IMA SDK 會遵循設定的值。
在應用程式 (行動裝置或連網電視) 中,這個值必須設為最能精確代表用於營利的影片或音訊廣告空間網址。舉例來說,如果使用者是在行動應用程式中觀看影片,則這個值應設為可用來在電腦上觀看該影片的對等網址。*
這個參數值必須經過編碼才能使用。
使用範例
url=https%3A%2F%2Fwww.videoad.com%2Fgolf.html
* 針對應用程式,如果無法將這個參數設為網址變數值,建議設為下列模式:
url=https%3A%2F%2F<app/bundleid>.adsenseformobileapps.com
必要與否
必須用於網站和應用程式
建議用於程式輔助營利
|
vpa
(影片自動播放)
|
建議依據:MRC影片評估指南
「影片自動播放」參數接受常數值,指出廣告中的影片內容是自動播放還是點擊後才開始播放。
如果頁面會等待使用者動作,可能的值為 click ;如果影片會自動播放,則可能的值為 auto 。
如果狀態不明,請勿設定這個參數。
使用範例
自動播放:
vpa=auto
隨點即播:
vpa=click
必要與否
建議用於程式輔助營利
|
vpmute
(影片播放靜音)
|
建議依據:MRC影片評估指南
「靜音影片」參數接受常數值,以指出在影片播放器設為靜音時,廣告是否會開始播放。
使用範例
已靜音:
vpmute=1
已取消靜音:
vpmute=0
必要與否
必須用於網站和程式輔助營利
|
wta
(為什麼會顯示這則廣告)
|
「為什麼會顯示這則廣告?」參數接受常數值,此值可用來辨別影片播放器是否支援顯示廣告徽章。如果未傳送 &wta 參數,則預設為 &wta=1 。
使用 IMA SDK 時,系統會自動支援廣告徽章功能。如果不使用 IMA SDK,影片播放器就必須導入 VAST Icon 和 IconClickFallbackImage 支援 (如 IAB VAST 標準文件所述)。
如果發布商不會顯示 AdChoices 圖示 (如 VAST 回應所提供),則必須傳送 &wta=0 。若傳送有 &wta=1 或無 &wta 參數的廣告請求,系統會理解為發布商將顯示提供的 AdChoices 資訊。
如果 AdChoices 圖示 (如 VAST 回應所提供) 將顯示在隨播廣告上,或以其他方式投放給使用者,音訊廣告請求可能會傳送 wta=1 。
如果流量來自歐洲經濟區,含有 &wta=0 的請求就無法使用已啟用 Google 徽章功能的預訂廣告素材。
廣告必須符合在歐洲經濟區 (EEA) 放送廣告的適用法律規定,包括使用者檢舉非法內容的機制。發布商必須使用適當的表單,將任何非法內容的檢舉情況告知 Google。
使用範例
支援:
wta=1 或無 wta 參數
不支援:
wta=0
規定
必須用於 Ad Exchange
必須用於網頁和應用程式歐洲經濟區流量
建議用於程式輔助營利
|