Refresh.count

How many times this slot has refreshed since the page last loaded. Recommended. The first ad after a page load has a count of 0.

CurrentintegerRecommendedSince 2.6-202303

Field facts

Path
imp.refresh.count
Object
Refresh
Type
integer
Requirement
Recommended
Added
OpenRTB 2.6-202303
Spec section
3.2.33

How it is used

Buyers often value the first ad in a slot differently from the fifth, and this count is the standard way to tell them apart.

Example

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

{
  "id": "req-1",
  "imp": [
    {
      "refresh": {
        "count": 2
      }
    }
  ]
}

Common mistakes

  • Counting across page loads or whole sessions instead of starting again on each load.

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.

VersionsType in the specRequiredDeprecated
2.6-202303Listed in this release's notes; IAB's tagged spec file for it does not include the field yet.
2.6-202309 to 2.6-202606integerRecommendedNo

Related fields

Other Refresh fields