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.
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.
| 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 | integer | Recommended | No |