视频广告

视频广告支持推出后,买方可以通过 Authorized Buyers 购买视频广告资源。 本文档简要介绍了使用 Authorized Buyers 协议通过实时出价进行购买时需满足的集成要求。 如需了解可用协议,请参阅入门指南的选择协议部分。

买方可以购买跨展示位置(目前为插播广告和插页式广告)的视频广告资源。 如需了解详情,请参阅 插页式广告

买方要求

新的实时出价买方应使用最新的协议缓冲区和以下各部分中所述的信息开发出价工具。如需下载协议,请参阅实时出价参考数据页面。 如需了解如何开发出价工具,请参阅处理请求构建响应

Supported macros

插播视频广告素材支持以下宏:

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

Click 宏(例如 CLICK_URL_ESC)不是必需的,因为 Authorized Buyers 将其点击跟踪广告代码包含在 VAST 封装容器中。 因此,插播视频广告不支持 Click 宏。 如需详细了解支持的宏,请参阅构建响应下的指定宏

宣传信息详情

实时出价协议使用 real-time-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
此字段是仅在使用 SSL 时设置的 16 字节 UUID。这是 encrypted_advertising_id 的未加密版本。 对于 iOS 设备,它包含广告客户标识符 (IDFA)。对于 Android 设备,它包含 Android 标识符 (ADID)。对于联网电视设备,该文件包含唯一标识符(例如 Roku 的 RIDA)。
device_type
指定设备的类型。
UNKNOWN_DEVICE 是此字段的默认值。
HIGHEND_PHONE 包括具备视频功能的手机。
TABLET 包括平板电脑设备
PERSONAL_COMPUTER 包括桌面设备和笔记本电脑设备。
CONNECTED_TV 包括联网电视(即智能电视)和联网设备(例如 Roku、Apple TV 等)。
GAME_CONSOLE 包括专用游戏设备。
brand
指定设备的品牌(如诺基亚或三星)。 此字段是选填字段;默认情况下不指定。
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 视频广告格式

买方如何添加视频广告

下表说明了买方可通过哪些方法在广告素材和展示位置(分别用于网站和移动应用)中添加视频。

Web

视频广告素材 插播广告(全部) 信息流广告/文章 原生信息流广告/文章内嵌广告 插页式广告 横幅内嵌广告

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 横幅内嵌视频(用户启动)


AdX 协议推荐的信号

下表说明了适用于桌面版网站和移动网站以及移动应用的所有视频广告格式的 Authorized Buyers proto 推荐信号。

桌面版网站和移动网站

视频格式 推荐的视频相关信号 相关视频相关信号

插播 (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 proto 推荐信号。

视频格式 与视频相关的出价请求的详细信息 视频相关信号

插播

存在视频消息
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

发布商如何允许/禁止视频

下表说明了发布商可在其展示位置中允许/禁止视频的各种方法,以及视频如何在 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

原生

存在原生对象

屏蔽视频插页式广告

插页式应用

视频对象不存在

AdX 协议

发布选项 适用的格式 在出价请求中描述为(注意:这些是出价请求中发布商选项的所有指示符 - 有关建议的信号,请参阅下表) 默认设置

为插播视频广告指定单位

插播广告(全部)

显示视频消息 &
placement = INSTREAM

不适用

选择启用 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 扩展程序 bool

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
最短持续时间 发布商配置
最大时长 发布商配置
playmet
hod
[6] 通常是由发布商
配置
API (MRAID) [1、2] Google
protocols [2,3,5,6,7,8] Google
线性度 [1] Google
展示位置 [1] Google
播放器宽度 400,400,300 Google
播放器高度 225,300,153 Google
启动延迟 0 Google,默认为 5 秒
跳过 1 Publisher/Google
- 对于插页式广告 => Google
- 对于插播广告 => 发布商
决定是允许
允许可跳过式、不可跳过式或同时采用两者。
激励广告,一律不可跳过;
最低比特率 Google
最大比特率 Google
pos 1 Google
设备
Px 比率 1 Google
展示
安全 1 Google
默认为 true
,因为广告代码始终是
安全的