必須用於應用程式的參數

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

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

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

使用範例

correlator=4345645667

必要與否

必須用於網站和應用程式

建議用於程式輔助營利

「說明網址」參數接受的變數值必須能描述網頁上播放的影片。使用 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

建議用於程式輔助營利

「環境」參數接受常數值，以表示串流內請求，或請求特別源自某個影片播放器。

可能的值包括 instream (可用於影片和音訊廣告) 或 vp (只能用於影片廣告)。

使用範例

影片和/或音訊廣告：
env=instream

僅限影片廣告：
env=vp

必要與否

必須用於網站和應用程式

「Ad Manager 結構定義指示器」參數接受常數值，以指出使用者處於 Ad Manager 架構。

使用範例

gdfp_req=1

規定

必須用於網站和應用程式

「廣告單元」參數接受變數值，但該值應設為目前的廣告單元，並採用下列格式：

/network_code/.../ad_unit

使用範例

iu=/6062/videodemo

規定

必須用於網站和應用程式

「應用程式 ID」和「應用程式名稱」參數接受變數值；由於大部分的程式輔助影片廣告都需要這兩個參數，這兩個參數應該用於從行動應用程式和連網電視裝置發出的請求。

IMA SDK 會自動填入這兩個參數，但您必須在非 SDK 環境 (包括直接 VAST 呼叫)，或使用程式輔助存取權資料庫 (PAL)/發布商驗證廣告空間 (PAI) 時手動指定。

雖然應用程式名稱應採用使用者可理解的形式，但在 iOS 和 tvOS 中，SDK 無法存取應用程式 ID。在這些情況下，系統不會傳送 msid 參數，且 SDK 會透過 an 參數傳送應用程式套件。

使用範例

msid=com.package.publisher&an=sample%20app

應用程式 ID 的名稱和格式，會因應用程式商店而異。請參閱 IAB 應用程式識別指南，或常見專屬 ID 範例。

如果平台沒有應用程式商店，則 IAB 建議發布商使用以下商店 ID 格式：com.publisher.deviceplatform

必要與否

這兩個都是應用程式的必要參數

建議用於程式輔助營利

「廣告輸出格式」參數接受常數值，但該值應設為廣告的輸出格式。

針對已為聯播網設定的預設 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

必要與否

必須用於網站和應用程式

當使用者在 Android 裝置上停用個人化設定時，必須提供應用程式組 ID 值才能營利。

pvid 參數接受設為 Android 應用程式組 ID 的變數值，pvid_s 參數則接受代表應用程式組 ID 範圍 (scope_app 或 scope_developer) 的常數值。

IMA/PAL SDK 會自動傳遞這個欄位，但未導入 SDK 的發布商必須呼叫應用程式設定的 SDK，並根據廣告請求手動傳遞這些參數。

請參閱 Android 說明文件，瞭解如何擷取應用程式組 ID。

使用範例

pvid=[AppSetID_value]
pvid_s=scope_app

必要與否

必須用於應用程式

建議用於程式輔助營利

可重設的裝置 ID 接受變數值。

針對內建應用程式 (一般網站和行動版網站不適用)，SDK 會將可重設的裝置 ID (用於指定使用者) 傳入您的串流請求，使用的參數包括 rdid、idtype 和 is_lat。在 SSB 串流中，您必須以明確的參數形式傳遞這些參數，就跟在用戶端廣告請求中一樣。進一步瞭解裝置 ID。　

幾乎所有的程式輔助影片廣告都需要這些值。

使用範例

查看可重設裝置 ID 的詳細範例。

必要與否

必須用於應用程式

建議用於程式輔助營利

「大小」參數接受變數值，但該值應設為主影片廣告版位的大小。

如有多個大小，請使用直立線 (|) 做為分隔字元。

請勿在大小後面加上「v」。

使用範例

sz=400x300

必要與否

必須用於網站和應用程式

如果只請求 ad_type=audio，則此參數為選用。

「延遲曝光」參數接受常數值，以指出影片的延遲曝光次數。

使用範例

unviewed_position_start=1

必要與否

必須用於網站和應用程式

「網址」參數接受變數值，但該值應設為傳送請求的完整網址。這個必要值可協助買方辨識及瞭解此請求的來源脈絡。在可行範圍內，這個值應能動態填入廣告請求。

在網頁上，這是顯示影片播放器的網頁網址。如果您使用 IMA SDK，SDK 會自動設定網址值。要是播放器設定了這個值，IMA SDK 會遵循設定的值。

在應用程式 (行動裝置或連網電視) 中，這個值必須設為最能精確代表用於營利的影片或音訊廣告空間網址。舉例來說，如果使用者是在行動應用程式中觀看影片，則這個值應設為可用來在電腦上觀看該影片的對等網址。*

這個參數值必須經過編碼才能使用。

使用範例

url=https%3A%2F%2Fwww.videoad.com%2Fgolf.html

* 針對應用程式，如果無法將這個參數設為網址變數值，建議設為下列模式：
url=https%3A%2F%2F<app/bundleid>.adsenseformobileapps.com

必要與否

必須用於網站和應用程式

建議用於程式輔助營利

「為什麼會顯示這則廣告？」參數接受常數值，此值可用來辨別影片播放器是否支援顯示廣告徽章。如果未傳送 &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

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

建議用於程式輔助營利