该对象表示原生(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 Native as a subordinate of the Imp object indicates that this impression is offered as a native type impression. At the publisher’s discretion, that same impression may also be offered as Banner, Video, and/or Audio by also including as Imp subordinates objects of those types. However, any given bid for the impression must conform to one of the offered types.
| Attribute | Type | Description |
|---|---|---|
| request required | string | 符合原生广告规范(Native Ad Specification,https://github.com/InteractiveAdvertisingBureau/Native-Ads)的请求载荷。载荷的根节点 “native” 已在原生广告规范 1.1 中移除。对于 Native 1.0,这是一个 JSON 编码字符串,由一个未命名根对象构成,其下含唯一子对象 “native”(即 Native Markup Request 对象,见 OpenRTB Native 1.0 规范第 4.1 节);对于 Native 1.1 及以上,这是一个 JSON 编码字符串,由一个未命名根对象构成,该根对象本身即 Native Markup Request Object(见 OpenRTB Native 1.1+ 规范第 4.1 节)。译稿校对中ENRequest payload complying with the Native Ad Specification. The root node of the payload, "native", was dropped in the Native Ads Specification 1.1. For Native 1.0, this is a JSON-encoded string consisting of a unnamed root object, with a single subordinate object named 'native', which is the Native Markup Request object, section 4.1 of OpenRTB Native 1.0 specification. For Native 1.1 and higher, this is a JSON-encoded string consisting of an unnamed root object which is itself the Native Markup Request Object, section 4.1 of OpenRTB Native 1.1+ . |
| ver | string | request 所遵循的 Dynamic Native Ads API 版本;强烈建议传递,以便高效解析。译稿校对中ENVersion of the Dynamic Native Ads API to which request complies; highly recommended for efficient parsing. |
| api | integer[] | 该展示所支持的 API 框架列表。参见 AdCOM 列表:API 框架(List: API Frameworks)。未明确列出的 API 视为不支持。译稿校对中ENList of supported API frameworks for this impression. Refer to List: API Frameworks in AdCOM. If an API is not explicitly listed, it is assumed not to be supported.枚举 API Frameworks · 10 个值1VPAID 1.0 2VPAID 2.0 3MRAID 1.0 4ORMMA 5MRAID 2.0 6MRAID 3.0 7OMID 1.0 8SIMID 1.0 9SIMID 1.1 500+Vendor-specific codes. |
| battr | integer[] | 被拦截的创意属性。参见 AdCOM 列表:创意属性(List: Creative Attributes)。译稿校对中ENBlocked creative attributes. Refer to List: Creative Attributes in AdCOM.枚举 Creative Attributes · 24 个值1Audio Ad (Autoplay) 2Audio Ad (User Initiated) 3Expandable (Automatic) 4Expandable (User Initiated - Click) 5Expandable (User Initiated - Rollover) 6In-Banner Video Ad (Autoplay) 7In-Banner Video Ad (User Initiated) 8Pop (e.g., Over, Under, or Upon Exit) 9Provocative or Suggestive Imagery 10Shaky, Flashing, Flickering, Extreme Animation, Smileys 11Surveys 12Text Only 其余 12 个值见枚举总览 → |
| ext | object | 供交易平台(exchange)对 OpenRTB 进行专属扩展(exchange-specific extensions)的占位对象。译稿校对中ENPlaceholder for exchange-specific extensions to OpenRTB. |
译注
译者注Native:Imp 的子对象,其出现即表示该展示以原生类型提供;业内文档一般保留英文对象名 Native。原生广告单元旨在与周围内容无缝融合(如赞助帖子),响应必须结构良好以便发布方细粒度控制渲染。译稿校对中
request 的版本兼容要求:Native 1.0 与 1.1+ 的载荷结构不同(后者移除了 “native” 根节点);解析时必须先读 ver 再选择对应的解码路径,不应假设固定结构。新接入方应直接使用 Native 1.1+。译稿校对中
不透明字符串设计的取舍:request 以不透明字符串传输,使参数演进由 Dynamic Native Ads API 独立管辖;代价是交易平台无法审计其内容,买方需自行校验载荷合法性,避免因非法载荷导致填充失败。译稿校对中
字段描述收录自 IAB Tech Lab OpenRTB 2.6 官方规范(CC-BY 3.0)· 枚举值来源 AdCOM 1.0 · 初稿校对中