How can we help you?

  1. Digital Turbine
  2. DT Exchange
  3. Buyers Entrance
  4. OpenRTB Specifications
Follow

Contextual App Targeting

Digital Turbine's role as an ad monetization SDK and supply-side partner is to provide buyers with high-quality, in-app inventory. We believe the app economy is shifting towards new non-personalized targeting signals, ranging from session-level data to on-device aggregated data. DT's goal is to establish standardized OpenRTB custom extensions that you can seamlessly adopt and use for targeting in the programmatic app industry.

Data Use

DT's SDK enables the collection of the following data objects and shares this data with buyers via the bid request for the specific purposes cited in the table below. Third-party advertisers should limit use of this data to contextual ads only and not create alternative user profiles or use this data for any other purpose.

Digital Turbine requires that all buyers on DT Exchange abide by Apple's User Privacy and Data Use Policy.

OpenRTB Bid Request Parameters for Contextual App Targeting

  • The following bid request parameters are structured to fit into existing OpenRTB 2.5 and 3.0 specifications.
  • Bid request parameters are available on both iOS and Android, unless noted otherwise.
  • DT does not pass a data signal if it is not present in the request.

Object: App

Attribute Definition Value Type & Example Release Purpose
ver App Version. The version of the application. String
14.16.0 		iOS 7.6.3
Android 7.7.0
FairBid iOS 3.6.0
FairBid Android 3.6.0		 App categorization
ext.
storecat		 App Store Category. Google Play and Apple App Store category definitions. String
Games 		iOS 7.6.3
Android 7.7.0
FairBid iOS 3.6.0
FairBid Android 3.6.0		 App categorization
ext.
storesubcat		 App Store Subcategory. Google Play and Apple App Store Sub-game category definitions. The array contains a maxumum of 3 strings. String Array
["entertainment", "trivia",
"simulation"] 		iOS 7.6.3
Android 7.7.0
FairBid iOS 3.6.0
FairBid Android 3.6.0		 App categorization
ext.
fmwname		 Framework Name. A string value describing if the app is using the unity or native framework, listed as unity or native. Stringnative iOS 7.6.3
Android 7.7.0
FairBid iOS 3.6.0
FairBid Android 3.6.0		 App categorization
ext.
apilevel		 (Android only) API Level. An integer value that specifies the API level supported. Integer
10 		iOS 7.8
Android 7.8		 App categorization

Object: Publisher

Attribute Definition Value Type & Example Release Purpose
Domain Developer Domain. The developer domain used for app-ads.txt. String
developer.com 		iOS 7.8
Android 7.8		 Publisher categorization

Object: User

Attribute Definition Value Type & Example Release Purpose
ext.
impdepth		 Impression Depth. The count of impressions for a specific placement type in a given app session. The impression depth is reset once the session ends. Integer
4 		FairBid iOS 3.5.0
FairBid Android 3.5.0		 Ad relevance
ext.
sessionduration		 Session Duration. The total duration of 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. Integer
45 		FairBid iOS 3.5.0
FairBid Android 3.5.0

 User engagement
ext.
lastbundle 		(iOS Only) Prior App Bundle. The last app bundle the user saw on the previous impression in a given session per placement type. String
123456789 		iOS 7.6.3
Android 7.7.0
FairBid iOS 3.6.0
FairBid Android 3.6.0		 Ad relevance 
ext.
lastadomain		 Prior Adomain. The last advertiser domain the user saw on the previous impression in a given session per placement type. String
advertiser.com 		iOS 7.6.3
Android 7.7.0
FairBid iOS 3.6.0
FairBid Android 3.6.0		 Ad relevance 
ext.
clickrate		 Click Rate. The percentage of clicks/impressions per user per placement type over a given number of impressions, where 5 represents a 5% CTR. Integer
5 		iOS 7.8
Android 7.8		 User engagement 
ext.
lastclick		 Prior Click. A boolean value indicating if the user clicked on the last impression in a given session per placement type, where "1" = user clicked. Integer
1 		iOS 7.8
Android 7.8		 User engagement
ext.
lastclicktype		 Prior Video Click Type. VAST specific.VAST Specific. An integer value indicating what part of the video the user clicked on.
0 = no click
1 = ClickThrough
2 = CompanionClickThrough		 Integer
1 		iOS 7.8
Android 7.8		 User engagement 
ext.
completionrate		 Completion Rate. The percentage of completions/impressions per user per placement type for a given number of impressions, where 70 represents a 70% completion rate. This only applies to Rewarded and Video placement types. Integer
70 		iOS 7.8
Android 7.8		 User engagement

Object: Device

Attribute Definition Value Type & Example Release Purpose
ext.atts (iOS Only) ATTrackingManager AuthorizationStatus. An integer passed to represent the app's app tracking authorization status, where
0 = not determined
1 = restricted
2 = denied
3 = authorized		 Integer
3 		iOS 7.7.0
FairBid iOS 3.6.0		 User tracking consent
ext.
inputlanguage		 Device Keyboard Languages. A string array containing the languages setup on the user's device keyboard. Country codes are passed in the string array, where "en", "he" are English and Hebrew (languages that are enabled on the user's device keyboard). String array
["en","he"] 		iOS 7.3.3
Android 7.3.3
FairBid 2.2.0		 Language preferences
ext.
diskspace		 Device Available Disk Space. An integer value describing the available disk space on the device in megabytes, where "18201" means that 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 use and user privacy Integer
18201 		iOS 7.6.3
Android 7.7.0
FairBid iOS 3.6.0
FairBid Android 3.6.0		 Capacity to download a new app
ext.
totaldisk		 Device Total Disk Space. An integer value describing the total disk space on the device in megabytes, where "63989" means the device has 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 Integer
63989 		iOS 7.6.3
Android 7.7.0
FairBid iOS 3.6.0
FairBid Android 3.6.0		 Capacity to download a new app
ext.
ringmute		 (Android only) Ring Sound Settings. An integer value describing the device sound setting during time of ad request describing if sound is set to ring or mute
0 = ring
1 = mute		 Integer
1

Android 7.8

iOS 8.3.0

 User engagement
ext.
charging		 Battery Charging. An integer value describing if the device is connected to a charger, where
0 = unplugged
1 = plugged into power outlet		 Integer
1 		iOS 7.6.3
Android 7.7.0
FairBid iOS 3.6.0
FairBid Android 3.6.0		 User engagement
ext.
bluetooth		 Bluetooth Connected. A boolean value indicating if the device is connected to bluetooth, where "1" means connected to bluetooth Integer
1 		iOS 7.6.3
Android 7.7.0
FairBid iOS 3.6.0
FairBid Android 3.6.0		 User engagement
ext.
headset		 Wired Headset. A boolean value indicating if the device is connected to a wired headset.
0 = no wired headset is connected
1 = device is connected to any wired headset		 Integer
1 		iOS 7.6.3
Android 7.7.0
FairBid iOS 3.6.0
FairBid Android 3.6.0		 User engagement
ext.
batterylevel		 Battery Level. An integer passed describing percentage of battery charge remaining on the user's device, segmented into buckets.
1 = less than 5%
2 = 9-5%
3 = 21-10%
4 = 39-25%
5 = 54-40%
6 = 69-55%
7 = 84-70%
8 = 100-85%		 Integer
4 		iOS 7.6.3
Android 7.7.0
FairBid iOS 3.6.0
FairBid Android 3.6.0		 Capacity to download a new app
ext.
batterysaver		 Battery Saver Status. A boolean value indicating if battery saver (Low Power Mode on iOS) has been enabled.
0 = battery saver not enabled
1 = battery saver enabled		 Integer
1 		iOS 7.6.3
Android 7.7.0
FairBid iOS 3.6.0
FairBid Android 3.6.0		 Capacity to download a new app
hwv Device Hardware Version. The hardware version of the device passed as a string. String
iPhone X 		iOS 7.3.3
Android 7.3.3
FairBid 2.2.0		 Device categorization
ipv6 Internet Protocol version 6. This is the most recent IP version on the Internet. This value is the truncated IP address with a 128-bit value. String
2001:0db8:85a3:
0000:0000:8a2e:
0370:7334 		Supported on all versions. General location
utcoffset Time difference from UTC. Local time as the number +/- of minutes from UTC. Integer
60 		iOS 7.6.3
Android 7.7.0
FairBid iOS 3.6.0
FairBid Android 3.6.0		 Timezone
ext.
darkmode		 Dark Mode Setting. A boolean value indicating if dark mode is enabled on the device.
0 = dark mode not enabled
1 = dark mode enabled		 Integer
1 		iOS 7.7.0
Android 7.7.0		 Creative preferences
ext.
airplane		 (Android only) Airplane Mode Setting. A boolean value indicating if airplane mode is enabled
0 = airplane mode not enabled
1 = airplane mode enabled		 Integer
1 		iOS 7.8
Android 7.8		 Capacity to download a new app
ext.dnd (Android only) Do Not Disturb Setting. A boolean value indicating if do not disturb setting is enabled
0 = do not disturb not enabled
1 = do not disturb enabled		 Integer
1 		iOS 7.8
Android 7.8		 Capacity to download a new app

Back to Top ⇧