ORTB
中 / EN

Native 1.1

Objects
13
Fields
62
Data baseline: OCR transcript of the official legacy PDF, collected on 2026-08-25 · CC-BY 3.0 (IAB / IAB Tech Lab)

This version's data comes from an OCR transcript of the official legacy PDF, reviewed table by table before ingestion, and is in draft status; audit fixes and faithfully kept official quirks are registered in the object notes and provenance record.

Bid Request side (§4)

Native Markup Request§4.110 fields1 requiredThe 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.
Asset Request§4.27 fields1 requiredThe main container object for each asset requested or supported by Exchange on behalf of the rendering client. Any object that is required is to be flagged as such. Only one of the {title,img,video,data} objects should be present in each object. All others should be null/absent. The id is to be unique within the AssetObject array so that the response can be aligned.
Title Request§4.32 fields1 requiredThe Title object is to be used for title element of the Native ad.
Image Request§4.47 fieldsThe Image object to be used for all image elements of the Native ad such as Icons, Main Image, etc. Recommended sizes and aspect ratios are included in the Image Asset Types section.
Video Request§4.55 fields4 requiredThe video object to be used for all video elements supported in the Native Ad. This corresponds to the Video object of OpenRTB. Exchange implementers can impose their own specific restrictions. Here are the required attributes of the Video Object. For optional attributes please refer to OpenRTB.
Data Request§4.63 fields1 requiredThe Data Object is to be used for all non-core elements of the native unit such as Brand Name, Ratings, Review Count, Stars, Download count, descriptions etc. It is also generic for future native elements not contemplated at the time of the writing of this document. In some cases, additional recommendations are also included in the Data Asset Types table.

Bid Response side (§5)

Native Markup Response§5.16 fields2 requiredThe native object is the top level JSON object which identifies a native response. The native object has following attributes:
Asset Response§5.28 fields1 requiredCorresponds to the Asset Object in the request. The main container object for each asset requested or supported by Exchange on behalf of the rendering client. Any object that is required is to be flagged as such. Only one of the {title,img,video,data} objects should be present in each object. All others should be null/absent. The id is to be unique within the AssetObject array so that the response can be aligned.
Title Response§5.32 fields1 requiredCorresponds to the Title Object in the request, with the value filled in.
Image Response§5.44 fields1 requiredCorresponds to the Image Object in the request. The Image object to be used for all image elements of the Native ad such as Icons, Main Image, etc.
Data Response§5.53 fields1 requiredCorresponds to the Data Object in the request, with the value filled in. The Data Object is to be used for all miscellaneous elements of the native unit such as Brand Name, Ratings, Review Count, Stars, Downloads, Price count etc. It is also generic for future native elements not contemplated at the time of the writing of this document.
Video Response§5.61 fields1 requiredCorresponds to the Video Object in the request, yet containing a value of a conforming VAST tag as a value.
Link Response§5.74 fields1 requiredUsed for 'call to action' assets, or other links from the Native ad. This Object should be associated to its peer object in the parent Asset Object or as the master link in the top level Native Ad response object. When that peer object is activated (clicked) the action should take the user to the location of the link.
EnumerationsOfficial samples