此页面由 Cloud Translation API 翻译。

视频广告

本指南概述了在对视频广告资源出价时，您可以使用的集成要求、配置和相关 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 秒后显示在下方也是如此

案例说明

出价请求

使用 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 ，因为广告代码始终安全无虞