VAST 廣告代碼網址參數

必須用於和建議用於網站的參數

不使用 IMA SDK 導入 Ad Exchange 需求的代碼式影片廣告解決方案的功能目前是 Beta 版,可能未開放給您的聯播網使用。如需詳細資訊,請與您的帳戶管理員聯絡。

以下是一部分的 VAST 廣告代碼網址參數。如果這些參數未整合到 IMA SDK 中,則適合用於網站的代碼式影片廣告解決方案。

請參閱必須用於應用程式的參數清單,或是必須用於和建議用於程式輔助的參數清單。

加入書籤 跳至清單中的特定參數

correlator
description_url
env
gdfp_req

iu
output
plcmt
sz

unviewed_position_start
url
vpmute
wta

 
參數 詳細說明
correlator

(Correlator)

「Correlator」參數接受由同一次網頁瀏覽的多個請求共用的變數值。這個參數可用來執行競爭排除設定,就算環境中沒有 Cookie 也無妨。

如果您使用 IMA SDK,SDK 會自動設定 Correlator 值。要是播放器嘗試設定 Correlator 值,SDK 會將該值換成自己的值。

如果未使用 IMA SDK,請務必將這個值設為真正隨機且不會在多次網頁瀏覽重複使用的正整數值。

使用範例

correlator=4345645667

必要與否

必填 必須用於網站應用程式

建議 建議用於程式輔助營利

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_id/.../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_vast3xml_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

必要與否

必填 必須用於網站應用程式

建議 建議用於程式輔助營利

vpmute

(影片播放靜音)

建議依據:MRC影片評估指南

「靜音影片」參數接受常數值,以指出在影片播放器設為靜音時,廣告是否會開始播放。

使用範例

已靜音:
vpmute=1

已取消靜音:
vpmute=0

必要與否

必填 必須用於網站程式輔助營利

wta

(為什麼會顯示這則廣告)

「為什麼會顯示這則廣告?」參數接受常數值,以指出影片播放器是否支援顯示「為什麼會顯示這則廣告?」

使用 IMA SDK 時,系統會自動支援「為什麼會顯示這則廣告?」功能。如果不使用 IMA SDK,影片播放器就必須導入 VAST IconIconClickFallbackImage 支援 (如 IAB VAST 標準文件所述)。

如果 AdChoices 圖示 (如 VAST 回應所提供) 將顯示在隨播廣告上,或以其他方式投放給使用者,音訊廣告請求就應該傳送 wta=1

為符合歐洲經濟區內 Google 廣告需求和 Google 代管預訂流量的資格,廣告請求必須傳送 wta=1,表示 AdChoices 圖示 (如 VAST 回應所提供) 會顯示在影片廣告、隨播廣告上,或以其他方式投放給所有廣告素材的使用者。

使用範例

支援:
wta=1

不支援:
wta=0

規定

必填 必須用於 Ad Exchange

必填 必須用於網頁應用程式歐洲經濟區流量

建議 建議用於程式輔助營利

這對您有幫助嗎?

我們應如何改進呢?
true
版本資訊

瞭解 Ad Manager 最新功能和說明中心更新內容。

查看新功能

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