User Matching
Method 1: Index-initiated (secure)
An example of a secure user match request initiated by Index:
<img width="0" height="0" src="https://adserver.dsp.com/match?cm_dsp_id=12345&cm_user_id=OiN64EPS1JwAAChRYjwAAAA5&cm_callback_url=https%3A%2F%2Fdsum-sec.casalemedia.com%2Fcrum">
An example of a DSP response to a secure user match request initiated by Index:
https://dsum-sec.casalemedia.com/crum?cm_dsp_id=12345&external_user_id=550e8400-e29b-41d4-a716-446655440000Method 1: Index-initiated (Insecure)
An example of an insecure user match request initiated by Index:
<img width="0" height="0" src="http://adserver.dsp.com/match?cm_dsp_id=12345&cm_user_id=OAn example of a DSP response to an insecure user match request initiated by Index:
http://dsum.casalemedia.com/crum?cm_dsp_id=12345&external_user_id=550e8400-e29b-41d4-a716-446655440000Method 2: DSP-Initiated User Matching
An example of a secure DSP-initiated user match request:
https://dsum-sec.casalemedia.com/rrum?cm_dsp_id=12345&external_user_id=550e8400-e29b-41d4-a716-446655440000&cb=https%3A%2F%2Fdsp-endpoint.com%2Fusermatch%0AAn example of a secure redirect response to a DSP-initiated user match:
https://dsp-endpoint.com/usermatch?cmid=Vk789A258q32983dc4589ABqkShared User Matches (Secure)
An example of a secure user match, shared with Index by a DSP:
https://dsum-sec.casalemedia.com/rum?cm_dsp_id=12345&external_user_id=550e8400-e29b-41d4-a716-446655440000Shared User Matches (Insecure)
An example of a user match, shared with Index by a DSP:
http://dsum.casalemedia.com/rum?cm_dsp_id=12345&external_user_id=550e8400-e29b-41d4-a716-446655440000User Match Configuration Options
For DSPs using method 1, the id parameter may be the only parameter sent in the User Object (most fields omitted for clarity):
{
"id": "004D186C00CD5202",
"user":{
"id": "OiN64EPS1JwAAChRYjwAAAA5"
},
<all other objects>
}For DSPs using method 2, the User Object may be omitted from the request (most fields omitted for clarity):
{
"id": "004D186C00CD5202",
<all other objects>
}IX-initiated User Match with TCF Privacy Strings Example
In regions where privacy regulations apply, for example GDPR or CCPA, we will pass along the following IAB standard query string parameters when available in the gdpr, gdpr_consent or us_privacy fields. The following is a GDPR example:
<img src="https://match.dsp.com/match?cm_dsp_id=12345&cm_user_id=XYZ&gdpr=1&
gdpr_consent=CO6cZXbO6cZXbAGABCENA5C.YAAAAAAAAAAA&
cm_callback_url=https%3A%2F%2Fdsum-sec.casalemedia.com%2Fcrum">Bid Request Examples
Bid Request: Video
An example of a video bid request with a deal:
{ "device": { "ua": "Mozilla/5.0 (Windows NT 5.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/41.0.2272.101 Safari/537.36", "language": "EN", "ip": "73.55.27.72", "geo": { "lat": 40.7141667, "lon": -74.0063889, "country": "USA", "region": "NY", "regionfips104": "US36", "metro": "803", "city": "New York", "zip": "10001", "type": 2, "utcoffset": -300 } }, "imp": [ { "video": { "startdelay": 0, "w": 640, "mimes": ["video/mp4"], "minduration": 6, "api": [1, 2], "h": 360, "protocols": [2, 5], "linearity": 1, "maxduration": 15 }, "secure": 0, "ext": { "bcrid": ["5C7A9L","5G57H9"] }, "pmp": { "private_auction": 1, "deals": [ { "wseat": [ "401471" ], "bidfloor": 3.50, "at": 1, "id": "20202003" }, "ext":{ "name":"Placement-1" } ] }, "id": "1", "tagid": "161213_246812" } ], "bcat": ["IAB11-4", "IAB23", "IAB9-30", "IAB14-1", "IAB25-2"], "cattax": 6, "site": { "cat": ["IAB1-6"], "cattax": 6, "page": "genericnews.com", "ref": "genericnews.com", "id": "161213", "publisher": { "name": "Generic Media Company", "id": "12345" } }, "user": { "buyeruid": "8f3a4a46-a6c9-41b3-a7da-17c51be605ec", "id": "VPzhc8AoJCgAACHWr5cAAAAY" }, "id":"112d66c0-d576-4c57-caf7-bbf94123326d", "source": { "pchain": "50b1c356f2c5c8fc:2167" "ext": { "schain":{ "complete":1, "ver": "1.0" "nodes":[ { "asi": "indexexchange.com", "sid": "12345", "hp": 1, "rid": "A94E2BC017C0D68D" } ] } } } } }
Bid Request: Banner
An example of a banner bid request:
{
"device": {
"ua": "Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/41.0.2272.101 Safari/537.36",
"language": "EN",
"ip": "207.34.112.154",
"geo": {
"lat": 40.7141667,
"lon": -74.0063889,
"country": "USA",
"region": "NY",
"regionfips104": "US36",
"metro": "803",
"city": "New York",
"zip": "10001",
"type": 2,
"utcoffset": -300
}
},
"imp": [
{
"banner": {
"w": 728,
"h": 90,
"pos": 1,
"topframe": 0
},
"metric": [
{
"type": "viewability",
"value": 0.70,
"vendor": "INDEXEXCHANGE"
}],
"secure":
"ext": {
"bcrid": ["5C7A9L","5G57H9"]
},
"pmp": {
"deals": [{
"bidfloor": 3.50,
"at": 1,
"id": "33CBCEYE0214"
}
]
},
"id": "1",
"tagid": "3447033_246891"
}
],
"bcat": ["IAB7-41", "IAB3-7", "IAB11-4", "IAB8-5", "IAB23", "IAB9-30", "IAB1-7", "IAB14", "IAB12", "IAB14-1", "IAB25-2", "IAB24"],
"cattax": 6,
"site": {
"domain": "genericnews.ca",
"cat": ["IAB12"]
},
"cattax": 6,
"id": "3447033",
"publisher": {
"name": "News",
"id": "54321"
}
},
"user": {
"buyeruid": "79EB93BF-5BD9-8C24-385D-C3D3BECF5994",
"id": "vE4OjdHt54QAAEhFcacAAACq"
},
"id": "112d66c0-d576-4c57-caf7-bbf94123326d",
"ext": {
"tz": 360,
},
"source": {
"pchain": "50b1c356f2c5c8fc:2167"
"ext": {
"schain":{
"complete":1,
"ver": "1.0"
"nodes":[
{
"asi": "indexexchange.com",
"sid": "54321",
"hp": 1,
"rid": "A92AF4241C4A8FF6"
}
]
}
}
}
}
}
"secure":
"ext": {
"bcrid": ["5C7A9L","5G57H9"]
},
"pmp": {
"deals": [{
"bidfloor": 3.50,
"at": 1,
"id": "33CBCEYE0214"
}
]
},
"id": "1",
"tagid": "3447033_246891"
}
],
"bcat": ["IAB7-41", "IAB3-7", "IAB11-4", "IAB8-5", "IAB23", "IAB9-30", "IAB1-7", "IAB14", "IAB12", "IAB14-1", "IAB25-2", "IAB24"],
"cattax": 6,
"site": {
"domain": "genericnews.ca",
"cat": ["IAB12"]
},
"cattax": 6,
"id": "3447033",
"publisher": {
"name": "News",
"id": "54321"
}
},
"user": {
"buyeruid": "79EB93BF-5BD9-8C24-385D-C3D3BECF5994",
"id": "vE4OjdHt54QAAEhFcacAAACq"
},
"id": "112d66c0-d576-4c57-caf7-bbf94123326d",
"ext": {
"tz": 360,
},
"source": {
"pchain": "50b1c356f2c5c8fc:2167"
"ext": {
"schain":{
"complete":1,
"ver": "1.0"
"nodes":[
{
"asi": "indexexchange.com",
"sid": "54321",
"hp": 1,
"rid": "A92AF4241C4A8FF6"
}
]
}
}
}
}
}App Bid Request: Banner
An example of a mobile banner bid request for an app:
{ "device": { "ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 6_1 like Mac OS X) AppleWebKit/53 4.46 (KHTML, like Gecko) Version/5.1 Mobile/9A334 Safari/7534.48.3", "language": "EN", "ip": "207.34.112.154", "geo": { "lat": 40.7141667, "lon": -74.0063889, "country": "USA", "region": "NY", "regionfips104": "US36", "metro": "803", "city": "New York", "zip": "10001", "type": 2, "utcoffset": -300 }, "ifa": "AA000DFE74168477C70D291f574D344790E0BB11", "dpidsha1": "7ad708d34a4b91e46a7d6892835cdacfdc7026c3", "dpidmd5": "db4f7bcdf48ecf468f858b3b19cb35d0", "carrier": "VERIZON", "h": 2208, "w": 1242, "pxratio": 1.0, "make": "Apple", "model": "iPhone", "os": "iOS", "osv": "6.1", "ppi": 326, "hwv": "5s", "lmt": 0, }, "imp": [ { "banner": { "w": 728, "h": 90, "pos": 1, "topframe": 0 }, "secure": 0, "ext": { "bcrid": ["5C7A9L","5G57H9"] }, "skadn": { "version": "2.0", "versions": ["2.0", "2.1"], "sourceapp": "8800047117", "skadnetlist": { "max": 306, "excl": [2,8,10,55] "addl": [ "cdkw7geqsh.skadnetwork", "qyJfv329m4.skadnetwork" ] } } }, "pmp": { "deals": [{ "bidfloor": 3.50, "at": 1, "id": "33CBCEYE0214" } ] }, "id": "1", "tagid": "3447033_246789" } ], "bcat": ["IAB7-41", "IAB3-7", "IAB11-4", "IAB8-5", "IAB23", "IAB9-30", "IAB1-7", "IAB14", "IAB12", "IAB14-1", "IAB25-2", "IAB24"], "cattax": 6, "app": { "name": "my news app", "privacypolicy": 1, "keywords": "keyword-a, keyword-b", "domain": "genericnews.ca", "cat": ["IAB12"], "cattax": 6, "id": "3447033", "publisher": { "name": "News", "id": "54321" } }, "bundle": "ca.genericnews.app", "ver": "1.2.3", "storeurl": "https://itunes.apple.com/id123456789", "paid": 1 }, "user": { "buyeruid": "79EB93BF-5BD9-8C24-385D-C3D3BECF5994", "id": "vE4OjdHt54QAAEhFcacAAACq" }, "id":"112d66c0-d576-4c57-caf7-bbf94123326d", "regs: { "coppa": 0 }, "ext": { "tz": 360, }, "source": { "pchain": "50b1c356f2c5c8fc:2167" "ext": { "schain":{ "complete":1, "ver": "1.0" "nodes":[ { "asi": "indexexchange.com", "hp": 1, "sid": "54321", "rid": "A92AF4241C4A8FF6" } ] } } } } }
Bid Request: Banner for Topics API
An example of a banner bid request using the Topics API:
{
...
"user": {
"data": [{
"name": "topics.indexexchange.com", // Exchange-specific name for the data provider that observed the topic ID
"ext": {
"segtax": 600, // Taxonomy Mapping to V1
"segclass": "1" // Model Mapping
},
"segment": [{
"id": "10"// Topic ID
}]
},
{
"name": "topics.indexexchange.com", // Exchange-specific name for the data provider that observed the topic ID
"ext": {
"segtax": 601, // Taxonomy Mapping to V2
"segclass": "2" // Model Mapping
},
"segment": [{
"id": "12" // Topic ID
}]
}
]
}
}
Mobile App Bid Request with SKAdNetwork
{
"imp": [
{
"ext": {
"skadn": {
"version": "2.0",
"versions": ["2.0", "2.1"],
"sourceapp": "880047117",
"skadnetlist":{
"max": 306,
"excl": [2,8,10,55],
"addl": [
"cdkw7geqsh.skadnetwork",
"qyJfv329m4.skadnetwork"
]
}
}
}
}
]
}Native Bid Request: Non-video
{
"app": {
"bundle": "com.app.test",
"cat": [
"IAB22"
],
"cattax": 6,
"domain": "com.app.test",
"id": "123456",
"name": "TestApp",
"publisher": {
"id": "123456"
},
"storeurl": "https://play.google.com/store/apps/details?id=com.app.test"
},
"at": 1,
"bcat": [
"IAB7-41",
"IAB11-4",
"IAB22-1",
"IAB8-5"
],
"cattax": 6,
"device": {
"devicetype": 4,
"geo": {
"city": "New York",
"country": "US"
},
"h": 736,
"ip": "192.168.1.0",
"make": "Samsung",
"model": "SM-G973x",
"os": "Android",
"osv": "10",
"pxratio": 3,
"ua": "Mozilla/5.0 (Linux; Android 9; SAMSUNG SM-G977N Build/PPR1.180610.011) AppleWebKit/537.36 (KHTML, like Gecko) SamsungBrowser/9.2 Chrome/67.0.3396.87 Mobile Safari/537.36",
"w": 360
},
"id": "0000000000000",
"imp": [
{
"bidfloor": 0.05,
"id": "1",
"native": {
"request": "{\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"len\":25}},{\"data\":{\"len\":90,\"type\":2},\"id\":2,\"required\":1},{\"data\":{\"len\":15,\"type\":12},\"id\":3},{\"data\":{\"len\":25,\"type\":1},\"id\":4,\"required\":1},{\"id\":5,\"img\":{\"hmin\":627,\"type\":3,\"wmin\":1200},\"required\":1},{\"id\":6,\"img\":{\"hmin\":100,\"type\":2,\"wmin\":100}}],\"context\":1,\"contextsubtype\":10,\"eventtrackers\":[{\"event\":1,\"methods\":[1]}],\"ext\":{},\"plcmttype\":1,\"ver\":\"1.2\"}"
},
"secure": 1,
"tagid": "12345"
}
]
}Native Bid Request: Video
{
"app": {
"bundle": "com.app.test",
"cat": [
"IAB22"
],
"domain": "com.app.test",
"id": "123456",
"name": "TestApp",
"publisher": {
"id": "12345"
},
"storeurl": "https://play.google.com/store/apps/details?id=com.app.test"
},
"at": 1,
"bcat": [
"IAB7-41",
"IAB11-4"
],
"cattax": 6,
"device": {
"devicetype": 4,
"geo": {
"city": "New York",
"country": "US"
},
"h": 640,
"ip": "182.0.234.0",
"make": "Xiaomi",
"model": "Redmi Note 5A",
"os": "Android",
"osv": "7.1.2",
"pxratio": 2,
"ua": "Mozilla/5.0 (Linux; Android 7.1.2; Redmi Note 5A Build/N2G47H; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/83.0.4103.106 Mobile Safari/537.36 (Mobile; afma-sdk-a-v204217020.204217020.0)",
"w": 360
},
"id": "000000000000000",
"imp": [
{
"bidfloor": 0.05,
"id": "1",
"native": {
"request": "{\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"len\":25}},{\"data\":{\"len\":15,\"type\":12},\"id\":2},{\"data\":{\"len\":25,\"type\":1},\"id\":3,\"required\":1},{\"id\":4,\"img\":{\"hmin\":100,\"type\":2,\"wmin\":100},\"required\":1},{\"id\":5,\"required\":1,\"video\":{\"mimes\":[\"video/mp4\"],\"minduration\":15,\"maxduration\":30,\"protocols\":[2,3,5,6]}}],\"context\":1,\"contextsubtype\":10,\"eventtrackers\":[{\"event\":1,\"methods\":[1]}],\"ext\":{},\"plcmttype\":1,\"ver\":\"1.2\"}"
},
"secure": 1,
"tagid": "12345"
}
]
}
Bid Request: Outstream Video
{
"id":"2545D87B17C8853B",
"badv":[
"blocked-advertiser.com",
"blocked-brand.com"
],
"bcat":[
"IAB23",
"IAB25-2"
],
"cattax": 6,
"imp":[
{
"id":"1",
"secure":0,
"video":{
"minduration":6,
"maxduration":30,
"mimes":['video/mp4','application/javascript','video/webm'],
"protocols":[2,3,5,6],
"w":640,
"h":480,
"maxbitrate":1500,
"minbitrate":50,
"playbackmethod":[6],
"skip":1,
"plcmt":2,
"startdelay":0,
"maxextended":2,
"api":[2,7]
}Bid request: Multi-format (channel) Impression object
"imp": [
{
"id": "2545D87B17C8853CD",
"banner": {
"format": [
{
"w": 300,
"h": 250
},
{
"w": 320,
"h": 50
}
],
"w": 300,
"h": 250,
"pos": 3,
"id": "1"
},
"video": {
"mimes": [
"video/mp4",
"application/javascript"
],
"startdelay": 0,
"protocols": [
1,
4,
2,
5
],
"w": 640,
"h": 360,
"placement": 3,
"skip": 0,
"api": [
1,
2
]
},
"native": {
"request": "{\"ver\":\"1.2\",\"plcmttype\":1,\"plcmtcnt\":1,\"assets\":[{\"id\":5,\"required\":1,\"img\":{\"type\":3}},{\"id\":6,\"img\":{\"type\":1}},{\"id\":1,\"required\":1,\"title\":{\"len\":140}},{\"id\":2,\"data\":{\"type\":2}},{\"id\":3,\"data\":{\"type\":1}},{\"id\":4,\"data\":{\"type\":12}}],\"eventtrackers\":[{\"event\":1,\"methods\":[1,2]},{\"event\":2,\"methods\":[1,2]},{\"event\":3,\"methods\":[1,2]},{\"event\":4,\"methods\":[1,2]}]}",
"ver": "1.2"
},
"bidfloor": 0.312797
}
]Bid Request: Structured Pod
{
"id": "cj62dimonm9chvfnkqg0",
"imp": [
{
"id": "520921_1",
"video": {
"mimes": [
"video/mp4",
"video/H264"
],
"minduration": 1,
"maxduration": 31,
"protocols": [
2,
3,
5,
6
],
"w": 1280,
"h": 720,
"startdelay": 0,
"skip": 0,
"placement": 1,
"linearity": 1,
"sequence": 1,
"minbitrate": 240,
"maxbitrate": 30000,
"playbackmethod": [
1
],
"delivery": [
1,
2
],
"podid": "1",
"podseq": 0
...
},
"tagid": "520921_1",
"bidfloor": 12.7,
"secure": 1
...
},
{
"id": "520921_2",
"video": {
"mimes": [
"video/mp4",
"video/H264"
],
"minduration": 1,
"maxduration": 31,
"protocols": [
2,
3,
5,
6
],
"w": 1280,
"h": 720,
"startdelay": 0,
"skip": 0,
"placement": 1,
"linearity": 1,
"sequence": 2,
"minbitrate": 240,
"maxbitrate": 30000,
"playbackmethod": [
1
],
"delivery": [
1,
2
],
"podid": "1",
"podseq": 0
...
},
"tagid": "520921_2",
"bidfloor": 12.7,
"secure": 1
...
},
],
...
"app": {
"name": "PublisherName",
"bundle": "123456",
"domain": "PublisherName.com",
"storeurl":https://appstore.streamingplatform.com/details/123456",
"publisher": {
"id": "987654"
},
"content": {
"genre": "Sports",
"prodq": 1,
"context": 1,
"contentrating": "TV-PG",
"livestream": 1,
"len": 1800,
"language": "en"
}
}
},
"device": {
...
}
},
"user": {
...
}
},
"at": 1,
"tmax": 1250,
"badv": [
"blocked-advertiser.com",
"blocked-brand.com"
],Bid Request: Dynamic Pod
{
"id": "cj62dimonm9chvfnkqg0",
"imp": [
{
"id": "25874_1",
"video": {
"mimes": [
"video/mp4",
"video/H264"
],
"minduration": 1,
"maxduration": 31,
"protocols": [
2,
3,
5,
6
],
"w": 1280,
"h": 720,
"startdelay": 0,
"skip": 0,
"placement": 1,
"linearity": 1,
"sequence": 1,
"minbitrate": 240,
"maxbitrate": 30000,
"playbackmethod": [
1
],
"delivery": [
1,
2
],
"maxseq": 8,
"poddur": 150,
"podid": "1",
"podseq": 0,
"rqddurs": null
},
"bidfloor": 18.7,
"secure": 1
}
],
"app": {
"name": "PublisherName",
"bundle": "123456",
"domain": "PublisherName.com",
"storeurl": "https://appstore.streamingplatform.com/details/123456",
"publisher": {
"id": "987654"
},
"content": {
"genre": "Sports",
"prodq": 1,
"context": 1,
"contentrating": "TV-PG",
"livestream": 1,
"len": 1800,
"language": "en"
}
}
},
"device": {
...
}
},
"user": {
...
}
},
"at": 1,
"tmax": 1250,
"badv": [
"blocked-advertiser.com",
"blocked-brand.com"
],
"source": {
"tid": "cj62dimonm9chvfnkqgg"
},
"regs": {
"us_privacy": "1YNY",
"ext": {
"gdpr": 0
}
}
}
Bid Response Examples
Bid Response: Video
{ "cur": "USD", "id":"112d66c0-d576-4c57-caf7-bbf94123326d", "seatbid": [{ "seat": "1", "bid": [{ "adomain": ["website.org"], "price": 450, "dealid": "20202003", "id": "5496275328589086182", "adm": "<?xml version=\"1.0\" encoding=\"UTF-8\"?><VAST version=\"2.0\"><Ad id=\"602833\"><Wrapper><AdSystem></AdSystem><VASTAdTagURI>http://ad.server.com/path?price=${AUCTION_PRICE}</VASTAdTagURI><Error>http://ad.server.com/wrapper/error</Error><Impression>http://ad.server.com/wrapper/impression</Impression></Wrapper></Ad></VAST>", "impid": "1", }] }], }
Bid Response: Banner
An example of a banner bid response:
{ "id":"112d66c0-d576-4c57-caf7-bbf94123326d", "seatbid": [{ "bid": [{ "id": "93587a2a-d0b3-11e4-9a5c-d5086b3235de", "impid": "1", "price": 300.0, "attr": [3], "adomain": ["www.genericcar.ca"], "adm": "<script type=\"text/javascript\" src=\"http://p3.location.com/ed/3/?5045740&cid=12622&tid=5045740&oid=A92AF4241C4A8FF6&vid=vE4OjdHt54QAAEhFcacAAACq&p=${AUCTION_PRICE}&bd=k1h6KtCzEeSaXNUIazI13gY9gN1dCbmXnCjTIg&rnd=-5462374893397372747\"></script>" }], "seat": "339" }] }
App Bid Response: Banner
An example of a mobile banner bid response for an app:
{
"id":"112d66c0-d576-4c57-caf7-bbf94123326d",
"seatbid": [{
"bid": [{
"id": "93587a2a-d0b3-11e4-9a5c-d5086b3235de",
"bundle": "foo.com.mygame",
"impid": "1",
"price": 300.0,
"attr": [3],
"adomain": ["www.genericcar.ca"],
"adm": "<script type=\"text/javascript\" src=\"http://p3.location.com/ed/3/?5045740&cid=12622&tid=5045740&oid=A92AF4241C4A8FF6&vid=vE4OjdHt54QAAEhFcacAAACq&p=${AUCTION_PRICE}&bd=k1h6KtCzEeSaXNUIazI13gY9gN1dCbmXnCjTIg&rnd=-5462374893397372747\"></script>"
}],
"seat": "339"
}]
}App Bid Response with burl: Banner
An example of a mobile banner bid response for an app which contains the burl field:
{
"seatbid": [
{
"bid": [
{
"w": 300,
"impid": "1",
"attr": [],
"burl": "https://adserver.co./win-notify?impid=1&wp=${AUCTION_PRICE}",
"adm": "<iframe src=\"https://adserver.com/ed/?5045740&cid=12622&tid=5045740&oid=A92AF4241C4A8FF6&vid=vE4OjdHt54QAAEhFcacAAACq&p=${AUCTION_PRICE}\"width=\"300\" height=\"600\" scrolling=\"no\" frameBorder=\"0\"></iframe>",
"crid": "abc77au4",
"adid": "pC2Z6R12dxHbQ0DxEIxW",
"adomain": [
"www.genericcar.ca"
],
"h": 600,
"id": "1",
"price": 0.0224490158630113,
"cid": "f6l0r6n"
}
],
"seat": "1"
}
],
"cur": "USD",
"bidid": "B754A202472ABC2A",
"id": "112d66c0-d576-4c57-caf7-bbf94123326d"
}Mobile App Bid Response with SKAdNetwork
{ "id":"112d66c0-d576-4c57-caf7-bbf94123326d", "seatbid": [ { "bid": [ { "id": "93587a2a-d0b3-11e4-9a5c-d5086b3235de", "bundle": "foo.com.mygame", "impid": "1", "price": 300.0, "attr": [3], "adomain": ["www.genericcar.ca"], "adm":"<script type=\"text/javascript\" src=\"http://p3.location.com/ed/3/?5045740&cid=12622&tid=5045740&oid=A92AF4241C4A8FF6&vid=vE4OjdHt54QAAEhFcacAAACq&p=${AUCTION_PRICE}&bd=k1h6KtCzEeSaXNUIazI13gY9gN1dCbmXnCjTIg&rnd=-546237489339<,7372747\"</script>", "ext": { "skadn": { "version": "2.0", "network": "cdkw7geqsh.skadnetwork", "campaign": "45", "itunesitem": "123456789", "nonce": "473b1a16-b4ef-43ad-9591-fcf3aefa82a7", "sourceapp": "880047117", "timestamp": "1594406341", "signature": "MEQCIEQlmZRNfYzKBSE8QnhLTIHZZZWCFgZpRqRxHss65KoFAiAJgJKjdrWdkLUOCCjuEx2RmFS7daRzSVZRVZ8RyMyUXg==" } } } ], "seat": "339" } ] }
Native Bid Response: Non-video
{
"cur": "USD",
"id": "s9x0vc09sdj9e3",
"seatbid": [
{
"bid": [
{
"adid": "82347892173",
"adm": "{\"native\":{\"assets\":[{\"id\":1,\"title\":{\"text\":\"Native Example Ad\"}},{\"data\":{\"value\":\"Are we having fun yet???\"},\"id\":2},{\"data\":{\"value\":\"Tap here\"},\"id\":12},{\"id\":4,\"img\":{\"h\":627,\"url\":\"https:\/\/test.com?asset=mainImage\",\"w\":1200}},{\"id\":5,\"img\":{\"h\":100,\"url\":\"https:\/\/test.com?asset=iconImage\",\"w\":100}}],\"imptrackers\":[\"https:\/\/test.com?link=impressionTracker\"],\"link\":{\"url\":\"https:\/\/test.com?link=clickThroughUrl\"},\"ver\":\"1.1\"}}",
"adomain": [
"testSite.com"
],
"burl": "https://test.com?link=billingNoticeUrl",
"cid": "123456",
"crid": "123456",
"h": 1,
"id": "1",
"impid": "1",
"price": 3.50,
"w": 1
}
],
"seat": "1"
}
]
}
Native Bid Response: Video
{
"cur": "USD",
"id": "s9x0vc09sdj9e3",
"seatbid": [
{
"bid": [
{
"adid": "82347892173",
"adm": "{\"native\":{\"assets\":[{\"id\":1,\"title\":{\"text\":\"Native Example Ad\"}},{\"data\":{\"value\":\"Are we having fun yet???\"},\"id\":2},{\"data\":{\"value\":\"Tap here\"},\"id\":12},{\"id\":5,\"video\":{\"vasttag\":\"<VAST version=\\\"2.0\\\"><Ad id=\\\"preroll-1\\\"><InLine><AdSystem>2.0<\/AdSystem><AdTitle>5748406<\/AdTitle><Impression id=\\\"blah\\\"><![CDATA[ https:\/\/blah.casalemedia.com\/ifnotify?blah=10 ]]><\/Impression><Creatives><Creative><Linear><Duration>00:00:30<\/Duration><TrackingEvents\/><VideoClicks><ClickThrough id=\\\"scanscout\\\"><![CDATA[ https:\/\/kb.indexexchange.com\/IX_Library\/About_IX_Library.htm ]]><\/ClickThrough><\/VideoClicks><MediaFiles><MediaFile height=\\\"396\\\" width=\\\"600\\\" bitrate=\\\"496\\\" type=\\\"video\/mp4\\\" delivery=\\\"progressive\\\"><![CDATA[ https:\/\/sandbox.ht.indexexchange.com\/ht\/ixLibraryVideoMedia.mp4 ]]><\/MediaFile><\/MediaFiles><\/Linear><\/Creative><Creative\/><\/Creatives><\/InLine><\/Ad><\/VAST>\"}},{\"id\":4,\"img\":{\"h\":100,\"url\":\"https:\/\/test.com?asset=iconImage\",\"w\":100}}],\"imptrackers\":[\"https:\/\/test.com?link=impressionTracker\"],\"link\":{\"url\":\"https:\/\/test.com?link=clickThroughUrl\"},\"ver\":\"1.1\"}}",
"adomain": [
"testSite.com"
],
"cid": "123456",
"crid": "123456",
"h": 1,
"id": "1",
"impid": "1",
"price": 10.00,
"w": 1
}
],
"seat": "1"
}
]
}
Bid Response: Structured pod
{
"id": "cj5cnhamuq7o1c4upkl0",
"seatbid": [
{
"bid": [
{
"id": "1",
"impid": "520921_1",
"price": 19.71,
"adid": "1234567890",
"adm": "<VAST version=\"3.0\"><Ad id=\"1\"><Wrapper><AdSystem>..."
"adomain": [
"testDomain.com"
],
"cid": "222222",
"crid": "111111",
"dur": 30,
"ext": {
"dspid": 1234
}
}
],
"seat": "123123"
},
{
"bid": [
{
"id": "2",
"impid": "520921_3",
"price": 19.5,
"adid": "987654320",
"adm": "<VAST version=\"3.0\"><Ad id=\"1\"><Wrapper><AdSystem>..."
"adomain": [
"testDomain2.com"
],
"cid": "111111",
"crid": "222222",
"dealid": "Deal123",
"dur": 30,
"ext": {
"dspid": 1234
}
},
],
"seat": "32321"
}
],
"cur": "USD",
}Bid Response: Dynamic pod
{
"id": "cj5cnhamuq7o1c4upkl0",
"seatbid": [
{
"bid": [
{
"id": "1",
"impid": "25874_1",
"price": 13,
"adid": "1234567890",
"adm": "<VAST version=\"3.0\"><Ad id=\"1\"><Wrapper><AdSystem>..."
"adomain": [
"advertiserA.com"
],
"cid": "222222",
"crid": "111111",
"dur": 30,
"ext": {
"dspid": 1234
}
}],
"seat": "123123"
},
{
"bid": [
{
"id": "2",
"impid": "25874_1",
"price": 10,
"adid": "987654320",
"adm": "<VAST version=\"3.0\"><Ad id=\"1\"><Wrapper><AdSystem>..."
"adomain": [
"advertiserB.com"
],
"cid": "333333",
"crid": "4444444",
"dur": 15,
"ext": {
"dspid": 1234
}
}],
"seat": "123123"
},
{
"bid": [
{
"id": "3",
"impid": "25874_1",
"price": 12.85,
"adid": "987654320",
"adm": "<VAST version=\"3.0\"><Ad id=\"1\"><Wrapper><AdSystem>..."
"adomain": [
"advertiserC.com"
],
"cid": "5555555",
"crid": "6666666",
"dealid": "Deal123",
"dur": 30,
"ext": {
"dspid": 4321
}
}],
"seat": "321321"
}
],
"cur": "USD",
}
Win notification examples
An example of a win notification before the macro is replaced:
<script src=\"http://adserver.dsp.com/ad.js?price=${AUCTION_PRICE}\">>If the DSP produces the winning bid, the following is called when the creative is rendered:
<script src=\"http://adserver.dsp.com/ad.js?price=1.41\">>The following contains examples of macro usage via the <Impression> tag in the VAST data structure. An example of a win notification URL with a macro, before the macro is replaced:
<Impression><![CDATA{http://adserver.dsp.com/ad.js?price=${AUCTION_PRICE}]]></Impression>