本指南概述了实时出价购买的集成要求 使用 OpenRTB 协议本指南应与 OpenRTB 集成指南 其中详细介绍了此处讨论的字段。
如果您在 iOS 应用中购买了包含 <video>
代码的 HTML 代码段,
必须在视频代码中添加 playsinline
属性。否则,用户会非常
本应播放的视频广告弹出显示
全屏。不遵守此政策的广告将会被屏蔽。
买方要求
新的实时出价买方应使用最新的协议缓冲区开发出价工具 以及下文所述信息。 如需下载协议,请参阅 参考数据页面。 如需了解如何开发出价工具 请参阅处理请求 和构建响应。
支持的宏
插播视频广告素材支持以下宏:
%%CACHEBUSTER%%
%%WINNING_PRICE%%
请注意,视频网址中允许替换宏,但不允许 实际的 VAST XML 内
Click 宏(例如 CLICK_URL_ESC
)不是必需的
因为 Authorized Buyers 将点击跟踪广告代码包含在 VAST 封装容器中。
因此,插播视频广告不支持 Click 宏。
如需详细了解支持的宏
请参阅指定宏
在 Build the Response(构建响应)下方,
视频对象详情
OpenRTB 协议使用 Video
消息,该消息在
<ph type="x-smartling-placeholder"></ph>
openrtb-proto.txt 文件来识别视频请求
并提供有关相应请求的其他视频专用信息。
请参阅视频消息字段列表 请查看 OpenRTB 集成指南,了解详细说明和示例。
其他视频广告出价请求字段
以下信号并非全部视频广告素材都独有, 但同时也是出价请求的关键部分
展示对象字段
此对象描述正在竞价的广告展示位置或展示。
banner |
Banner 对象;如果相应展示是作为横幅广告机会提供的,则该字段为必需字段。 |
video |
用于表示提供的展示类型,本例中为视频。请注意,横幅内嵌广告
如果 imp 对象同时包含 banner 和
video 对象。 |
tagid |
用于发起竞价的特定广告展示位置或广告代码的标识符。 这对于调试任何问题或买方进行优化都很有用。 |
bidfloor |
此展示的最低出价(以每千次展示费用表示)。 |
bidfloorcur |
一种货币,从包含的 billing_id. 获取 |
如需了解更多详情,请参阅 OpenRTB 指南中的展示对象部分。
设备对象字段
Device
对象中的字段提供有关目标设备的信息。
ua |
浏览器用户代理字符串。 |
ip |
离设备最近的 IPv4 地址。 |
geo |
假定设备的位置是由 Geo 对象定义的用户的当前位置。 |
devicetype |
设备的常规类型。 |
ifa |
明文准许广告客户使用的 ID(例如,未经过哈希处理)。ifa 适用于联网电视设备,例如 Roku、Apple TV、Fire TV、Xbox。 |
如需了解更多详情,请参阅 OpenRTB 指南中的设备对象部分。
Site 对象
Site
对象中的字段提供了有关含广告内容的网站的信息。
page |
将显示广告的网页的网址。 |
publisher |
网站的 Publisher 对象的详细信息。 |
content |
网站中有关Content 的详细信息。 |
有关更多详情,请参阅 OpenRTB 指南中的 Site 对象部分。
User 对象
User
对象中的字段提供了有关含广告内容的网站的信息。
id |
用户的广告交易平台特定 ID。建议至少使用 id 和 buyerid 中的一个。 |
data |
网站的 Publisher 对象的详细信息。 |
请参阅用户对象部分 。
出价请求广告资源字段
视频广告出价请求还包含内容类型的相关信息 以及任何指定的随播广告
mimes
- 支持的内容 MIME 类型的许可名单。
companionad
- 一组 Banner 对象(如果有随播广告)。
出价响应字段
视频广告出价响应中的关键字段包括: