Documentation

Support

Unity Exchange

Get started with Unity Exchange

Bid requests

Creative format guidelines

Unity Exchange

Contextual data extensions

Help demand partners optimize ad targeting and relevance.
Read time 1 minuteLast updated 7 months ago
Unity offers additional metric signals on the app or user providing the impression to help fine-tune your bidding strategies. Contact your account manager to activate the following data sets:

Attribute

Data type

Example

Description

mediationOrdinal
int
"mediationOrdinal": 15
Signifies how many ads have been in the session across other ad networks. This can be passed in mediated projects with multiple ad networks when supported.
mute
boolean
"mute": true
The device's mute status when the request was made.
gameCategory
string
"gameCategory": "Games"
Google Play and Apple App Store category definitions.
subGameCategory
string
"subGameCategory": "Simulation"
Google Play and Apple App Store sub-game category definitions.
sessionDepth
int
"sessionDepth": 1
The number of times an ad has been delivered for the current session.
bAge
string
"bAge": "17+"
Content age ratings that are blocked by the publisher.
Important
If your app's age rating (as defined on its store page) exceeds this value, your bid will be filtered out.
Note
Unity will not pass any of these data signals if they are not present in the request.
Bid request example with contextual data 
{     "id": "ABCDEfghijkLMNOPqrstUV",         "imp": [{             "id": "1",                 "banner": {                     "w": 320,                     "h": 480,                     "battr": [1, 3, 5, 6, 8, 9],                     "pos": 7                 },             "instl": 1,             "tagid": "com.unity.example-vast",             "secure": 1         }],         "app": {             "id": "123abc4d5e0aa0473a80e9e1f43528d8",             "name": "Example Game",             "bundle": "123456789",             "storeurl": "https://itunes.apple.com/us/app/ExampleGame/id123456789?mt=8"         },         "device": {             "ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 11_2_5 like Mac OS X) AppleWebKit/604.5.6 (KHTML, like Gecko) Mobile/15D60",             "geo": {                 "lat": 50.0144,                 "lon": -50.2772,                 "type": 2,                 "country": "USA",                 "city": "San Francisco",                 "utcoffset": -480             },             "ip": "123.123.12.123",             "devicetype": 4,             "model": "iPhone7,2",             "os": "ios",             "osv": "11.2.5",             "hwv": "iPhone 6",             "h": 667,             "w": 375,             "language": "en",             "carrier": "ATT",             "connectiontype": 2,             "ifa": "12345AB-C6789-DEFG-0123"         },     "at": 2,     "tmax": 200,     "regs": {},     "ext": {         "mediationOrdinal": 1,         "mute": true,         "gameCategory": "Games",         "subGameCategory": "Simulation",         "sessionDepth": 1,        "bAge": "17+"     } }