ORTB
中 / EN

Native§3.2.9 · Bid Request

This 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.

AttributeTypeDescription
request
required
stringRequest 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
stringVersion of the Dynamic Native Ads API to which request complies; highly recommended for efficient parsing.
api
integer[]List 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.
Enum API Frameworks · 10 values
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[]Blocked creative attributes. Refer to List: Creative Attributes in AdCOM.
Enum Creative Attributes · 24 values
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 more values in the enumerations overview →
ext
objectPlaceholder for exchange-specific extensions to OpenRTB.

Field descriptions are published in the official IAB Tech Lab OpenRTB 2.6 spec (CC-BY 3.0) · enumeration values sourced from AdCOM 1.0 · first-draft proofreading