本頁面由 Cloud Translation API 翻譯而成。

影片廣告

本指南將概略說明整合要求、設定，以及在影片廣告空間出價時可使用的相關 OpenRTB 通訊協定欄位。Google RTB 通訊協定已淘汰，因此不會是本指南的重點。如要瞭解 Google RTB 通訊協定中的影片廣告，請參閱 Google RTB 中的影片廣告指南。

Google 支援串流內、原生和插頁式影片廣告。如需進一步瞭解這些格式，請參閱原生和插頁式廣告格式的指南。

買方規定

RTB 通訊協定

本指南通常會參照 Protobuf 格式，但除非另有說明，否則欄位名稱和路徑在 Protobuf 格式和 JSON 格式之間是等價的。

您可以在「Proto 和參考資料」頁面中，找到 OpenRTB proto 和 Google 專屬的 OpenRTB 擴充功能。如要進一步瞭解如何開發出價方，請參閱「處理要求」和「建立回應」相關說明。

廣告素材審核

Google 建議您先提交廣告素材，再使用該素材進行出價。您可以使用即時出價 API 的廣告素材資源，開始審查程序。

預先指定設定

如要接收影片廣告空間，授權買方帳戶必須建立包含影片廣告空間的預先指定設定。

巨集

您可以在 BidResponse.seatbid.bid.adm 中指定的影片網址連結或 VAST XML 中指定巨集。此外，如果您指定影片網址，也可以在已連結的 VAST XML 文件中放置巨集。影片廣告素材支援下列巨集：

%%CACHEBUSTER%%
%%WINNING_PRICE%%
%%SITE%%

系統不支援 CLICK_URL_ESC 等點擊巨集，因為 Authorized Buyers 會在 VAST 包裝函式中加入點擊追蹤程式。如要進一步瞭解支援的巨集，請參閱「指定巨集」。

摘要詳細資料

您可以使用 OpenRTB 的 BidRequest.imp.video 欄位，判斷傳入的出價要求是針對串流內或插頁式影片廣告空間，並找出要求的其他影片專屬資訊。此外，如果是原生廣告空間，您可以使用 BidRequest.imp.native.{request/request_native}.assets.video 取得類似的影片專屬資訊。

BidRequest.{app/site}.content.producer.domain

描述影片內容的網頁網址 (已移除參數)。發布商會將這個網址提交給 Google。例如：

http://www.publisher.com/watchpagelink

banner.vcm

如果設為 true，系統會在影片廣告播放完畢後，將隨播廣告選取為影片版位中的結尾卡片 (資訊卡) 進行算繪。否則，系統不會將隨播廣告顯示為結尾展示畫面。

BidRequest.imp.rwdd

如果設為 true，表示使用者觀看影片廣告後可獲得獎勵。常見的獎勵包括免費閱讀額外文章、在遊戲中獲得額外生命，或是獲得贊助的無廣告音樂時段。

BidRequest.imp.video.maxduration

您應傳回的廣告時間長度上限 (以秒為單位)。如果未設定，則沒有持續時間上限。當 BidRequest.imp.video.skip 為 true 時，這可能會呈現不同的行為。詳情請參閱「可略過的影片時間長度上限」。

BidRequest.imp.video.maxseq

影片廣告連播中的廣告數量上限。如果未設定，廣告版位就不會是影片播放清單的一部分。

實際顯示的影片廣告數量可能會小於或等於這個值，但不得超過這個值。

BidRequest.imp.video.minduration

傳回廣告的最短時間長度 (以秒為單位)。未設定時，則沒有時間長度下限。

BidRequest.imp.video.plcmt

說明影片的播放位置。

`PLCMT_UNKNOWN`	刊登位置不明或無法判斷。
`PLCMT_INSTREAM`	在消費者要求的串流影片內容播放前、期間或之後播放的片頭、片中和片尾廣告。預設情況下，串流內影片必須在播放器開始播放時設為「開啟音訊」，或是明確顯示使用者有意觀看影片內容。雖然播放器周圍可能有其他內容，但影片內容必須是使用者造訪的重點。它應為網頁上的主要內容，且在播放時，它是唯一可播放音訊的 in-view 影片播放器。如果播放器轉換為浮動/固定，後續的廣告呼叫應準確傳達更新後的播放器大小。
`PLCMT_ACCOMPANYING_CONTENT`	在串流影片內容播放前、期間或結束後播放的片頭、片中和片尾廣告。影片播放器會在文字或圖形內容的段落前、中間或後方載入及播放，且只會在進入檢視區時開始播放。隨播內容應僅在進入可視區域時才開始播放。捲動離開頁面時，可能會轉換為浮動/固定播放器。
`PLCMT_INTERSTITIAL`	在沒有影片內容的情況下播放的影片廣告。在播放期間，該廣告必須是網頁的主要焦點，並佔據大部分可視區域，且不能捲動至畫面外。這類廣告可刊登在應用程式內影片或幻燈片等刊登位置。
`PLCMT_NO_CONTENT_STANDALONE`	在沒有串流影片內容的情況下播放的影片廣告。這類廣告可出現在幻燈片、原生動態消息、內容內或固定/浮動廣告位。

BidRequest.imp.video.playbackmethod

說明影片廣告的播放方式。系統會根據可用的最佳評估方式，判斷播放方法是自動播放或點選即播。

`AUTO_PLAY_SOUND_ON`	在開啟音效的情況下，在網頁載入時啟動。
`AUTO_PLAY_SOUND_OFF`	在網頁載入時啟動，並關閉音效。
`CLICK_TO_PLAY`	在點按時啟動，並開啟音效。
`MOUSE_OVER`	在滑鼠游標移過時啟動，並開啟音效。
`ENTER_SOUND_ON`	在進入可視區域時啟動，且音效開啟。
`ENTER_SOUND_OFF`	根據預設，進入可視區域時會關閉音效。

BidRequest.imp.video.skip

如果為 true，表示播放器會允許略過影片，或允許可略過的廣告。否則，表示系統不允許使用可略過的廣告。

BidRequest.imp.video.startdelay

值為 0 表示片頭廣告、-1 表示片中廣告，而 -2 則表示片尾廣告。

任何其他正值都是從影片開始到廣告顯示點的時間長度 (以秒為單位)。

這些信號並非影片廣告素材專屬，但對出價方來說特別有用：

BidRequest.device.ifa

這個欄位是 36 個字元的 UUID，僅在使用 SSL 時設定，且不會經過雜湊處理。這是 BidRequest.device.dpidm5 的未加密版本。對於 iOS 裝置，此值包含以全大寫字母表示的廣告主 ID (IDFA)。對於 Android 裝置，此字串會以全小寫字元包含 Android 識別碼 (ADID)。對於連網電視裝置，則包含其專屬 ID (例如 Roku 的 RIDA)。

BidRequest.device.devicetype

指定裝置類型。

`MOBILE`	已淘汰的別名，用於 HIGHEND_PHONE 或 TABLET。
`PERSONAL_COMPUTER`	包括電腦和筆電裝置。
`CONNECTED_TV`	包括連網電視 (即智慧型電視) 和連網裝置 (例如 Roku、Apple TV 等)。
`HIGHEND_PHONE`	包括高階手機裝置。
`TABLET`	包括平板電腦。
`CONNECTED_DEVICE`	包括專用遊戲機。
`SET_TOP_BOX`	包括機上盒裝置。
`OOH_DEVICE`	包括戶外廣告裝置，例如數位看板。

BidRequest.device.make

指定裝置的品牌 (例如 Nokia 或 Samsung)。

BidRequest.device.model

如果可用，則指定裝置的確切型號 (例如 N70 或 Galaxy)；否則包含通用型號，例如「iPhone」或「iPad」。

BidRequest.imp.metric

如果 Metric.type 設為 completion_rate，Metric.value 就會是介於 [0.0, 1.0] 範圍內的小數，代表廣告版位中放送的影片廣告歷來完成率。預設值 -1.0 表示無法取得歷來完成率資料。

BidRequest.imp.video.poddur

整個廣告插播的時間長度 (以秒為單位)，包括廣告連播包含的所有時段。這會設為影片發布者提供的影片中繼資料中指定的值。

影片出價要求也包含廣告空間的相關資訊，例如產業別、允許的供應商和頻道資訊。出價要求中的所有其他現有欄位也適用於影片。

影片要求的 AdSlot 訊息中，寬度和高度欄位對應至影片廣告播放器的大小。

BidRequest.imp.ext.allowed_vendor_type: 允許的供應商。如需 ID 清單，請參閱技術文件中的 vendors.txt 檔案。例如 309 = DFA 影片單元。
BidRequest.imp.video.mimes: 允許清單，說明配合出價請求放送的廣告支援哪些內容 MIME 類型，例如「video/mp4」。出價回應應指出至少有一項技術受到支援。

BidRequest.imp.video.protocols: 說明發布商支援的影片廣告請求 VAST 版本。包含 Protocol 列舉值的陣列，包括：VAST_2_0、VAST_3_0、VAST_2_0_WRAPPER、VAST_3_0_WRAPPER、VAST_4_0、VAST_4_0_WRAPPER 等。

BidRequest.imp.video.companionad: 這個欄位包含 Banner 物件的陣列，代表隨播廣告 (如有)。
BidRequest.site.page: 影片觀賞頁面的網址，或影片已嵌入的網頁網址。例如：
http://www.publisher.com/watchpagelink

回應影片要求時，出價方應在 BidResponse.seatbid.bid.adm 欄位中傳回 VAST 重新導向網址或 VAST XML。出價回應也應包含影片廣告的適當宣告。以下是正確的影片出價回應摘錄：

id: "cRPF1960K8WH788KM8ZT5k"
seatbid {
  bid {
    id: "99862J52T2r9f8n6hzY"
    impid: "1"
    price: 0.2873480215418293
    adid: "test_creative_id_958969"
    adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
    adomain: "google.com"
    cid: "80831705186"
    crid: "test_creative_id_958969"
    w: 480
    h: 854
  }
  seat: "5731:4728:218110"
}
bidid: "dR2wx766-444e907U-Xpv0-634m58Wa5V73"
cur: "USD"

影片出價回應中的重要欄位如下：

BidResponse.seatbid.bid.ext.attribute

在此程式碼片段中可能會顯示適用於該廣告的屬性。如要查看 ID 清單，請參閱 buyer-declarable-creative-attributes.txt 檔案。我們會檢查這些屬性，確保沒有任何屬性與出價要求中發布商禁止的屬性相符。舉例來說，如果任何一個欄位包含 30，就表示廣告需要 VPAID 支援才能顯示。

BidResponse.seatbid.bid.adm

對於影片廣告，這是影片廣告的 VAST 重新導向網址。範例如下：

http://ad.doubleclick.net/pfadx/N270.132652.1516607168321/B3442378.3;dcadv=1379578;sz=0x0;ord=79879;dcmt=text/xml

或者，這可能是原始的 VAST XML。

出價要求和回應範例

買家如何加入影片

下表說明買家可在廣告素材中加入影片的方式，以及可分別在網站和行動應用程式中放送的刊登位置。

網頁

影片廣告素材	串流內 (全部)	動態/文章內	動態消息/文章內原生廣告	插頁式	橫幅內
VPAID + VAST
VAST
MRAID + JS
自訂 JS
原生 + VAST

行動應用程式

影片廣告素材	串流內 (全部)	動態/文章內	動態消息/文章內原生廣告	插頁式	橫幅內
VPAID + VAST
VAST
MRAID + JS
自訂 JS
原生 + VAST

索引鍵：	不支援的格式/技術		這個刊登位置接受的影片廣告素材 (視發布商封鎖情況而定)		影片廣告素材不適用於這個刊登位置

OpenRTB 建議信號

下表列出 OpenRTB 建議的所有影片格式信號，適用於電腦版和行動版網站，以及行動應用程式。

電腦版和行動版網站

影片格式	建議信號 (僅限影片相關信號)	相關信號 (僅限影片相關信號)
串流內 (VPAID)	存在 VIDEO 物件 & `video.placement = INSTREAM &`
串流內 (無 VPAID)	存在 VIDEO 物件 & `video.placement = INSTREAM & video.api = 1 VPAID 1.0 or 2:VPAID 2.0`
非串流內	存在 VIDEO 物件 `video.linearity: linear` placement 取決於實際 placement，值如下 `Video.startdelay = 0`
動態內廣告	存在 VIDEO 物件 & `video.placement = IN-FEED`
文章內	存在 VIDEO 物件 & `video.placement = IN-ARTICLE`
原生	存在原生物件 &
橫幅內	影片物件不存在 & `banner.battr ≠ 6` 橫幅廣告內嵌影片 (自動播放) & `banner.battr ≠ 7` 橫幅廣告內嵌影片 (使用者啟動)

行動應用程式

影片格式	出價要求詳細資料 (僅限與影片相關的詳細資料)
串流內	存在 VIDEO 物件 & `video.placement = INSTREAM &`	`video.api = 1` VPAID 1.0 或 `2`：VPAID 2.0
非串流內	存在 VIDEO 物件 `video.linearity: linear` placement 取決於實際 placement，值如下 `Video.startdelay = 0`
動態內廣告	存在 VIDEO 物件 & `video.placement = IN-FEED`
文章內	存在 VIDEO 物件 & `video.placement = IN-ARTICLE`
原生	原生物件存在且
插頁式廣告 (VAST)	存在 VIDEO 物件 & `video.placement = INTERSTITIAL`
插頁式 (不含 VAST)	存在 VIDEO 物件 & `video.placement = INTERSTITIAL`	已篩選
橫幅內 (MRAID)	影片物件不存在 & `banner.battr ≠ 6` 橫幅廣告內嵌影片 (自動播放) & `banner.battr ≠ 7` 橫幅廣告內嵌影片 (使用者啟動)
橫幅內 (沒有 MRAID)	影片物件不存在 & `banner.battr ≠ 6` 橫幅廣告內嵌影片 (自動播放) & `banner.battr ≠ 7` 橫幅廣告內嵌影片 (使用者啟動)

發布商如何允許/禁止使用影片

下表說明發布商可在其刊登位置中允許/禁止影片的方式。

發布選項	適用的格式	在出價要求中描述為
指定串流內影片單位	串流內 (全部)	影片物件存在 & `video.placement = INSTREAM`
選擇採用 VPAID	串流內網頁	影片物件存在 & `video.api = 1` (VPAID 1.0) 或 `2` (VPAID 2.0)
選擇採用 IBV	橫幅內插頁式	`banner.battr ≠ 6` 橫幅內嵌影片 (自動播放) 和/或 `7` 橫幅內嵌影片 (使用者啟動)
選擇加入 (操作說明)	動態內廣告文章內	影片物件存在 & `video.placement = IN-FEED` 或 `IN-ARTICLE`
選擇啟用非串流內廣告 (操作說明)	原生	原生物件存在
封鎖影片插頁式廣告	插頁式應用程式	沒有 VIDEO 物件

極端案例

#	案件說明	留言	出價要求
1	使用 MRAID 延遲自訂關閉	對於插頁式廣告，關閉廣告時會使用 MRAID 傳送通知給買家，即使買家未使用自訂關閉按鈕也一樣。即使自訂關閉按鈕會在 5 秒後顯示，但 Authorized Buyers 套用的 X 一律會顯示在任何自訂關閉按鈕上方

案件說明

留言

出價要求

使用 MRAID 延遲自訂關閉

對於插頁式廣告，關閉廣告時會使用 MRAID 傳送通知給買家，即使買家未使用自訂關閉按鈕也一樣。

即使自訂關閉按鈕會在 5 秒後顯示，但 Authorized Buyers 套用的 X 一律會顯示在任何自訂關閉按鈕上方

詞彙解釋

請參閱 Authorized Buyers 影片術語彙典。

串流內和非串流內格式的相關欄位

請參閱 OpenRTB 2.5 (第 47 頁起)

BidRequest.Video。

Placement

串流內

mWeb

1：串流內廣告
2：橫幅內廣告

mApp

1：串流內廣告
2：橫幅內廣告

非串流內

mApp Interstitial

5：插頁式廣告

Native

3：文章內
4：動態內

Rewarded

is_rewarded_inventory：OpenRTB 擴充功能布林值

linearity

指出曝光是否必須是線性、非線性等。如果未指定，則系統會假設所有曝光都允許。

串流內

mWeb

1：LINEAR (串流內廣告)

mApp

1：LINEAR (串流內廣告)

非串流內

mApp Interstitial

2：INTERSTITIAL

Native

3：IN_FEED
5：IN_ARTICLE

videoad_start_delay

串流內

mWeb

>0: start delay in seconds 0: PRE_ROLL -1: GENERIC_MID_ROLL -2: GENERIC_POST_ROLL

mApp

>0: start delay in seconds 0: PRE_ROLL -1: GENERIC_MID_ROLL -2: GENERIC_POST_ROLL

非串流內

Rewarded

>0: start delay in seconds 0: PRE_ROLL -1: GENERIC_MID_ROLL -2: GENERIC_POST_ROLL

出價要求值來源

OpenRTB 物件	欄位	Authorized Buyers /廣告交易平台出價非串流內	範例值	誰來判定？ /這個值的來源為何？
物件
影片	mimes	是	["application/javascript", "video/mp4"]",	Google
	minduration	否		已設定發布商
	maxduration	是		已設定發布商
	playbackmet hod	是	[6]	通常為發布商已設定
	API (MRAID)	是	[1,2]	Google
	通訊協定	是	[2,3,5,6,7,8]	Google
	線性	是	[1]	Google
	刊登位置	是	[1]	Google
	播放器寬度	是	400,400,300	Google
	玩家身高	是	225,300,153	Google
	開始延遲	是	0	Google，預設為 5 秒
	略過	是	1	發布商/Google - 插播式廣告 => Google - 串流廣告 => 發布商決定是否允許可略過、不可略過或兩者皆可。獎勵廣告，一律不可略過；
	最低位元率	否		Google
	最高位元率	否		Google
	pos	是	1	Google
裝置
	像素比例	是	1	Google
曝光 (次數)
	安全	是	1	Google 預設為 true ，因為 adtag 一律為安全