不使用 IMA SDK 導入 Ad Exchange 需求的代碼式影片廣告解決方案的功能目前是 Beta 版，可能未開放給您的聯播網使用。如需詳細資訊，請與您的帳戶管理員聯絡。
本文列出 VAST 廣告代碼的必要和建議參數，可用於在網站導入作業中放送廣告。
本頁內容
您可以查看其他導入類型清單，或參閱 VAST 廣告代碼的網址規定。
必須用於和建議用於網站的參數
廣告放送所需的參數
correlator (Correlator)
說明
「Correlator」參數 (correlator) 接受變數值，這是由同一次網頁瀏覽的多個請求共用的值。這個參數可用來執行競爭排除設定，就算環境中沒有 Cookie 也無妨。
使用範例
correlator=4345645667
description_url (內容描述網址)
說明
「說明網址」參數 (description_url) 接受變數值，但該值必須描述網頁上播放的影片。
內容描述網址應是網頁應用程式、行動應用程式或 TV 應用程式特定網頁上播放的影片，而非所有影片或所有廣告請求的頂層網域。舉例來說，假設 https://www.sample.com/golf.html 網頁用來顯示高爾夫影片，請將該網頁設為 description_url 的值。
使用範例
description_url 值必須針對含有影片的網頁和連網電視/OTT 裝置進行網址編碼。如果是行動應用程式，則不得針對 description_url 值進行編碼。
網址編碼：
description_url=
https%3A%2F%2Fwww.sample.com%2Fgolf.html
未編碼：
description_url=
https://www.sample.com/golf.html
需求條件和建議
如要在網站和行動應用程式中導入廣告放送作業，就必須使用這個參數。如果您使用 Ad Exchange 或 AdSense 進行動態分配，也需要提供這個參數。
建議搭配程式輔助營利功能使用這個參數。
SDK 使用情形
IMA SDK 不會自動設定這個參數，您必須手動設定。
請參閱您平台的 IMA SDK 指南。
env (環境)
說明
「環境」參數 (env) 接受常數值，表示串流內廣告請求，或請求特別源自某個影片播放器。
可能的值包括 instream (可用於影片和音訊廣告) 或 vp (只能用於影片廣告)。
使用範例
影片和/或音訊廣告：
env=instream
僅限影片廣告：
env=vp
gdfp_req (架構指標)
iu (廣告單元)
output (輸出內容)
說明
「輸出格式」參數 (output) 接受常數值，該值應設為廣告的輸出格式。
使用範例
output=vast
使用 VAST 4 (可以為特定代碼設定特定版本)：
output=xml_vast4
使用聯播網的預設 VMAP 設定：
output=vmap
使用 VMAP 1：
output=xml_vmap1
使用 VMAP 1，傳回 VAST 4 (如果在 VMAP 中傳回 VAST)：
output=xml_vmap1_vast4
sz (大小)
說明
大小 (sz) 參數接受變數值，應設為主要影片廣告版位的大小。
如有多個大小，請使用直立線 (|) 做為分隔字元。
請勿在大小後面加上「v」。
使用範例
單一大小：
sz=400x300
多個大小：
sz=300x250|400x300
unviewed_position_start (延遲曝光)
url (網址)
說明
網址 (url) 參數接受變數值，應設為傳送請求的完整網址。這個必要的值可讓買方辨識及瞭解該項請求的來源背景資訊。如果可以，這個值應動態填入廣告請求。
- 以網頁來說，這是顯示影片播放器的網頁網址。
- 非網頁環境中，這個值應設為最能準確代表營利影片或音訊廣告空間的網址。舉例來說，假設使用者是在行動應用程式觀看影片，這個值應設為可以在電腦存取該行動應用程式的對等網址*。
注意事項：url 與 description_url 不同。url 是指廣告請求的來源位置，description_url 則是說明影片內容的可檢索網頁。
這項參數的值必須經過編碼。
使用範例
url=https%3A%2F%2Fwww.example.com%2Fvideo.html
* 以應用程式來說，如果無法將這項參數設為網址變數值，建議採用下列模式：url=https%3A%2F%2F<app/bundleid>.example.com
必須用於程式輔助的參數
ott_placement (OTT 刊登位置)
說明
「OTT 刊登位置」參數 (ott_placement) 接受常數值，指出特定刊登位置類型的請求。
1.標準串流內廣告不需要傳遞這個參數。
以下是刊登位置定義範例：
- 暫停：使用者暫停內容播放時，串流外格式會以重疊方式顯示在影片內容上方。
- 主畫面：在連網電視裝置或 OTT 應用程式的主畫面上顯示的廣告，包括主畫面上的刊頭廣告、橫幅廣告和圖塊。
- 子母畫面：在影片內容旁邊，獨立影片廣告播放器中播放的串流內影片廣告。通常需要壓縮影片內容並載入第二個影片播放器。
- L 型橫幅廣告：串流內多媒體廣告，會壓縮影片內容，並在影片周圍建立廣告。通常是 L 形廣告素材方塊，但不限於此。
- 重疊：任何串流內廣告格式，顯示在影片內容上方，但不會占滿全螢幕，可以是多媒體廣告或影片廣告。
使用範例
支援的格式及其對應值：
暫停：
ott_placement=1
主畫面：
ott_placement=2
子母畫面：
ott_placement=3
L 型橫幅廣告：
ott_placement=4
重疊廣告：
ott_placement=5
自訂/其他：
ott_placement=99
plcmt (刊登位置)
說明
「刊登位置」參數 (plcmt) 接受常數值，用於指出串流內廣告空間是否依據 IAB 規格的指引，宣告為「串流內廣告」或「隨播內容」。
針對非串流內廣告請求，系統會根據宣告的廣告空間格式，自動替買方填入這個欄位，並會覆寫任何串流內廣告或隨播內容宣告。
使用範例
串流內廣告請求：
plcmt=1
隨播內容請求：
plcmt=2
vpa (影片自動播放)
說明
影片自動播放 (vpa) 參數接受常數值，會指出廣告中的影片內容是自動播放或點選後才開始播放。
如果頁面會等待使用者動作，可能的值為 click；如果影片會自動播放，則為 auto。這項參數不會改變影片播放器的狀態，播放模式必須直接透過影片播放器操作。
使用範例
自動播放：
vpa=auto
隨點即播：
vpa=click
如果值未知，請勿設定這項參數。
vpmute (影片播放靜音)
說明
影片播放靜音 (vpmute) 參數接受常數值，會指出影片播放器處於靜音狀態時是否會播放廣告。這項參數不會改變影片播放器的狀態，播放模式必須直接透過影片播放器操作。
使用範例
靜音時開始播放：
vpmute=1
非靜音時播放：
vpmute=0
建議用於程式輔助的參數
aconp (音訊連續播放)
說明
「音訊連續播放」參數 (aconp) 接受常數值，指出播放器是否打算連續播放音訊內容。這有助於 Google Ad Manager 為使用者提供最合適的廣告體驗。
使用範例
開啟連續播放：
aconp=2
關閉連續播放：
aconp=1
如果不知道音訊是否會持續播放，請勿設定這個參數，或將其設為 aconp=0。
dth (裝置類型提示)
說明
「裝置類型提示」參數 (dth) 接受常數值，有助減少裝置分類錯誤的情況，特別是在連網電視和機上盒環境。
裝置分類錯誤可能是發布商或連網電視原始設備製造商 (OEM) 無意間造成的錯誤。這個參數會與其他信號搭配使用，讓 Google 自動標示可能需要重新分類連網電視廣告空間的情況。
使用範例
請求來自：
- 功能型手機：
dth=1 - 智慧型手機：
dth=2 - 桌上型電腦：
dth=3 - 平板電腦：
dth=4 - 連網電視：
dth=5 - 遊戲主機：
dth=6 - 機上盒：
dth=7
givn (影片 Nonce)
說明
如果整合作業使用程式輔助存取權資料庫 (PAL)，影片 Nonce 參數會接受變數字串值。
Nonce 是安全的網址，您不需要對其進行網址編碼。
注意：如果您先前使用舊版 paln 參數提供 Nonce，強烈建議您改用 givn 參數，並停止傳送 paln。請勿同時加入這兩個參數。
使用範例
如要進一步瞭解傳遞給這個參數的值，請參閱 PAL 的入門指南。
hl (語言)
說明
「語言」參數接受 (hl) 常數值，用於請求該語言的廣告；在 Ad Exchange 或 AdSense 影片廣告中，這個參數能夠為動態分配的廣告選擇作業和影片廣告顯示作業設定語言。
使用範例
請求義大利文廣告：
hl=it
參數值可以是任何 ISO 639-1 (雙字母) 或 ISO 639-2 (三字母) 代碼。請查看有效代碼清單。
如果省略，該值則會預設使用在 Ad Exchange 中依據語言指定廣告目標的任何語言。
omid_p (OMID 合作夥伴名稱)
說明
「OMID 合作夥伴名稱」參數 (omid_p) 接受使用變數值，指出整合 OMID 評估功能的合作夥伴名稱和合作夥伴版本。
「支援的 SDK API」參數 (sdk_apis) 接受變數值，可使用單一或以逗號分隔的支援 API 清單。
這些參數是一組參數的一部分，用於可見度和廣告驗證。
使用範例
未使用 PAL 時：
omid_p=examplepartnername/1.0.0.0&sdk_apis=7
請參閱可能的 API 架構值清單。
使用 PAL 時：
request.omidPartnerName = 'examplepartnername'
request.omidPartnerVersion = '1.0.0.0'
需求條件和建議
雖然您不必使用這個參數為特定導入類型放送廣告，但建議您在網頁、行動應用程式、連網電視、音訊和數位戶外廣告中使用程式輔助營利功能。
SDK 使用情形
- 請注意，這個參數僅適用於使用 Open Measurement SDK (OM SDK)，且想透過 Active View 評估的發布商。
- 如要在使用程式輔助存取權資料庫 (PAL) 時指明 OMID 支援，請務必透過
omidPartnerName和omidPartnerVersion設定合作夥伴名稱和版本。如果您不是使用 PAL 或 IMA SDK，則須設定omid_p和sdk_apis參數。 - 假如您是使用 IMA SDK，則請勿使用這個參數，因為系統會自動完成相關設定。
vconp (影片連續播放)
說明
影片連續播放 (vconp) 參數接受常數值，會指出播放器是否會接續播放影片內容 (類似電視節目)。
使用範例
連續播放為「啟用」：
vconp=2
連續播放為「停用」：
vconp=1
如果值未知，請勿設定這項參數。
要求和建議
雖然針對任意實作項目放送廣告時，您不一定要提供這項參數，不過如要透過程式在網站、行動應用程式、連網電視和音訊營利，則建議使用這項參數。
美國媒體評議會 (MRC) 影片評估規範也建議使用這項參數。
vid_d (影片長度)
說明
影片時間長度 (vid_d) 參數接受變數值，會指出內容的時間長度 (以秒為單位)。
vid_d和allcues參數用於不擷取內容而放送片中廣告。- 必須使用廣告規則，才能傳回片中廣告。如果廣告規則使用以時間為基礎的提示 (例如「每 N 秒」或「在固定的時間」)，就會使用所設提示，並忽略傳入
allcues的提示。片中廣告仍須設定時間長度，因此還是要傳遞vid_d。
使用範例
片長 90,000 秒 (25 小時) 的影片：
vid_d=90000
vpos (影片位置)
說明
影片位置 (vpos) 參數接受常數值，會指出廣告請求的來源為片頭、片中或片尾。
使用範例
片頭：
vpos=preroll
片中：
vpos=midroll
片尾：
vpos=postroll
wta (為什麼會顯示這則廣告)
說明
「為什麼會顯示這則廣告？」參數 (wta) 接受常數值，會指出影片播放器是否支援顯示廣告徽章。
使用範例
如果播放器應顯示 VAST 回應中提供的 AdChoices 圖示，請使用：
wta=1(也可以省略wta參數，或是傳遞未設有值的wta)如果 VAST 回應中提供的 AdChoices 圖示會顯示於隨播廣告或提供給使用者，音訊請求則應使用
wta=1。
如果播放器不應顯示 VAST 回應中提供的 AdChoices 圖示，請使用：
wta=0
要求和建議
雖然針對任意實作類型放送廣告時，您不一定要提供這項參數，不過如要透過程式在網站、行動應用程式、連網電視和音訊營利，則建議使用這項參數。
使用參數時：
&wta=0流量不適用於 Google Demand 中的某些個人化類型。- 來自歐洲經濟區的
&wta=0流量不適用於位於預訂和發布商管理的程式輔助保證委刊項，並已啟用廣告徽章的廣告素材。
廣告必須符合在歐洲經濟區 (EEA) 放送廣告的適用法律規定，包括可讓使用者檢舉非法內容的機制。發布商應使用「舉報 Google 上的內容」表單，通知 Google 遭到檢舉的所有非法內容。
使用 SDK
使用 IMA SDK 時，系統會自動支援廣告徽章功能。如果不使用 IMA SDK，影片播放器就必須導入 VASTIcon 和 IconClickFallbackImage 支援 (如 IAB VAST 標準的相關說明所述)。