Context Object¶
This object passes information about the context of the where, how, and to whom the ad will be shown, i.e. the user, their device, their location, the channel (e.g., site, app, digital out-of-home) with which they are interacting, the channel’s publisher, its content, and any regulations that are in effect (e.g., COPPA, GDPR).
Value |
Type |
Description |
---|---|---|
regs |
object |
Contains any regulation specific information, e.g. GDPR, see Regulations Context |
restrictions |
object |
This object allows lists of restrictions on ad responses to be specified including specific content categories, advertisers, ads pertaining to specific apps, or creative attributes, see Restrictions Context |
site |
object |
Specifies the website on which the ad will be shown, see Site Context |
user |
object |
Contains details of the user to whom the ad will be shown, User Context |
device |
object |
Specifies the device on which the ad will be shown, see Device Context |
app |
object |
Specifies the app on which the ad will be shown, see App Context |
dooh |
object |
Specifies the Direct out of Home (DOOH) details for this ad, see DOOH Context |
Example Context JSON¶
{
"id":"0123456789ABCDEF",
"item":[
{
"id":"1"
},
{
"id":"2"
}
],
"context":{
"regs":{
"gdpr":0,
"coppa":1
},
"restrictions":{
"bcat":[
"IAB24",
"IAB25",
"IAB26"
],
"cattax":1,
"badv":[
"example.com",
"example_2.com"
]
},
"site":{
"id":"1234",
"name":"Awesome Example Site",
"domain":"examplesitedomain.com",
"mobile":1,
"amp":0,
"pub":{
"id":"9876",
"name":"Example Publisher, Inc.",
"domain":"examplepubdomain.com"
}
},
"user":{
"id":"a0af45c77890045deec100acb8443baff57c",
"consent":"ihdknkhkq8y",
"buyeruid":"fcd4282456238256034abcdef220d9aa5892",
"yob":1990,
"gender":"F",
"ext":{
"consented_providers_settings":{
"consented_providers":[
1,
52,
45,
23
]
}
}
},
"device":{
"type":4,
"ifa":"8846d6fa10008bceaaf322908dfcb221",
"ip":"1.2.3.4",
"ua":"Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.6; en-US; rv:1.9.2.16) Gecko/20110319 Firefox/3.6.16",
"make":"Apple",
"model":"iPhone",
"hwv":"6s",
"os":13,
"osv":"11.4.1",
"mccmnc":"310-005",
"geo":{
"type":1,
"lat":42.3601,
"lon":71.0581,
"country":"USA",
"utcoffset":-300
}
}
}
}