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 Demand-Side Platform (DSP). A software platform that automates bidding decisions in real-time and efficiently connects buyers and audiences through an ad exchange or SSP. Also known as a buy-side platform. 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 Interactive Advertising Bureau (IAB). An advertising business organization that develops industry standards, conducts research, and provides legal support for the online advertising industry. 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 An OpenRTB request that is sent from a supply-side platform (SSP) or ad exchange to the DSP requesting a bid response for potential impressions. A bid request contains information about the impression that allows the DSP to decide whether to bid on the impression. with a deal A private auction that allows publishers to offer specific inventory directly to selected buyers identified by a deal ID. Terms are negotiated and are agreed upon before the auction occurs.:
{ "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"], "site": { "cat": ["IAB1-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"],
"site": {
"domain": "genericnews.ca",
"cat": ["IAB12"]
},
"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"],
"site": {
"domain": "genericnews.ca",
"cat": ["IAB12"]
},
"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"], "app": { "name": "my news app", "privacypolicy": 1, "keywords": "keyword-a, keyword-b", "domain": "genericnews.ca", "cat": ["IAB12"], "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"
],
"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"
],
"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"
],
"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"
],
"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
{ "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 A digital ad made available in various creative types, defined by their size in pixels such as 300x250px. 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 Video ad-serving template (VAST). A communication standard between ad servers and video players in XML-format that describes the video player's expected behavior. 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>
