视频广告

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

Google 支持插播式视频广告、原生视频广告和插页式视频广告。如需详细了解原生广告格式和插页式广告格式，请参阅相应指南。

买方要求

RTB 协议

本指南通常会提及 Protobuf 格式，但除非另有说明，否则字段名称和路径在 Protobuf 格式和 JSON 格式之间是等效的。

您可以在 Proto 和参考数据页面中找到 OpenRTB proto 和 Google 专用 OpenRTB 扩展。如需详细了解如何开发出价方，请参阅处理请求和构建响应。

广告素材审核

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	在没有流式视频内容的情况下播放的视频广告。此类广告可在幻灯片、原生信息流、内容内或固定/浮动广告展示位置中展示。

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

指定设备的品牌（例如 Nokia 或 Samsung）。

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

允许使用的供应商。如需查看 ID 列表，请参阅技术文档中的 vendors.txt 文件。 例如，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

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

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。

出价请求和响应示例

• 视频出价请求示例
• 视频出价响应示例

视频格式

• 买方如何添加视频
• 适用于所有视频格式的 OpenRTB 建议信号
• 适用于所有视频格式的 Authorized Buyers proto 建议信号
• 发布商如何允许/禁止视频
• 边缘用例

买方如何添加视频

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

Web

移动应用

OpenRTB 建议的信号

下表展示了适用于桌面版网站和移动网站以及移动应用的所有视频格式的 OpenRTB 建议信号。

桌面网站和移动网站

移动应用

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

下表展示了发布商可以在其展示位置中允许/禁止视频广告的方式。

边缘用例

术语库

请参阅 Authorized Buyers 视频术语表。

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

请参阅 OpenRTB 2.5（第 47 页起）

出价请求价值来源