This is a list of the objects (and their attributes) that AdButler includes in OpenRTB bid requests. For more information on OpenRTB objects, read IAB's OpenRTB API Specification (PDF).
BidRequest
Source
Regs
Imp
Metric
Banner
Video
Pmp
Deal
Site
App
Publisher
Content
Device
Geo
User
Sample Bid Request
BidRequest |
|
id |
included |
at |
1 (First Price) |
tmax |
included |
imp |
included |
app |
included when using mobile API |
site |
included when not using mobile API |
device |
included |
user |
included |
source |
included |
Regs |
included |
Regs |
|
coppa |
Request parameter: coppa (default: 0) |
ext |
|
- gpdr |
Request parameter: gdpr_applies (default: not sent unless specified) |
Imp |
|
id |
included |
instl |
0 |
bidfloor |
populated by endpoint parameter (bid floor) |
metric |
included |
banner |
included on standard zone requests |
video |
included on VAST requests |
secure |
1 if requested with https, 0 if requested with http |
pmp |
included |
Metric |
No fields included |
Banner |
|
format |
a list of the demand endpoint sizes for a dynamic zone, or the zone size for a fixed-size standard zone |
w |
the ad item width specified by the zone, or width request parameter |
h |
the ad item height specified by the zone, or height request parameter |
btype |
[1] (XHTML Text Ad) |
api |
API frameworks from zone programmatic settings, or the apiFrameworks request parameter |
video |
included in VAST requests |
secure |
1 if requested with https, 0 if requested with http |
pmp |
included |
Video |
|
mimes |
VAST zone programmatic settings (default: ['video/mp4']) |
skip |
VAST zone programmatic settings |
boxingallowed |
VAST zone programmatic settings |
protocols |
[2, 3, 5, 6] VAST 2, 3, 4 and VAST 2, 3, 4 wrappers |
minduration |
VAST zone programmatic settings |
maxduration |
VAST zone programmatic settings |
w |
VAST zone programmatic settings (player width) |
h |
VAST zone programmatic settings (player height) |
startdelay |
VAST zone programmatic settings |
linearity |
VAST zone programmatic settings |
skip |
VAST zone programmatic settings |
skipmin |
VAST zone programmatic settings |
skipafter |
VAST zone programmatic settings |
minbitrate |
VAST zone programmatic settings |
maxbitrate |
VAST zone programmatic settings |
apiFrameworks |
VAST zone programmatic settings |
placement |
VAST zone programmatic settings |
Pmp |
|
private_auction |
PMP deal settings |
deals |
included |
Deal |
|
id |
included |
bidfloor |
PMP deal settings |
wseat |
PMP deal settings |
Site |
|
id |
included |
name |
sitename request parameter |
domain |
included |
cat |
zone programmatic settings (IAB categories), plus categories specified by request parameter taxonomy |
pagecat |
request parameter ortb_page_cat |
sectioncat |
request parameter ortb_section_cat |
publisher |
included |
content |
included |
App |
|
id |
Endpoint parameter App ID |
name |
included when using mobile SDK |
bundle |
included when using mobile SDK |
domain |
included when using mobile SDK |
storeurl |
included when using mobile SDK |
cat |
zone programmatic settings (IAB categories), plus categories specified by request parameter taxonomy |
ver |
included when using mobile SDK |
publisher |
included |
content |
included |
Content |
|
cat |
request parameter taxonomy |
language |
request parameter lang (default: en) |
keywords |
if endpoint parameter include keywords is enabled, then included with request param kw plus page keywords |
Device |
|
ua |
included |
geo |
included |
dnt |
request parameter dnt |
lmt |
request parameter dnt |
ip |
included |
devicetype |
request parameter rtbDeviceType , or populated from user agent |
make |
included when using mobile SDK |
model |
included when using mobile SDK |
os |
included when using mobile SDK |
osv |
included when using mobile SDK |
w |
request parameter sw |
h |
request parameter sh |
pxratio |
request parameter spr (default: 1) |
language |
request parameter lang (default: en) |
carrier |
included when using mobile SDK |
mccmnc |
included when using mobile SDK |
ifa |
included when using mobile SDK |
Geo |
|
lat |
included |
lon |
included |
type |
included |
city |
included |
region |
included |
country |
included |
User |
|
yob |
included when using mobile SDK |
gender |
included when using mobile SDK |
Sample OpenRTB bid request
{
"id": "10011_104369_0_1634241004",
"at": 1,
"tmax": 800,
"imp": [
{
"id": "1",
"instl": 0,
"ext": {
"s2s_nurl": 1
},
"bidfloor": 0.5,
"metric": [],
"banner": {
"w": 300,
"h": 250,
"btype": [
1
],
"format": [
{
"w": 300,
"h": 250
}
],
"api": [
3,
5,
6,
4
]
},
"secure": 1,
"pmp": {}
}
],
"site": {
"id": "example_bundle_id",
"cat": [
"IAB1",
"IAB4",
"IAB22"
],
"sectioncat": [
"IAB1",
"IAB2"
],
"pagecat": [
"IAB3",
"IAB4"
],
"publisher": {
"id": "4841"
},
"content": {
"keywords": "keyword1,keyword2,keyword",
"language": "en"
}
},
"device": {
"js": 1,
"ua": "Mozilla\/5.0 (Windows NT 10.0; Win64; x64; rv:94.0) Gecko\/20100101 Firefox\/94.0",
"geo": {},
"dnt": 0,
"lmt": 0,
"ip": "1.1.1.1",
"devicetype": 2,
"pxratio": 1,
"language": "en"
},
"user": {
"ext": {
"consented_providers_settings": {
"consented_providers": []
}
}
},
"source": {
"fd": 0,
"ext": {
"schain": {
"ver": "1.0",
"complete": 0,
"nodes": [
{
"asi": "domain.com",
"sid": "1234",
"rid": "63_85820_1571331626",
"hp": 1
}
]
}
}
},
"regs": {
"coppa": 0
},
"ext": {
"zone_list": [
104369
]
}
}