Imp.refresh

A Refresh object describing how this ad slot reloads automatically: what triggers it, the minimum interval, and how many times it has refreshed already. Added in OpenRTB 2.6-202303.

CurrentobjectOptionalSince 2.6-202303

Field facts

Path: imp.refresh
Object: Imp
Type: object
Requirement: Optional
Added: OpenRTB 2.6-202303
Spec section: 3.2.4

How it is used

A refreshing slot shows several ads in one page view, and buyers often value later refreshes differently from the first ad. Declaring refresh here lets them price that from the request instead of discovering it in their own logs.

Example

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

{
  "id": "req-1",
  "imp": [
    {
      "refresh": {
        "refsettings": [
          {
            "reftype": 3,
            "minint": 30
          }
        ],
        "count": 2
      }
    }
  ]
}

Version history

Added in OpenRTB 2.6-202303, 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.6-202303	Listed in this release's notes; IAB's tagged spec file for it does not include the field yet.
2.6-202309 to 2.6-202606	object	No	No

Versioned rules that name this field

openrtb.2.6-202303.imp.refresh OpenRTB 2.6-202303 added refresh signaling and refsettings guidance.

Related fields

Other Imp fields

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