# 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 Policy](https://developer.apple.com/app-store/user-privacy-and-data-use/).

### 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`   | <p>VAST Specific. An integer value indicating what part of the video the user clicked on.<br><code>0</code> = no click<br><code>1</code> = ClickThrough<br><code>2</code> = CompanionClickThrough</p> |
| `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`          | <p>(iOS only) An integer passed to represent the app's app tracking authorization status.<br><code>0</code> = not determined<br><code>1</code> = restricted<br><code>2</code> = denied<br><code>3</code> = authorized</p>                                                                                                                             |
| `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`      | <p>(Android only) An integer value describing the device sound setting during time of ad request describing if sound is set to ring or mute:<br><code>0</code> = ring<br><code>1</code> = mute</p>                                                                                                                                                    |
| `ext.charging`      | <p>An integer value describing if the device is connected to a charger, where<br><code>0</code> = unplugged<br><code>1</code> = plugged into power outlet</p>                                                                                                                                                                                         |
| `ext.bluetooth`     | Bluetooth Connected. A boolean value indicating if the device is connected to bluetooth, where "1" means connected to bluetooth.                                                                                                                                                                                                                      |
| `ext.headset`       | <p>A boolean value indicating if the device is connected to a wired headset.<br><code>0</code> = no wired headset is connected<br><code>1</code> = device is connected to any wired headset</p>                                                                                                                                                       |
| `ext.batterylevel`  | <p>An integer passed describing percentage of battery charge remaining on the user's device, segmented into buckets.<br><code>1</code> = less than 5%<br><code>2</code> = 9-5%<br><code>3</code> = 21-10%<br><code>4</code> = 39-25%<br><code>5</code> = 54-40%<br><code>6</code> = 69-55%<br><code>7</code> = 84-70%<br><code>8</code> = 100-85%</p> |
| `ext.batterysaver`  | <p>A boolean value indicating if battery saver (Low Power Mode on iOS) has been enabled.<br><code>0</code> = battery saver not enabled<br><code>1</code> = battery saver enabled</p>                                                                                                                                                                  |
| `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`      | <p>A boolean value indicating if dark mode is enabled on the device.<br><code>0</code> = dark mode not enabled<br><code>1</code> = dark mode enabled</p>                                                                                                                                                                                              |
| `ext.airplane`      | <p>(Android only) A boolean value indicating if airplane mode is enabled.<br><code>0</code> = airplane mode not enabled<br><code>1</code> = airplane mode enabled</p>                                                                                                                                                                                 |
| `ext.dnd`           | <p>(Android only) A boolean value indicating if the do-not-disturb setting is enabled.<br><code>0</code> = do not disturb not enabled<br><code>1</code> = do not disturb enabled</p>                                                                                                                                                                  |
