影片廣告

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

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

買方相關規定

RTB 通訊協定

本指南通常會以 Protobuf 格式表示，但欄位名稱 除非另有說明，否則路徑與 JSON 格式之間的路徑相同。

您可以在 Protos and 參考資料」網頁。適用對象 如要進一步瞭解如何開發出價工具，請參閱 處理要求並 建立回應。

廣告素材審核

Google 建議您在出價前，先將廣告素材送審 具體做法是指示 Kubernetes 建立並維護 一或多個代表這些 Pod 的物件您可以使用即時出價 API 的 廣告素材資源 即可開始審查

預先指定設定

如要接收影片廣告空間，您的 Authorized Buyers 帳戶必須 建立 預先指定設定 包含影片廣告空間

巨集

您可以在 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	在消費者要求的串流影片內容前、中間或結束後播放的片頭、片中和片尾廣告。串流內影片廣告必須設為「開啟音效」預設為 或明確清除使用者有意觀看 影片內容雖然播放器周圍可能有其他內容，但影片內容必須是使用者造訪的重點。這項服務 仍應將主要內容放在頁面上，其中也只有影片 並在播放時在畫面中顯示音訊。如果玩家 轉換為浮動/固定式，後續廣告呼叫應正確轉換 會顯示更新過的播放器大小
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。

出價要求和回應範例

• 影片出價要求範例
• 影片出價回應範例

影片格式

• 買方如何加入影片
• OpenRTB 建議的所有影片格式信號
• Authorized Buyers 為所有影片格式提供原始建議的信號
• 發布商如何允許/禁止影片
• 邊緣保護殼

買家如何加入影片

下表說明買方如何在廣告素材中加入影片，並 這些刊登位置可分別放送到網站和行動應用程式。

網路

影片廣告素材	串流內廣告 (全部)	動態內/文章	原生動態內/文章	插頁式	橫幅內
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 刊登位置取決於實際 刊登位置，值如下 Video.startdelay = 0
動態內廣告	存在 VIDEO 物件  & video.placement = IN-FEED
文章內	存在 VIDEO 物件  & video.placement = IN-ARTICLE
原生	有 NATIVE 個物件，
橫幅內	影片物件不存在 & banner.battr ≠ 6 橫幅廣告內嵌影片 (自動播放) & banner.battr ≠ 7 橫幅廣告內嵌影片 (使用者啟動)

行動應用程式

影片格式	出價要求詳細資料 (僅限影片相關詳細資料)
串流內	有 VIDEO 物件，且 video.placement = INSTREAM    &	video.api = 1VPAID 1.0 或 2：VPAID 2.0
非串流內	有 VIDEO 物件 video.linearity: linear 刊登位置取決於實際 刊登位置，值如下 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 一律會顯示在任何自訂關閉按鈕上方

詞彙解釋

請參閱 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
裝置
	Px 比率	是	1	Google
曝光 (次數)
	安全	是	1	Google 預設為 true ，因為 adtag 一律為 安全