OpenRTB 2.5
What this release is
OpenRTB 2.5 was the workhorse version of the header-bidding era and remained the most common declared version for years. It added the Source object for upstream decisioning context, the Metric object for viewability signals, video placement-type signaling, seat blocking (bseat), creative language allow-listing, loss-notice macros, and the expanded response notice URLs (burl and friends).
Available coverage
- Release documentation
- Available
- Extracted object catalog
- Available
- JSON Schemas
- Available
- Exact-snapshot validation
- Supported
What changed in 2.5
| Change | Kind | Summary |
|---|---|---|
| bid.burl | Added field | OpenRTB 2.5 expanded bid response notice URLs and creative metadata fields. |
| bidrequest.bseat | Added field | OpenRTB 2.5 added buyer seat blocking and creative language allow-listing on the bid request. |
| bidrequest.source | Added field | OpenRTB 2.5 added the Source object to model upstream decisioning and header bidding context. |
| imp.metric | Added field | OpenRTB 2.5 introduced the Metric object for historical viewability, CTR, and similar signals. |
| imp.video.placement | Added field | OpenRTB 2.5 added video placement-type and playback-cessation signaling. |
| macro.${AUCTION_MBR} | Added macro | OpenRTB 2.5 added auction minimum-bid and loss-notice macros. |
Validate against 2.5
The tester can pin validation to this exact revision, so deprecated, moved, and not-yet-available findings reflect what 2.5 actually says. The same pin works in the CLI: rtblint validate --version 2.5 request.json.
Adjacent versions
- Previous: OpenRTB 2.4
- Next: OpenRTB 2.6-202204
- All versions: version index
- Migrating across the big steps: 2.5 vs 2.6 and 2.6 vs 3.0