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

影片廣告

本指南將說明整合規定、設定，以及對影片廣告空間出價時可使用的相關欄位。

Google 支援串流內、原生和插頁式影片廣告，這些廣告會以個別廣告商機或動態影片廣告插播的形式呈現。動態廣告連播是指連續播放的一組影片廣告，廣告連播的時間長度上限會分成一或多部影片，每部影片的長度不一。如要進一步瞭解原生和插頁式廣告格式，請參閱原生和插頁式廣告格式指南。

買家規定

即時出價通訊協定

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

您可以在「原始檔和參考資料」頁面中，找到 OpenRTB 原始檔和 Google 專屬的 OpenRTB 擴充功能。如要進一步瞭解如何開發競價工具，請參閱「處理要求」和「建構回應」。

廣告素材審查

Google 建議您先提交廣告素材以供核准，再使用這些廣告素材出價。您可以使用 Real-time Bidding 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

動態影片廣告連播中可能放送的廣告數量上限。如果已設定 poddur，但未設定 maxseq 或 0，則影片廣告連播可放送的廣告數量不受限制。Google 僅支援動態 Pod。

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

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.imp.video.durfloors和BidRequest.imp.audio.durfloors

DurFloors 物件陣列，指出買方可出價的各種時長影片或音訊廣告素材的底價。

以下是 Google 指定 durfloors 的範例：

{"maxdur": 16, "bidfloor": 5}，代表 $5 的 (0, 16) 秒。
{"mindur": 16, "maxdur": 31, "bidfloor": 10} 代表 [16, 31) 秒，以 $10 為單位。
{"mindur": 31, "bidfloor": 20}，代表 $20 的 [31, inf) 秒。

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

BidRequest.device.ifa

這個欄位是 36 個字元的 UUID，只會在您使用 SSL 時設定，且不會經過雜湊處理。這是 BidRequest.device.dpidm5 的未加密版本。如果是 iOS 裝置，則包含全大寫的廣告主 ID (IDFA)。如果是 Android 裝置，則包含全小寫的 Android ID (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

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

id: "n40G42d551UX18627ao8lt"
seatbid {
  bid {
    id: "17u6BnD62h88r5q7066"
    impid: "1"
    price: 0.797848
    adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
    adomain: "google.com"
    crid: "test_creative_id_987914"
    w: 320
    h: 480
    cattax: GOOGLE_CATEGORIES
    [com.google.doubleclick.bid] {
      attribute: 47
      attribute: 50
      billing_id: 55383762512
      skadn {
        version: "4.0"
        network: "306el65O"
        itunesitem: "832461214"
        sourceapp: "977150768"
        fidelities {
          fidelity: VIEW_THROUGH_ADS
          nonce: "0054e0b9-0b53-4426-99dd-a1eefeb45565"
          timestamp: "1757329316673"
          signature: "oE3Ek8347oZV1Yl1J42G2c88BSKr2dqEbiOK2S4ni7NVDh3v128NN0hlzWK5aX96ecV1504E9k288i0t0wGX73P317812WE7"
        }
        fidelities {
          fidelity: STOREKIT_RENDERED_ADS
          nonce: "0054e0b9-0b53-4426-99dd-a1eefeb45565"
          timestamp: "1757329316673"
          signature: "b1GqXA4v889p842512GQ1p3249q5VmPt1335f1H1zdK92fq24j7a7ml419W7u8B7rhhH97s507f2251923oWi89XF1voZv4b"
        }
        sourceidentifier: "8396"
      }
      app_promotion_type: INSTALLS
      clickurl: "google.com"
    }
  }
}
[com.google.doubleclick.bid_response] {
  processing_time_ms: 20
}

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

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` 刊登位置取決於實際刊登位置，值如下所示 `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 = 1` VPAID 1.0 或 `2`：VPAID 2.0
非串流內廣告	存在 VIDEO 物件 `video.linearity: linear` 刊登位置取決於實際刊登位置，值如下所示 `Video.startdelay = 0`
動態內廣告	存在 VIDEO 物件 & `video.placement = IN-FEED`
文章內	存在 VIDEO 物件 & `video.placement = IN-ARTICLE`
原生	NATIVE 物件存在且
插頁式廣告 (VAST)	存在 VIDEO 物件 & `video.placement = INTERSTITIAL`
插頁式廣告 (無 VAST)	存在 VIDEO 物件 & `video.placement = INTERSTITIAL`	已篩選
橫幅內 (MRAID)	沒有影片物件 & `banner.battr ≠ 6` 橫幅廣告內嵌影片 (自動播放) & `banner.battr ≠ 7` 橫幅廣告內嵌影片 (使用者啟動)
橫幅內 (無 MRAID)	沒有影片物件 & `banner.battr ≠ 6` 橫幅廣告內嵌影片 (自動播放) & `banner.battr ≠ 7` 橫幅廣告內嵌影片 (使用者啟動)

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

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

Pub 選項	適用格式	出價要求中描述為
指定串流內影片廣告單元	串流內 (全部)	影片物件存在 & `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

rwdd：bool

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 /Exchange 出價非串流	範例值	誰會決定？ /這個值的推導來源為何？
物件
影片	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 因為廣告代碼一律為安全

影片廣告 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

買家規定

即時出價通訊協定

廣告素材審查

預先指定設定

巨集

摘要詳細資料

出價要求和回應範例

影片格式

買家如何加入影片

網頁

OpenRTB 建議信號

電腦版和行動版網站

行動應用程式

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

極端案例

詞彙

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

出價要求值來源

影片廣告