OpenRTB enumerated lists

The integer codes an OpenRTB bid request uses for device type, connection type, video placement, playback, API frameworks, creative attributes, protocols, position, and every other AdCOM list: 42 lists in all, each with its own page explaining the values.

Where the lists live now

As of OpenRTB 2.6, the request-side enumerated lists are kept in the AdCOM 1.0 specification (no-bid and loss reason codes live in the OpenRTB 3.0 document) so they can change without a new OpenRTB release. Field tables in 2.6 say things like "Refer to List: Device Types in AdCOM 1.0". In OpenRTB 2.5 and earlier the same lists sat in section 5 of the spec itself, so older integration docs cite section numbers (5.21 Device Types, 5.9 Video Placement Types) for values that are now AdCOM lists. The values below are the current AdCOM lists the RTBlint validator checks. See specification versions for what changed when.

Video and audio

Plcmt subtypes (video)

Used by imp.video.plcmt.

ValueName
1Instream
2Accompanying Content
3Interstitial
4No Content/Standalone
5Pause
6Screensaver
7Overlay
8Squeezeback
9In-scene

Creative subtypes (audio and video)

Used by imp.audio.protocols, seatbid.bid.protocol, imp.video.protocols.

ValueName
1VAST 1.0
2VAST 2.0
3VAST 3.0
4VAST 1.0 Wrapper
5VAST 2.0 Wrapper
6VAST 3.0 Wrapper
7VAST 4.0
8VAST 4.0 Wrapper
9DAAST 1.0
10DAAST 1.0 Wrapper
11VAST 4.1
12VAST 4.1 Wrapper
13VAST 4.2
14VAST 4.2 Wrapper
15VAST 4.3
16VAST 4.3 Wrapper

Playback methods

Used by imp.video.playbackmethod.

ValueName
1Initiates without any specific user interaction with Sound On
2Initiates without any specific user interaction Sound Off by Default
3Initiates on Click with Sound On
4Initiates on Mouse-Over or cursor over with Sound On
5Initiates on Entering Viewport or scrolling into view with Sound On
6Initiates on Entering Viewport or scrolling into view with Sound Off by Default
7Continuous Playback
8Initiated by user pausing content, Sound on
9Initiated by user pausing content, Sound off
10Initiated by idling
11Initiated by idling

Playback cessation modes

Used by imp.video.playbackend.

ValueName
1On Video Completion or when Terminated by User
2On Leaving Viewport or when Terminated by User
3On Leaving Viewport Continues as a Floating/Slider Unit

Start delay modes

Used by imp.audio.startdelay, imp.video.startdelay.

ValueName
>0Mid-Roll (the value is the start delay in seconds)
0Pre-Roll
-1Generic Mid-Roll
-2Generic Post-Roll

Linearity modes

Used by imp.video.linearity.

ValueName
1Linear
2Non-Linear (i.e., Overlay)

Companion types

Used by imp.audio.companiontype, imp.video.companiontype.

ValueName
1Static Resource
2HTML Resource
3iframe Resource

Delivery methods

Used by imp.audio.delivery, imp.video.delivery.

ValueName
1Streaming
2Progressive
3Download

Feed types

Used by imp.audio.feed.

ValueName
1Music Streaming Service
2FM/AM Broadcast
3Podcast
4Catch-up Radio
5Web Radio
6Video Game
7Text to Speech
500+Vendor-specific codes

Volume normalization modes

Used by imp.audio.nvol.

ValueName
0None
1Ad Volume Average Normalized to Content
2Ad Volume Peak Normalized to Content
3Ad Loudness Normalized to Content
4Custom Volume Normalization

Pod deduplication

Used by imp.video.poddedupe.

ValueName
1Deduplicated on adomain
2Deduplicated on IAB Tech Lab Content Taxonomy
3Deduplicated on creative ID
4Deduplicated on mediafile URL
5No deduplication

Pod sequence

Used by imp.audio.podseq.

ValueName
-1Last pod in the content stream
0Any pod in the content stream
1First pod in the content stream

Slot position in pod

Used by imp.audio.slotinpod, seatbid.bid.slotinpod, imp.video.slotinpod.

ValueName
-1Last ad in the pod
0Any ad in the pod
1First ad in the pod
2First or Last ad in the pod

Production qualities

Used by app.content.prodq.

ValueName
0Unknown
1Professionally Produced
2Prosumer
3User Generated (UGC)

Ad placement and creative

Placement positions

Used by imp.banner.pos, imp.video.pos.

ValueName
0Unknown
1Above The Fold
2Locked (fixed position)
3Below The Fold
4Header
5Footer
6Sidebar
7Fullscreen
8Partial Screen
9Top Left
10Top Right
11Frame the content
12Double box
13Double box with background
14Bottom Left
15Bottom Right
16L shape
17Reversed L shape

API frameworks

Used by imp.audio.api, imp.banner.api, seatbid.bid.apis, imp.native.api, imp.video.api.

ValueName
1VPAID 1.0
2VPAID 2.0
3MRAID 1.0
4ORMMA
5MRAID 2.0
6MRAID 3.0
7OMID 1.0
8SIMID 1.0
9SIMID 1.1
500+Vendor-specific codes

Creative attributes

Used by imp.audio.battr, imp.banner.battr, seatbid.bid.attr, imp.native.battr, imp.video.battr.

ValueName
1Audio Ad (Autoplay)
2Audio Ad (User Initiated)
3Expandable (Automatic)
4Expandable (User Initiated - Click)
5Expandable (User Initiated - Rollover)
6In-Banner Video Ad (Autoplay)
7In-Banner Video Ad (User Initiated)
8Pop (e.g., Over, Under, or Upon Exit)
9Provocative or Suggestive Imagery
10Shaky, Flashing, Flickering, Extreme Animation, Smileys
11Surveys
12Text Only
13User Interactive (e.g., Embedded Games)
14Windows Dialog or Alert Style
15Has Audio On/Off Button
16Ad Provides Skip Button
17Adobe Flash
18Responsive, sizeless or fluid
19Contains advertiser QR code
20Supports alpha channel transparency
21Static visual
22Limited motion (cinemagraph)
23Full-motion video
500+Vendor-specific codes

Expandable directions

Used by imp.banner.expdir.

ValueName
1Left
2Right
3Up
4Down
5Full Screen
6Resize or minimize

Auto refresh triggers

Used by imp.refresh.refsettings.reftype.

ValueName
0Unknown
1User Action
2Event
3Time

Device, location, and connection

Device types

Used by device.devicetype.

ValueName
1Mobile/Tablet - General
2Personal Computer
3Connected TV
4Phone
5Tablet
6Connected Device
7Set Top Box
8OOH Device

Connection types

Used by device.connectiontype.

ValueName
1Ethernet; Wired Connection
2WIFI
3Cellular Network - Unknown Generation
4Cellular Network - 2G
5Cellular Network - 3G
6Cellular Network - 4G
7Cellular Network - 5G

Operating systems

ValueName
0Other Not Listed
13DS System Software
2Android
3Apple TV Software
4Asha
5Bada
6BlackBerry
7BREW
8ChromeOS
9Darwin
10FireOS
11FirefoxOS
12HelenOS
13iOS
14Linux
15MacOS
16MeeGo
17MorphOS
18NetBSD
19NucleusPLUS
20PS Vita System Software
21PS3 System Software
22PS4 Software
23PSP System Software
24Symbian
25Tizen
26WatchOS
27WebOS
28Windows
500+Vendor-specific codes

Location types

Used by device.geo.type.

ValueName
1GPS/Location Services
2IP Address
3User Provided (e.g., registration data)

IP location services

Used by device.geo.ipservice.

ValueName
1ip2location
2Neustar (Quova)
3MaxMind
4NetAcuity (Digital Element)
51151Degrees (High Confidence)
51251Degrees (Medium Confidence)

User-Agent source

Used by device.sua.source.

ValueName
0Unspecified or unknown
1Client Hints, low entropy only
2Client Hints, with high entropy
3Parsed from the User-Agent header

Content and taxonomies

Content contexts

Used by app.content.context.

ValueName
1Video
2Game
3Music
4Application
5Text
6Other
7Unknown

Media ratings

Used by seatbid.bid.qagmediarating, app.content.qagmediarating.

ValueName
1All Audiences
2Everyone Over Age 12
3Mature Audiences

Category taxonomies

Used by app.cattax, seatbid.bid.cattax, cattax, app.content.cattax, app.content.gtax, app.content.producer.cattax, app.publisher.cattax, site.cattax.

ValueName
1IAB Tech Lab Content Category Taxonomy 1.0
2IAB Tech Lab Content Category Taxonomy 2.0
3IAB Tech Lab Ad Product Taxonomy 1.0
4IAB Tech Lab Audience Taxonomy 1.1
5IAB Tech Lab Content Taxonomy 2.1
6IAB Tech Lab Content Taxonomy 2.2
7IAB Tech Lab Content Taxonomy 3.0
8IAB Tech Lab Ad Product Taxonomy 2.0
9IAB Tech Lab Content Taxonomy 3.1
500+Vendor-specific codes

DOOH venue taxonomies

Used by dooh.venuetypetax.

ValueName
0AdCOM DOOH Venue Types (deprecated)
1OpenOOH Venue Taxonomy 1.0
2DPAA Device Venue Types
3DMI Categorization of Venues 1.1
4OMA taxonomy, January 2022
5OpenOOH Venue Taxonomy 1.1

DOOH multiplier measurement source types

Used by imp.qty.sourcetype.

ValueName
0Unknown
1Measurement Vendor Provided
2Publisher Provided
3Exchange Provided

Identity

ID match methods

Used by user.eids.mm.

ValueName
0Unknown
1No Match
2Browser Cookie Sync
3Authenticated
4Observed
5Inference
500+Vendor-specific

Agent types

Used by user.eids.uids.atype.

ValueName
1Browser or device
2In-app
3Person-based
500+Vendor-specific codes

Lists used by OpenRTB 3.0 and AdCOM objects

Display context types

ValueName
10Content-centric
11Article content
12Video content
13Audio content
14Image content
15User-generated content
20Social-centric
21Email
22Chat or instant messaging
30Product context
31App store or marketplace
32Product reviews
500+Vendor-specific codes

Display placement types

ValueName
1In-feed
2In the content unit
3Outside the core content
4Recommendation widget
500+Vendor-specific codes

Creative subtypes for display

ValueName
1HTML
2AMPHTML
3Structured Image Object
4Structured Native Object

Native data asset types

ValueName
1sponsored
2desc
3rating
4likes
5downloads
6price
7saleprice
8phone
9address
10desc2
11displayurl
12ctatext
500+Vendor-specific codes

Native image asset types

ValueName
1Icon
3Main
500+Vendor-specific codes

Event types

ValueName
1loaded
2impression
3viewable-mrc50
4viewable-mrc100
5viewable-video50
500+Vendor-specific codes

Event tracking methods

ValueName
1Image-Pixel
2JavaScript
500+Vendor-specific codes

Click types

ValueName
0Non-Clickable
1Clickable, details unknown
2Clickable, embedded browser or webview
3Clickable, native browser
500+Vendor-specific codes

Audit status codes

ValueName
1Pending Audit
2Pre-Approved
3Approved
4Denied
5Changed; Resubmission Requested
6Expired
500+Vendor-specific codes

Size units

ValueName
1Device independent pixels (DIPS)
2Inches
3Centimeters

Lists defined in OpenRTB itself

Auction type (at)

BidRequest.at, integer, default 2. Defined in the OpenRTB spec, not AdCOM.

ValueNameMeaning
1First PriceWinner pays what they bid.
2Second Price PlusWinner pays just above the second-highest bid; the spec default.
3Fixed price (deals only)On Deal.at, the deal's bidfloor is the agreed price.
500+Exchange-specificCustom auction types agreed with buyers.

Legacy video placement (placement)

Video.placement used OpenRTB 2.5 list 5.9. It is deprecated since 2.6-202303 in favor of Video.plcmt, whose list is on the plcmt page. The two lists do not map one to one; the placement versus plcmt guide explains the migration.

ValueNameMeaning
1In-StreamPre-, mid-, post-roll against requested video content.
2In-BannerVideo inside display banner inventory.
3In-ArticlePlayer loading between paragraphs of editorial content.
4In-FeedInside content, social, or product feeds.
5Interstitial/Slider/FloatingAlways on screen while displayed.

No-bid and loss reasons

BidResponse.nbr uses the no-bid reason codes, and the loss notice macro carries loss reason codes. Each code has its own page.

Questions people ask

Where are OpenRTB enum values defined?

Since OpenRTB 2.6, the request-side enumerated lists live in the AdCOM 1.0 specification, referenced from the 2.6 field tables as AdCOM lists; no-bid and loss reason codes live in the OpenRTB 3.0 document. In OpenRTB 2.5 and earlier the same lists were section 5 of the OpenRTB document itself. Most values match across the two homes; AdCOM has since added values the 2.5 lists never had.

What do enum values of 500 and above mean?

Where a list says so (auction type, API frameworks, creative attributes, no-bid reasons, and others), values 500 and greater are reserved for exchange-specific or vendor-specific use. They are only meaningful to partners who agreed on them beforehand, so a validator can accept them but cannot tell you what they mean.

Is video.placement still valid in OpenRTB 2.6?

It parses, but it was deprecated in the 2.6-202303 update in favor of video.plcmt, which uses a different list. Send plcmt; keep placement only for partners that have not migrated, and never assume the two lists share meanings.

Validate the enums you send

On OpenRTB 2.6 snapshots, RTBlint checks every integer field that points to an AdCOM list against the values above and reports anything else as openrtb.value.invalid. Paste a request into the tester to try it.