ORTB
中 / EN

Enumerations

OpenRTB 2.6 的枚举全部引用 AdCOM 1.0(共 42 个清单 / 303 个值,其中 31 个被 2.6 字段引用)。数据收录自 AdCOM v1.0 FINAL.md(CC-BY 3.0)。

The following table lists the options for taxonomies that can be used to describe content, audience, and ad creative categories.

1IAB Tech Lab Content Category Taxonomy 1.0: Deprecated, and recommend NOT be used since it does not have SCD flags.
2IAB Tech Lab Content Category Taxonomy 2.0: Deprecated, and recommend NOT be used since it does not have SCD flags.
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.

Creative Attributes

24 个值引用:Banner.battr · Video.skip · Video.battr · Audio.battr · Native.battr · Bid.attr

The following table specifies a standard list of creative attributes that can describe an actual ad or restrictions relative to a given placement.

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 (e.g. VPAID-rendered skip button on pre-roll video)
17Adobe Flash
18Responsive; Sizeless; Fluid (i.e., creatives that dynamically resize to environment)
19Contains advertiser QR Code
20Support alpha channel transparency
21Static Visual. Creative contains no perceptible motion and renders as a static visual, even if delivered in a video file format (e.g., MP4). No animated elements or time-based visual transitions are present.
22Limited Motion (Cinemagraph). Creative contains subtle or localized motion within an otherwise static composition. Motion is minimal, looped, and does not constitute full-scene animation or continuous narrative progression.
23Full-Motion Video. Creative contains continuous or scene-level motion typical of standard video assets, including dynamic visual transitions, camera movement, or narrative progression across frames.
500+Vendor-specific codes.

API Frameworks

10 个值引用:Banner.api · Video.api · Audio.api · Native.api · Bid.apis

The following table is a list of API frameworks either supported by a placement or required by an ad.

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 Subtypes - Audio/Video

16 个值引用:Video.protocols · Audio.protocols · Bid.protocol

The following table lists the various subtypes of audio and video ad creatives.

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

Placement Positions

18 个值引用:Banner.pos · Video.pos

The following table lists the placement positions as a relative measure of visibility or prominence. This table has values derived from the TAG Inventory Quality Guidelines (IQG).

0Unknown
1Above The Fold
2Locked (i.e., 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

Start Delay Modes

4 个值引用:Video.startdelay · Audio.startdelay

The following table lists the various options for the video or audio start delay. If the start delay value is greater than 0, then the position is mid-roll and the value indicates the start delay.

>0Mid-Roll (value indicates start delay in second)
0Pre-Roll
-1Generic Mid-Roll
-2Generic Post-Roll

Slot Position in Pod

4 个值引用:Video.slotinpod · Audio.slotinpod

The following table lists the values for the slot position in pod field, for use in audio and video ad pods.

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

Delivery Methods

3 个值引用:Video.delivery · Audio.delivery

The following table lists the various options for the delivery of video or audio content.

1Streaming
2Progressive
3Download

Companion Types

3 个值引用:Video.companiontype · Audio.companiontype

The following table lists the options to indicate markup types allowed for companion ads that apply to video and audio ads. This table is derived from VAST 2.0+ and DAAST 1.0+ specifications.

1Static Resource
2HTML Resource
3iframe Resource

Media Ratings

3 个值引用:Content.qagmediarating · Bid.qagmediarating

The following table lists the media ratings used in describing content based on the TAG Inventory Quality Guidelines (IQG) v2.1 categorization. Refer to www.iab.com/guidelines/digital-video-suite for more information.

1All Audiences
2Everyone Over Age 12
3Mature Audiences

Expandable Directions

6 个值引用:Banner.expdir

The following table lists the directions in which an expandable ad may expand, given the positioning of the ad unit on the page and constraints imposed by the content.

1Left
2Right
3Up
4Down
5Full Screen
6Resize/Minimize (make smaller)

Plcmt Subtypes - Video

9 个值引用:Video.plcmt

The following table lists the various types of video placements in accordance with updated IAB Digital Video Guidelines. To be sent using <code>plcmt</code> attribute in <strong>Object:Video</strong>. Please refer to the <a href=https://github.com/InteractiveAdvertisingBureau/openrtb2.x/blob/main/implementation.md#710---updated-video-signals>implementation guide</a> for examples and information on how to use the updated signals.

1Instream: Pre-roll, mid-roll, and post-roll ads that are played before, during or after the streaming video content that the consumer has requested. Instream video must be set to “sound on” by default at player start, or have explicitly clear user intent to watch the video content. While there may be other content surrounding the player, the video content must be the focus of the user’s visit. It should remain the primary content on the page and the only video player in-view capable of audio when playing. If the player converts to floating/sticky subsequent ad calls should accurately convey the updated player size.
2Accompanying Content: Pre-roll, mid-roll, and post-roll ads that are played before, during, or after streaming video content. The video player loads and plays before, between, or after paragraphs of text or graphical content, and starts playing only when it enters the viewport. Accompanying content should only start playback upon entering the viewport. It may convert to a floating/sticky player as it scrolls off the page.
3Interstitial:Video ads that are played without video content. During playback, it must be the primary focus of the page and take up the majority of the viewport and cannot be scrolled out of view. This can be in placements like in-app video or slideshows.
4No Content/Standalone: Video ads that are played without streaming video content. This can be in placements like slideshows, native feeds, in-content or sticky/floating.
5Pause: An ad present in streaming video content that the consumer has requested. While there may be other content surrounding the player, the video content must be the focus of the user’s visit. It should remain the primary content on the page and the only video player in-view.
6Screensaver: An ad present, when OS/App Screen Saver are initiated.
7Overlay: Ads occurring during program content and outside of the traditional ad break. The ad format places ad creatives over top of the program content, often as a banner or picture in picture execution. While there may be other content surrounding the player with the overlay, the player with the overlay must be the focus of the user’s visit. It should remain the primary content on the page and the primary video player in-view.
8Squeezeback: Ads Alongside or Adjacent to Content, also known as L-Shape Ads & Double Box, are ads that occur during program content and outside of the traditional ad break. The program content is resized to allow for placement of an ad on the screen. In a squeezeback, none of the content is covered by the ad, instead it shares screen space with the ad. This is the major distinction between squeezeback and overlay. While there may be other content surrounding the player with the squeezeback, the player with the squeezeback must be the focus of the user’s visit. It should remain the primary content on the page and the primary video player in-view.
9In-scene: A form of advertising that integrates branded elements directly within the content itself, rather than appearing as separate pre-roll, mid-roll, overlay, or display formats. In Scene Advertising is composited into the video content and blends the brand naturally into the scene, environment, or storyline, ensuring contextual relevance and viewer immersion without interrupting the user experience. In-scene ads typically consist of product placements or virtual out of A insertions. At this time, the standardization focuses on the out of home insertions in non-live content. While there may be other content surrounding the player with the in-scene ad, the player with the in-scene ad must be the focus of the user’s visit. It should remain the primary content on the page and the primary video player in-view.

Linearity Modes

2 个值引用:Video.linearity

The following table indicates the options for media linearity (typically video). This corresponds to the required type of VAST response, where a linear response is VAST containing video assets, and non-linear is a VAST response (typically) containing a banner/overlay.

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

Playback Methods

11 个值引用:Video.playbackmethod

The following table lists the various media playback methods.

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 - Media playback is set to play additional media automatically without user interaction. The media player will keep playing additional media (playlist or generated) for the user until the user actively stops this from happening.
8Initiated by user pausing content, Sound on
9Initiated by user pausing content, Sound off
10Initiated by idling (e.g. screensaver), Sound on
11Initiated by idling (e.g. screensaver), Sound off

Playback Cessation Modes

3 个值引用:Video.playbackend

The following table lists the various modes for when media playback terminates.

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 until Video Completion or when Terminated by User

Pod Deduplication Settings

5 个值引用:Video.poddedupe

The following table lists the various pod deduplication settings.

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

Pod Sequence

3 个值引用:Audio.podseq

The following table lists the values for the pod sequence field, for use in audio and video content streams with one or more ad pods.

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

Feed Types

8 个值引用:Audio.feed

The following table lists the types of feeds for audio.

1AOD Music streaming service
2LIVE FM/AM broadcast (live content broadcast over the air but also available via online streaming)
3AOD Podcast (original, pre-recorded content distributed as episodes in a series)
4AOD Catch-up radio (recorded segment of a radio show that was originally broadcast live)
5LIVE Web radio (live content only available via online streaming, not as AM/FM broadcast)
6MISC Video game (background audio in video games)
7MISC Text to speech (audio books, website plugin that can read article)
500+MISC Vendor-specific codes.

Volume Normalization Modes

5 个值引用:Audio.nvol

The following table lists the types of volume normalization modes, typically for audio.

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

Production Qualities

4 个值引用:Content.prodq

The following table lists the options for content quality. These values are defined by the IAB; refer to [www.iab.com/wp-content/uploads/2015/03/long-form-video-final.pdf](www.iab.com/wp-content/uploads/2015/03/long-form-video-final.pdf) for more information.

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

Content Contexts

7 个值引用:Content.context

The following table lists the various options for indicating the type of content being used or consumed by the user in which ads may appear. This table has values derived from the TAG Inventory Quality Guidelines (IQG).

1Video (i.e., video file or stream such as Internet TV broadcasts)
2Game (i.e., an interactive software game)
3Music (i.e., audio file or stream such as Internet radio broadcasts)
4Application (i.e., an interactive software application)
5Text (i.e., primarily textual document such as a web page, eBook, or news article)
6Other (i.e., none of the other categories applies)
7Unknown

Device Types

8 个值引用:Device.devicetype

The following table lists the types of devices. This table has values derived from the TAG Inventory Quality Guidelines (IQG).

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

Connection Types

7 个值引用:Device.connectiontype

The following table lists the options for the type of device connectivity.

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

Location Types

3 个值引用:Geo.type

The following table lists the options to indicate how the geographic information was determined.

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

IP Location Services

6 个值引用:Geo.ipservice

The following table lists the services and/or vendors used for resolving IP addresses to geolocations.

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

ID Match Methods

7 个值引用:EID.mm

The following table contains enumerations for various ways an ID could be matched to an ad request, and if they pertain to a single property or app. It should be used on conjunction with the <code>mm</code> attribute in <a href=https://github.com/InteractiveAdvertisingBureau/openrtb2.x/blob/main/2.6.md#3227---object-eid->Object: EID</a> of OpenRTB 2.x.

0Unknown
1No Match No matching has occurred. The associated ID came directly from a 3rd-party cookie or OS-provided resettable device ID for advertising (IFA).
2Browser Cookie Sync Real time cookie sync as described in Appendix: Cookie Based ID Syncing of OpenRTB 2.x
3Authenticated ID match was based on user authentication such as an email login or hashed PII
4Observed ID match was based on a 1st party observation, but without user authentication (e.g. GUID, SharedID, Session IDs, CHIPS or other 1st party cookies contained in localStorage)
5Inference ID match was inferred from linkage based on non-authenticated features across multiple browsers or devices (e.g. IP address and/or UserAgent)
500+Vendor Specific

Agent Types

4 个值引用:UID.atype

This list identifies the user agent types a user identifier is from.

1An ID which is tied to a specific web browser or device (cookie-based, probabilistic, or other).
2In-app impressions, which will typically contain a type of device ID (or rather, the privacy-compliant versions of device IDs).
3A person-based ID, i.e., that is the same across devices.
500+Vendor-specific codes.

User-Agent Source

4 个值引用:UserAgent.source

The following table lists the possible sources for User-Agent metadata.

0Unspecified/unknown
1User-Agent Client Hints (only low-entropy headers were available)
2User-Agent Client Hints (with high-entropy headers available)
3Parsed from User-Agent header (the same string carried by the ua field)

DOOH Multiplier Measurement Source Types

4 个值引用:Qty.sourcetype

The following table lists the types of entities that provide quantity measurement for impression multipliers, which are common in Out of Home advertising.

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

DOOH Venue Taxonomies

6 个值引用:DOOH.venuetypetax

The following table contains a list of supported taxonomies describing the locations and contexts in which Out-Of-Home media may be experienced. Taxonomies entries are expected to refer to a specific version, unless a given taxonomy has explicit semantics for forward compatibility and handling updates. The specifics of how to serialize values for a given taxonomy are expected to be defined by the given taxonomy.

0AdCom DOOH Venue Types (deprecated)
1OpenOOH Venue Taxonomy 1.0 https://github.com/openooh/venue-taxonomy/blob/main/specification-1.0.md
2DPAA Device Venue Types https://github.com/InteractiveAdvertisingBureau/AdCOM/blob/master/AdCOM%20v1.0%20FINAL.md#list--dooh-venue-types-
3DMI Categorization of Venues 1.1 https://www.dmi-org.com/download/DMI_Standards_for_DOOH_Venues.pdf
4OMA taxonomy Jan 2022 https://www.oma.org.au/industry-standards
5OpenOOH Venue Taxonomy 1.1 https://github.com/openooh/venue-taxonomy/blob/main/specification-1.1.md

Auto Refresh Triggers

4 个值引用:RefSettings.reftype

The following table is a list of triggers that result in an ad slot refreshing.

0UNKNOWN
1User Action: Refresh triggered by user-initiated action such as scrolling.
2Event: Event-driven content change. For example, ads refresh when the football game score changes on the page.
3Time:Time-based refresh. Ads refresh on a predefined time interval even without user activity.