Google RTB 通訊協定中的影片廣告

隨著影片廣告支援服務推出 買方可以透過 Authorized Buyers 購買影片廣告空間 本文件將概述透過即時出價進行採購的整合規定 使用 Authorized Buyers 通訊協定 如要進一步瞭解可用的通訊協定，請參閱 選取通訊協定 一節的說明操作。

買方可購買各種刊登位置的影片廣告空間 目前串流內廣告和插頁式廣告中 詳情請參閱 插頁式廣告

買方相關規定

新的即時出價買方應使用最新的通訊協定緩衝區開發出價工具 以及下列各節所述資訊 如要下載通訊協定，請參閱即時出價參考資料頁面。 如要瞭解如何開發出價工具 請參閱「處理要求」 和建立回應。

支援的巨集

串流內影片廣告素材支援下列巨集：

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

不需使用 Click 巨集 (例如 CLICK_URL_ESC) 因為 Authorized Buyers 會將其點擊追蹤程式納入 VAST 包裝函式中。 因此，串流內影片廣告不支援 Click 巨集。 如要進一步瞭解支援的巨集 請參閱指定巨集 在 Build the Response 底下。

摘要詳細資料

即時出價工具通訊協定會使用影片訊息 (如 Realtime-bidding-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
允許的供應商。詳情請參閱 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

回應影片要求時 出價工具應傳回 VAST 重新導向網址 video_url。 出價回應中也應包含 關於影片廣告的適當聲明 以下擷取適當的影片出價回應： 

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
可透過此程式碼片段顯示的廣告的所有屬性。詳情請參閱 Buyers-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 物件，且
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

原生

有 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 部橫幅廣告影片 (使用者啟動)

AdX proto 建議信號

下表說明 Authorized Buyers 為所有影片格式提供原始建議信號： 電腦版和行動版網站，以及行動應用程式。

電腦版和行動版網站

影片格式 推薦的影片相關信號 相關影片相關信號

串流內 (VPAID)

顯示影片訊息   &
placement = INSTREAM    &
Allowed_video_formats = VPAID_JS

Allowed_video_formats = VIDEO_HTML5
Allowed_ad_types = VIDEO

串流內廣告 (不含 VPAID)

顯示影片訊息   &
placement = INSTREAM    &
Allowed_video_formats ≠ VPAID_JS

Allowed_video_formats = VIDEO_HTML5   &
excluded_attribute = 30 InstreamVastVideoType: Vpaid
Allowed_ad_types = VIDEO

動態內廣告

顯示影片訊息   &
placement = IN-FEED

Allowed_video_formats = VIDEO_HTML5   &
excluded_attribute = 30 InstreamVastVideoType: Vpaid
Allowed_ad_types = VIDEO

文章內

顯示影片訊息   &
placement = IN-ARTICLE

Allowed_video_formats = VIDEO_HTML5   &
excluded_attribute = 30 InstreamVastVideoType: Vpaid
Allowed_ad_types = VIDEO

原生

已顯示 NATIVE 訊息   &
原生訊息中的 VIDEO = 000x000

Allowed_ad_types = NATIVE

橫幅內

excluded_attribute ≠ 95 VideoType：橫幅廣告內嵌影片 (發布商可封鎖)

Allowed_ad_types = BANNER

行動應用程式

下表說明 AdX 原型針對所有影片格式的建議信號， 電腦版和行動版網站，以及行動應用程式。

影片格式 影片相關出價要求詳細資料 影片相關信號

串流內

顯示了影片訊息
placement = INSTREAM

Allowed_video_formats = VIDEO_HTML5
excluded_attribute = 30 InstreamVastVideoType: Vpaid
Allowed_ad_types = VIDEO

動態內廣告

顯示影片訊息   &
placement = IN-FEED

Allowed_video_formats = VIDEO_HTML5   &
excluded_attribute = 30 InstreamVastVideoType: Vpaid
Allowed_ad_types = VIDEO

文章內

顯示影片訊息   &placement = IN-ARTICLE

Allowed_video_formats = VIDEO_HTML5   &
excluded_attribute = 30 InstreamVastVideoType: Vpaid
Allowed_ad_types = VIDEO

原生

已顯示 NATIVE 訊息   &
原生訊息中的 VIDEO = 000x000

Allowed_ad_types = NATIVE

插頁式

顯示影片訊息   &
placement = INTERSTITIAL   &

Allowed_video_formats = VIDEO_HTML5   &
excluded_attribute = 30 InstreamVastVideoType: Vpaid
Allowed_ad_types = VIDEO

橫幅廣告內嵌 (MRAID)

excluded_attribute ≠ 95 VideoType: In-Banner Video (Publisher Blockable)  &
excluded_attribute ≠ 32 MraidType: MRAID

Allowed_video_formats = VIDEO_HTML5   &
excluded_attribute = 30 InstreamVastVideoType: Vpaid
Allowed_ad_types = BANNER

橫幅內

(無 MRAID)

excluded_attribute ≠ 95 VideoType: In-Banner Video (Publisher Blockable)  &
excluded_attribute = 32 MraidType: MRAID

Allowed_video_formats = VIDEO_HTML5   &
excluded_attribute = 30 InstreamVastVideoType: Vpaid
Allowed_ad_types = BANNER

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

下表說明發布商在 以及廣告請求在出價要求中的運作方式 OpenRTB 和 AdX Proto。

OpenRTB

酒吧選項 適用的格式 出價要求中描述：

指定串流內影片單元

串流內廣告 (全部)

有影片物件 &
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 物件

AdX 通訊協定

酒吧選項 適用的格式 出價要求中描述如下 (注意：以下是 出價要求 - 如需建議的信號，請參閱下表) 預設值

指定串流內影片單元

串流內廣告 (全部)

會顯示影片訊息和
placement = INSTREAM

不適用

選擇啟用 VPAID

串流內廣告

會顯示影片訊息和
Allowed_video_formats = VPAID_JS &

excluded_attribute ≠ 30 InstreamVastVideoType: Vpaid

已選擇不採用

選擇加入 IBV

橫幅內

插頁式

excluded_attribute ≠ 95 VideoType: In-Banner Video (Publisher Blockable)

已選擇不採用

選擇啟用串流外廣告 (操作說明)

動態內廣告

文章內

會顯示影片訊息和
Allowed_video_formats = VIDEO_HTML5 &
placement = IN-FEED or IN-ARTICLE

已選擇不採用

選擇啟用串流外廣告 (操作說明)

原生

已呈現 NATIVE 訊息和

原生訊息中的 VIDEO = 000x000

已選擇不採用

封鎖影片插頁式廣告

插頁式應用程式

未顯示影片訊息和
excluded_attribute = 30 InstreamVastVideoType: Vpaid

已選擇採用

極端案例

# 案件說明 留言 出價要求

1

使用 MRAID 延遲自訂關閉

如果是插頁式廣告，只要使用 MRAID 關閉廣告，系統就會傳送通知給買方 即使他們沒有自訂關閉方式也無妨


AdX 套用的 X 一律會顯示在任何自訂關閉上方，即使自訂關閉 會在 5 秒後出現

詞彙解釋

詳情請參閱 Authorized Buyers 影片詞彙表。

串流內和串流外格式中的 AdX 和 OpenRTB 欄位

AdX 通訊協定

BidRequest.Video.
Placement
串流內 mWeb

0: UNKNOWN_PLACEMENT
1: INSTREAM

mApp

0: UNKNOWN_PLACEMENT
1: INSTREAM
串流外 mApp Interstitial

2: INTERSTITIAL

Native

3: IN_FEED
5: IN_ARTICLE

Rewarded

is_rewarded
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 通訊協定

詳情請參閱 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
物品 		欄位 AdX
/廣告交易平台
出價
串流外廣告		 範例值 由誰決定？
/這個值衍生工具：
最低價格？
物件
影片 米梅 是 ["application/javascript",
"video/mp4"]",		 Google
時間長度下限 否 由發布商設定
maxduration 是 由發布商設定
播放串流「
」 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
因為廣告代碼一律為
安全