Bid Request Examples
note
BidMachine exchange currently works with Open RTB 2.3 and 2.5. Provided examples are only valid for Open RTB 2.3.
Banner Bid Request
Banner Bid Request Example
Banner Bid Request
{
"allimps": 0,
"app":
{
"bundle": "ru.kuchaknig.android.freebooks.scifi",
"cat":
[
"IAB1-1"
],
"ext":
{
"badv":
[],
"bcat":
[],
"packagename": "ru.kuchaknig.android.freebooks.scifi"
},
"id": "16848",
"name": "Фантастика",
"paid": 0,
"publisher":
{
"id": "618",
"name": "Роман"
},
"storeurl": "https://play.google.com/store/apps/details?id=ru.kuchaknig.android.freebooks.scifi&hl=en",
"ver": "2.9.37"
},
"at": 2,
"badv":
[],
"bcat":
[],
"cur":
[
"USD"
],
"device":
{
"carrier": "250-01",
"connectiontype": 3,
"devicetype": 4,
"geo":
{
"country": "RUS",
"lat": 56.8519,
"lon": 60.6122,
"type": 2,
"utcoffset": 300,
"zip": "620002"
},
"h": 1280,
"hwv": "DOOGEE HT16",
"ifa": "6d670e54-ffe3-4318-9100-dd600ee040c4",
"ip": "213.87.249.67",
"js": 1,
"language": "ru",
"lmt": 0,
"make": "DOOGEE",
"model": "DOOGEE HT16",
"os": "android",
"osv": "6.0",
"ua": "Mozilla/5.0 (Linux; Android 4.0.4; Galaxy Nexus Build/IMM76B) AppleWebKit/535.19(KHTML, like Gecko) Chrome/18.0.1025.133 Mobile Safari/535.19",
"w": 720
},
"id": "d5260eec-75d9-4f7d-86bc-22b01b4c779e",
"imp":
[
{
"banner":
{
"api":
[
5,
3
],
"battr":
[
5,
8,
9,
10,
14
],
"h": 50,
"mimes":
[
"image/jpg",
"image/gif",
"image/png"
],
"w": 320
},
"bidfloor": 0.945,
"bidfloorcur": "USD",
"displaymanager": "appodeal",
"displaymanagerver": "1.15.8",
"id": "e58013b7-3e6e-4bcf-9121-1bcedeeb319c",
"instl": 0,
"tagid": "1"
}
],
"source":
{
"ext":
{
"schain":
{
"complete": 1,
"nodes":
[
{
"asi": "seller.com",
"hp": 1,
"rid": "7578222740099842730",
"sid": "210676"
},
{
"asi": "bidmachine.io",
"hp": 1,
"rid": "ce4d7ece-aa68-4e9b-91f5-fc581ed0bde4",
"sid": "124"
}
],
"ver": "1.0"
}
},
"fd": 1,
"tid": "7578222740099842730"
},
"tmax": 500,
"user":
{
"gender": "F",
"geo":
{
"country": "RUS",
"lat": 56.8519,
"lon": 60.6122,
"type": 2,
"utcoffset": 300,
"zip": "620002"
}
}
}
Interstitial Bid Request
info
If Exchange is requesting a rewarded (non-skippable) interstitial, then we ALWAYS send "battr": [16] in Banner object. We also send imp.banner.ext.bannertype: "rewarded" inside bid request.
If Exchange is requesting a skippable interstitial, then we DO NOT send "battr": [16] in Banner object.
Interstitial Bid Request Example
Interstitial Bid Request
{
"app":
{
"bundle": "1214661054",
"cat":
[
"IAB1-6",
"IAB14"
],
"ext":
{
"badv":
{},
"bcat":
{},
"packagename": "com.boom.topaudio"
},
"id": "68629",
"name": "Top Audio",
"publisher":
{
"id": "1582",
"name": "Роман"
},
"storeurl": "https://itunes.apple.com/de/app/top-audio-excellent-player/id1214661054?mt=8&uo=4",
"ver": "1.1"
},
"at": 2,
"cur":
[
"USD"
],
"device":
{
"carrier": "250-02",
"connectiontype": 2,
"devicetype": 4,
"geo":
{
"city": "Troitsa",
"country": "RUS",
"ext":
{
"old_geo":
{
"country": "RUS",
"lat": 55.4792,
"lon": 37.3086,
"type": 2,
"utcoffset": 180,
"zip": "142190"
}
},
"ipservice": 3,
"lat": 55.4792,
"lon": 37.3086,
"type": 2,
"utcoffset": 180,
"zip": "142190"
},
"h": 568,
"hwv": "iPhone6,2",
"ifa": "10133A31-C4BF-489E-A310-B9241861E439",
"ip": "212.41.49.81",
"js": 1,
"language": "ru",
"make": "Apple",
"model": "iPhone6,2",
"os": "ios",
"osv": "10.1.1",
"ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 10_1_1 like Mac OS X) AppleWebKit/602.2.14 (KHTML, like Gecko) Mobile/14B100",
"w": 320
},
"id": "12f71145-a0f0-4b8b-a513-c051d0bb4159",
"imp":
[
{
"banner":
{
"api":
[
5,
3
],
"battr":
[
14,
5,
8,
9,
10
],
"h": 480,
"mimes":
[
"image/jpg",
"image/gif",
"image/png"
],
"w": 320
},
"bidfloor": 13.568,
"bidfloorcur": "USD",
"displaymanager": "appodeal",
"displaymanagerver": "1.3.9",
"id": "e9761ecc-f2fb-47b0-99d4-bc1a67cab07d",
"instl": 1,
"tagid": "3"
}
],
"source":
{
"ext":
{
"schain":
{
"complete": 1,
"nodes":
[
{
"asi": "fyber.com",
"hp": 1,
"rid": "7578222740099842730",
"sid": "210676"
},
{
"asi": "bidmachine.io",
"hp": 1,
"rid": "ce4d7ece-aa68-4e9b-91f5-fc581ed0bde4",
"sid": "124"
}
],
"ver": "1.0"
}
},
"fd": 1,
"tid": "7578222740099842730"
},
"tmax": 500,
"user":
{
"gender": "O",
"geo":
{
"country": "RUS",
"lat": 55.4792,
"lon": 37.3086,
"type": 2,
"utcoffset": 180,
"zip": "142190"
}
}
}
Rewarded Interstitial Bid Request
info
For nonskippalbe (rewarded interstitials) we add "imp.banner.ext.bannertype: "rewarded" to bid request
Rewarded Bid Request Example
Rewarded Bid Request
{
"app":
{
"bundle": "1214661054",
"cat":
[
"IAB1-6",
"IAB14"
],
"ext":
{
"badv":
{},
"bcat":
{},
"packagename": "com.boom.topaudio"
},
"id": "68629",
"name": "Top Audio",
"publisher":
{
"id": "1582",
"name": "Роман"
},
"storeurl": "https://itunes.apple.com/de/app/top-audio-excellent-player/id1214661054?mt=8&uo=4",
"ver": "1.1"
},
"at": 2,
"cur":
[
"USD"
],
"device":
{
"carrier": "250-02",
"connectiontype": 2,
"devicetype": 4,
"geo":
{
"city": "Troitsa",
"country": "RUS",
"ext":
{
"old_geo":
{
"country": "RUS",
"lat": 55.4792,
"lon": 37.3086,
"type": 2,
"utcoffset": 180,
"zip": "142190"
}
},
"ipservice": 3,
"lat": 55.4792,
"lon": 37.3086,
"type": 2,
"utcoffset": 180,
"zip": "142190"
},
"h": 568,
"hwv": "iPhone6,2",
"ifa": "10133A31-C4BF-489E-A310-B9241861E439",
"ip": "212.41.49.81",
"js": 1,
"language": "ru",
"make": "Apple",
"model": "iPhone6,2",
"os": "ios",
"osv": "10.1.1",
"ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 10_1_1 like Mac OS X) AppleWebKit/602.2.14 (KHTML, like Gecko) Mobile/14B100",
"w": 320
},
"id": "12f71145-a0f0-4b8b-a513-c051d0bb4159",
"imp":
[
{
"banner":
{
"api":
[
5,
3
],
"battr":
[
14,
5,
8,
9,
10
],
"ext":
{
"bannertype": "rewarded"
},
"h": 480,
"mimes":
[
"image/jpg",
"image/gif",
"image/png"
],
"w": 320
},
"bidfloor": 13.568,
"bidfloorcur": "USD",
"displaymanager": "appodeal",
"displaymanagerver": "1.3.9",
"id": "e9761ecc-f2fb-47b0-99d4-bc1a67cab07d",
"instl": 1,
"tagid": "3"
}
],
"source":
{
"ext":
{
"schain":
{
"complete": 1,
"nodes":
[
{
"asi": "fyber.com",
"hp": 1,
"rid": "7578222740099842730",
"sid": "210676"
},
{
"asi": "bidmachine.io",
"hp": 1,
"rid": "ce4d7ece-aa68-4e9b-91f5-fc581ed0bde4",
"sid": "124"
}
],
"ver": "1.0"
}
},
"fd": 1,
"tid": "7578222740099842730"
},
"tmax": 500,
"user":
{
"gender": "O",
"geo":
{
"country": "RUS",
"lat": 55.4792,
"lon": 37.3086,
"type": 2,
"utcoffset": 180,
"zip": "142190"
}
}
}
Video Bid Request
Video Bid Request Example
Video Bid Request
{
"allimps": 0,
"app":
{
"cat":
[
"IAB24"
],
"ext":
{
"app_uptime": 1317,
"badv":
{},
"bcat":
[
"IAB-30"
],
"click":
{},
"click_count": 0,
"finish":
{},
"finish_count": 4,
"imp":
{},
"imp_count": 4,
"packagename": "com.appodeal.sandbox",
"sdk": "2.1.10",
"session_id": 13,
"session_uptime": 15,
"tclick":
{},
"tfinish":
{
"interstitial": 4
},
"timp":
{
"interstitial": 4
}
},
"id": "7635",
"name": "Appodeal Sandbox",
"privacypolicy": 0,
"publisher":
{
"id": "1819",
"name": "pub name"
},
"storeurl": "This app is not in store yet",
"ver": "4.0"
},
"at": 2,
"badv":
[],
"bcat":
[
"IAB-30"
],
"cur":
[
"USD"
],
"device":
{
"connectiontype": 2,
"devicetype": 4,
"ext":
{
"battery": -100,
"rooted": "false"
},
"geo":
{
"city": "Kirov",
"country": "RUS",
"lat": 58.5969,
"lon": 49.6583,
"type": 2,
"utcoffset": 180,
"zip": "610000"
},
"h": 320,
"hwv": "x86_64",
"ifa": "CCBD556A-14A7-4E26-A52C-652355D4BA5A",
"ip": "77.72.140.9",
"js": 1,
"lmt": 0,
"make": "Apple",
"model": "x86_64",
"os": "iOS",
"osv": "11.2",
"ppi": 326,
"pxratio": 2,
"ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 11_2 like Mac OS X) AppleWebKit/604.4.7 (KHTML, like Gecko) Mobile/15C107",
"w": 568
},
"id": "ca0463e4-0c19-42c4-99e9-534713c6ee84",
"imp":
[
{
"bidfloor": 10.01,
"bidfloorcur": "USD",
"displaymanager": "appodeal",
"displaymanagerver": "2.1.10",
"id": "c1816ba0-d005-4d19-a11e-49147712e5b1",
"instl": 1,
"tagid": "82",
"video":
{
"api":
[],
"battr":
[
16
],
"delivery":
[
1,
2
],
"ext":
{
"videotype": "rewarded"
},
"h": 320,
"linearity": 1,
"maxduration": 30,
"mimes":
[
"video/mp4"
],
"minduration": 5,
"playbackmethod":
[
1
],
"protocols":
[
1,
2,
3,
4,
5,
6
],
"w": 480
}
}
],
"regs":
{
"coppa": 0
},
"tmax": 300,
"user":
{
"gender": "O",
"geo":
{
"city": "Kirov",
"country": "RUS",
"lat": 58.5969,
"lon": 49.6583,
"type": 2,
"utcoffset": 180,
"zip": "610000"
}
}
}
Native Ad Bid Request
Native Ad Bid Request Example
Native Ad Bid Request
{
"allimps": 0,
"app":
{
"bundle": "1134511982",
"cat":
[
"IAB9-30",
"IAB9-30"
],
"ext":
{
"badv":
[],
"bcat":
[],
"packagename": "com.tigrido.color6"
},
"id": "41944",
"name": "Color 6 (iOS)",
"paid": 0,
"privacypolicy": 0,
"publisher":
{
"id": "2089",
"name": "Aleksandr Filatov"
},
"storeurl": "https://itunes.apple.com/us/app/color-6/id1134511982?mt=8&uo=4",
"ver": "1.0"
},
"at": 2,
"badv":
[],
"bcat":
[],
"cur":
[
"USD"
],
"device":
{
"connectiontype": 2,
"devicetype": 4,
"geo":
{
"city": "Kirov",
"country": "RUS",
"lat": 58.5966,
"lon": 49.6601,
"type": 2,
"utcoffset": 180,
"zip": "249440"
},
"h": 568,
"hwv": "x86_64",
"ifa": "9611032A-935B-472A-878E-D4CBD9D4B192",
"ip": "77.72.140.9",
"js": 1,
"language": "en",
"lmt": 0,
"make": "Apple",
"model": "x86_64",
"os": "iOS",
"osv": "10.3.1",
"ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 10_3_1 like Mac OS X) AppleWebKit/603.1.30 (KHTML, like Gecko) Mobile/14E8301",
"w": 320
},
"id": "d97cef2b-36be-44fe-90ed-15f90666bbe7",
"imp":
[
{
"bidfloor": 0.0858,
"bidfloorcur": "USD",
"displaymanager": "appodeal",
"displaymanagerver": "1.3.9",
"id": "ae7c1c88-de6a-4893-8474-fe491024d159",
"instl": 0,
"native":
{
"api":
[
1,
2,
3,
4,
5
],
"request": "{\"assets\":[{\"id\":123,\"required\":1,\"title\":{\"len\":40}},{\"id\":124,\"required\":1,\"img\":{\"type\":1,\"wmin\":50,\"hmin\":50,\"mimes\": [\"image/jpg\",\"image/gif\",\"image/png\",\"image/jpeg\"]}},{\"id\":128,\"required\":1,\"img\":{\"type\":3,\"wmin\":1200,\"hmin\":627,\"mimes\":[\"image/jpg\",\"image/gif\",\"image/png\",\"image/jpeg\"]}},{\"id\":4,\"required\":0,\"video\":{\"mimes\":[\"video/mp4\"],\"minduration\":1,\"maxduration\":90,\"protocols\":[2,5]}},{\"id\":127,\"required\":1,\"data\":{\"type\":2}},{\"id\":7,\"required\":0,\"data\":{\"type\":3}},{\"id\":8,\"required\":0,\"data\":{\"type\":12}}],\"ver\":\"1.0\",\"plcmtcnt\":1,\"seq\":0}",
"ver": "1.1"
},
"tagid": "34"
}
],
"regs":
{
"coppa": 0
},
"tmax": 250,
"user":
{
"gender": "O",
"geo":
{
"city": "Kirov",
"country": "RUS",
"lat": 58.5966,
"lon": 49.6601,
"type": 2,
"utcoffset": 180,
"zip": "249440"
}
}
}