Docs
OpenRTB rule catalog
64 versioned rules across OpenRTB 2.0 through 3.0, one per field that was added, deprecated, moved, removed, or corrected in a release. Each links to its own page with what it means, why it matters, and how to fix it. For the diagnostic codes the validator emits, see the rule reference.
OpenRTB 2.0 4 rules
| Change id | Kind | Paths |
|---|---|---|
| openrtb.2.0.device.geo | Added behavior | device.geo |
| openrtb.2.0.device.ifa | Added field | device.ifa |
| openrtb.2.0.imp.video | Added object | imp.video |
| openrtb.2.0.user.data | Added field | user.data |
OpenRTB 2.1 3 rules
| Change id | Kind | Paths |
|---|---|---|
| openrtb.2.1.enum.content_category.tier2 | Added list | enum.content_category.tier2 |
| openrtb.2.1.geo.type | Added field | geo.type |
| openrtb.2.1.imp.video.behavior | Added behavior | imp.video |
OpenRTB 2.2 4 rules
| Change id | Kind | Paths |
|---|---|---|
| openrtb.2.2.imp.secure | Added field | imp.secure |
| openrtb.2.2.pmp.deals | Added behavior | imp.pmp.deals |
| openrtb.2.2.regs.coppa | Added field | regs.coppa |
| openrtb.2.2.traffic.feedback.bot | Added guidance | traffic.feedback.bot |
OpenRTB 2.3.1 2 rules
| Change id | Kind | Paths |
|---|---|---|
| openrtb.2.3.1.macro.auction_bid_id | Added behavior | macro.${AUCTION_BID_ID} |
| openrtb.2.3.1.user.buyeruid | Corrected field | user.buyuid |
OpenRTB 2.3 3 rules
| Change id | Kind | Paths |
|---|---|---|
| openrtb.2.3.imp.native | Added object | imp.native |
| openrtb.2.3.imp.native.request | Added field | imp.native.request |
| openrtb.2.3.native.assets | Added behavior | native.assets |
OpenRTB 2.4 4 rules
| Change id | Kind | Paths |
|---|---|---|
| openrtb.2.4.geo.location | Added behavior | geo |
| openrtb.2.4.imp.audio | Added object | imp.audio |
| openrtb.2.4.imp.secure.ssl | Added behavior | imp.secure |
| openrtb.2.4.imp.video.skip | Added field | imp.video.skip |
OpenRTB 2.5 6 rules
| Change id | Kind | Paths |
|---|---|---|
| openrtb.2.5.bid.response_urls | Added field | bid.burl, bid.lurl, bid.tactic, bid.language, bid.wratio, bid.hratio |
| openrtb.2.5.bidrequest.bseat_wlang | Added field | bidrequest.bseat, bidrequest.wlang |
| openrtb.2.5.bidrequest.source | Added field | bidrequest.source |
| openrtb.2.5.imp.metric | Added field | imp.metric, metric |
| openrtb.2.5.imp.video.placement | Added field | imp.video.placement, imp.video.playbackend |
| openrtb.2.5.macro.loss | Added macro | macro.${AUCTION_MBR}, macro.${AUCTION_LOSS} |
OpenRTB 2.6-202211 3 rules
| Change id | Kind | Paths |
|---|---|---|
| openrtb.2.6-202211.imp_qty_bidrequest_dooh | Added object | imp.qty, bidrequest.dooh |
| openrtb.2.6-202211.inventorypartnerdomain | Moved field | site.ext.inventorypartnerdomain, app.ext.inventorypartnerdomain |
| openrtb.2.6-202211.regs.gpp | Added field | regs.gpp, regs.gpp_sid |
OpenRTB 2.6-202303 4 rules
| Change id | Kind | Paths |
|---|---|---|
| openrtb.2.6-202303.imp.refresh | Added object | imp.refresh, refresh.refsettings |
| openrtb.2.6-202303.imp.video.placement | Deprecated field | imp.video.placement |
| openrtb.2.6-202303.imp.video.plcmt | Added field | imp.video.plcmt |
| openrtb.2.6-202303.macro.auction_imp_ts | Added macro | macro.${AUCTION_IMP_TS} |
OpenRTB 2.6-202309 3 rules
| Change id | Kind | Paths |
|---|---|---|
| openrtb.2.6-202309.bidrequest.acat | Added field | bidrequest.acat |
| openrtb.2.6-202309.deal.floor_fields | Added field | deal.guaranteed, deal.mincpmpersec |
| openrtb.2.6-202309.durfloors | Added object | imp.video.durfloors, imp.audio.durfloors, deal.durfloors |
OpenRTB 2.6-202402 1 rule
| Change id | Kind | Paths |
|---|---|---|
| openrtb.2.6-202402.imp.video.poddedupe | Added field | imp.video.poddedupe |
OpenRTB 2.6-202409 2 rules
| Change id | Kind | Paths |
|---|---|---|
| openrtb.2.6-202409.cookie_sync_guidance | Added guidance | appendix.cookie_sync |
| openrtb.2.6-202409.eid.matching | Added field | eid.inserter, eid.matcher, eid.mm |
OpenRTB 2.6-202501 1 rule
| Change id | Kind | Paths |
|---|---|---|
| openrtb.2.6-202501.content.gtax_genres | Added field | content.gtax, content.genres |
OpenRTB 2.6-202505 1 rule
| Change id | Kind | Paths |
|---|---|---|
| openrtb.2.6-202505.data.cids | Added field | data.cids |
OpenRTB 2.6-202606 2 rules
| Change id | Kind | Paths |
|---|---|---|
| openrtb.2.6-202606.content.liveness | Added field | content.realtime, content.firstbroadcast |
| openrtb.2.6-202606.macro.auction_discount | Added macro | macro.${AUCTION_DISCOUNT_PCT}, macro.${AUCTION_DISCOUNT_CPM} |
OpenRTB 2.6-202204 14 rules
| Change id | Kind | Paths |
|---|---|---|
| openrtb.2.6.bid.apis | Added field | bid.apis |
| openrtb.2.6.bid.mtype | Added field | bid.mtype |
| openrtb.2.6.cattax | Added field | bidrequest.cattax, site.cattax, app.cattax, publisher.cattax, content.cattax, producer.cattax, bid.cattax |
| openrtb.2.6.deprecated_fields | Deprecated field | imp.video.sequence, imp.audio.sequence, device.didsha1, device.didmd5, device.dpidsha1, device.dpidmd5, device.macsha1, device.macmd5, user.yob, user.gender, bid.api |
| openrtb.2.6.imp.rwdd_ssai | Added field | imp.rwdd, imp.ssai |
| openrtb.2.6.imp.video_audio.pod_bidding | Added field | imp.video.maxseq, imp.video.poddur, imp.video.podid, imp.video.podseq, imp.video.mincpmpersec, imp.video.slotinpod, imp.audio.maxseq, imp.audio.poddur, imp.audio.podid, imp.audio.podseq, imp.audio.mincpmpersec, imp.audio.slotinpod |
| openrtb.2.6.imp.video_audio.rqddurs | Added field | imp.video.rqddurs, imp.audio.rqddurs |
| openrtb.2.6.language.bcp47 | Added behavior | language.bcp47 |
| openrtb.2.6.macro.min_to_win | Added macro | macro.${AUCTION_MIN_TO_WIN} |
| openrtb.2.6.network_channel_supplychain_eids | Added object | network, channel, source.schain, source.schain.nodes, user.eids, eid.uids |
| openrtb.2.6.regs.gdpr | Moved field | regs.ext.gdpr |
| openrtb.2.6.removed_deprecated_fields | Removed field | banner.wmax, banner.hmax, banner.wmin, banner.hmin, video.protocol, content.videoquality |
| openrtb.2.6.user_agent_brandversion | Added object | device.sua, brandversion |
| openrtb.2.6.user.consent | Moved field | user.ext.consent |
OpenRTB 3.0 7 rules
| Change id | Kind | Paths |
|---|---|---|
| openrtb.3.0.ads_cert | Added behavior | inventory_authentication.ads.cert |
| openrtb.3.0.events | Added object | event.pending, event.billing, event.loss |
| openrtb.3.0.item | Structural shift | request.item |
| openrtb.3.0.macro_object | Added object | response.macro |
| openrtb.3.0.openrtb_root | Structural shift | openrtb |
| openrtb.3.0.request_response | Structural shift | request, response |
| openrtb.3.0.version_header | Added header | header.x-openrtb-version |