- 对象
- 38
- 字段
- 417
- 枚举引用
- 55
- 已废弃字段
- 12
Bid Request 对象模型
Bid Response 对象模型
seatbid 1..*
cur · nbr(No-Bid 原因)· bidid
经 ID 关联的请求侧对象(引用,非组合)
BidRequest · Response to this Request (id)
Imp · Bid for this Impression (bid.impid)
Deal · Bid under the terms of this Deal (bid.dealid)
竞价核心
请求级信息与交易规则- BidRequest§3.2.124 字段2 required1 枚举顶层竞价请求对象包含一个交易平台唯一的竞价请求或拍卖 ID。id 属性为必填,且至少需包含一个展示对象(参见第 3.2.4 节)。该顶层对象中的其他属性建立适用于所有所提供展示的规则与约束。另有若干子对象向潜在买方提供详细数据,其中的 Site、App 与 DOOH 对象描述展示所出现的已发布媒体类型;这三个对象强烈建议传递,但视媒体是浏览器网页内容、非浏览器应用还是数字户外(Digital Out of Home)库存,同一竞价请求只适用其一。译稿校对中ENThe top-level bid request object contains an exchange unique bid request or auction ID. This
idattribute is required as is at least one impression object (Section 3.2.4). Other attributes in this top-level object establish rules and restrictions that apply to all impressions being offered. There are also several subordinate objects that provide detailed data to potential buyers. Among these are theSite,AppandDOOHobjects, which describe the type of published media in which the impression(s) appear. These objects are highly recommended, but only one applies to a given bid request depending on whether the media is browser-based web content, a non-browser application, or Digital Out of Home inventory respectively. - Source§3.2.25 字段该对象描述位于交易平台(exchange)上游、作为竞价请求来源的实体的性质与行为。其主要目的是在交易平台本身不控制最终决策时,定义竞后决策(post-auction decisioning)或上游决策(upstream decisioning)。一个常见的例子是头部竞价(header bidding),但它同样适用于上游服务端实体——例如另一个 RTB 交易平台、聚合平台(mediation platform),或将直客投放活动(direct campaigns)与第三方需求(3rd party demand)合并决策的广告服务器(ad server)。译稿校对中ENThis object describes the nature and behavior of the entity that is the source of the bid request upstream from the exchange. The primary purpose of this object is to define post-auction or upstream decisioning when the exchange itself does not control the final decision. A common example of this is header bidding, but it can also apply to upstream server entities such as another RTB exchange, a mediation platform, or an ad server combines direct campaigns with 3rd party demand in decisioning.
- Regs§3.2.36 字段该对象包含发送方认为适用于该请求的法律、政府或行业监管要求。有关支持 COPPA、GDPR 等标志的更多细节,参见第 7.5 节。译稿校对中ENThis object contains any legal, governmental, or industry regulations that the sender deems applicable to the request. See Section 7.5 for more details on the flags supporting Coppa, GDPR and others.
广告位与媒体形式
Impression 及 Banner / Video / Audio / Native 形式定义与交易条款- Imp§3.2.423 字段1 required该对象描述正在拍卖的广告位(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
Impobjects, a use case for which might be an exchange that supports selling all ad positions on a given page. EachImpobject has a required ID so that bids can reference them individually. The presence ofBanner(Section 3.2.6),Video(Section 3.2.7), and/orNative(Section 3.2.9) objects subordinate to theImpobject 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. - Metric§3.2.54 字段2 required该对象以指标(metrics)数组的形式与展示关联。这些指标可提供关于展示的洞察以辅助决策(decisioning),如近期平均可见性(viewability)、点击率等。每条指标由其类型标识、上报指标取值,并可选地标明测量该取值的来源或供应商。译稿校对中ENThis object is associated with an impression as an array of metrics. These metrics can offer insight into the impression to assist with decisioning such as average recent viewability, click-through rate, etc. Each metric is identified by its type, reports the value of the metric, and optionally identifies the source or vendor measuring the value.
- Banner§3.2.613 字段4 枚举该对象表示最通用的展示类型。虽然 “banner” 一词在其他语境中可能有非常特定的含义,但在这里它可以是多种形态:简单的静态图片、可展开的广告单元,甚至 banner 内嵌视频(更通用、功能更全的视频广告单元参见第 3.2.7 节的 Video 对象)。Banner 对象数组也可出现于 Video 内部,描述 VAST 规范定义的可选伴生广告(companion ads)。Banner 作为 Imp 的子对象出现,即表示该展示以 banner 类型提供;经发布方许可,同一展示还可通过在 Imp 下并列包含 video、audio 和/或 native 类型对象的方式同时以这些类型提供,但针对该展示的任一具体出价,只能符合所供类型中的一种。译稿校对中ENThis object represents the most general type of impression. Although the term “banner” may have very specific meaning in other contexts, here it can be many things including a simple static image, an expandable ad unit, or even in-banner video (refer to the
Videoobject in Section 3.2.7 for the more generalized and full featured video ad units). An array ofBannerobjects can also appear within theVideoto describe optional companion ads defined in the VAST specification. The presence of aBanneras a subordinate of theImpobject indicates that this impression is offered as a banner type impression. At the publisher’s discretion, that same impression may also be offered as video, audio, and/or native by also including asImpsubordinates objects of those types. However, any given bid for the impression must conform to one of the offered types. - Video§3.2.736 字段1 required14 枚举2 废弃该对象表示视频展示。其中许多字段对最小可行交易并非必需,但可在需要时提供精细控制。OpenRTB 中的视频通常假定符合 VAST 标准;因此,伴生广告(companion ads)的概念通过可选地包含一个定义这些伴生广告的 Banner 对象数组(参见第 3.2.6 节的 Banner 对象)得到支持。Video 作为 Imp 的子对象出现,即表示该展示以视频类型提供;经发布方许可,同一展示还可通过在 Imp 下并列包含 Banner、Audio 和/或 Native 类型对象的方式同时以这些类型提供,但针对该展示的任一具体出价,只能符合所供类型中的一种。译稿校对中ENThis object represents a video impression. Many of the fields are non-essential for minimally viable transactions, but are included to offer fine control when needed. Video in OpenRTB generally assumes compliance with the VAST standard. As such, the notion of companion ads is supported by optionally including an array of
Bannerobjects (refer to theBannerobject in Section 3.2.6) that define these companion ads. The presence of aVideoas a subordinate of theImpobject indicates that this impression is offered as a video type impression. At the publisher’s discretion, that same impression may also be offered asBanner,Audio, and/orNativeby also including asImpsubordinates objects of those types. However, any given bid for the impression must conform to one of the offered types. - Audio§3.2.826 字段1 required10 枚举1 废弃该对象表示音频(audio)类型的展示。其中许多字段对最小可行交易并非必需,但可在需要时提供精细控制。OpenRTB 中的音频通常假定符合 VAST 标准;因此,伴生广告(companion ads)的概念通过可选地包含一个定义这些伴生广告的 Banner 对象数组(参见第 3.2.6 节的 Banner 对象)得到支持。Audio 作为 Imp 的子对象出现,即表示该展示以音频类型提供;经发布方许可,同一展示还可通过在 Imp 下并列包含 Banner、Video 和/或 Native 类型对象的方式同时以这些类型提供,但针对该展示的任一具体出价,只能符合所供类型中的一种。译稿校对中ENThis object represents an audio type impression. Many of the fields are non-essential for minimally viable transactions, but are included to offer fine control when needed. Audio in OpenRTB generally assumes compliance with the VAST standard. As such, the notion of companion ads is supported by optionally including an array of
Bannerobjects (refer to theBannerobject in Section 3.2.6) that define these companion ads. The presence of aAudioas a subordinate of theImpobject indicates that this impression is offered as an audio type impression. At the publisher’s discretion, that same impression may also be offered asBanner,Video, and/orNativeby also including asImpsubordinates objects of those types. However, any given bid for the impression must conform to one of the offered types. - Native§3.2.95 字段1 required2 枚举该对象表示原生(native)类型的展示。原生广告单元旨在与周围内容无缝融合(如 Twitter 或 Facebook 上的赞助帖子),因此响应必须结构良好,以便发布方对渲染实施细粒度控制。Native 小组委员会(Native Subcommittee)制定了一份名为 Dynamic Native Ads API 的 OpenRTB 伴生规范,定义原生广告单元的请求参数与响应标记结构;本对象提供了将请求参数以不透明字符串传输的手段,使具体参数可在该规范的管辖下独立演进,下发的广告标记同样遵循其结构。Native 作为 Imp 的子对象出现,即表示该展示以原生类型提供;经发布方许可,同一展示还可通过在 Imp 下并列包含 Banner、Video 和/或 Audio 类型对象的方式同时以这些类型提供,但针对该展示的任一具体出价,只能符合所供类型中的一种。译稿校对中ENThis object represents a native type impression. Native ad units are intended to blend seamlessly into the surrounding content (e.g., a sponsored Twitter or Facebook post). As such, the response must be well-structured to afford the publisher fine-grained control over rendering. The Native Subcommittee has developed a companion specification to OpenRTB called the Dynamic Native Ads API. It defines the request parameters and response markup structure of native ad units. This object provides the means of transporting request parameters as an opaque string so that the specific parameters can evolve separately under the auspices of the Dynamic Native Ads API. Similarly, the ad markup served will be structured according to that specification. The presence of a
Nativeas a subordinate of theImpobject indicates that this impression is offered as a native type impression. At the publisher’s discretion, that same impression may also be offered asBanner,Video, and/orAudioby also including asImpsubordinates objects of those types. However, any given bid for the impression must conform to one of the offered types. - Format§3.2.106 字段该对象表示 banner 展示所允许的一种尺寸(即高宽组合)或一组弹性广告(Flex Ad)参数。它们通常以数组形式使用,以允许多种尺寸。建议指定 w/h 对或 wratio/hratio/wmin 组合(即用于 Flex Ads)二者之一。译稿校对中ENThis object represents an allowed size (i.e., height and width combination) or Flex Ad parameters for a banner impression. These are typically used in an array where multiple sizes are permitted. It is recommended that either the
w/hpair or thewratio/hratio/wminset (i.e., for Flex Ads) be specified. - Pmp§3.2.113 字段该对象是私有交易市场(private marketplace)的容器,承载买卖双方之间可能与该展示相关的直接交易(direct deals)。实际交易以 Deal 对象集合的形式表达。更多细节参见第 7.3 节。译稿校对中ENThis object is the private marketplace container for direct deals between buyers and sellers that may pertain to this impression. The actual deals are represented as a collection of
Dealobjects. Refer to Section 7.3 for more details. - Deal§3.2.1210 字段1 required该对象构成买方与卖方之间达成的具体交易(deal)。它出现在 Pmp 集合中,即表示该展示可按该交易的条款获取。更多细节参见第 7.3 节。译稿校对中ENThis object constitutes a specific deal that was struck between a buyer and a seller. Its presence with the
Pmpcollection indicates that this impression is available under the terms of that deal. Refer to Section 7.3 for more details. - Qty§3.2.314 字段2 required1 枚举在数字户外(DOOH)与 CTV 中,一次程序化展示机会常被称为一个“时段(spot)”,而一次展示是观看它的受众中的一个独立个体。因此,需要在竞价请求中传递乘数的标准方式,以表示展示总量。本对象包含展示乘数,并描述乘数取值的来源。译稿校对中ENA programmatic impression is often referred to as a ‘spot’ in digital out-of-home and CTV, with an impression being a unique member of the audience viewing it. Therefore, a standard means of passing a multiplier in the bid request, representing the total quantity of impressions, is required. This object includes the impression multiplier, and describes the source of the multiplier value.
- DOOH§3.2.329 字段1 枚举当承载广告的内容是数字户外(Digital Out-Of-Home)屏幕时,应包含本对象。含 DOOH 对象的竞价请求不得同时包含 site 或 app 对象。至少提供 id 和/或 venuetypeid 是有用的,但这并非严格要求。译稿校对中ENThis object should be included if the ad supported content is a Digital Out-Of-Home screen. A bid request with a DOOH object must not contain a site or app object. At a minimum, it is useful to provide id and/or venuetypeid, but this is not strictly required.
- Refresh§3.2.333 字段该对象描述自动刷新的广告位:包含刷新机制(RefSettings)与自上次页面加载以来的刷新次数,挂载于 Imp.refresh。译稿校对中
- RefSettings§3.2.343 字段1 枚举关于广告位被刷新的频率与触发方式的信息。译稿校对中ENInformation on how often and what triggers an ad slot being refreshed.
- DurFloors§3.2.354 字段本对象允许卖方为按时长差异定价的视频与音频创意指定价格底线。例如:1–15 秒底价 $5;16–30 秒底价 $10;31 秒以上底价 $20。对已定义的区间无显式约束,也不保证其互不重叠;在多区间可能同时适用时,由买卖双方协调确定适用的底价。关于这些字段使用的更多说明,参见实施指引第 7.11 节。译稿校对中ENThis object allows sellers to specify price floors for video and audio creatives, whose price varies based on time. For example: 1-15 seconds at a floor of $5; 16-30 seconds at a floor of $10, > 31 seconds at a floor of $20. There are no explicit constraints on the defined ranges, nor guarantees that they don't overlap. In cases where multiple ranges may apply, it is up to the buyer and seller to coordinate on which floor is applicable. See [Section 7.11 of Implementation Guidance](implementation.md#floors) for additional notes regarding the use of these fields.
媒体上下文
Site / App 载体与内容、出版方- Site§3.2.1318 字段1 枚举当承载广告的内容是网站而非非浏览器应用或数字户外(DOOH)库存时,应包含该对象。一个竞价请求不得同时包含 Site、App、DOOH 对象中的多个。至少提供站点 ID 或页面 URL 是有用的,但这并非严格要求。译稿校对中ENThis object should be included if the ad supported content is a website as opposed to a non-browser application or Digital Out of Home (DOOH) inventory. A bid request must not contain more than one of a
Site,ApporDOOHobject. At a minimum, it is useful to provide a site ID or page URL, but this is not strictly required. - App§3.2.1418 字段1 枚举当承载广告的内容是非浏览器应用(通常为移动端)而非网站时,应包含该对象。一个竞价请求不得同时包含 Site、App、DOOH 对象中的多个。至少提供应用 ID 或 bundle 是有用的,但这并非严格要求。译稿校对中ENThis object should be included if the ad supported content is a non-browser application (typically in mobile) as opposed to a website. A bid request must not contain more than one of a
Site,ApporDOOHobject. At a minimum, it is useful to provide an App ID or bundle, but this is not strictly required. - Publisher§3.2.156 字段1 枚举该对象描述直接向交易平台供给库存并从交易平台获得结算的实体。它可以是发布方(publisher)、中间交易平台、广告联盟等。译稿校对中ENThis object describes the entity who directly supplies inventory to and is paid by the exchange. This may be a publisher, intermediary exchange, ad network, etc.
- Content§3.2.1634 字段5 枚举该对象描述展示(impression)将出现于其中的内容,内容可以是联合发行的(syndicated),也可以是非联合发行的。当联合发行的内容承载展示、且不一定符合发布方的整体内容定位时,该对象尤为有用。受联合发行方式影响,交易平台(exchange)可能知晓、也可能不知晓内容实际运行所在的页面——例如,它可能是嵌入在某个未知网络资产或设备的 iframe 中的视频展示。译稿校对中ENThis object describes the content in which the impression will appear, which may be syndicated or non-syndicated content. This object may be useful when syndicated content contains impressions and does not necessarily match the publisher’s general content. The exchange might or might not have knowledge of the page where the content is running, because of the syndication method. For example, might be a video impression embedded in an iframe on an unknown web property or device.
- Producer§3.2.176 字段1 枚举该对象定义广告将展示于其中的内容的制作方(producer)。当内容被联合发行(syndicated)、可能经由不同的发布方(publisher)分发时,该对象尤为有用——此时制作方与发布方不一定是同一实体。译稿校对中ENThis object defines the producer of the content in which the ad will be shown. This is particularly useful when the content is syndicated and may be distributed through different publishers and thus when the producer and publisher are not necessarily the same entity.
设备与用户
设备、地理位置、用户与人群分段- Device§3.2.1833 字段2 枚举6 废弃Device 对象用于描述用户当前进行交互所使用的设备的相关信息。设备信息涵盖其硬件、平台、地理位置(location)以及运营商(carrier)相关数据。此处所述的设备可以指代移动电话(mobile handset)、台式计算机、机顶盒(set top box)或其他数字设备。译稿校对中ENThis object provides information pertaining to the device through which the user is interacting. Device information includes its hardware, platform, location, and carrier data. The device can refer to a mobile handset, a desktop computer, set top box, or other digital device.
- Geo§3.2.1914 字段2 枚举该对象封装了指定地理位置的多种方式。当从属于 Device 对象时,它表示设备的位置,也可理解为用户的当前位置;当从属于 User 对象时,它表示用户常驻地(home base,即不一定是其当前位置)。lat/lon 属性只有在其精度符合 type 属性所刻画的精度时才应传递;例如,邮编等地理区域的质心不应被传递。译稿校对中ENThis object encapsulates various methods for specifying a geographic location. When subordinate to a
Deviceobject, it indicates the location of the device which can also be interpreted as the user’s current location. When subordinate to aUserobject, it indicates the location of the user’s home base (i.e., not necessarily their current location). Thelat/lonattributes should only be passed if they conform to the accuracy depicted in thetypeattribute. For example, the centroid of a geographic region such as postal code should not be passed. - User§3.2.2012 字段2 废弃该对象包含关于设备背后真实用户(即广告受众)的已知或推导信息。用户 id 是交易平台(exchange)的产物,可能受轮换或其他隐私策略约束;但当存在时,该用户 ID 应足够稳定,方能合理地作为频控(frequency capping)与重定向(retargeting)的基础。译稿校对中ENThis object contains information known or derived about the human user of the device (i.e., the audience for advertising). The user
idis an exchange artifact and may be subject to rotation or other privacy policies. However, when present, this user ID should be stable long enough to serve reasonably as the basis for frequency capping and retargeting. - Data§3.2.215 字段Data 与 Segment 对象共同作用,允许为相关对象(如用户、内容)指定附加数据。这些数据可以来自多个来源,无论是交易平台(exchange)自身还是由 id 字段指定的第三方。一个竞价请求可以混合来自多个提供者的 Data 对象。在用的具体数据提供者应由交易平台事先(a priori)公布给其竞价方。译稿校对中ENThe data and segment objects together allow additional data about the related object (e.g., user, content) to be specified. This data may be from multiple sources whether from the exchange itself or third parties as specified by the
idfield. A bid request can mix data objects from multiple providers. The specific data providers in use should be published by the exchange a priori to its bidders. - Segment§3.2.224 字段Segment 对象本质上是一个键值对(key-value pair),用于传达具体的数据单元。其父对象 Data 是某个数据提供者(data provider)提供的此类取值的集合。具体的段名称与取值选项必须由交易平台(exchange)事先(a priori)公布给其竞价方。译稿校对中ENSegment objects are essentially key-value pairs that convey specific units of data. The parent
Dataobject is a collection of such values from a given data provider. The specific segment names and value options must be published by the exchange a priori to its bidders. - UserAgent§3.2.298 字段1 枚举结构化用户代理信息,在客户端支持 User-Agent Client Hints 时可用。若竞价请求中 device.ua 与 device.sua 同时存在,应视 device.sua 为设备属性的更准确表达——因为浏览器弃用用户代理字符串,device.ua 可能包含被冻结或精简的用户代理字符串。译稿校对中ENStructured user agent information, which can be used when a client supports User-Agent Client Hints. If both
device.uaanddevice.suaare present in the bid request,device.suashould be considered the more accurate representation of the device attributes. This is because thedevice.uamay contain a frozen or reduced user agent string due to deprecation of user agent strings by browsers. - BrandVersion§3.2.303 字段1 required基于 User-Agent Client Hints 的进一步标识:BrandVersion 对象用于标识设备的浏览器或类似软件组件,以及用户代理的执行平台或操作系统。译稿校对中ENFurther identification based on User-Agent Client Hints, the
BrandVersionobject is used to identify a device’s browser or similar software component, and the user agent’s execution platform or operating system.
分发渠道
广告分发的网络与渠道标识- Network§3.2.234 字段该对象描述广告将展示于其上的电视网(network)。Network 定义为 Channel 对象的上级实体,用于组织频道。示例:拥有和/或授权内容频道集合的公司(Viacom、Discovery、CBS、WarnerMedia、Turner 等),或制作并自发行的工作室。name 是人读字段,domain 与 id 可用于报告与定向。更多示例参见第 7.6 节。译稿校对中ENThis object describes the network an ad will be displayed on. A Network is defined as the parent entity of the
Channelobject’s entity for the purposes of organizing Channels. Examples are companies that own and/or license a collection of content channels (Viacom, Discovery, CBS, WarnerMedia, Turner and others), or studio that creates such content and self-distributes content. Name is a human-readable field while domain and id can be used for reporting and targeting purposes. See 7.6 for further examples. - Channel§3.2.244 字段该对象描述广告将展示于其上的频道(channel)。Channel 定义为在品牌名下为观众策划内容库或流的实体。示例:线性与流媒体电视中可选择的具体频道(MTV、HGTV、CNN、BBC One 等),或俗称“电台(stations)”的特定音频内容流。name 是人读字段,domain 与 id 可用于报告与定向。更多示例参见第 7.6 节。译稿校对中ENThis object describes the channel an ad will be displayed on. A Channel is defined as the entity that curates a content library, or stream within a brand name for viewers. Examples are specific view selectable ‘channels’ within linear and streaming television (MTV, HGTV, CNN, BBC One, etc) or a specific stream of audio content commonly called ‘stations.’ Name is a human-readable field while domain and id can be used for reporting and targeting purposes. See 7.6 for further examples.
身份与供应链
扩展 ID 与付款链路(schain)- EID§3.2.276 字段1 枚举OpenRTB 规范中的扩展标识符(Extended Identifiers)支持使买方能够在实时竞价中使用受众数据。本对象可包含来自单一来源或技术提供者的一个或多个 UID。交易平台应确保商业协议允许发送此类数据。关于这些字段使用的更多说明,参见实施指引第 7.12 节。译稿校对中ENExtended identifiers support in the OpenRTB specification allows buyers to use audience data in real-time bidding. This object can contain one or more UIDs from a single source or a technology provider. The exchange should ensure that business agreements allow for the sending of this data. See [Section 7.12 of Implementation Guidance](implementation.md#idmm) for additional notes regarding the use of these fields.
- UID§3.2.283 字段1 枚举该对象包含作为扩展标识符一部分提供的单个用户标识符。交易平台应确保商业协议允许发送此类数据。译稿校对中ENThis object contains a single user identifier provided as part of extended identifiers. The exchange should ensure that business agreements allow for the sending of this data.
- SupplyChain§3.2.254 字段3 required该对象由一组节点构成,每个节点代表参与库存交易的一个具体实体。从首至尾的整条节点链代表参与库存直接支付流的所有实体。详细实现示例参见:https://github.com/InteractiveAdvertisingBureau/openrtb/blob/master/supplychainobject.md译稿校对中ENThis object is composed of a set of nodes where each node represents a specific entity that participates in the transacting of inventory. The entire chain of nodes from beginning to end represents all entities who are involved in the direct flow of payment for inventory. Detailed implementation examples can be found here: https://github.com/InteractiveAdvertisingBureau/openrtb/blob/master/supplychainobject.md
- SupplyChainNode§3.2.267 字段2 required该对象以节点数组的形式与 SupplyChain 对象关联。这些节点定义参与竞价请求供应链的实体的身份。详细实现示例参见:https://github.com/InteractiveAdvertisingBureau/openrtb/blob/master/supplychainobject.md。译稿校对中ENThis object is associated with a
SupplyChainobject as an array of nodes. These nodes define the identity of an entity participating in the supply chain of a bid request. Detailed implementation examples can be found here: https://github.com/InteractiveAdvertisingBureau/openrtb/blob/master/supplychainobject.md. TheSupplyChainNodeobject contains the following attributes:
竞价响应
Bid Response 侧对象- BidResponse§4.2.17 字段1 required该对象是顶层竞价响应(bid response)对象(即未命名的外层 JSON 对象)。id 属性反映竞价请求 ID,用于日志记录;同样地,bidid 是供竞价方使用的可选响应跟踪 ID,若已指定,当竞价方胜出时可将其包含在后续的赢标通知(win notice)调用中。至少需要一个 seatbid 对象,其中至少包含一条针对某展示的出价;其他属性均为可选。要表达“不出价(no-bid)”,选项是返回 HTTP 204 的空响应;若竞价方希望向交易平台传达不出价的原因,也可仅返回一个 BidResponse 对象,并在 nbr 属性中携带原因码。译稿校对中ENThis object is the top-level bid response object (i.e., the unnamed outer JSON object). The
idattribute reflects the bid request ID for logging purposes. Similarly,bididis an optional response tracking ID for bidders. If specified, it can be included in the subsequent win notice call if the bidder wins. At least oneseatbidobject is required, which contains at least one bid for an impression. Other attributes are optional. To express a “no-bid”, the options are to return an empty response with HTTP 204. Alternately if the bidder wishes to convey to the exchange a reason for not bidding, just aBidResponseobject is returned with a reason code in thenbrattribute. - SeatBid§4.2.24 字段1 required一个竞价响应可包含多个 SeatBid 对象,每个代表一个不同的竞价方席位(bidder seat),各含一条或多条独立出价。若请求中呈现了多个展示,可用 group 属性指明该席位是愿意接受其能赢下的任何展示(默认),还是只有在能整组赢下时才感兴趣。译稿校对中ENA bid response can contain multiple
SeatBidobjects, each on behalf of a different bidder seat and each containing one or more individual bids. If multiple impressions are presented in the request, thegroupattribute can be used to specify if a seat is willing to accept any impressions that it can win (default) or if it is only interested in winning any if it can win them all as a group. - Bid§4.2.333 字段3 required5 枚举1 废弃一个 SeatBid 对象包含一个或多个 Bid 对象,每个 Bid 通过 impid 属性关联竞价请求中的某一具体展示,并构成以给定价格(price)购买该展示的要约。译稿校对中ENA
SeatBidobject contains one or moreBidobjects, each of which relates to a specific impression in the bid request via theimpidattribute and constitutes an offer to buy that impression for a givenprice.