必須用於和建議用於程式輔助的參數

「語言」參數接受常數值，用來請求該語言的廣告；在 Ad Exchange 或 AdSense 影片廣告中，這個參數能夠為動態分配的廣告選擇作業和影片廣告顯示作業設定語言。

參數值可以是任何 ISO 639-1 (雙字母) 或 ISO 639-2 (三字母) 代碼。請查看有效代碼清單。

如果省略，該值則會預設使用在 Ad Exchange 中依據語言指定廣告目標的任何語言。

使用範例

hl=it

必要與否

建議用於程式輔助營利

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

建議用於程式輔助營利

裝置類型提示參數可接受常數值，有助減少裝置分類錯誤的情況，特別是在連網電視和機上盒環境。

裝置分類錯誤可能源自發布商或連網電視原始設備製造商 (OEM) 的非預期錯誤。這個參數會與其他信號搭配使用，讓 Google 自動標示可能需要重新分類連網電視廣告空間的情況。

使用範例

請求來自：

• 功能型手機：dth=1
• 智慧型手機：dth=2
• 桌上型電腦：dth=3
• 平板電腦：dth=4
• 連網電視：dth=5
• 遊戲主機：dth=6
• 機上盒：dth=7

必要與否

建議用於連網電視的程式輔助營利。

建議在導入 PAL 和 PAI (非 SDK) 時使用這個參數。導入 IMA SDK 或 DAI SDK 不需要這個參數。

「應用程式 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

必要與否

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

建議用於程式輔助營利

刊登位置參數接受常數值。根據 IAB 規格的指引，這個值可用於指出串流內廣告空間是宣告為「串流內廣告」還是「隨播內容」。

針對非串流內廣告請求，系統會根據宣告的廣告空間格式，自動替買方填入這個欄位，並會覆寫任何串流內廣告或隨播內容宣告。

使用範例

串流內廣告請求：
plcmt=1

隨播內容請求：
plcmt=2

必要與否

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

「廣告素材設定檔」參數接受變數值，會根據影片和音訊廣告素材設定檔中的設定，控管哪些廣告素材符合放送資格。

使用範例

pp=creative_profile

規定

建議用於程式輔助營利

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

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

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

使用範例

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

必要與否

必須用於應用程式

建議用於程式輔助營利

「工作階段 ID」參數接受變數值；這是一種可保障隱私權的廣告 ID，只能用於設定展示頻率上限。

來自連網電視的串流內影片請求，以及來自行動應用程式裝置的串流內影片廣告空間，都支援工作階段 ID，但目前不支援網頁版。

根據 IAB 的 IFA 指南，這個參數應以 UUID 格式填入。進一步瞭解用於指定使用者的可重設裝置 ID。

如要停止傳送工作階段 ID，您可以設定 sid=0。

使用範例

123e4567-e89b-12d3-a456-426614174000

規定

建議用於程式輔助營利

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

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

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

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

使用範例

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

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

必要與否

必須用於網站和應用程式

建議用於程式輔助營利

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

「影片自動播放」參數接受常數值，指出廣告中的影片內容是自動播放還是點擊後才開始播放。

如果頁面會等待使用者動作，可能的值為 click；如果影片會自動播放，則可能的值為 auto。

如果狀態不明，請勿設定這個參數。

使用範例

自動播放：
vpa=auto

隨點即播：
vpa=click

必要與否

建議用於程式輔助營利

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

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

使用範例

已靜音：
vpmute=1

已取消靜音：
vpmute=0

必要與否

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

「影片位置」參數接受常數值，以指出廣告請求的來源是片頭、片中還是片尾位置。

使用範例

片頭廣告：
vpos=preroll

片中廣告：
vpos=midroll

片尾廣告：
vpos=postroll

規定

建議用於程式輔助營利

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

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

建議用於程式輔助營利