Native section navigation
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.
On this page
| 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.