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.3/2.4 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.1 | Version of the Native Markup version in use. |
| layout | integer | recommended | — | The Layout ID of the native ad unit. See the Table of Layout IDs below. |
| adunit | integer | recommended | — | The Ad unit ID of the native ad unit. See Table of Ad Unit IDs below for a list of supported core ad units. |
| 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.3 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.4 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.5 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. |
| 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.
OCR 跨页断裂：assets 描述被续表行 'the array of elements expressed in the bid request.' 截断，人工合并。
Content faithfully follows the IAB Tech Lab OpenRTB Native Ads 1.1 official spec (CC-BY 3.0).