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