Google 实时出价协议中的视频广告

我们推出了视频广告支持功能 买方可通过 Authorized Buyers 购买视频广告资源。 本文档简要介绍了通过实时出价工具进行购买的集成要求 使用 Authorized Buyers 协议。 有关可用协议的信息，请参阅 选择协议 部分。

买方可以跨多个展示位置购买视频广告资源， 插播广告和插页式广告 请参阅 插页式广告。

买方要求

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

支持的宏

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

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

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

宣传信息详情

实时出价协议使用 <ph type="x-smartling-placeholder"></ph> 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
您应返回的广告时长下限（以毫秒为单位）。 如果未设置，或者值小于或等于 0， 没有最短时长要求
Placement
说明视频的播放位置。
UNKNOWN_PLACEMENT 展示位置未知或无法确定。
INSTREAM 插播意味着广告在其他视频播放前、播放过程中或播放后播放 视频内容。这与传统电视广告类似。 用户当前观看的视频内容 。
INTERSTITIAL 插页式广告是指 非视频内容（例如新闻报道或视频游戏）。 广告覆盖了屏幕上的全部或几乎所有空间 被内容占据，并且用户无法继续操作 直到广告播完或用户跳过广告为止。
IN_FEED 信息流视频广告格式是一种视频广告素材，会在用户 滚动浏览内容信息流，通常是社交应用信息流、 新闻报道等。视频会显示在主要 Feed 和用户的 视觉和阅读流视频无法像在 YouTube 中那样横向呈现 横幅内嵌视频广告
skippable_max_ad_duration
广告时长上限（以毫秒为单位） 应返回的值。 这通常不同于最大时长 允许投放不可跳过的广告 如果此字段未设置，或者值小于或等于 0， 允许任何持续时间。
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 标识符 (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
指定发送广告请求时设备的屏幕方向。 有效值为 LANDSCAPE、PORTRAIT、 和 UNKNOWN_ORIENTATION。
viewability
提供相应广告位 将根据 过去可见。以百分比的形式表示， 范围为 [0, 100]。默认值 -1 表示无法提供历史可见度数据。
content_attributes.duration_seconds
视频播放的秒数（例如 200 秒）。 这在 ContentAttributes 消息中声明。 此值设为视频元数据中指定的值 发布商提供的广告资源

视频广告出价请求还包含 例如行业、允许的供应商和渠道信息。全部 出价请求中的其他现有字段也适用于视频广告。

AdSlot 消息中的宽度和高度字段 与视频广告播放器的尺寸相对应。

allowed_vendor_type
允许的供应商。请参阅 vendors.txt 文件，以获取 ID 列表。 例如，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
可通过此代码段展示的广告的所有属性。请参阅 <ph type="x-smartling-placeholder"></ph> buyer-declarable-creative-attributes.txt 文件获取 ID 列表。 我们会进行检查以确保上述所有属性均未包含在 出价请求的 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

预定位

要接收视频广告资源，RTB 买方必须拥有 预定位配置 适用于包含视频广告资源的实时出价工具

出价请求和响应示例

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 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

原生

显示原生消息   &
原生消息中的 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

原生

显示原生消息   &
原生消息中的 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
/交换
出价
外播广告		 示例值 由谁决定？
/此值派生
的位置 来自？
对象
视频 哑剧 是 [&quot;application/javascript&quot;,
"视频/mp4"]",		 Google
最短持续时间 否 由发布商配置
最大时长 是 由发布商配置
播放时间：
Hod		 是 [6] 通常是发布商：
已配置
API (MRAID) 是 [1、2] Google
protocols 是 [2、3、5、6、7、8] Google
线性 是 [1] Google
展示位置 是 [1] Google
播放器宽度 是 400400300 Google
播放器高度 是 225,300,153 Google
启动延迟 是 0 Google，默认 5 秒
跳过 是 1 发布商/Google
- 表示插页式广告 =>Google
- 对于插播广告 =>发布商
决定是否允许
可跳过式广告、不可跳过式广告，或两者兼有。
激励广告，一律不得跳过；
最小比特率 否 Google
最大比特率 否 Google
pos 是 1 Google
设备
像素比 是 1 Google
展示
安全 是 1 Google
默认为 true
因为 adtag 始终为
安全