OpenRTB (Real-Time Bidding) was initially built to standardize communication between parties for blocking inventory. It has since evolved into a standardized API protocol designed to automate the real-time trading of digital media across a range of platforms, devices, and advertising solutions.
DT supports OpenRTB versions 2.2, 2.3, and 2.5; older versions are incompatible. Buyers are encouraged to upgrade their integration to DT's latest OpenRTB 2.5 specification to benefit from all supported parameters.
Important
All references in the tables below to the OpenRTB Specification version 2.5 can be found in the attached document at the end of this article.
The tables below detail the parameters supported by Digital Turbine and the values you can expect to see.
Bid Request Specifications
| Attribute | Always Passed | Description |
|---|---|---|
| bidrequest | Yes | Top-Level Object |
| source | Yes | Request source details on post-auction decisions (e.g., header bidding) |
| regs | Yes | Regulatory conditions are in effect for all impressions in this bid request |
| imp | Yes | Container for the description of a specific impression; at least 1 per request |
| banner | Yes | Details for a banner impression, including in-banner video (MRAID Video) and video companion ad (end card) |
| video | Yes | Details for a video impression. |
| audio | No | Container for an audio impression |
| format | No | An allowed size of a banner |
| pmp | Yes | Collection of private marketplace (PMP) deals applicable to this impression |
| deal | Yes | Deal terms pertaining to this impression between a seller and buyer |
| app | Yes | Details of the application calling for the impression |
| publisher | Yes | Entity that controls the content of and distributes the site or app |
| device | Yes | Details of the device on which the content and impressions are displayed |
| geo | Yes | Location of the device or user’s home base depending on the parent object |
| user | No | Human user of the device; audience for advertising |
| bidresponse | Yes |
Top-level object. DT does not support multi-bid response, as signaled in our bid request. RTB responses contain bids that reference specific impressions within a bid request. Bids are in essence, an offer to buy. The bid response consists of the top-level bid response object and optional objects that depict the specific bids. An empty HTTP response constitutes a no-bid. Partners are encouraged to pass an HTTP 204 code to indicate a no-bid. Conversely, an HTTP 200 code indicates a ok code i.e., a bid. A malformed response or a response that contains no actual bids will also be interpreted as no-bid. |
| seatbid | Yes | Collection of bids made by the bidder on behalf of a specific seat |
| bid | Yes | An offer to buy a specific impression under certain business terms |
Object: BidRequest
| Attribute | Always Passed | Description |
|---|---|---|
| id | Yes | Unique ID of the bid request, provided by the exchange. |
| imp | Yes | Array of Imp objects representing the impressions offered. At least 1 Imp object is required. |
| app | Yes | Details via an App object about the publisher’s app. |
| device | Yes | Details via a Device object about the user’s device to which the impression will be delivered |
| user | Yes | Details via a User object about the human user of the device. |
| test | No | Indicator of test mode in which auctions are not billable, where 0 = live mode, 1 = test mode |
| at | Yes | Auction type, where 1 = First Price, 2 = Second Price |
| tmax | Yes | Maximum time in milliseconds the exchange allows for bids to be received including Internet latency to avoid timeout. This value supersedes any a priori guidance from the exchange. |
| cur | Yes | Array of allowed currencies for bids on this bid request using ISO-4217 alpha codes. Recommended only if the exchange accepts multiple currencies. |
| bcat | Yes | Blocked advertiser categories using the IAB content categories |
| badv | Yes | Blocked list of advertisers by their domains |
| bapp | Yes | Block list of applications by their platform-specific exchange independent application identifiers. On Android, these should be bundle or package names. On iOS, these are numeric ids. |
| source | Yes | A Sorce object that provides data about the inventory source and which entity makes the final decision. |
| regs | Yes | A Regs object that specifies any industry, legal, or Blocked advertiser categories using the IAB content categories. Refer to List 5.1.governmental regulations in force for this request. |
Object: Source
| Attribute | Always Passed | Description |
|---|---|---|
| fd | Yes |
Entity responsible for the final impression sale decision, where "0"=exchange and "1"=upstream source. When DT FairBid SDK is used, DT will pass "0". |
| tid | Yes | Transaction id that must be common across all participants in this bid request |
|
ext.schain |
Yes | The SupplyChain object is composed primarily of a set of nodes where each node represents a specific entity that participates in the transacting of inventory. The entire chain of nodes from beginning to end represents all entities who are involved in the direct flow of payment for inventory. |
Object: Source.ext.schain
| Attribute | Always Passed | Description |
|---|---|---|
| ext.schain.ver | Yes |
The version of the supply chain specification in use |
| ext.schain.complete | Yes | Flag indicating whether the chain contains all nodes involved in the transaction leading back to the owner of the site, app, or another medium of the inventory, where 0 = no, 1 = yes |
| ext.schain.nodes | Yes | Array of SupplyChainNode objects in the order of the chain. In a complete supply chain, the first node represents the initial advertising system and seller ID involved in the transaction. DT is always node 1 |
| ext.schain.asi | Yes | Canonical domain name of the SSP |
| ext.schain.sid | Yes | Publisher ID |
| ext.schain.hp | Yes | Indicates whether this node will be involved in the flow of payment for the inventory. |
| ext.schain.rid | Yes | The OpenRTB requestId of the request as issued by this seller |
| omidpn | No | Identifier of the Open Measurement SDK integration. The default value is "DT". |
| omidpv | No | Version of the Open Measurement SDK integration. |
Object: Regs
| Attribute | Always Passed | Description |
|---|---|---|
| coppa | Yes | Flag indicating if this request is subject to the COPPA regulations established by the USA FTC, where 0 = no, 1 = yes. |
| ext.gdpr | Yes | Extension to signal whether or not the request is subject to GDPR regulations |
| ext.us_privacy | Yes |
Always passed when available from publisher. Please follow the IAB US Privacy String Format. DT will not change, delete, or obfuscate any data in the bid request when the user opts-out. DT will pass the U.S Privacy string to demand partners. It is the demand partner's responsibility to determine which data can be used for ad targeting purposes. |
Object: Imp
| Attribute | Always Passed | Description |
|---|---|---|
| id | Yes | A unique identifier for this impression within the context of the bid request. |
| metric | No | An array of metrics. These metrics can offer insight into the impression to assist with decisioning such as average recent viewability, click-through rate, etc. Each metric is identified by its type, reports the value of the metric, and optionally identifies the source or vendor measuring the value. |
| banner | No | A Banner object is required if this impression is offered as a banner ad opportunity |
| video | No | A Video object is required if this impression is offered as a video ad opportunity |
| pmp | No | A PMP object containing any private marketplace deals in effect for this impression |
| displaymanager | Yes | Name of ad mediation partner, SDK technology, or player responsible for rendering ad (typically video or mobile). |
| displaymanagerver | Yes | Version of ad mediation partner, SDK technology, or player responsible for rendering ad. |
| instl | Yes | 1 = the ad is interstitial or full screen, 0 = not interstitial. |
| tagid | Yes | An identifier for specific ad placement or ad tag is used to initiate the auction. |
| bidfloor | Yes | The minimum bid for this impression is expressed in CPM |
| bidfloorcur | Yes | Currency specified using ISO-4217 alpha codes. |
| clickbrowser | Yes | Indicates the type of browser opened upon clicking the creative in an app, where 0 = embedded, 1 = native. |
| secure | Yes | Flag to indicate if the impression requires secure HTTPS URL creative assets and markup, where 0 = non-secure, 1 = secure. If omitted, the secure state is unknown, but non-secure HTTP support can be assumed. |
| exp | Yes |
Advisory as to the number of seconds that may elapse between the auction and the actual impression. DT's default cache times are dependent on placement times and the values are as follows.
Publishers can also set up custom cache times, contact your Account Manager for details. |
| ext.brsrclk | Yes |
A custom extension used to force open the device's browser. DT passes 1 when the bid request supports opening the device's external browser. Please click here for complete implementation instructions. |
| ext.dpl | No |
A custom extension that indicates the deep linking capability. |
Object: BidRequest.imp.ext.skadn
| Attribute | Always Passed | Description |
|---|---|---|
| version | No |
Version of skadnetwork supported. Always "2.0" or higher. Dependent on both the OS version and the SDK version. Note: With the release of SKAdNetwork 2.1, this field is deprecated in favor of the (For example: "2.0") |
| versions | No | Array of strings containing the supported skadnetwork versions. Always "2.0" or higher. Dependent on both the OS version and the SDK version. (For example: ["2.0", "2.1", "2.2", "3.0", "4.0"]) |
| sourceapp | Yes |
ID of publisher app in Apple's App Store. (For example: "880047117") |
| skadnetids | Yes |
A subset of SDKdNetworkItem entries in the publisher app's info.plist, expressed as lowercase strings , that are relevant to the bid request. Recommended that this list not exceed 10. (For example: ["SKAdNetwork1.skadnetwork"," |
| skadnetlist | No |
An object containing the IABTL list definition
|
| skoverlay | No |
List of attributes (array) that should be provided on the bid response Read more about SKOverlay. |
| productpage | No | This attribute flags supply supporting the Custom Product Page functionality; it passes with the value 1 when eligible and will not be passed when not eligible |
Object: BidRequest.device.ext
| Attribute | Always Passed | Description |
|---|---|---|
| atts | Yes |
(iOS Only) An integer passed to represent the app's app tracking authorization status, where 1 = restricted 2 = denied 3 = authorized |
| ifv | No | IDFV of the device in that publisher. Listed as ifv to match ifa field format. (For example: "24252409-0099-4708-BA27-EB182EC0DAEF") |
Object: Metric
| Attribute | Always passed | Description |
|---|---|---|
| type | Yes |
Type of metric being presented using exchange curated string
|
| value | Yes | Number representing the value of the metric. Probabilities must be in the range 0.0 – 1.0. |
| vendor | Yes | Source of the value using exchange curated string names which should be published to bidders a priori. If the exchange itself is the source versus a third party, “EXCHANGE” is recommended. |
| ext | No | Placeholder for exchange-specific extensions to OpenRTB. |
Object: Banner
| Attribute | Always Passed | Description |
|---|---|---|
| format | No | Array of format objects representing the banner sizes permitted. If none are specified, then use of the h and w attributes is highly recommended |
| w | Yes | Exact width in device independent pixels (DIPS); recommended if no format objects are specified |
| h | Yes | Exact height in device independent pixels (DIPS); recommended if no format objects are specified |
| btype | Yes | Blocked banner ad types. |
| battr | Yes | Blocked creative attributes. |
| pos | Yes | Ad position on the screen. |
| topframe | Yes | Indicates if the banner is in the top frame instead of an iframe, where 0 = no, 1 = yes. |
| mimes | Yes | Content MIME types supported. |
| expdir | No | Directions in which the banner may expand. |
| api | Yes | List of supported API frameworks for this impression. |
| id | Yes | Unique identifier for this banner object. |
| vcm | No | Relevant only for Banner objects used with a Video object in an array of companion ads. Indicates the companion banner rendering mode relative to the associated video, where 0 = concurrent, 1 = end-card. |
|
ext.rewarded |
Yes | DT will use the custom extension, ”rewarded” where 1 = Rewarded Playables are supported |
Object: Video
| Attribute | Always Passed | Description |
|---|---|---|
| mimes | Yes | Content MIME types supported |
| minduration | Yes | Minimum video ad duration in seconds |
| maxduration | Yess | Maximum video ad duration in seconds |
| protocols | Yes |
Array of supported video protocols. DT will always pass 2, 5, 3, 6, 7, 8. |
| w | Yes | Width of the video player in pixels |
| h | Yes | Height of the video player in pixels |
| startdelay | Yes |
Indicates the start delay in seconds for pre-roll, mid-roll, or post-roll ad placements. DT always passes 0 for pre-roll |
| placement | Yes |
Placement type for the impression. DT always passes 5 for interstitial video |
| linearity | No |
Indicates if the impression must be linear, nonlinear, etc. DT always passes 1 for linear video |
| skip | Yes | Indicates if the player will allow the video to be skipped, where 0 = no, 1 = yes. |
| skipmin | No | Videos of total duration greater than this number of seconds can be skippable. only applicable if the ad is skippable. |
| skipafter | No | Number of seconds a video must play before skipping is enabled; only applicable if the ad is skippable. |
| battr | Yes | Blocked creative attributes. |
| maxbitrate | No |
Maximum bit rate in Kbps |
|
playbackmethod |
Yes |
Playback methods that may be in use. DT always passes 5, where 5 = fullscreen video. DT will always respect the user's device settings. |
| playbackend | Yes |
The event that causes playback to end. DT will always pass 1 |
| pos | Yes |
Ad position on screen. Always passed as 7 = fullscreen |
| companionad | Yes | An array of Banner objects if companion ads are available. |
| api | Yes | List of supported API frameworks for this impression. |
| companiontype | Yes |
Supported VAST companion ad types. DT always supports 1, 2, 3 (static, HTML, iframe) when companionad is supported. |
|
ext.rewarded |
Yes | DT will use the custom extension, ”rewarded” where 1 = Rewarded, 0 = Non-Rewarded. Always passed on video requests |
|
ext.mraidendcard |
Yes | DT will use the custom extension, ”mraidendcard” where 1 = MRAID end card is supported, 0 = MRAID end card is not supported. Always passed on video requests. |
|
ext.autostore |
Yes | Indicates whether the inventory is eligible for Auto Store 1 - true; 0 - false Int; default 1 |
Object: PMP
| Attribute | Always Passed | Description |
|---|---|---|
| privateauction | Yes |
Indicator of auction eligibility to seats named in the Direct Deals object, where 0 = all bids are accepted, 1 = bids are restricted to the deals specified and the terms thereof. |
|
deals |
Yes |
Array of Deal objects that convey the specific deals applicable to this impression |
Object: Deal
| Attribute | Always Passed | Description |
|---|---|---|
| id | Yes | A unique identifier for the PMP deal |
|
bidfloor |
Yes | Minimum bid for this impression expressed in CPM |
|
at |
Yes |
Optional override of the overall auction type of the bid request, where 1 = First Price 2 = Second Price Plus, 3 = the value passed in bidfloor is the agreed upon deal price. Additional auction types can be defined by the exchange |
|
wseat |
Yes | Whitelist of buyer seats (e.g., advertisers, agencies) allowed to bid on this deal. IDs of seats and the buyer’s customers to which they refer must be coordinated between bidders and the exchange a priori. Omission implies no seat restrictions. |
Object: App
| Attribute | Always Passed | Description |
|---|---|---|
| id | Yes | Exchange-specific id |
|
name |
Yes | App name (may be aliased at the publisher's request) |
|
bundle |
No | A platform-specific application identifier intended to be unique to the app and independent of the exchange. On Android, this should be a bundle or package name (e.g., com.foo.mygame). On iOS, it is typically a numeric ID (app store ID) |
|
domain |
No |
Domain of the app |
|
storeurl |
No | App Store URL for an installed app |
|
cat |
Yes | Array of IAB content categories of the app. |
|
ver |
Yes | Application version |
|
privacypolicy |
Yes | Indicates if the app has a privacy policy, where 0 = no, 1 = yes. |
|
paid |
No | 0 = app is free, 1 = the app is a paid version. |
|
publisher |
Yes | Details about the Publisher of the app |
|
ext.devuserid |
No | A developer's own persistent unique user identifier |
| ext.storecat | No |
Google Play and Apple App Store category definitions. For example, "games" |
|
ext.storesubcat |
No |
Google Play and Apple App Store Sub-game category definitions. The array is always capped at 3 strings |
|
ext.fmwname |
No | A string value describing if the app is using the unity or native framework, listed as "unity" or "native" |
|
ext.apilevel
|
No | (Android only) An integer value that specifies the API level supported. |
Object: Publisher
| Attribute | Always Passed | Description |
|---|---|---|
| id | Yes | Exchange-specific publisher id |
|
name |
Yes | Publisher name (may be aliased at the publisher’s request). |
|
domain |
No | Highest level domain of the publisher |
Object: Device
| Attribute | Always Passed | Description |
|---|---|---|
| ua | Yes | Browser user agent string that informs about device data |
|
dnt |
Yes | Standard “Do Not Track” flag as set in the header by the browser, where 0 = tracking is unrestricted, 1 = do not track. |
|
lmt |
No | Limit Ad Tracking” signal commercially endorsed (e.g., iOS, Android), where 0 = tracking is unrestricted, 1 = tracking must be limited per commercial guidelines. |
|
ip |
Yes | IPv4 address closest to device. Example, 86.179.150.0 |
|
ipv6 |
No | IP address closest to device as IPv6. |
|
devicetype |
Yes | The general type of device. |
|
make |
No | Device make |
|
model |
No | Device model |
|
os |
No | Device operating system |
|
osv |
No | Device operating system version |
|
hwv |
No | Hardware version of the device |
|
h |
Yes | Physical height of the screen in pixels |
|
w |
Yes | Physical width of the screen in pixels |
|
ppi |
No | Screen size as pixels per linear inch |
|
pxratio |
No | The ratio of physical pixels to device-independent pixels |
|
js |
Yes | Support for JavaScript, where 0 = no, 1 = yes |
|
language |
Yes | Browser language using ISO-639-1-alpha-2 |
|
carrier |
No | Carrier or ISP using exchange curated string names which should be published to bidders a priority |
|
connectiontype |
Yes | Network connection |
|
ifa |
No | Clear (not hashed) device identifier |
|
ext.inputLanguage |
No | A string array containing the languages setup on the user's device keyboard |
|
ext.ifv |
No |
(iOS only). A persistent unique identifier for each app on a device that identifies the device to the app's vendor. The value of this property is the same for apps that come from the same vendor running on the same device. A different value is returned for apps on the same device that come from different vendors, and for apps on different devices regardless of vendor. |
|
ext.atts |
No | (iOS only) An integer passed to represent the app's app. tracking authorisation status, where 0 = not determined 1 = restricted 2 = denied 3 = authorized |
|
ext.inputlanguage |
No | A string array containing the languages setup on the user's device keyboard. Country codes are passed in the string array. |
|
ext.diskspace |
No |
An integer value describing the available disk space on the device in megabytes, where "18201" = device has 18201 MB of available disk space. MB will be rounded up and passed as a whole number to align with Apple's data user and user privacy. |
|
ext.totaldisk |
No |
An integer value describing the total disk space on the device in megabytes, where "63989" = 63989 MB of total disk space. MB will be rounded up and passed as a whole number to align with Apple's data use and user privacy |
|
ext.ringmute |
No | (Android only) An integer value describing the device sound setting during time of ad request describing if sound is set to ring or mute, where "0" - mute and "1" = ring. |
|
ext.charging |
No | An integer value describing if the device is connected to a charger, where, "0" unplugged, "1" plugged into power outlet |
|
ext.bluetooth
|
No | A boolean value indicating if the device is connected to bluetooth where "1" = connected to bluetooth |
|
ext.headset |
Yes | A boolean value indicating if the device is connected to a wired headset, where "1" = device is connected to any wired headset and "0" = no wired headset is connected |
|
ext.batterylevel |
No |
An integer passed describing percent battery remaining on the user's device, segmented into buckets, where 100-85% = 8 84-70% = 7 69-55% = 6 54-40% = 5 39-25% = 4 21-10% = 3 9-5% = 2 < 5% = 1 |
|
ext.batterysaver |
No | A boolean value indicating if battery saver ("Low Power Mode" on iOS) has been enabled, where "1" = batter saver, "0" = not enabled |
|
ext.darkmode |
No | A boolean value indicating if dark mode is enabled on the device, where "1" = dark mode enabled, "0"= not enabled |
|
ext.airplane |
No | (Android only) A boolean value indicating if airplane mode is enabled, where "1" = airplane mode enabled, "0" = not enabled |
|
ext.dnd |
No | (Android only) A boolean value indicating if do not disturb setting is enabled, where "1" = do not disturb enabled, "0" = not enabled. |
Object: Geo
| Attribute | Always Passed | Description |
|---|---|---|
|
lat |
No | Latitude from -90.0 to +90.0, where negative is south |
|
lon |
No | Longitude from -180.0 to +180.0, where negative is west |
|
type |
No | Source of location data; recommended when passing lat/lon. |
|
accuracy |
No | Estimated location accuracy in meters; recommended when lat/lon are specified and derived from a device’s location services |
|
lastfix |
No | The number of seconds since this geolocation fix was established. Note that devices may cache location data across multiple fetches. Ideally, this value should be from the time the actual fix was taken. |
|
ipservice |
No | Service or provider used to determine geolocation from IP address if applicable |
|
country |
Yes | Country code using ISO-3166-1-alpha-3. |
|
region |
No | Region code using ISO-3166-2; 2-letter state code if USA |
|
city |
No | City using United Nations Code for Trade & Transport Locations. See Appendix A for a link to the codes |
|
zip |
No | The home zip or postal code of the user |
|
utcoffset |
No | Local time as the number +/- of minutes from UTC |
Object: User
| Attribute | Always Passed | Description |
|---|---|---|
|
yob |
No | Year of birth as a 4-digit integer |
|
gender |
No | Gender, where “M” = male, “F” = female, “O” = known to be other (i.e., omitted is unknown) |
|
ext.consent |
Yes | Extension to signal whether or not the user subject to GDPR regulations has given consent |
|
ext.impdepth |
No | The count of impressions for a specific placement type in a given app session. The impression depth is reset once the session ends. |
|
ext.sessionduration |
No | The total duration of a time a user has spent so far in a specific app session expressed in seconds. For example, a user has been playing Word Game for 45 seconds. |
|
ext.lastbundle |
No | (iOS only) The last app bundle the user saw on the previous impression in a given session per placement type. |
|
ext.lastadomain |
No | The last advertiser domain the user saw on the previous impression in a given session per placement type. |
|
ext.clickrate |
No | The percentage of clicks/impressions per user per placement type over a given number of impressions, where 5 represents a 5% CTR |
|
ext.lastclick |
No | VAST specific. A boolean value indicating if the user skipped the video on the last impression in a given session, where "1" = user skipped |
|
ext.lastclicktype |
No |
VAST Specific. An integer value indicating what part of the video the user click on, where "0" = no click, "1" = ClickThrough, and "2" = CompanionClickThrough
|
|
ext.completionrate |
No | The percentage of completions/impressions per user per placement type for a given number of impressions, where 70 represents 70% completion rate. This only applies to Rewarded and Video placement types. |
Bid Response Specifications
Important
When replying to a bid request for a Rewarded Playable ad, you must include specific values in your bid response. To learn more, please click here.
Object: BidResponse
| Attribute | Required | Description |
|---|---|---|
|
id |
Yes |
The bid response id must be the same as the bid request ID. They are used for tracking purposes. |
|
seatbid |
Yes |
Array of seatbid objects; 1+ required if a bid is to be made. |
|
bid |
No |
Bidder generated response id to assist with logging/tracking |
|
cur |
No |
Bid currency using ISO-4217 alpha codes.USD is the only supported currency on DT |
|
attr |
No |
Set of attributes describing the creative |
|
ext.crtype |
No |
Custom extension used to identify the type of ad markup the DSP is responding with. |
|
ext.apis |
No |
List of supported API frameworks for this impression. If an API is not explicitly listed, it is assumed not to be supported. |
bid.ext.crtype
| Ad Format | Values on Bid Response |
|---|---|
| HTML Ads | HTML |
| MRAID | MRAID 1.0, MRAID 2.0, MRAID 3.0 |
| VAST | VAST 2.0, VAST 3.0 |
| Playables | Playable |
| Rewarded Playables | Playable |
| Rewarded Video | VAST 2.0, VAST 3.0 |
| MRAID Video | Null |
Object: SeatBid
| Attribute | Required | Description |
|---|---|---|
|
bid |
Yes | Array of 1+ Bid objects (Section 4.2.3) each related to an impression. Multiple bids can relate to the same impression. |
|
seat |
Yes | ID of the buyer seat (e.g., advertiser, agency) on whose behalf this bid is made. |
Object: Bid
| Attribute | Required | Description |
|---|---|---|
|
id |
Yes | Bidder generated bid id to assist with logging/tracking. |
|
impid |
Yes | id of the Imp object in the related bid request. |
|
price |
Yes | Bid price expressed as CPM although the actual transaction is for a unit impression only. |
|
nurl |
No | Win notice URL called by the exchange if the bid wins (not necessarily indicative of a delivered, viewed, or billable ad); optional means of serving ad markup. Substitution macros (Section 4.4) may be included in both the URL and optionally returned markup. |
|
burl |
Yes | Billing notice URL called by the exchange when a winning bid becomes billable based on exchange-specific business policy (e.g., typically delivered, viewed, etc.). Substitution macros may be included. |
|
lurl |
No | Loss notice URL called by the exchange when a bid is known to have been lost. Substitution macros (Section 4.4) may be included. Exchange-specific policy may preclude support for loss notices or the disclosure of winning clearing prices resulting in ${AUCTION_PRICE} macros being removed (i.e., replaced with a zero-length string). |
|
adm |
Yes | Optional means of conveying ad markup in case the bid wins; supersedes the win notice if markup is included in both. Substitution macros (Section 4.4) may be included. |
|
adomain |
Yes | Advertiser domain for block list checking (e.g., “ford.com”). This can be an array of for the case of rotating creatives. Exchanges can mandate that only one domain is allowed. |
|
bundle |
No | A platform-specific application identifier intended to be unique to the app and independent of the exchange. On Android, this should be a bundle or package name (e.g., com.foo.mygame). On iOS, it is a numeric id. |
|
iurl |
No | URL without cache-busting to an image that is representative of the content of the campaign for ad quality/safety checking |
|
cid |
Yes | Campaign id to assist with ad quality checking; the collection of creatives for which iurl should be representative |
|
crid |
Yes | Creative id to assist with ad quality checking |
|
cat |
No | IAB content categories of the creative. Refer to List 5.1 |
|
dealid |
No | Reference to the deal.id from the bid request if this bid pertains to a private marketplace direct deal |
|
ext.autostore |
No |
Indicates whether DTX should enable automatically displaying the Store 1 - true; 0 - false For example, click here. |
|
ext.autostoreclick |
No |
Indicates whether DT Exchange should fire click trackers when displaying the Store Kit For example, click here. |
Object: BidResponse.seatbid.bid.ext.skadn
| Attribute | Required | Description |
|---|---|---|
| version | Yes |
Version of SKAdNetwork desired. Must be 2.0 or above. (For example: "2.0") |
| network | No |
Ad network identifier used in signature. Should match one of the items in the skadnetids array in the request (For example:"dsp1.skadnetwork") |
| campaign | No |
Campaign id compatible with Apple's spec. As of 2.0, should be an integer between 1 and 100, expressed as a string. (For example: "45") |
| itunesitem | No |
id of advertiser's app in Apple's app store. Should match (For example: "4321") |
| fidelities | No | Supports multiple fidelity types introduced in SKAdNetwork v2.2 (For example: "880047117) |
| nonce | No |
An id unique to each ad response. Refer to Apple's documentation for the proper UUID format requirements. (For example: "beeeb65e-b3de-02420004") |
| sourceapp | No |
id of publisher's app in Apple's app store. Should match (For example: "123456789") |
| timestamp | No |
Unix time in millis string used at the time of signature. Note: With the release of SKAdNetwork 2.2, this field is deprecated in favor of (For example: "1594406341") |
| signature | No |
SKAdNetwork signature as specified by Apple. Note: With the release of SKAdNetwork 2.2, this field is deprecated in favor of the (For example: "MEQCIEQZRRyMyUXg==") |
| skoverlay | No |
SKOverlay auto present support |
| productpageid | No |
Product Page id to direct to on click |
Object: BidResponse.seatbid.bid.ext.skadn.skoverlay
| Attribute | Required | Description |
|---|---|---|
| present | Yes |
Should DTX present the SKOverlay (For example: "1") |
| dismissible | No |
Should overlay be dismissable by the user or not (For example: "0") |
| delay | No |
Delay in seconds before showing the overlay (0-60) (For example: "5") |
|
pos |
No |
Position of the overlay; (For example: "0") |
|
endcarddelay |
No |
Delay in seconds before showing the overlay on top of the end card (0-60). (For example: "0") |
|
autoclose |
No |
Time in seconds to automatically dismiss the endcard (0-60) (For example: "0") |
|
ext |
No |
Placeholder for exchange-specific extensions to OpenRTB. (For example:"{}") |
Object: BidResponse.seatbid.bid.ext.fidelities
| Attribute | Required | Description |
|---|---|---|
| fidelity | Yes | The fidelity-type of the attribution to track |
| nonce | Yes | An id unique to each ad response. Refer to Apple's documentation for the proper UUID format requirements. |
| timestamp | Yes | Unix time in millis string used at the time of signature |
| signature | Yes | SKAdNetwork signature as specified by Apple |
Enumerated Lists
IAB Categories
For the full list, including the sub categories, please refer to the OpenRTB 2.3 Document, Table 5.1
| Value | Description |
|---|---|
| IAB1 | Arts & Entertainment |
| IAB2 | Automotive |
| IAB3 | Business |
| IAB4 | Careers |
| IAB5 | Education |
| IAB6 | Family & Parenting |
| IAB7 | Health & Fitness |
| IAB8 | Food & Drink |
| IAB9 | Hobbies & Interests |
| IAB10 | Home & Garden |
| IAB11 | Law, Government and Politics |
| IAB12 | News |
| IAB13 | Personal Finance |
| IAB14 | Society |
| IAB15 | Science |
| IAB16 | Pets |
| IAB17 | Sports |
| IAB18 | Style & Fashion |
| IAB19 | Technology & Computing |
| IAB20 | Travel |
| IAB21 | Real Estate |
| IAB22 | Shopping |
| IAB23 | Religion & Spirituality |
| IAB24 | Uncategorized |
| IAB25 | Non-Standard Content |
| IAB26 | Illegal Content |
Creative Attributes Table
These are from the OpenRTB 2.3 Specifications list, Table 5.3.
| Value | Description |
|---|---|
| 1 | Audio Ad (Auto Play) |
| 2 | Audio Ad (User Initiated) |
| 3 | Expandable (Automatic) |
| 4 | Expandable (User initiated - Click) |
| 5 | Expandable (User initiated - Rollover) |
| 6 | In banner video ad (Auto play) |
| 7 | In banner video ad (User initiated) |
| 8 | Pop (i.e., Over Under or Upon exit) |
| 9 | Provocative or suggestive imagery |
| 10 | Shaky, flashing, flickering, extreme animation, or smileys |
| 11 | Surveys |
| 12 | Text only |
| 13 | User Interactive (i.e. Embedded games) |
| 14 | Windows dialog or alert style |
| 15 | Has audio on/off button |
| 16 | Ad can be skipped (i.e., skip button on preroll video) |
API Frameworks Table
These are from the OpenRTB 2.5 Specifications list, Table 5.6.
| Value | Description |
|---|---|
| 3 | MRAID-1 |
| 4 | ORMMA |
| 5 | MRAID-2 |
| 7 | OMID-1 |
For CCPA, please refer to DT's Resource Page.