隨著影片廣告支援功能推出,買方可透過 Authorized Buyers 購買影片廣告空間。 本文概述使用 Authorized Buyers 通訊協定透過即時出價功能購買的整合規定。如要進一步瞭解可用的通訊協定,請參閱入門指南中的「選取通訊協定」一節。
買方可以購買各個刊登位置 (目前串流內和插頁式廣告) 的影片廣告空間。 詳情請參閱「 插頁式廣告」一文。
買方相關規定
新的即時出價買方應使用最新的通訊協定緩衝區及下列各節所述資訊,開發出價工具。如要下載通訊協定,請參閱即時出價參考資料頁面。如要瞭解如何開發出價工具,請參閱「處理要求」和「建立回應」。
支援的巨集
串流內影片廣告素材支援下列巨集:
%%CACHEBUSTER%%
%%WINNING_PRICE%%
%%SITE%%
由於 Authorized Buyers 已在 VAST 包裝函式中加入點擊追蹤程式,因此不一定要使用 Click 巨集 (例如 CLICK_URL_ESC
)。
因此,串流內影片廣告不支援 Click 巨集。
如要進一步瞭解支援的巨集,請參閱「建立回應」下方的「指定巨集」。
摘要詳細資料
即時出價通訊協定會使用在 Real-time-出價-proto.txt 檔案中定義的影片訊息識別影片要求,並提供廣告請求的其他影片專屬資訊。
下列巢狀影片訊息中的欄位清單也提供詳細說明和範例:
description_url
-
說明影片內容所在網頁的網址 (已移除參數)。出版商已將這個網址提交給 Google。例如:
http://www.publisher.com/watchpagelink
EndCapSupport
-
啟用後,您就可以在影片廣告版位播放完畢後,挑選隨播廣告做為影片版位的結尾展示畫面 (資訊卡)。
END_CAP_NOT_ENABLED
隨播廣告不會顯示為結尾展示畫面。 END_CAP_OPTIONAL
如果回應包含符合資格的隨播橫幅廣告,但不需要隨播橫幅廣告,就會顯示結尾展示畫面。 END_CAP_FORBIDDEN
篩除包含隨播廣告的回應。 END_CAP_REQUIRED
系統會篩除不含隨播廣告的回應。 is_embedded_offsite
-
如果設為
true
,表示影片嵌入了發布商網域以外的網頁中。 is_rewarded
-
如果設為
true
,表示使用者觀看影片廣告可獲得獎勵。一般獎勵包括免費閱讀一篇額外文章、在遊戲中獲得額外生命,或體驗沒有廣告贊助的音樂工作階段。 max_ad_duration
-
傳回廣告允許的時間長度上限,以毫秒為單位。如果設為
0
,則沒有時間長度上限。 max_ads_in_pod
- Authorized Buyers 影片廣告連播中的廣告數量上限。 如果值不是零,表示目前的廣告版位是可顯示多則影片廣告的影片廣告連播。實際顯示的影片廣告數量可能小於或等於這個值,但不得超過這個值。
min_ad_duration
- 這是指廣告的時間長度下限,以毫秒為單位。 如未設定這個值,或是值小於或等於零,則沒有時間長度下限。
Placement
-
說明影片的播放位置。
UNKNOWN_PLACEMENT
刊登位置不明或無法確定。 INSTREAM
「串流內廣告」是指在其他影片內容開播前、結束後或播放期間放送廣告,這與傳統電視廣告類似。 廣告播放時,使用者觀看的影片內容無法播放。 INTERSTITIAL
「插頁式廣告」是指影片廣告在非影片內容 (例如新聞報導或電玩遊戲) 前方播放。 廣告會佔滿整個或絕大多數由內容佔用的螢幕空間,且使用者在廣告播放完畢或略過前,無法繼續觀看內容。 IN_FEED
動態內影片格式是一種影片廣告素材,會在使用者捲動瀏覽內容動態消息 (通常是社交應用程式動態消息、新聞報導等) 時顯示。影片會在主要動態消息和使用者的視覺和閱讀流程中顯示。影片不會像橫幅廣告內嵌影片一樣顯示在側邊。 skippable_max_ad_duration
- 如果可略過這則廣告,您應傳回廣告的時間長度上限 (以毫秒為單位)。這個值通常與不可略過廣告的播放時間長度上限不同。如未設定這個欄位,或是值小於或等於零,則允許使用任何時間長度。
VideoPlaybackMethod
-
說明影片廣告的播放方式。
系統會根據可用的最佳測量方式,決定自動播放或隨點即播播放方式。
AUTO_PLAY_SOUND_ON
廣告會自動開啟有聲播放。 AUTO_PLAY_SOUND_OFF
表示廣告會自動以靜音模式播放。 CLICK_TO_PLAY
表示廣告必須先獲得點擊才會播放。 video_ad_skippable
- 這是
SkippableBidRequestType
的值,包含下列其中一個值:ALLOW_SKIPPABLE
表示同時允許可略過和不可略過的廣告。 REQUIRE_SKIPPABLE
表示只會傳回可略過的廣告 BLOCK_SKIPPABLE
這代表系統只會傳回不可略過的廣告。 如果沒有設定這個欄位,預設會允許可略過的廣告。
videoad_start_delay
-
從影片開始到廣告顯示時間點的時間 (以毫秒為單位)。0 代表片頭廣告,-1 代表片尾廣告。 如果設為其他正值,代表版位位於影片播放期間。
您必須先設定這個參數,值才會生效。 如未設定,顯示位置不明。
這些信號不是影片廣告素材的專屬信號,但特別適合出價方讀取:
advertising_id
- 這個欄位是 16 位元組的 UUID,只有在使用安全資料傳輸層 (SSL) 時才會設定。
這是未加密的
encrypted_advertising_id
版本。如果是 iOS 裝置,則包含廣告客戶識別碼 (IDFA)。 如果是 Android 裝置,其中含有 Android ID (ADID)。如果是連網電視裝置,當中包含專屬 ID (例如 Roku 的 RIDA)。 device_type
- 指定裝置類型。
UNKNOWN_DEVICE
是這個欄位的預設值。 HIGHEND_PHONE
包括具備影片功能的手機。 TABLET
包括平板電腦裝置 PERSONAL_COMPUTER
包括桌上型電腦和筆記型電腦。 CONNECTED_TV
包括連網電視 (也就是智慧型電視) 和連網裝置 (例如 Roku、Apple TV 等)。 GAME_CONSOLE
包括專用遊戲裝置。 brand
- 指定裝置品牌 (例如 Nokia 或 Samsung)。這是選填欄位,預設為未指定。
model
- 指定裝置的確切型號 (例如 N70 或 Galaxy)。這是選填欄位,預設為未指定。
screen_orientation
-
指定傳送廣告請求時的裝置方向。
有效值為
LANDSCAPE
、PORTRAIT
和UNKNOWN_ORIENTATION
。 viewability
-
根據使用者過去可視這個版位的顯示頻率,提供使用者可見這個版位的預估機率。以在 [0, 100] 範圍內的百分比表示。預設值
-1
表示無法取得過去的可視度資料。 content_attributes.duration_seconds
- 影片播放的秒數 (例如 200)。這會在
ContentAttributes
訊息中宣告。已設為影片發布商提供的影片中繼資料中指定的值。
影片出價要求也會包含廣告空間相關資訊,例如產業、允許的供應商和頻道資訊。出價要求中的所有其他現有欄位也適用於影片。
影片請求 AdSlot 訊息中的寬度和高度欄位,會對應到影片播放器的大小。
allowed_vendor_type
- 允許的供應商。如需 ID 清單,請參閱技術說明文件中的 vendors.txt 檔案。例如 309 = DFA 影片單元。
allowed_video_formats
- 說明配合這項要求所放送的廣告可採用的影片技術。回應應指出至少有一項技術受到支援。此重複欄位的值來自列舉 VideoFormat:
VIDEO_FLASH
允許使用 Flash 影片 (FLV) 格式的影片。 VIDEO_HTML5
允許使用 HTML5 影片格式的影片。 VPAID_FLASH
允許使用影片播放器廣告放送介面定義 (VPAID) Flash 影片格式的影片。 VPAID_JS
允許使用 VPAID JavaScript 影片格式的影片。 companion_slot
-
這個欄位代表 CompanionSlot 訊息,當中包含下列欄位:
height
此版位的可用高度。 width
此版位可用的寬度。 CreativeFormat
廣告素材格式代表這個隨播廣告版位中的廣告素材可能格式。 url
-
影片觀賞頁面的網址,或是影片的內嵌網頁網址。例如:
http://www.publisher.com/watchpagelink
回應影片請求時,出價方應在 video_url
欄位中傳回 VAST 重新導向網址。此外,出價回應也應包含影片廣告的適當宣告。以下摘錄適當的影片出價回應:
protocol_version: 1 ad { adslot { id: 1 max_cpm_micros: 50000000 } click_through_url: "http://google.com/" video_url: "http://ad.doubleclick.net/pfadx/N270.132652.1516607168321/ B3442378.3;dcadv=1379578;sz=0x0;ord=79879;dcmt=text/xml" }
影片出價回應中的重要欄位如下:
attribute
-
可透過這個程式碼片段顯示的廣告的所有屬性。如需 ID 清單,請參閱
Buyer-declarable-creative-attributes.txt 檔案。
我們會檢查並確認這些屬性都未列在出價要求的
excluded_attribute
清單中。 只有在傳回 HTML 程式碼片段或影片廣告時,才需要設定這個欄位。 舉例來說,將這個欄位設為30
,表示廣告需要 VPAID 支援才能顯示。 protocol
-
說明發布商為影片廣告請求支援的 VAST 版本,允許 VAST 廣告支援 (甚至包含指定版本)。包含支援的影片廣告通訊協定的陣列。
這個值與 OpenRTB 2.4 的行為相符。
可能的值如下:
VAST_2_0
、VAST_3_0
、VAST_2_0_WRAPPER
、VAST_3_0_WRAPPER
、VAST_4_0
和VAST_4_0_WRAPPER
。 video_url
-
影片廣告的 VAST 重新導向網址。例如:
http://ad.doubleclick.net/pfadx/N270.132652.1516607168321/B3442378.3;dcadv=1379578;sz=0x0;ord=79879;dcmt=text/xml
預先指定
為了接收影片廣告空間,即時出價買方必須為包含影片廣告空間的即時出價的預先指定設定。
出價要求和回應範例
AdX 影片格式
買方如何加入影片
下表說明買方可在廣告素材和刊登位置中加入影片,以便分別在網頁和行動應用程式中放送。
網站
影片廣告素材 | 串流內廣告 (全部) | 動態內/文章 | 原生動態內廣告/文章 | 插頁式 | 橫幅廣告內嵌 |
---|---|---|---|---|---|
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) |
影片物件未顯示及 |
AdX 原型建議信號
下表說明適用於電腦版和行動版網站和行動應用程式所有影片格式的 Authorized Buyers 原型建議信號。
電腦和行動版網站
影片格式 | 推薦影片相關信號 | 相關影片相關信號 |
---|---|---|
串流內 (VPAID) |
顯示影片訊息 & |
|
串流內 (無 VPAID) |
顯示影片訊息 & |
Allowed_video_formats = VIDEO_HTML5 & |
動態內廣告 |
顯示影片訊息 & |
Allowed_video_formats = VIDEO_HTML5 & |
文章內 |
顯示影片訊息 & |
|
原生 |
顯示原生訊息並 |
|
橫幅廣告內嵌 |
|
|
行動應用程式
下表說明 AdX 原型建議信號,說明適用於電腦版和行動版網站和行動應用程式的所有影片格式。
影片格式 | 影片相關出價要求詳細資料 | 影片相關信號 |
---|---|---|
串流內 |
顯示影片訊息 |
|
動態內廣告 |
顯示影片訊息 & |
|
文章內 |
顯示影片訊息 和 |
|
原生 |
顯示原生訊息並 |
|
插頁式 |
顯示影片訊息 & |
|
橫幅廣告內嵌 (MRAID) |
|
|
橫幅廣告內嵌 (無 MRAID) |
|
|
發布商如何允許/禁止影片
下表說明發布商允許/禁止在刊登位置中加入影片的方式,以及 OpenRTB 和 AdX Proto 出價要求中的資訊清單。
OpenRTB
酒吧選項 | 適用的格式 | 在出價要求中描述為 |
---|---|---|
指定影片插播廣告 |
串流內廣告 (全部) |
顯示影片物件和 |
選擇啟用 VPAID |
串流內廣告網站 |
有影片物件 & |
啟用 IBV |
橫幅廣告內嵌 插頁式 |
|
選擇採用串流外廣告 (instructions) |
動態內廣告 文章內 |
顯示影片物件及 |
選擇採用串流外廣告 (instructions) |
原生 |
存在原生物件 |
封鎖影片插頁式廣告 |
插頁式應用程式 |
沒有 VIDEO 物件 |
AdX 通訊協定
酒吧選項 | 適用的格式 | 在出價要求中描述為 (注意:這些都是出價要求中發布商選項的「所有」指標;如需建議信號,請參閱下表) | 預設值 |
---|---|---|---|
指定影片插播廣告 |
串流內廣告 (全部) |
顯示影片訊息和 |
n/a |
選擇啟用 VPAID |
串流內廣告網站 |
顯示影片訊息和
|
已選擇不開放 |
啟用 IBV |
橫幅廣告內嵌 插頁式 |
|
已選擇不開放 |
選擇採用串流外廣告 (instructions) |
動態內廣告 文章內 |
顯示影片訊息和 |
已選擇不開放 |
選擇採用串流外廣告 (instructions) |
原生 |
顯示自然訊息及 原生訊息中的 |
已選擇不開放 |
封鎖影片插頁式廣告 |
插頁式應用程式 |
沒有影片訊息; |
已選擇開放 |
極端案例
# | 客服案件說明 | 留言 | 出價要求 |
---|---|---|---|
1 |
使用 MRAID 延遲自訂關閉 |
如果是插頁式廣告,即使沒有使用自訂關閉,關閉廣告仍可以使用 MRAID 傳送通知給買方。 AdX 套用的 X 一律會顯示在任何自訂關閉上方,即使自訂關閉是在 5 秒後顯示 |
詞彙
請參閱 Authorized Buyers 影片詞彙一文。
串流內和串流外格式的 AdX 和 OpenRTB 欄位
AdX 通訊協定
BidRequest.Video。 | |||||
---|---|---|---|---|---|
Placement
|
|
||||
videoad_start_delay
|
|
OpenRTB 通訊協定
BidRequest.Video。 | |||||
---|---|---|---|---|---|
Placement
|
|
||||
linearity
|
表示曝光是否為線性或非線性等。 如果未指定,請假設所有曝光均可。
|
||||
videoad_start_delay
|
|
出價要求值來源
OpenRTB 物件 | 欄位 | AdX /廣告交易平台 出價 串流外 |
範例值 | 由誰決定? /這個值衍生自 ? |
---|---|---|---|---|
物件 | ||||
影片 | 米姆 | 是 | ["application/javascript"、 "video/mp4"]", |
|
時間長度下限 | 否 | 發布商設定 | ||
最長持續時間 | 是 | 發布商設定 | ||
播放頭 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 | ||
裝置 | ||||
Px 比例 | 是 | 1 | ||
曝光 (次數) | ||||
安全 | 是 | 1 | Google 預設為 true ,因為廣告代碼一律為 安全 |