Bid.hratio

The relative height of the creative when its size is expressed as a ratio, used for Flex Ads together with Bid.wratio. Added in 2.5.

CurrentintegerOptionalSince 2.5

Field facts

Path: seatbid.bid.hratio
Object: Bid
Type: integer
Requirement: Optional
Added: OpenRTB 2.5
Spec section: 4.2.3

How it is used

Pair it with wratio so the two values give the aspect ratio, for example 9 against a wratio of 16. The spec text for 2.6-202210 through 2.6-202303 misspelled the field as hration, and 2.6-202309 corrected it.

Example

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

{
  "seatbid": [
    {
      "bid": [
        {
          "hratio": 9
        }
      ]
    }
  ]
}

Common mistakes

Shipping the misspelled hration after copying a field list from one of those snapshots. Payloads have always used hratio.

Version history

Added in OpenRTB 2.5, and present in the latest snapshot. The spec text for 2.6-202210 to 2.6-202303 spelled it hration; payloads use hratio. The table shows how each version's spec text types the field.

Versions	Type in the spec	Required	Deprecated
2.5	integer	No	No
2.6-202210 to 2.6-202303	integer	No	No
2.6-202309 to 2.6-202606	integer	No	No

Related fields

Other Bid fields

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