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 idKindPaths
openrtb.2.0.device.geoAdded behaviordevice.geo
openrtb.2.0.device.ifaAdded fielddevice.ifa
openrtb.2.0.imp.videoAdded objectimp.video
openrtb.2.0.user.dataAdded fielduser.data

OpenRTB 2.1 3 rules

Change idKindPaths
openrtb.2.1.enum.content_category.tier2Added listenum.content_category.tier2
openrtb.2.1.geo.typeAdded fieldgeo.type
openrtb.2.1.imp.video.behaviorAdded behaviorimp.video

OpenRTB 2.2 4 rules

Change idKindPaths
openrtb.2.2.imp.secureAdded fieldimp.secure
openrtb.2.2.pmp.dealsAdded behaviorimp.pmp.deals
openrtb.2.2.regs.coppaAdded fieldregs.coppa
openrtb.2.2.traffic.feedback.botAdded guidancetraffic.feedback.bot

OpenRTB 2.3.1 2 rules

Change idKindPaths
openrtb.2.3.1.macro.auction_bid_idAdded behaviormacro.${AUCTION_BID_ID}
openrtb.2.3.1.user.buyeruidCorrected fielduser.buyuid

OpenRTB 2.3 3 rules

Change idKindPaths
openrtb.2.3.imp.nativeAdded objectimp.native
openrtb.2.3.imp.native.requestAdded fieldimp.native.request
openrtb.2.3.native.assetsAdded behaviornative.assets

OpenRTB 2.4 4 rules

Change idKindPaths
openrtb.2.4.geo.locationAdded behaviorgeo
openrtb.2.4.imp.audioAdded objectimp.audio
openrtb.2.4.imp.secure.sslAdded behaviorimp.secure
openrtb.2.4.imp.video.skipAdded fieldimp.video.skip

OpenRTB 2.5 6 rules

Change idKindPaths
openrtb.2.5.bid.response_urlsAdded fieldbid.burl, bid.lurl, bid.tactic, bid.language, bid.wratio, bid.hratio
openrtb.2.5.bidrequest.bseat_wlangAdded fieldbidrequest.bseat, bidrequest.wlang
openrtb.2.5.bidrequest.sourceAdded fieldbidrequest.source
openrtb.2.5.imp.metricAdded fieldimp.metric, metric
openrtb.2.5.imp.video.placementAdded fieldimp.video.placement, imp.video.playbackend
openrtb.2.5.macro.lossAdded macromacro.${AUCTION_MBR}, macro.${AUCTION_LOSS}

OpenRTB 2.6-202211 3 rules

Change idKindPaths
openrtb.2.6-202211.imp_qty_bidrequest_doohAdded objectimp.qty, bidrequest.dooh
openrtb.2.6-202211.inventorypartnerdomainMoved fieldsite.ext.inventorypartnerdomain, app.ext.inventorypartnerdomain
openrtb.2.6-202211.regs.gppAdded fieldregs.gpp, regs.gpp_sid

OpenRTB 2.6-202303 4 rules

Change idKindPaths
openrtb.2.6-202303.imp.refreshAdded objectimp.refresh, refresh.refsettings
openrtb.2.6-202303.imp.video.placementDeprecated fieldimp.video.placement
openrtb.2.6-202303.imp.video.plcmtAdded fieldimp.video.plcmt
openrtb.2.6-202303.macro.auction_imp_tsAdded macromacro.${AUCTION_IMP_TS}

OpenRTB 2.6-202309 3 rules

Change idKindPaths
openrtb.2.6-202309.bidrequest.acatAdded fieldbidrequest.acat
openrtb.2.6-202309.deal.floor_fieldsAdded fielddeal.guaranteed, deal.mincpmpersec
openrtb.2.6-202309.durfloorsAdded objectimp.video.durfloors, imp.audio.durfloors, deal.durfloors

OpenRTB 2.6-202402 1 rule

Change idKindPaths
openrtb.2.6-202402.imp.video.poddedupeAdded fieldimp.video.poddedupe

OpenRTB 2.6-202409 2 rules

Change idKindPaths
openrtb.2.6-202409.cookie_sync_guidanceAdded guidanceappendix.cookie_sync
openrtb.2.6-202409.eid.matchingAdded fieldeid.inserter, eid.matcher, eid.mm

OpenRTB 2.6-202501 1 rule

Change idKindPaths
openrtb.2.6-202501.content.gtax_genresAdded fieldcontent.gtax, content.genres

OpenRTB 2.6-202505 1 rule

Change idKindPaths
openrtb.2.6-202505.data.cidsAdded fielddata.cids

OpenRTB 2.6-202606 2 rules

Change idKindPaths
openrtb.2.6-202606.content.livenessAdded fieldcontent.realtime, content.firstbroadcast
openrtb.2.6-202606.macro.auction_discountAdded macromacro.${AUCTION_DISCOUNT_PCT}, macro.${AUCTION_DISCOUNT_CPM}

OpenRTB 2.6-202204 14 rules

Change idKindPaths
openrtb.2.6.bid.apisAdded fieldbid.apis
openrtb.2.6.bid.mtypeAdded fieldbid.mtype
openrtb.2.6.cattaxAdded fieldbidrequest.cattax, site.cattax, app.cattax, publisher.cattax, content.cattax, producer.cattax, bid.cattax
openrtb.2.6.deprecated_fieldsDeprecated fieldimp.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_ssaiAdded fieldimp.rwdd, imp.ssai
openrtb.2.6.imp.video_audio.pod_biddingAdded fieldimp.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.rqddursAdded fieldimp.video.rqddurs, imp.audio.rqddurs
openrtb.2.6.language.bcp47Added behaviorlanguage.bcp47
openrtb.2.6.macro.min_to_winAdded macromacro.${AUCTION_MIN_TO_WIN}
openrtb.2.6.network_channel_supplychain_eidsAdded objectnetwork, channel, source.schain, source.schain.nodes, user.eids, eid.uids
openrtb.2.6.regs.gdprMoved fieldregs.ext.gdpr
openrtb.2.6.removed_deprecated_fieldsRemoved fieldbanner.wmax, banner.hmax, banner.wmin, banner.hmin, video.protocol, content.videoquality
openrtb.2.6.user_agent_brandversionAdded objectdevice.sua, brandversion
openrtb.2.6.user.consentMoved fielduser.ext.consent

OpenRTB 3.0 7 rules

Change idKindPaths
openrtb.3.0.ads_certAdded behaviorinventory_authentication.ads.cert
openrtb.3.0.eventsAdded objectevent.pending, event.billing, event.loss
openrtb.3.0.itemStructural shiftrequest.item
openrtb.3.0.macro_objectAdded objectresponse.macro
openrtb.3.0.openrtb_rootStructural shiftopenrtb
openrtb.3.0.request_responseStructural shiftrequest, response
openrtb.3.0.version_headerAdded headerheader.x-openrtb-version