Native Markup Request§4.1 · Bid Request
The Native Object defines the native advertising opportunity available for bid via this bid request. It will be included as a JSON-encoded string in the bid request’s imp.native field or as a direct JSON object, depending on the choice of the exchange. While OpenRTB 2.x officially supports only JSON-encoded strings, many exchanges have implemented a formal object. Check with your integration docs. The Default column dictates how optional parameters should be interpreted if explicit values are not provided.
| Attribute | Type | Requirement | Default | Description |
|---|---|---|---|---|
| ver | string | optional | 1.2 | Version of the Native Markup version in use. |
| context | integer | recommended | — | The context in which the ad appears. See Table of Context IDs below for a list of supported context types.value table §7.1 Context Type IDs |
| contextsubtype | integer | optional | — | A more detailed context in which the ad appears. See Table of Context SubType IDs below for a list of supported context subtypes.value table §7.2 Context Sub Type IDs |
| plcmttype | integer | recommended | — | The design/format/layout of the ad unit being offered. See Table of Placement Type IDs below for a list of supported placement types.value table §7.3 Placement Type IDs |
| plcmtcnt | integer | optional | 1 | The number of identical placements in this Layout. Refer Section 8.1 Multiplacement Bid Requests for further detail. |
| seq | integer | optional | 0 | 0 for the first ad, 1 for the second ad, and so on. Note this would generally NOT be used in combination with plcmtcnt - either you are auctioning multiple identical placements (in which case plcmtcnt>1, seq=0) or you are holding separate auctions for distinct items in the feed (in which case plcmtcnt=1, seq=>=1). |
| assets | object[] | required | — | An array of Asset Objects. Any bid response must comply with the array of elements expressed in the bid request. |
| aurlsupport | integer | optional | 0 | Whether the supply source / impression supports returning an assetsurl instead of an asset object. 0 or the absence of the field indicates no such support. |
| durlsupport | integer | optional | 0 | Whether the supply source / impression supports returning a dco url instead of an asset object. 0 or the absence of the field indicates no such support. Beta feature. |
| eventtrackers | object[] | optional | — | Specifies what type of event tracking is supported - see Event Trackers Request Object. |
| privacy | integer | recommended | 0 | Set to 1 when the native ad supports buyer-specific privacy notice. Set to 0 (or field absent) when the native ad doesn’t support custom privacy links or if support is unknown. |
| ext | object | optional | — | This object is a placeholder that may contain custom JSON agreed to by the parties to support flexibility beyond the standard defined in this specification. |
Notes
Note: Prior to VERSION 1.1, the specification could be interpreted as requiring the native request to have a root node with a single field “native” that would contain the object above as its value. The Native Markup Request Object specified above is now the root object.
Content faithfully follows the IAB Tech Lab OpenRTB Native Ads 1.2 official spec (CC-BY 3.0).