Imp.native

A Native object, present when the impression is offered as native. The asset request itself travels inside it as a JSON-encoded string in Native.request. Added in OpenRTB 2.3.

CurrentobjectOptionalSince 2.3

Field facts

Path: imp.native
Object: Imp
Type: object
Requirement: Optional
Added: OpenRTB 2.3
Spec section: 3.2.4

Example

Where the field sits in a payload, with everything else left out:

{
  "id": "req-1",
  "imp": [
    {
      "native": {
        "ver": "1.2",
        "request": "{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"len\":90}}]}"
      }
    }
  ]
}

Common mistakes

Putting the decoded native request object straight at imp.native instead of inside a Native object whose request field holds it as a string.

Version history

Added in OpenRTB 2.3, and present in the latest snapshot. The table shows how each version's spec text types the field.

Versions	Type in the spec	Required	Deprecated
2.3 to 2.4	object	No	No
2.5 to 2.6-202606	object	No	No

Versioned rules that name this field

openrtb.2.3.imp.native OpenRTB 2.3 introduced native ad placements directly on the impression object.

Related fields

Other Imp fields

For a walkthrough of the whole object, read Bid request anatomy.