ORTB
中 / EN

Imp§3.2.4 · Bid Request

该对象描述正在拍卖的广告位(ad placement)或展示(impression)。一个竞价请求可包含多个 Imp 对象,其用例可以是支持售卖指定页面上所有广告位的交易平台。每个 Imp 对象都有一个必填的 ID,以便出价能逐一引用它们。Banner第 3.2.6 节)、Video第 3.2.7 节)和/或 Native第 3.2.9 节)对象作为 Imp 的子对象出现,即表明所提供展示的类型。发布方可选择其中一种类型(典型情形),也可自行许可混售;但针对该展示的任一具体出价,只能符合所供类型中的一种。译稿校对中ENThis object describes an ad placement or impression being auctioned. A single bid request can include multiple Imp objects, a use case for which might be an exchange that supports selling all ad positions on a given page. Each Imp object has a required ID so that bids can reference them individually. The presence of Banner (Section 3.2.6), Video (Section 3.2.7), and/or Native (Section 3.2.9) objects subordinate to the Imp object indicates the type of impression being offered. The publisher can choose one such type which is the typical case or mix them at their discretion. However, any given bid for the impression must conform to one of the offered type.

AttributeTypeDescription
id
required
string本展示在竞价请求上下文内的唯一标识符(通常从 1 开始递增)。译稿校对中ENA unique identifier for this impression within the content of the bid request (typically, starts with 1 and increments).
metric
object[]Metric 对象(参见第 3.2.5 节)数组。译稿校对中ENAn array of Metric object (section 3.2.5).
banner
objectBanner 对象(参见第 3.2.6 节);当该展示以 banner 广告机会提供时必填。译稿校对中ENA Banner object (section 3.2.6); required if this impression is offered as a banner ad opportunity.
video
objectVideo 对象(参见第 3.2.7 节);当该展示以视频广告机会提供时必填。译稿校对中ENA Video object (Section 3.2.7); required if this impression is offered as a video ad opportunity.
audio
objectAudio 对象(参见第 3.2.8 节);当该展示以音频广告机会提供时必填。译稿校对中ENAn Audio object (Section 3.2.8); required if this impression is offered as an audio ad opportunity.
native
objectNative 对象(参见第 3.2.9 节);当该展示以原生广告机会提供时必填。译稿校对中ENA Native object (Section 3.2.9); required if this impression is offered as a native ad opportunity.
pmp
objectPmp 对象(参见第 3.2.11 节),包含对该展示生效的私有交易市场交易。译稿校对中ENA Pmp object (Section 3.2.11) containing any private marketplace deals in effect for this impression.
displaymanager
string负责渲染广告的广告聚合合作方(ad mediation partner)、SDK 技术或播放器的名称(通常为视频或移动场景)。部分广告服务器用它按合作方定制广告代码。视频和/或应用场景建议传递。译稿校对中ENName of ad mediation partner, SDK technology, or player responsible for rendering ad (typically video or mobile). Used by some ad servers to customize ad code by partner.
Recommended for video and/or apps.
displaymanagerver
string负责渲染广告的广告聚合合作方、SDK 技术或播放器的版本号(通常为视频或移动场景)。部分广告服务器用它按合作方定制广告代码。视频和/或应用场景建议传递。译稿校对中ENVersion of ad mediation partner, SDK technology, or player responsible for rendering ad (typically video or mobile). Used by some ad servers to customize ad code by partner.
Recommended for video and/or apps.
instl
default 0
integer1 = 广告为插屏(interstitial)或全屏,0 = 非插屏。译稿校对中EN1 = the ad is interstitial or full screen, 0 = not interstitial.
tagid
string用于发起本次拍卖的特定广告位或广告标签(ad tag)的标识符。可用于问题排查,或供买方做优化。译稿校对中ENIdentifier for specific ad placement or ad tag that was used to initiate the auction. This can be useful for debugging of any issues, or for optimization by the buyer.
bidfloor
default 0
float该展示的最低出价,以 CPM(Cost Per Mille,每千次展示成本)计价。译稿校对中ENMinimum bid for this impression expressed in CPM.
bidfloorcur
default "USD"
string指定币种,采用 ISO-4217 alpha 代码。若交易平台允许,它可以不同于竞价方返回的出价币种。该币种为 Imp 对象内所有底价(floors)的默认币种。译稿校对中ENCurrency specified using ISO-4217 alpha codes. This may be different from bid currency returned by bidder if this is allowed by the exchange. This currency sets the default for all floors specified in the Imp object.
clickbrowser
integer指示在应用内点击创意时打开的浏览器类型:0 = 嵌入式(embedded),1 = 原生(native)。注意:就本属性而言,iOS 9.x 设备上的 Safari View Controller 被视为原生浏览器。译稿校对中ENIndicates the type of browser opened upon clicking the creative in an app, where 0 = embedded, 1 = native. Note that the Safari View Controller in iOS 9.x devices is considered a native browser for purposes of this attribute.
secure
integer指示该展示是否要求安全的 HTTPS URL 创意素材与标记:0 = 非安全,1 = 安全。省略时安全状态未知,但可假定支持非安全 HTTP。译稿校对中ENFlag to indicate if the impression requires secure HTTPS URL creative assets and markup, where 0 = non-secure, 1 = secure. If omitted, the secure state is unknown, but non-secure HTTP support can be assumed.
iframebuster
string[]受支持的 iframe 破框器(iframe buster)的交易平台专属名称数组。译稿校对中ENArray of exchange-specific names of supported iframe busters.
rwdd
default 0
integer指示用户观看广告后是否获得奖励:0 = 否,1 = 是。典型视频广告实现中,用户可通过观看广告免费阅读额外新闻文章、在游戏中获得额外生命,或获得赞助的无广告音乐时段;奖励通常在视频广告播放完成后发放。译稿校对中ENIndicates whether the user receives a reward for viewing the ad, where 0 = no, 1 = yes. Typically video ad implementations allow users to read an additional news article for free, receive an extra life in a game, or get a sponsored ad-free music session. The reward is typically distributed after the video ad is completed.
ssai
default 0
integer指示是否使用服务端广告插入(server-side ad insertion,如将广告拼接进音频或视频流)及其对素材与跟踪器获取的影响:0 = 状态未知,1 = 全部客户端侧(即非服务端),2 = 素材服务端拼接但跟踪像素由客户端触发,3 = 全部服务端侧。译稿校对中ENIndicates if server-side ad insertion (e.g., stitching an ad into an audio or video stream) is in use and the impact of this on asset and tracker retrieval, where 0 = status unknown, 1 = all client-side (i.e., not server-side), 2 = assets stitched server-side but tracking pixels fired client-side, 3 = all server-side.
exp
integer参考值,指示拍卖与实际展示之间可能经过的秒数。译稿校对中ENAdvisory as to the number of seconds that may elapse between the auction and the actual impression.
qty
object在竞价请求中传递乘数的方式,表示面向多人展示的广告的展示总量。译稿校对中ENA means of passing a multiplier in the bid request, representing the total quantity of impressions for adverts that display to more than one person.
dt
float预计履约(如 DOOH 展示将被播放)时刻的时间戳,Unix 格式(即自纪元起的毫秒数)。译稿校对中ENTimestamp when the item is estimated to be fulfilled (e.g. when a DOOH impression will be displayed) in Unix format (i.e., milliseconds since the epoch).
refresh
object自动刷新的广告位详情(参见第 3.2.33 节)。译稿校对中ENDetails about ad slots being refreshed automatically. (Section 3.2.33)
ext
object供交易平台(exchange)对 OpenRTB 进行专属扩展(exchange-specific extensions)的占位对象。译稿校对中ENPlaceholder for exchange-specific extensions to OpenRTB.

译注

译者注

Imp:竞价请求的核心对象,描述正在拍卖的广告位/展示;业内文档一般保留英文对象名 Imp。一个请求可含多个 Imp(如整页多广告位售卖),各 Imp 由必填的 id 唯一标识,出价通过 impid 引用。译稿校对中

rwdd 激励视频:激励广告(rewarded ads)的用户体验与计费均有特殊性——奖励在完播后发放,因此完播率与可见性口径与普通视频不同;买方出价与创意适配时应识别该标志。译稿校对中

ssai 的四态语义:服务端广告插入(SSAI/DAI)直接影响素材加载与跟踪归因路径:取值 2(服务端拼接 + 客户端跟踪)是 CTV 常见形态;竞价方应据此决定素材交付格式与防重复计数策略,避免 SSAI 链路上的跟踪器双计。译稿校对中

bidfloorcur 的默认币种语义:2.6 明确该币种是 Imp 内所有底价的默认币种(Deal 级 bidfloorcur 除外,见 Deal 译注);多币种出价时应逐层确认币种归属,避免结算口径错位。译稿校对中

qty / dt 的 DOOH 背景:数字户外(DOOH)屏幕一次展示可被多人观看,qty 传递观众规模乘数;dt 声明预计履约时刻(如屏幕播放时间点),两者是 DOOH 采买计价与排期的基础,传统在线流量不适用。译稿校对中

refresh 的可见性影响:自动刷新广告位(Refresh 对象)的单次曝光时长与可见性口径与静态广告位不同,可见性导向的采买应结合该对象评估。译稿校对中

displaymanager / displaymanagerver 的排查价值:渲染技术标识是排查创意兼容与渲染失败问题的关键线索;视频与 app 场景建议始终传递。译稿校对中

字段描述收录自 IAB Tech Lab OpenRTB 2.6 官方规范(CC-BY 3.0)· 枚举值来源 AdCOM 1.0 · 初稿校对中