本指南概述整合規定、設定,以及對影片廣告空間出價時可能使用的相關欄位。
Google 支援串流內、原生和插頁式影片廣告,這些廣告會以個別廣告商機或動態影片廣告連播的形式呈現。動態廣告連播是指一組依序顯示的影片廣告,其中廣告連播的時間長度上限會分成一或多部不同長度的影片。如要進一步瞭解原生和插頁式廣告格式,請參閱相關指南。
買家規定
RTB 通訊協定
本指南通常會參照 Protobuf 格式,但除非另有說明,否則欄位名稱和路徑在 Protobuf 和 JSON 格式之間是等效的。
您可以在「Proto 和參考資料」頁面中,找到 OpenRTB proto 和 Google 專屬 OpenRTB 擴充功能。如要進一步瞭解如何開發出價工具,請參閱「處理要求」和「建立回應」。
廣告素材審核
Google 建議您先將廣告素材送審,再用於出價。您可以使用 Real-time Bidding API 的廣告素材資源,啟動審查程序。
預先指定設定
如要接收影片廣告空間,Authorized Buyers 帳戶應建立包含影片廣告空間的預先指定設定。
巨集
您可以在影片網址連結或 BidResponse.seatbid.bid.adm 中指定的 VAST XML 內指定巨集。此外,如果您指定影片網址,也可以在連結的 VAST XML 文件中放置巨集。影片廣告素材支援下列巨集:
%%CACHEBUSTER%%%%WINNING_PRICE%%%%SITE%%
Authorized Buyers 會將點擊追蹤程式納入 VAST 包裝函式,因此不支援 CLICK_URL_ESC 等 Click 巨集。如要進一步瞭解支援的巨集,請參閱「指定巨集」。
摘要詳情
您可以使用 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 僅支援動態廣告連播。實際顯示的影片廣告數量可能小於或等於這個值,但不得超過。
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},代表$10的[16, 31)秒。{"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- 指定裝置類型。
MOBILEHIGHEND_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: "eW3q768m3k93fv93a80tGQ" seatbid { bid { id: "0uMc95E6ClImM3p5FSe" impid: "1" price: 0.034745 adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%" adomain: "google.com" crid: "test_creative_id_168019" cat: "7" w: 320 h: 480 cattax: GOOGLE_CATEGORIES [com.google.doubleclick.bid] { attribute: 47 attribute: 50 billing_id: 61170857882 app_promotion_type: INSTALLS clickurl: "google.com" } } } [com.google.doubleclick.bid_response] { processing_time_ms: 30 }
影片出價回應中的重要欄位如下:
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。
出價要求和回應範例
可略過修正功能
Google 會自動對影片廣告空間的即時出價套用可略過修正功能,避免出價因出價要求中要求的可略過性,與您在出價回應中傳回的廣告素材可略過性不同,而從競價中篩除。在下列情況下,系統不會套用可略過修正功能:
-
您在出價回應中指定的廣告素材是使用 VPAID 導入。您可以使用 Real-time Bidding API 中的
Creative.video.videoMetadata.isVpaid欄位,判斷哪些影片廣告素材是使用 VPAID 導入。 -
發布商將會算繪廣告素材。您可以根據
BidRequest.imp.displaymanager欄位判斷,如果發布商要顯示廣告素材,該欄位會是'PUBLISHER'。
以下範例說明如何套用可略過修正功能:
- 情境 1:
-
您收到出價要求,其中
BidRequest.imp.video.skip欄位設為0(JSON 格式) 或false(Protobuf 格式)。 - 您使用可略過的廣告素材出價。
- 結果:您的出價會參與競價。如果出價勝出且影片廣告素材顯示,則會顯示為不可略過。
- 情境 2:
-
您收到出價要求,其中
BidRequest.imp.video.skip欄位設為1(JSON 格式) 或true(Protobuf 格式)。 -
您使用不可略過的廣告素材出價,且時間長度超過
BidRequest.imp.video.skipmin欄位中指定的時間長度。 - 結果:您的出價會參與競價。如果出價勝出且影片廣告素材顯示,則會顯示為可略過。
影片格式
買家如何加入影片
下表說明買方在廣告素材中加入影片的方式,以及可分別在網站和行動應用程式中放送的刊登位置。
網頁
| 影片廣告素材 | 串流內 (全部) | 動態內/文章內廣告 | 原生動態內/文章內廣告 | 插頁式廣告 | 橫幅廣告內嵌 |
|---|---|---|---|---|---|
VPAID + VAST |
|
||||
VAST |
|
||||
MRAID + JS |
|
|
|
|
|
自訂 JS |
|
||||
原生 + VAST |
|
行動應用程式
| 影片廣告素材 | 串流內 (全部) | 動態內/文章內廣告 | 原生動態內/文章內廣告 | 插頁式廣告 | 橫幅廣告內嵌 |
|---|---|---|---|---|---|
VPAID + VAST |
|
|
|
|
|
VAST |
|||||
MRAID + JS |
|||||
自訂 JS |
|||||
原生 + VAST |
| 索引鍵: | 無法使用格式/技術 | 這個刊登位置接受影片廣告素材,但可能受發布商封鎖 |
這個刊登位置不支援影片廣告素材 |
|---|
OpenRTB 建議信號
下表列出電腦和行動版網站,以及行動應用程式中,所有影片格式的 OpenRTB 建議信號。
電腦版和行動版網站
| 影片格式 | 建議信號 (僅限影片相關信號) | 相關信號 (僅限影片相關信號) |
|---|---|---|
串流內 (VPAID) |
有 VIDEO 物件 & |
|
串流內 (無 VPAID) |
有 VIDEO 物件 & |
|
非串流內廣告 |
有 VIDEO 物件
|
|
動態內廣告 |
有 VIDEO 物件 & |
|
文章內廣告 |
有 VIDEO 物件 & |
|
原生 |
存在原生廣告物件,且 |
|
橫幅廣告內嵌 |
沒有影片物件 & |
行動應用程式
| 影片格式 | 出價要求詳細資料 (僅限影片相關詳細資料) | |
|---|---|---|
串流內 |
有 VIDEO 物件 & |
|
非串流內廣告 |
有 VIDEO 物件
|
|
動態內廣告 |
有 VIDEO 物件 & |
|
文章內廣告 |
有 VIDEO 物件 & |
|
原生 |
存在原生廣告物件,且 |
|
插頁式廣告 (VAST) |
有 VIDEO 物件 & |
|
插頁式廣告 (無 VAST) |
有 VIDEO 物件 & |
已篩選 |
橫幅廣告內嵌 (MRAID) |
沒有影片物件 & |
|
橫幅廣告內嵌 (無 MRAID) |
沒有影片物件 & |
發布商如何允許/禁止影片
下表說明發布商如何允許/不允許在刊登位置中放送影片。
| Pub 選項 | 適用格式 | 在出價要求中描述為 |
|---|---|---|
指定串流內影片廣告單元 |
串流內 (全部) |
有影片物件 & |
選擇採用 VPAID |
串流內網頁 |
影片物件存在 & |
啟用 IBV |
橫幅廣告內嵌 插頁式廣告 |
|
選擇加入 (操作說明) |
動態內廣告 文章內廣告 |
影片物件存在 & |
選擇加入非串流內廣告 (操作說明) |
原生 |
存在原生廣告物件 |
封鎖影片插頁式廣告 |
插頁式應用程式 |
沒有 VIDEO 物件 |
極端案例
| # | 案件說明 | 註解 | 出價要求 |
|---|---|---|---|
1 |
使用 MRAID 延遲自訂關閉 |
如果是插頁式廣告,關閉廣告時,系統會使用 MRAID 向買家傳送通知,即使買家未使用自訂關閉功能也一樣。 Authorized Buyers 套用的 X 一律會顯示在任何自訂關閉按鈕上方,即使自訂關閉按鈕在 5 秒後顯示在下方也一樣 |
詞彙
串流內和非串流內格式的相關欄位
| BidRequest.Video。 | |||||
|---|---|---|---|---|---|
Placement
|
|
||||
linearity
|
指出曝光是否必須為線性、非線性等。如未指定,則假設所有類型皆可。
|
||||
videoad_start_delay
|
|
||||
出價要求值來源
| OpenRTB 物件 |
欄位 | Authorized Buyers /廣告交易平台 出價 非串流內 |
範例值 | 由誰決定? /這個值的來源 為何? |
|---|---|---|---|---|
| 物件 | ||||
| 影片 | 默劇 | 是 | ["application/javascript", "video/mp4"]", |
|
| minduration | 否 | 由發布商設定 | ||
| maxduration | 是 | 由發布商設定 | ||
| playbackmet hod |
是 | [6] | 通常由發布商 設定 |
|
| api (MRAID) | 是 | [1,2] | ||
| 通訊協定 | 是 | [2,3,5,6,7,8] | ||
| 線性 | 是 | [1] | ||
| 刊登位置 | 是 | [1] | ||
| 播放器寬度 | 是 | 400,400,300 | ||
| 播放器高度 | 是 | 225,300,153 | ||
| 開始延遲 | 是 | 0 | Google,預設 5 秒 | |
| 略過 | 是 | 1 | 發布商/Google - 插頁式廣告 => Google - 串流內廣告 => 發布商 決定是否允許 可略過、不可略過或兩者皆可。 獎勵廣告,一律不可略過; |
|
| 最低位元率 | 否 | |||
| 最高位元率 | 否 | |||
| pos | 是 | 1 | ||
| 裝置 | ||||
| 像素比例 | 是 | 1 | ||
| 曝光 (次數) | ||||
| 安全 | 是 | 1 | Google 預設為 true 因為廣告代碼一律 安全 |