VAST 廣告代碼網址參數

播放器會使用 VAST 廣告代碼網址擷取影片和音訊廣告。您可以手動組譯 VAST 廣告代碼網址，或使用下列參數修改現有的網址，然後使用 VAST 套件檢查器進行測試。您也可以使用這些廣告代碼範例進行審查及測試。

一般網址規定

通訊協定：VAST 廣告代碼支援 http 和 https。曝光追蹤網址會依據目前的 SSL 設定，傳回 http 或 https。點閱和點擊追蹤則是採用 http 協定，因為這會從另一個頁面重新導向。
網域：系統不支援透過模式比對巨集或任何其他動態方法建立的動態網域，使用這類網域會導致錯誤。
直播流量：直播影片廣告代碼網址的路徑中「必須」包含 /live，才能夠處理同時包含所有廣告插播的大量流量。

VAST 廣告代碼範例

設有參數和指定值的 VAST 廣告代碼網址範例看起來應該會像這樣：

https://securepubads.g.doubleclick.net/gampad/ads?env=vp&gdfp_req=1&output=vast&iu=/1234/video-demo&sz=400x300&unviewed_position_start=1&ciu_szs=728x90,300x250

跳至清單中的特定參數

aconp
ad_rule
ad_type
addtl_consent
afvsz
allcues
an
ciu_szs
correlator
cmsid
cust_params
description_url
env
excl_cat
gdfp_req
gdpr
gdpr_consent
hl

iabexcl
idtype
ipd
ipe
is_lat
iu
lip
ltd
max_ad_duration
min_ad_duration
mridx
msid
nofb
npa
omid_p
output
plcmt
pmad

pmnd
pmxd
pod
pp
ppt
ppid
ppos
ppsj
ptpl
ptpln
pubf
pvid
pvid_s
pvtf
rdid
rdp
scor
sdk_apis

sdmax
sid
ssss
sz
tfcd
trt
unviewed_position_start
url
vad_type
vconp
vid
vid_d
vpa
vpi
vpmute
vpos
wta

參數詳細說明

aconp

_{(音訊連續播放)}

依據 MRC 音訊評估指南的建議

「音訊連續播放」參數接受常數值，以指出播放器是否打算連續播放音訊內容。

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

使用範例

連續播放「開啟」：
aconp=2

連續播放「關閉」：
aconp=1

ad_rule

_{(廣告規則)}

「廣告規則」參數接受常數值，以指出應傳回 VAST 廣告素材還是廣告規則回應。

廣告規則的預設設定取決於 Ad Manager 聯播網設定。您可以使用以下的範例，覆寫特定廣告代碼的設定。

使用範例

請求 VAST 廣告素材：
ad_rule=0

請求廣告規則 (VMAP)：
ad_rule=1

規定

必須用於影片廣告規則

ad_type

_{(廣告類型)}

「廣告類型」參數接受常數值，以指出應針對請求傳回的廣告類型。

只有音訊廣告才需要這個參數。

如果 ad_type 設為 audio 或 audio_video，vpmute 參數就必須設為 0。

使用範例

只允許音訊廣告：
ad_type=audio

允許可略過和不可略過的影片廣告：
ad_type=video

允許音訊和影片廣告：
ad_type=audio_video
(這個值會允許這兩種格式競爭，但只會放送一種格式。)

audio_video 廣告類型只能用來將影片廣告素材放送至支援影片廣告播放的音訊內容，或將音訊廣告素材放送至播放自然環境中「可聽」內容的串流內影片播放器。例如：體育賽事串流、節目影片、新聞等。進一步瞭解影片內容中的音訊。

只允許可略過的影片廣告：
ad_type=skippablevideo

只允許不可略過的影片廣告：
ad_type=standardvideo

必要與否

必須用於音訊廣告

addtl_consent

_{(額外同意聲明)}

「額外同意聲明」參數會接受變數值；如果發布商想要整合 IAB 資訊公開和同意聲明架構第 2.0 版，並使用尚未註冊加入歐洲互動廣告局全球供應商清單，但已列入 Google 廣告技術供應商 (ATP) 名單的供應商，就會使用「額外同意聲明」參數。直接 VAST 請求並不會自動讀取這些值；一旦這些值加入廣告代碼中，就會獲得接受。

如需進一步瞭解傳遞給這個參數的值，請參閱《額外同意聲明模式技術規格》的內容。

使用範例

addtl_consent=1~1.35.41.101

afvsz

_{(非線性廣告大小)}

「非線性廣告大小」參數接受常數值，但這些值應為可以在影片廣告版位中顯示的非線性廣告大小逗號分隔清單。

廣告的大小必須是以下支援的大小之一：

200x200
250x250
300x250
336x280
450x50
468x60
480x90
729x90

使用 IMA SDK 時，這個欄位將被覆寫，並填入 nonLinearAdSlotWidth 和 nonLinearAdSlotHeight 內所有受支援的大小。

如果不支援非線性大小，這個參數可以省略或留空。

使用範例

支援所有大小：
afvsz=200x200,250x250,300x250,336x280, 450x50,468x60,480x90,728x90

寬度上限為 250：
afvsz=200x200,250x250

高度上限為 60：
afvsz=450x50,468x60

寬度上限為 100：
//empty; no values supported

必要與否

不使用 IMA SDK 時，必須用於非線性影片廣告

allcues

_{(所有提示點)}

此參數接受變數值；這些值為逗號分隔的提示點清單 (以毫秒為單位)。Ad Manager 會針對每個值傳回一個廣告插播。

vid_d 和 allcues 參數是用來在不攝入內容的情況下放送片中廣告。您也必須設定廣告規則，才能傳回片中廣告。

如果廣告規則中使用以時間為基準的提示 (例如「每 N 秒」或「在固定的時間」)，則會使用廣告規則中設定的提示、忽略傳遞至 allcues 中的提示。由於片中廣告仍需要設定時間長度，因此還是必須傳遞 vid_d。

使用範例

10 秒和 20 秒的提示點：
allcues=10000,20000

ciu_szs

_{(隨播廣告大小)}

「隨播廣告大小」參數接受變數值；這些值為逗號分隔的隨播廣告大小清單。

用直立線 (|) 分隔的值表示廣告版位具有多個大小。

使用範例

ciu_szs=728x90,300x250

多重大小版位的廣告大小：
ciu_szs=728x90,300x200|300x250

cmsid

_{(內容來源 ID)}

vid

_{(影片 ID)}

「內容來源 ID」和「影片 ID」參數接受變數值。

如要將廣告指定到影片內容，您的主影片廣告代碼必須「同時」包含這兩個參數。

cmsid 是每個內容來源的專屬號碼。如要在 Ad Manager 中找出這組號碼，請依序按一下 [影片] 接下來 [內容來源]，然後按一下來源名稱。

vid 是用來表示特定影片的字串或編號。這個 ID 是由代管內容的內容管理平台指定。如要在 Ad Manager 中找出這個 ID，請依序按一下 [影片] 接下來 [內容]，然後按一下特定影片內容。

使用範例

cmsid=[value]&vid=[value]

如果是為包含隨選影片的動態廣告插播建立廣告代碼，應使用巨集，因為此巨集會動態插入正確的內容來源和影片 ID。

例如：cmsid=%%CMS_ID%%&vid=%%VIDEO_ID%%

必要與否

必須用於影片內容指定目標

correlator

_(Correlator)

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

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

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

使用範例

correlator=4345645667

必要與否

必須用於網站和應用程式

建議用於程式輔助營利

cust_params

_{(自訂鍵/值參數)}

「自訂參數」參數接受變數值，也就是可讓您設立特定指定目標的鍵/值組合，例如客層、網頁上的某些位置或特定網頁。

使用範例

請參閱如何新增鍵/值組合的範例。

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

必要與否

必須用於網站和應用程式

excl_cat

_{(排除類別)}

「排除類別」參數接受變數值；如果委刊項包含其中列示的排除標籤，即會遭到封鎖，無法符合特定廣告請求的資格。這個參數適用於 cust_params。

使用範例

&cust_params=excl_cat%3Dairline_excl_label%7C

gdfp_req

_{(Ad Manager 架構指標)}

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

使用範例

gdfp_req=1

規定

必須用於網站和應用程式

gdpr

_(GDPR)

GDPR 參數會接受常數值，而且想要整合 IAB 資訊公開和同意聲明架構第 2.0 版的發布商也會使用該參數。直接 VAST 請求不會自動讀取這些值，但加入至廣告代碼之後，這些值就會獲得接受。

這個參數的有效值只有 0 和 1，其中 0 代表不適用 GDPR，1 則代表適用 GDPR。如果適用 GDPR，您還必須使用 gdpr_consent 參數提供有效的資訊公開和同意聲明 (TC) 字串。

如需進一步瞭解傳遞給這個參數的值，請參閱導入架構的一般指南，或 IAB 資訊公開和同意聲明架構第 2.0 版規格中「TC 字串」一節的內容。

使用範例

適用 GDPR：
gdpr=1

不適用 GDPR：
gdpr=0

gdpr_consent

_{(GDPR 同意聲明)}

GDPR 同意聲明參數會接受變數值，而且想要整合 IAB 資訊公開和同意聲明架構第 2.0 版的發布商都會使用該參數。直接 VAST 請求並不會自動讀取這些值；一旦這些值加入廣告代碼中，就會獲得接受。

如需進一步瞭解傳遞給這個參數的值，請參閱導入架構的一般指南，或 IAB 資訊公開和同意聲明架構第 2.0 版規格中「TC 字串」一節的內容。

使用範例

gdpr_consent=GDPR_CONSENT_123

hl

_(語言)

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

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

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

使用範例

hl=it

必要與否

建議用於程式輔助營利

iabexcl

_{(IAB 排除網址)}

iabexcl 網址參數接受以半形逗號分隔的類別清單。

使用範例

iabexcl=3,14,527 排除了「商用卡車」、「越野車」和「橄欖球」。

進一步瞭解 IAB 內容分類。

ipd

_{(廣告空間合作夥伴網域)}

「廣告空間合作夥伴網域」參數接受變數值，但該值應設為發布商 app-ads.txt (或 ads.txt) 檔案中的 inventorypartnerdomain 宣告。

inventorypartnerdomain 參數是 IAB 規格，可協助發布商指定廣告空間共用合作夥伴的網域，以便進行 ads.txt/app-ads.txt 驗證。

如果廣告請求的來源廣告空間是由其他合作夥伴 (廣告空間共用合作夥伴) 所擁有，則 IPD 宣告在廣告空間共用用途中格外重要。

進一步瞭解 ads.txt/app-ads.txt 和廣告空間共用合作夥伴。

ipe

_{(曝光連線偵測實體)}

曝光連線偵測實體 (ipe) 參數接受常數值，用於指出來自伺服器 (而非用戶端) 的曝光連線偵測和轉換次數。

使用範例

伺服器端信標 (SSB)：
ipe=ssb

iu

_{(廣告單元)}

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

/network_id/.../ad_unit

使用範例

iu=/6062/videodemo

規定

必須用於網站和應用程式

lip

_{(廣告連播中的最後 1 個位置)}

「廣告連播中的最後 1 個位置」參數接受常數值，以指出來自廣告連播中最後 1 個位置的請求。

這個參數僅適用於標準廣告連播。

使用範例

lip=true

ltd

_{(受限制的廣告)}

「受限制的廣告」參數接受常數值，指出是否要在未取得 Cookie 或其他本機 ID 使用同意聲明的情況下，以受限的方式放送廣告。

有別於其他網址參數，設定 ltd=1 會變更 IMA SDK 的行為，將請求視為無 ID 且不允許儲存。

使用範例

ltd=1

min_ad_duration

_{(廣告時間長度下限)}

max_ad_duration

_{(廣告時間長度上限)}

「廣告長度」參數接受變數值；搭配使用時，可用來指定廣告必須符合的播放時間範圍 (單位為毫秒)。

您可以使用這個參數，限制單一廣告和最佳化廣告連播要求的個別廣告時間長度。

使用範例

min_ad_duration=15000&max_ad_duration=30000

mridx

_{(片中廣告編號)}

「片中廣告編號」參數接受變數值，以指出片中廣告的序數 (例如片中廣告 1、片中廣告 2 等)。

使用範例

mridx=2

msid

_{(應用程式 ID)}

an

_{(應用程式名稱)}

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

必要與否

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

建議用於程式輔助營利

nofb

_{(停用備用廣告)}

「停用備用廣告」參數接受常數值，以指出廣告請求「不應」傳回影片備用廣告的播放清單。

使用範例

停用備用廣告：
nofb=1

npa

_{(非個人化廣告)}

「非個人化廣告」參數接受常數值，以指出應將廣告請求視為非個人化。

您必須特別設定 npa=1 或包含 npa (沒有固定值)，才能將請求標為非個人化。沒有這個參數或是設為 nap=0 的廣告請求會預設為個人化廣告。

使用範例

非個人化廣告：
npa=1

omid_p

_{(OMID 合作夥伴名稱)}

「OMID 合作夥伴名稱」參數接受使用變數值，指出整合 OMID 評估功能的合作夥伴名稱和合作夥伴版本。

請注意，這個參數僅適用於使用 Open Measurement SDK (OM SDK)，且想透過 Active View 評估的發布商。假如您是使用 IMA SDK，則請勿使用這個參數，因為系統會自動完成相關設定。

如要在使用程式輔助存取權資料庫 (PAL) 時指明 OMID 支援，請務必透過 omidPartnerName 和 omidPartnerVersion API 設定合作夥伴名稱和版本。若您不是使用 PAL 或 IMA，則須設定 omid_p 和 sdk_apis 參數 (兩者皆為支援的 API，也可以納入其他 API 並以半形逗號分隔)。

使用範例

使用 PAL 時：
request.omidPartnerName = 'examplepartnername' request.omidPartnerVersion = '1.0.0.0'

未使用 PAL 時：
omid_p=examplepartnername/1.0.0.0&sdk_apis=7

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

必要與否

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

pmad

_{(廣告連播廣告數量上限)}

「廣告連播廣告上限」參數接受變數值，以指出廣告連播中的廣告數量上限。

這個參數僅適用於最佳化廣告連播 (凡是擁有進階影片廣告套裝內容的發布商皆可使用)，不得用於 VMAP (當 ad_rule=1)。

使用範例

pmad=4

pmnd

_{(廣告連播時間長度下限)}

pmxd

_{(廣告連播時間長度上限)}

「廣告連播長度」參數接受變數值；搭配使用時，可用來指定廣告連播必須符合的播放時間範圍 (單位為毫秒)。

這些參數是用於請求多個廣告，僅適用於最佳化廣告連播 (凡是擁有進階影片廣告套裝內容的發布商皆可使用)。這些參數也不得用於 VMAP (當 ad_rule=1)。

使用範例

pmnd=0&pmxd=60000

廣告連播

_{(廣告連播編號)}

「廣告連播編號」參數接受變數值，代表影片中廣告連播的序數 (例如廣告連播 1、廣告連播 2 等)。

使用範例

pod=3

規定

必須用於競爭排除條件、展示頻率上限和相關功能，才能正確運作。

pp

_{(廣告素材設定檔)}

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

使用範例

pp=creative_profile

規定

建議用於程式輔助營利

ppt

_{(發布商隱私權處理方式)}

「發布商隱私權處理方式」參數接受常數值，用來指出是否要停用廣告請求的廣告個人化設定。

進一步瞭解發布商隱私權處理方式。

使用範例

停用廣告個人化設定：
ppt=1

ppid

_{(發布商提供的 ID)}

如果參數是由發布商提供 ID (PPID)，則該參數接受該 ID 使用變數值，以便用於展示頻率上限、目標對象區隔及指定廣告依序輪播，以及其他與目標對象相關的跨裝置廣告放送控制設定。

使用範例

ppid=12JD92JD8078S8J29SDOAKC0EF230337

ppos

_{(在廣告連播中的位置)}

「在廣告連播中的位置」參數接受變數值，代表在廣告連播中的位置 (例如位置 1、位置 2 等)。

這個參數僅適用於標準廣告連播，而且是自動供應隨播廣告的必要項目。

使用範例

ppos=2

規定

必須用於競爭排除條件、展示頻率上限和相關功能，才能正確運作。

ppsj

_{(發布商提供的信號 JSON)}

為提高程式輔助營利成效，發布商提供的信號 JSON 參數接受以 Base64 編碼的 JSON 物件，包含發布商提供的目標對象和比對內容資料。

進一步瞭解發布商提供的信號和支援的分類。

如要深入瞭解有效的 JSON 鍵/值組合，請參閱
HTML5 IMA SDK 範例。

使用範例

JSON 物件：
{ "PublisherProvidedTaxonomySignals": [{ "taxonomy": "IAB_AUDIENCE_1_1", "values": ["6", "284"] }] }

Base64 編碼值：
eyJQdWJsaXNoZXJQcm92aWRlZFRheG9ub215U2lnbmFscyI6W3s idGF4b25vbXkiOiJJQUJfQVVESUVOQ0VfMV8xIiwidmFsdWVzIj pbIjEiLCIyODQiXX1dfQ

ptpl

_{(廣告插播範本 ID)}

ptpln

_{(廣告插播範本名稱)}

廣告插播範本 ID 和名稱用來表示哪一個廣告插播範本應套用至最佳化廣告連播請求，可使用變數值。透過廣告時段範本，您可以設定哪些廣告位置或自訂廣告位置應包含在廣告插播中，以及應按哪種順序放送。

要求廣告插播範本時，只需使用其中一個參數 (名稱或 ID) 即可。

使用範例

如要進一步瞭解如何設定及要求廣告插播範本，請參閱這篇文章。

pubf

_{(Ad Exchange 廣告代碼中的公開底價)}

pvtf

_{(Ad Exchange 廣告代碼中的私下底價)}

pubf 等同於 google_ad_public_floor，而 pvtf 則相當於 google_ad_private_floor。這些參數可用來將底價加入至 Ad Exchange 廣告代碼中。

使用範例

pubf=123 pvtf=123

pvid

_{(應用程式組 ID)}

pvid_s

_{(應用程式組範圍)}

當使用者在 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

必要與否

必須用於應用程式

建議用於程式輔助營利

rdid

      idtype

      is_lat

_{(可重設裝置 ID)}

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

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

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

自 iOS 14.5 起，Apple 已淘汰 LAT 信號。Google 則需參考非零的廣告識別碼，瞭解在支援應用程式追蹤透明度的 iOS 版本上，使用者是否同意啟用追蹤功能。因此，系統需要有效的 UserAgent 來取得正確的 OS 版本。

使用範例

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

必要與否

必須用於應用程式

建議用於程式輔助營利

rdp

_{(受限的資料處理)}

「限制資料處理」參數接受常數值，以指出廣告請求應限制資料處理。

您必須特別設定 rdp=1 或包含 rdp (沒有固定值)，才能限制資料處理。除非啟用限制資料處理聯播網設定，否則沒有這個參數或是設為 rdp=0 的廣告請求不會實施限制。

使用範例

rdp=1

scor

_{(串流 Correlator)}

「串流 Correlator」參數接受變數值，但該值必須為針對每個影片串流所產生的整數。這個數字在同一個串流內必須保持一致，在同一次網頁瀏覽中則不得重複。如果使用者觀看同一個網頁中的多部影片，這個參數可用於設定競爭排除條件、展示頻率上限和相關功能。

使用範例

scor=17

必要與否

必須用於競爭排除條件、展示頻率上限和相關功能，才能正確運作。

sdk_apis

_{(SDK API 架構)}

SDK API 架構參數接受以逗號分隔的常數整數值清單，以指出播放器支援的所有 API 架構。

請參閱可能的 API 架構值清單。

對於未使用 IMA SDK 的發布商，這個參數支援程式輔助存取權資料庫 (PAL) 的 API。IMA SDK 會以 IMA SDK 支援的值覆寫任何已設定的值。

使用範例

sdk_apis=2,7,9

sdmax

_{可略過的廣告長度上限}

sdmax (可略過的廣告長度上限) 廣告請求參數接受變數值，發布商能夠為可略過的廣告指定想要的廣告時間長度上限。

時間長度以毫秒為單位，代表該特定廣告請求中，可略過影片/音訊廣告素材的時間長度上限。

sdmax 可以單獨用於可略過的廣告，也可以與現有的 max_ad_duration 參數搭配使用，為可略過和不可略過的廣告提供不同的時間長度上限。

使用範例

如將下列設定：

max_ad_duration = 15000 (15 秒)
sdmax = 45000 (45 秒)

套用至下列廣告素材：

廣告素材 A：不可略過；30 秒
廣告素材 B：可略過；30 秒

會產生以下結果：

由於廣告素材 A 不可略過，且時間長度超過 (不可略過) 上限，因此會遭到篩除。
廣告素材 B 的時間長度超過 max_ad_duration，但因其為可略過，而且時間長度未超過可略過的上限，因此不會遭到篩除。

sid

_{(工作階段 ID)}

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

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

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

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

使用範例

123e4567-e89b-12d3-a456-426614174000

規定

建議用於程式輔助營利

ssss

_{(伺服器端拼接來源)}

伺服器端拼接來源參數接受常數值，應設為 Google 提供的經認可影片拼接技術供應商值。

如果影片拼接技術供應商使用 Google 的伺服器對伺服器整合服務，此值會由 Google 提供，以便供應商為您提供該值。如果對用來設定此參數的值有任何疑問，請與您的 Google 客戶經理聯絡。

使用範例

ssss=mystitcher

規定

必須用於伺服器端導入

sz

_(大小)

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

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

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

使用範例

sz=400x300

必要與否

必須用於網站和應用程式

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

tfcd

_{(兒童導向內容標記)}

「兒童導向內容」參數接受常數值，會替廣告請求設定「兒童導向內容」標記。

使用範例

tfcd=1

trt

_{(流量類型)}

流量類型參數可接受常數值，用於請求購買的流量或是自然流量。

如果請求中缺少流量類型參數，則 IMA SDK 不會填入預設值；在這種情況下，伺服器會提供 0 (未定義的流量) 做為預設值。

使用範例

請求購買流量的參數為：
trt=1

請求自然流量的參數為：
trt=2

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

必要與否

必須用於網站和應用程式

建議用於程式輔助營利

vad_type

_{(影片廣告類型)}

「影片廣告類型」參數接受常數值，以指出應傳回線性還是非線性廣告。

使用範例

傳回線性廣告：
vad_type=linear

傳回非線性廣告：
vad_type=nonlinear

vid_d

_{(影片長度)}

此參數接受以變數值來指定內容長度 (以秒為單位)。

vid_d 和 allcues 參數是用來在不攝入內容的情況下放送片中廣告。您也必須設定廣告規則，才能傳回片中廣告。

使用範例

90000 秒 (25 小時) 的影片內容長度：
vid_d=90000

vconp

_{(影片連續播放)}

依據 MRC 影片評估規範的建議

「連續播放影片」參數接受常數值，以指出播放器是否打算連續播放影片內容，類似電視節目。

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

使用範例

連續播放「開啟」：
vconp=2

連續播放「關閉」：
vconp=1

vpa

_{(影片自動播放)}

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

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

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

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

使用範例

自動播放：
vpa=auto

隨點即播：
vpa=click

必要與否

建議用於程式輔助營利

vpi

_{(影片播放清單 inred)}

「影片播放清單 inred」參數接受常數值，以指出是否要放送內嵌 VMAP (在 VMAP 中傳回 VAST)。

這個參數可用來縮短延遲時間，並確保影片串流中的展示頻率上限和競爭排除項目。

使用範例

傳回 VAST：
vpi=1

傳回重新導向廣告代碼：
vpi=0

vpmute

_{(影片播放靜音)}

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

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

使用範例

已靜音：
vpmute=1

已取消靜音：
vpmute=0

必要與否

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

vpos

_{(影片位置)}

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

使用範例

片頭廣告：
vpos=preroll

片中廣告：
vpos=midroll

片尾廣告：
vpos=postroll

規定

建議用於程式輔助營利

wta

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

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

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

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

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

使用範例

支援：
wta=1

不支援：
wta=0

規定

必須用於 Ad Exchange

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

建議用於程式輔助營利

這對您有幫助嗎？

我們應如何改進呢？