Contextual App Targeting

As an ad monetization SDK and supply-side partner, Digital Turbine provides buyers with high-quality, in-app inventory. DT provides standardized OpenRTB custom extensions to use for targeting in the programmatic app industry.

Data Use

The DT SDK collects specific data objects and includes them in bid requests. Third-party advertisers should limit use of this data to contextual ads only. The data may not be used to build user profiles or for any unrelated purpose. All buyers on DT Exchange must comply with Apple's User Privacy and Data Use Policyarrow-up-right.

OpenRTB Bid Request Parameters for Contextual App Targeting

The following bid request parameters follow the 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

ver

Application version.

ext.storecat

App Store Category. Google Play and Apple App Store category definitions.

ext.storesubcat

Google Play and Apple App Store category definitions. For example, Games.

ext.fmwname

A string value describing if the app is using the unity or native framework, listed as unity or native.

ext.apilevel

(Android only) An integer value that specifies the API level supported.

Object: Publisher

Attribute
Definition

Domain

The highest-level domain of the publisher.

Object: User

Attribute
Definition

ext.impdepth

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

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.

ext.lastbundle

(iOS only) The last app bundle the user saw on the previous impression in a given session, per placement type.

ext.lastadomain

The last advertiser domain the user saw on the previous impression in a given session, per placement type.

ext.clickrate

The percentage of clicks or impressions per user per placement type over a given number of impressions, where 5 represents a 5% CTR.

ext.lastclick

VAST Specific. A boolean value indicating if the user clicked on the last impression in a given session, where "1" means user clicked.

ext.lastclicktype

VAST Specific. An integer value indicating what part of the video the user clicked on. 0 = no click 1 = ClickThrough 2 = CompanionClickThrough

ext.completionrate

For Rewarded and Video placement types, the percentage of completions or impressions per user per placement type for a given number of impressions. For example, 70 indicates a 70% completion rate.

Object: Device

Attribute
Definition

ext.atts

(iOS only) An integer passed to represent the app's app tracking authorization status. 0 = not determined 1 = restricted 2 = denied 3 = authorized

ext.inputlanguage

A string array containing the languages setup on the user's device keyboard. Country codes are passed in the string array.

ext.ringmute

(Android only) 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

ext.charging

An integer value describing if the device is connected to a charger, where 0 = unplugged 1 = plugged into power outlet

ext.bluetooth

Bluetooth Connected. A boolean value indicating if the device is connected to bluetooth, where "1" means connected to bluetooth.

ext.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

ext.batterylevel

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%

ext.batterysaver

A boolean value indicating if battery saver (Low Power Mode on iOS) has been enabled. 0 = battery saver not enabled 1 = battery saver enabled

hwv

Hardware version of the device.

ipv6

IP address closest to device as IPv6.

utcoffset

Local time as the number +/- of minutes from UTC.

ext.darkmode

A boolean value indicating if dark mode is enabled on the device. 0 = dark mode not enabled 1 = dark mode enabled

ext.airplane

(Android only) A boolean value indicating if airplane mode is enabled. 0 = airplane mode not enabled 1 = airplane mode enabled

ext.dnd

(Android only) A boolean value indicating if the do-not-disturb setting is enabled. 0 = do not disturb not enabled 1 = do not disturb enabled

Last updated