影片廣告

隨著影片廣告支援功能推出,買方可透過 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
指定傳送廣告請求時的裝置方向。 有效值為 LANDSCAPEPORTRAITUNKNOWN_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_0VAST_3_0VAST_2_0_WRAPPERVAST_3_0_WRAPPERVAST_4_0VAST_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


原生

真實的物體存在及


橫幅廣告內嵌

影片物件不存在及
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


原生

真實的物體存在及


插頁式廣告 (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 原型建議信號

下表說明適用於電腦版和行動版網站行動應用程式所有影片格式的 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

原生

顯示原生訊息並
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

原生

顯示原生訊息並
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

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

下表說明發布商允許/禁止在刊登位置中加入影片的方式,以及 OpenRTBAdX Proto 出價要求中的資訊清單。

OpenRTB

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

指定影片插播廣告

串流內廣告 (全部)

顯示影片物件和
video.placement = INSTREAM

選擇啟用 VPAID

串流內廣告網站

有影片物件 &
video.api = 1 (VPAID 1.0) 或 2 (VPAID 2.0)

啟用 IBV

橫幅廣告內嵌

插頁式

banner.battr ≠ 6 橫幅廣告內嵌影片 (自動播放) 和/或 7 橫幅廣告內嵌影片 (由使用者啟動)

選擇採用串流外廣告 (instructions)

動態內廣告

文章內

顯示影片物件及
video.placement = IN-FEEDIN-ARTICLE

選擇採用串流外廣告 (instructions)

原生

存在原生物件

封鎖影片插頁式廣告

插頁式應用程式

沒有 VIDEO 物件

AdX 通訊協定

酒吧選項 適用的格式 在出價要求中描述為 (注意:這些都是出價要求中發布商選項的「所有」指標;如需建議信號,請參閱下表) 預設值

指定影片插播廣告

串流內廣告 (全部)

顯示影片訊息和
placement = INSTREAM

n/a

選擇啟用 VPAID

串流內廣告網站

顯示影片訊息和
Allowed_video_formats = VPAID_JS &

excluded_attribute ≠ 30 InstreamVastVideoType: Vpaid

已選擇不開放

啟用 IBV

橫幅廣告內嵌

插頁式

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

已選擇不開放

選擇採用串流外廣告 (instructions)

動態內廣告

文章內

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

已選擇不開放

選擇採用串流外廣告 (instructions)

原生

顯示自然訊息及

原生訊息中的 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

1LINEAR (串流內廣告)

mApp

1LINEAR (串流內廣告)

串流外 mApp Interstitial

2INTERSTITIAL

Native

3IN_FEED
5IN_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
時間長度下限 發布商設定
最長持續時間 發布商設定
播放頭
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
,因為廣告代碼一律為
安全