视频广告

本指南概述了在对视频广告资源出价时，您可以使用的集成要求、配置和相关 OpenRTB 协议字段。Google RTB 协议已被弃用，因此本指南不会重点介绍该协议。有关 Google RTB 协议中的视频广告的信息， 请参阅 Google 实时出价中的视频广告指南。

Google 支持插播式视频广告、原生视频广告和插页式视频广告。查看指南 （针对原生广告和 插页式广告格式 详细了解这些格式

买方要求

RTB 协议

本指南通常涉及 Protobuf 格式，但字段名称和 除非另有说明，否则该路径等同于 JSON 格式。

您可以在 Protos 和参考数据页面。如需详细了解如何开发出价方，请参阅处理请求和构建响应。

广告素材审核

Google 建议您先提交广告素材以供审批，然后再使用这些广告素材进行出价。您可以使用实时出价 API 的 广告素材资源 以开始审核流程。

预定位配置

若要接收视频广告资源，您的 Authorized Buyers 账号应 创建 预定位配置 包含视频广告资源的广告资源

宏

您可以在视频网址链接或 BidResponse.seatbid.bid.adm 中指定的 VAST XML 中指定宏。此外，如果您指定了视频网址，还可以在关联的 VAST XML 文档中放置宏。通过 视频广告素材支持以下宏：

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

不支持 CLICK_URL_ESC 等点击宏，因为 Authorized Buyers 会在 VAST 封装容器中添加其点击跟踪广告代码。有关 有关受支持宏的信息，请参阅 指定宏。

宣传信息详情

您可以使用 OpenRTB 的 BidRequest.imp.video 字段来标识 传入的出价请求是针对插播视频广告还是插页式视频广告 ，并查找与该请求有关的其他视频专用信息。 此外，对于原生广告资源，您可以使用 BidRequest.imp.native.{request/request_native}.assets.video： 类似的视频专用信息。

BidRequest.{app/site}.content.producer.domain

移除了参数的网址 网页上的内容描述视频。 发布商将此网址提交给 Google。例如：

http://www.publisher.com/watchpagelink
banner.vcm
如果设置为 true，则可以选择呈现随播广告 视频广告播放完毕后，在视频广告位中显示为结尾画面（信息卡） 。否则，随播广告不会呈现为结尾画面。
BidRequest.imp.rwdd
如果设为 true，则表示用户收到 奖励。典型的奖励可能是阅读 免费获得额外文章、在游戏中获得额外生命，或者获得 无广告打扰的赞助音乐会话。
BidRequest.imp.video.maxduration

您应返回的广告的允许时长上限（以秒为单位）。 如果未设置此政策，则没有时长上限。时间 BidRequest.imp.video.skip 为 true，这可以 运作方式有所不同请参阅可跳过式视频广告时长上限 了解详情。

BidRequest.imp.video.maxseq

视频广告连播中的广告数量上限。如果未设置此政策，相应广告位便不会 是视频广告连播中的一部分。

实际展示的视频广告数量可以小于或等于此值，但不能超过此值。

BidRequest.imp.video.minduration
您应返回的广告的最短时长（以秒为单位）。时间 因此没有最短时长
BidRequest.imp.video.plcmt
说明视频将在何处播放。
PLCMT_UNKNOWN 展示位置未知或无法确定。
PLCMT_INSTREAM 在消费者请求的在线视频内容播放前、播放过程中或播放后展示的前贴片广告、中贴片广告和后贴片广告。插播视频必须在播放器启动时默认设为“开启音频”，或者用户明确表示要观看视频内容。尽管该区域周围可能还有其他内容 则视频内容必须是用户访问的重点。它 应始终是网页上的主要内容，且只能是 播放器。如果播放器转换为浮动/固定，后续的广告调用应准确传达更新后的播放器尺寸。
PLCMT_ACCOMPANYING_CONTENT 在视频内容在线播放前、播放过程中或播放后展示的前贴片广告、中贴片广告和后贴片广告。视频播放器加载 以及在文字或图形内容的段落之前、之间或之后播放 内容，并且仅在其进入视口时开始播放。 只有在进入 视口。当用户滚动到页面外时，它可能会转换为浮动/粘性播放器。
PLCMT_INTERSTITIAL 播放时没有视频内容的视频广告。在播放过程中 它必须是网页的重点内容，并且占据了大部分 并且无法滚动到视图之外。这可以是应用内视频或幻灯片等展示位置。
PLCMT_NO_CONTENT_STANDALONE 在没有流式视频内容的情况下播放的视频广告。这可以 展示位置，例如幻灯片、原生 Feed、内容 粘性广告/浮动广告
BidRequest.imp.video.playbackmethod
说明如何播放视频广告。 播放方法确定为自动播放或点击播放 最佳衡量方式。
AUTO_PLAY_SOUND_ON 网页加载时启动，声音会开启。
AUTO_PLAY_SOUND_OFF 网页加载时启动，静音播放。
CLICK_TO_PLAY 点击时启动声音并开启声音。
MOUSE_OVER 在鼠标悬停时启动，提示音处于开启状态。
ENTER_SOUND_ON 在进入视口且开启音频时启动。
ENTER_SOUND_OFF 默认情况下，进入视口时启动并静音。
BidRequest.imp.video.skip
如果为 true，则表示播放器允许播放视频 允许可跳过的广告。否则， 不允许使用可跳过式广告
BidRequest.imp.video.startdelay

值为 0 表示前贴片广告，-1 表示中贴片广告，-2 表示后贴片广告。

任何其他正值均指自 达到展示广告的位置。

这些信号并非视频广告素材所独有 但对出价方来说特别有价值：

BidRequest.device.ifa
此字段是一个 36 个字符的 UUID，仅在使用 SSL 时设置，且不会经过哈希处理。它是 BidRequest.device.dpidm5 的未加密版本。对于 iOS 设备，它包含 广告客户标识符 (IDFA)，全部为大写字符。对于 Android 设备 则其中包含以全部小写的 Android 标识符 (ADID) 字符。对于联网电视设备，该字段包含其唯一标识符（例如 Roku 的 RIDA）。
BidRequest.device.devicetype
指定设备类型。
MOBILE HIGHEND_PHONE 或 TABLET 的过时别名。
PERSONAL_COMPUTER 包括台式机和笔记本电脑设备。
CONNECTED_TV 既包括联网电视（即智能电视） 设备（例如 Roku、Apple TV 等）。
HIGHEND_PHONE 包括高端手机设备。
TABLET 包括平板电脑设备。
CONNECTED_DEVICE 包括专用游戏设备。
SET_TOP_BOX 包括机顶盒设备。
OOH_DEVICE 包括户外广告设备，例如数字广告牌。
BidRequest.device.make
指定设备的品牌（如诺基亚或三星）。
BidRequest.device.model
指定设备的确切型号（例如 N70 或 Galaxy），如果不提供，则包含通用型号，例如“iphone”或“ipad”。
BidRequest.imp.metric
将 Metric.type 设为 completion_rate 时，Metric.value 将是一个介于 [0.0, 1.0] 范围内的小数，表示在相应广告位中投放的视频广告的历史完成率。默认值 -1.0 表示无法提供历史完成率数据。
BidRequest.imp.video.poddur
整个广告插播时段的时长（以秒为单位），包括广告连播包含的所有广告位。此值会设置为视频发布商提供的视频元数据中指定的值。

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

视频请求的 AdSlot 消息中的 width 和 height 字段对应于视频广告播放器的尺寸。

BidRequest.imp.ext.allowed_vendor_type
允许的供应商。请参阅 vendors.txt 文件，以获取 ID 列表。 例如，309 = DFA 视频广告单元。
BidRequest.imp.video.mimes
一个许可名单，用于说明应对出价请求投放的广告支持的内容 MIME 类型；例如“video/mp4”。出价响应应注明至少支持其中之一。
BidRequest.imp.video.protocols
说明发布商针对视频广告请求支持的 VAST 版本。 包含 Protocol 枚举值数组，包括： VAST_2_0、VAST_3_0、 VAST_2_0_WRAPPER、VAST_3_0_WRAPPER、 VAST_4_0、VAST_4_0_WRAPPER等。
BidRequest.imp.video.companionad
此字段包含一个 Banner 对象数组，表示随播广告（如果有）。
BidRequest.site.page

视频观看页面的网址或网页的网址 所嵌入到的视频中。例如：

http://www.publisher.com/watchpagelink

在响应视频广告请求时，出价方应返回 VAST 重定向 网址或 VAST XML 文件。BidResponse.seatbid.bid.adm通过 出价响应中还应包含视频广告的适当声明。以下是正确的视频出价响应的摘要： 

id: "cRPF1960K8WH788KM8ZT5k"
seatbid {
  bid {
    id: "99862J52T2r9f8n6hzY"
    impid: "1"
    price: 0.2873480215418293
    adid: "test_creative_id_958969"
    adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
    adomain: "google.com"
    cid: "80831705186"
    crid: "test_creative_id_958969"
    w: 480
    h: 854
  }
  seat: "5731:4728:218110"
}
bidid: "dR2wx766-444e907U-Xpv0-634m58Wa5V73"
cur: "USD"

视频出价响应中的重要字段如下：

BidResponse.seatbid.bid.ext.attribute
可通过相应代码段展示的广告的属性。如需查看 ID 列表，请参阅 buyer-declarable-creative-attributes.txt 文件。我们会检查以确保 与发布商在出价请求中不允许的出价匹配。 例如，如果设置任一字段包含 30，则 表示广告需要支持 VPAID 才能呈现。
BidResponse.seatbid.bid.adm

对于视频广告，此网址是视频广告的 VAST 重定向网址。例如：

http://ad.doubleclick.net/pfadx/N270.132652.1516607168321/B3442378.3;dcadv=1379578;sz=0x0;ord=79879;dcmt=text/xml

或者，这可能是原始 VAST XML。

出价请求和响应示例

视频格式

买方如何添加视频

下表说明了买方可通过哪些方式在其广告素材中添加视频以及 它们可以分别投放到网站和移动应用的展示位置。

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 横幅内嵌视频（用户发起）

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

下表说明了发布商可通过哪些方式允许/禁止在其 展示位置。

酒馆选项 适用的格式 在出价请求中描述为

将插播视频作为广告单元

插播广告（所有）

有视频对象且
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 对象不存在

边缘用例

# 案例说明 评论 出价请求

1

使用 MRAID 延迟自定义关闭

对于插页式广告，关闭广告即可使用 MRAID 向买方发送通知， 即使没有使用自定义关闭功能也没关系


Authorized Buyers 应用的 X 始终会显示在任何自定义关闭按钮上方，即使自定义关闭按钮在 5 秒后显示在下方也是如此

术语库

请参阅 Authorized Buyers 视频广告词汇表。

插播广告和非插播广告格式的相关字段

请参阅 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
对象		 字段 Authorized Buyers
/广告交易平台
出价
非插播广告		 示例值 由谁决定？
/Where this value derives
from?
对象
视频 哑剧 是 ["application/javascript",
"video/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
，因为广告代码始终
安全无虞