{"__v":16,"_id":"55e8b5863fef5017000dbd9f","category":{"__v":3,"_id":"5603738d0c78b00d0039af47","pages":["561311eb41a9ec0d00a3fdf8","56958542cb14e11700f8a86e","56ad90e50c1cab0d009f658b"],"project":"5429beef1163360800ed31fa","version":"5429beef1163360800ed31fd","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-09-24T03:52:45.801Z","from_sync":false,"order":5,"slug":"exchange","title":"Marketplace"},"parentDoc":null,"project":"5429beef1163360800ed31fa","user":"55e74aae73169617001f2e78","version":{"__v":20,"_id":"5429beef1163360800ed31fd","project":"5429beef1163360800ed31fa","createdAt":"2014-09-29T20:19:59.904Z","releaseDate":"2014-09-29T20:19:59.904Z","categories":["5429beef1163360800ed31fe","55e74e1f5d36b32b002563fa","55e7500a73169617001f2e86","55e76b8196131b2f00bf4b72","55e89569cdbb8a350096df9c","55f8935eb089b71700a8364e","55f8a67d3bb4bb0d0022d093","55f9dbefc7ef770d00d9bf6d","5601c21a22ecf60d002b27b3","5601c21ff12aee0d001bb06e","5601c2256c7b610d00280db5","5601c22c22ecf60d002b27b4","5603738d0c78b00d0039af47","5626f70bfcbbc621004ebf52","566f7a1ae144ab0d00e9732f","566f85ca7820960d00c3b93d","56708ce43a32d20d00c45cbf","56708d436995210d003aad8e","5736471abe10a9200030732c","57a82c7aff9bd30e00a6f1c1"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-09-03T21:03:02.660Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":1,"body":"## AdsNative OpenRTB v2.3 Native Ad Specs ##\n\nAdsNative Marketplace is based on OpenRTB 2.3 Specs with Native Objects defined in the Native 1.0 Specs\n\nPlease see our validator console to test your bidder endpoint with AdsNative - http://openrtbvalidator.com/\n\n##  1. OpenRTB v2.3 Request\n\n### 1.1 What to Expect in a Bid Request:\n\nA. Creative assets in the native object\n\n  * The AdsNative Marketplace will usually mark the following creative assets as required: URL, Title, Image and Brand Name.\n  \n  * A summary is highly recommended, but not required.\n  \n  * ‘ctatext’ is typically only shown for app install ads in ANX.\n  \n  * The main image asset for the native ad is requested as type 3 from Native 1.0 specs.\n  \n  * ANX bid requests usually contain wmin and hmin, which should be considered as the minimun image size required in the response.\n  \n  * The bid request will also contains ‘w’ and ‘h’ value, which is a good representation of recommended image ratio. DSPs are NOT expected to resize the image to fit to the mentioned image size. ANX will resize or center the image to fit the placement.\n \nB. For ‘Recommendation Widgets’, ‘plcmtcnt’ will be greater than 1 otherwise its default is 1. In the case of ‘plcmtcnt’ > 1, DSPs can bid with multiple ‘bid’ objects.\n\nC. If the DSP has a cookie sync URL integrated with ANX, they can expect ‘buyeruid’ in ‘user’ object in the bid request.\n\nD. ANX uses ‘badv’ field to specify blocked advertiser for current bid request. DSPs are required to not bid with specified blocked advertisers.\n\n### 1.2 Ad Unit Types Supported by AdsNative (Field: adunit in native object):\n\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Value\",\n    \"h-1\": \"Name\",\n    \"0-0\": \"1\",\n    \"1-0\": \"2\",\n    \"2-0\": \"3\",\n    \"3-0\": \"4\",\n    \"4-0\": \"5\",\n    \"5-0\": \"501\",\n    \"6-0\": \"502\",\n    \"7-0\": \"503\",\n    \"0-1\": \"Paid Search Units\",\n    \"1-1\": \"Recommendation Widgets\",\n    \"2-1\": \"Promoted Listings\",\n    \"3-1\": \"In-Ad (IAB Standard) with Native Element Units\",\n    \"4-1\": \"Custom /”Can’t Be Contained”\",\n    \"5-1\": \"In-Feed\",\n    \"6-1\": \"End-of-Post\",\n    \"7-1\": \"In-Article\"\n  },\n  \"cols\": 2,\n  \"rows\": 8\n}\n[/block]\n### Examples\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/7FbrN6dNQJCh9PwngVlH_multidevice_nativeads.png\",\n        \"multidevice_nativeads.png\",\n        \"1399\",\n        \"561\",\n        \"#c59a99\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n### 1.3 ‘layout’ supported values:\n\n\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Value\",\n    \"h-1\": \"Name\",\n    \"h-2\": \"Comments\",\n    \"0-0\": \"3\",\n    \"1-0\": \"7\",\n    \"0-1\": \"News Feed\",\n    \"1-1\": \"Grid adjoining the content\",\n    \"0-2\": \"Passed only for 501 (In-Feed) adunit type\",\n    \"1-2\": \"Passed only for 2 (Recommendation Widgets) adunit type\"\n  },\n  \"cols\": 3,\n  \"rows\": 2\n}\n[/block]\nFor other ‘adunit’ types the ‘layout’ value is not present.\n\n\n## 2. OpenRTB v2.3 Response:\n\n### 2.1 What we expect in bid response and additional fields support\n\n  * ANX supports only ‘imptrackers’ and has no support for ‘jstracker’\n  \n  * ANX supports viewability tracking of the native ads according to IAB standards i.e. at least 50% of the should be in the view for at least 1 second. DSPs can specify tracking urls for the same in native.ext.viewabilitytrackers as an array of URLs. Please see the example below in section 4.1\n  \n  * Video Creatives: ANX supports standard video creative specification through VAST 2.0 and 3.0 through ‘vasttag’ value in ‘video’ object as specified by OpenRTB v2.3. Since, VAST allows various fields for variety of video experiences most of which are not applicable for native ads such as companion ads and interactive VPAID ads, we support only subset of VAST specifications. We do not support VPAID. The full extent of the fields supports by ANX is specified in the example below in section 4.2\n\n  * ANX requires DSPs to pass ‘nurl’ (seatbid.bid.nurl) for the win notice. ANX supports all macros defined in Table 4.4 in OpenRTB 2.3 specs. The win notice is sent, when an ad impression is served/rendered on the client side.\n \n  * All of the bid pricing in request and response is only processed in USD.\n \n  * DSPs are required to pass ‘adomain’ value for each bid request, which is a unique TLD value for each advertiser, for example ‘nike.com’. We accept single value per bid for this field. It’s important that DSPs maintain this mapping of adomain values for each advertiser/campaign/creative. In case a publisher blocks a particular advertiser we will pass this same ‘adomain’ value in ‘badv’ field in bid request next time indicating that current impression doesn’t support specified advertisers. If a DSP responds with the advertiser from ‘badv’ list, AdsNative will block that bid resulting into the lost bid for the DSP.\n\n\n## 3. OpenRTB v2.3 Example Bid Request:\n\n* Web Placement\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n    \\\"tmax\\\": 200,\\n    \\\"site\\\": {\\n        \\\"publisher\\\": {\\n            \\\"id\\\": \\\"123\\\"\\n        },\\n        \\\"domain\\\": \\\"example.com\\\",\\n        \\\"page\\\": \\\"http://example.com/some-page\\\",\\n        \\\"id\\\": \\\"1000\\\",\\n        \\\"sectioncat\\\": [\\\"IAB17\\\"]\\n    },\\n    \\\"imp\\\": [{\\n        \\\"tagid\\\": \\\"publisher-key\\\",\\n        \\\"bidfloorcur\\\": \\\"USD\\\",\\n        \\\"native\\\": {\\n            \\\"request\\\": \\\"{\\\\\\\"ver\\\\\\\":1,\\\\\\\"assets\\\\\\\":[{\\\\\\\"required\\\\\\\":1,\\\\\\\"id\\\\\\\":0,\\\\\\\"title\\\\\\\":{\\\\\\\"len\\\\\\\":120}},{\\\\\\\"required\\\\\\\":0,\\\\\\\"data\\\\\\\":{\\\\\\\"type\\\\\\\":2,\\\\\\\"len\\\\\\\":200},\\\\\\\"id\\\\\\\":1},{\\\\\\\"required\\\\\\\":0,\\\\\\\"data\\\\\\\":{\\\\\\\"type\\\\\\\":1},\\\\\\\"id\\\\\\\":2},{\\\\\\\"required\\\\\\\":0,\\\\\\\"data\\\\\\\":{\\\\\\\"type\\\\\\\":12},\\\\\\\"id\\\\\\\":3},{\\\\\\\"required\\\\\\\":0,\\\\\\\"id\\\\\\\":4,\\\\\\\"img\\\\\\\":{\\\\\\\"hmin\\\\\\\":60,\\\\\\\"wmin\\\\\\\":60,\\\\\\\"type\\\\\\\":1}},{\\\\\\\"required\\\\\\\":1,\\\\\\\"id\\\\\\\":5,\\\\\\\"img\\\\\\\":{\\\\\\\"hmin\\\\\\\":200,\\\\\\\"h\\\\\\\":260,\\\\\\\"type\\\\\\\":3,\\\\\\\"w\\\\\\\":300,\\\\\\\"wmin\\\\\\\":200}}],\\\\\\\"seq\\\\\\\":0,\\\\\\\"plcmtcnt\\\\\\\":1}\\\",\\n            \\\"ver\\\": \\\"1.0.0.1\\\"\\n        },\\n        \\\"bidfloor\\\": 0.2,\\n        \\\"id\\\": \\\"1\\\"\\n    }],\\n    \\\"device\\\": {\\n        \\\"os\\\": \\\"Windows 8\\\",\\n        \\\"language\\\": \\\"en\\\",\\n        \\\"ip\\\": \\\"207.98.184.143\\\",\\n        \\\"osv\\\": \\\"\\\",\\n        \\\"dnt\\\": 0,\\n        \\\"devicetype\\\": 2,\\n        \\\"model\\\": \\\"Other\\\",\\n        \\\"ua\\\": \\\"Mozilla\\\\/5.0 (Windows NT 6.2; WOW64) AppleWebKit\\\\/537.36 (KHTML, like Gecko) Chrome\\\\/40.0.2214.91 Safari\\\\/537.36\\\"\\n    },\\n    \\\"at\\\": 2,\\n    \\\"test\\\": 0,\\n    \\\"id\\\": \\\"7d08ff4e-7304-4609-9c89-8cc796e5826b\\\",\\n    \\\"user\\\": {\\n        \\\"buyeruid\\\": \\\"6a44c115-bae1-11e4-8cd2-a7bf6ea5c83c\\\",\\n        \\\"id\\\": \\\"e3265f488e43f1b240074b63aab77683ef126f1b\\\"\\n    }\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n* In App Placement\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n    \\\"badv\\\": [\\\"someapp.com\\\"],\\n    \\\"app\\\": {\\n        \\\"publisher\\\": {\\n            \\\"domain\\\": \\\"apppublisher.com\\\",\\n            \\\"id\\\": \\\"734\\\",\\n            \\\"name\\\": \\\"app_media\\\",\\n            \\\"cat\\\": [\\\"IAB9\\\", \\\"IAB12\\\", \\\"IAB18\\\", \\\"IAB24\\\"]\\n        },\\n        \\\"domain\\\": \\\"apppublisher.com\\\",\\n        \\\"ver\\\": \\\"\\\",\\n        \\\"id\\\": \\\"11257\\\",\\n        \\\"sectioncat\\\": [\\\"IAB9\\\", \\\"IAB12\\\", \\\"IAB18\\\", \\\"IAB24\\\"]\\n    },\\n    \\\"imp\\\": [{\\n        \\\"tagid\\\": \\\"oYJV6Ff-VekO0lWBn_xihcTQznxYO6vT1_UmcRQ0\\\",\\n        \\\"bidfloorcur\\\": \\\"USD\\\",\\n        \\\"native\\\": {\\n            \\\"request\\\": \\\"{\\\\\\\"adunit\\\\\\\":5,\\\\\\\"ver\\\\\\\":1,\\\\\\\"assets\\\\\\\":[{\\\\\\\"required\\\\\\\":0,\\\\\\\"id\\\\\\\":0,\\\\\\\"title\\\\\\\":{\\\\\\\"len\\\\\\\":120}},{\\\\\\\"required\\\\\\\":0,\\\\\\\"data\\\\\\\":{\\\\\\\"type\\\\\\\":2,\\\\\\\"len\\\\\\\":200},\\\\\\\"id\\\\\\\":1},{\\\\\\\"required\\\\\\\":0,\\\\\\\"data\\\\\\\":{\\\\\\\"type\\\\\\\":1},\\\\\\\"id\\\\\\\":2},{\\\\\\\"required\\\\\\\":0,\\\\\\\"data\\\\\\\":{\\\\\\\"type\\\\\\\":12},\\\\\\\"id\\\\\\\":3},{\\\\\\\"required\\\\\\\":0,\\\\\\\"id\\\\\\\":4,\\\\\\\"img\\\\\\\":{\\\\\\\"hmin\\\\\\\":60,\\\\\\\"wmin\\\\\\\":60,\\\\\\\"type\\\\\\\":1}},{\\\\\\\"required\\\\\\\":0,\\\\\\\"id\\\\\\\":5,\\\\\\\"img\\\\\\\":{\\\\\\\"hmin\\\\\\\":200,\\\\\\\"h\\\\\\\":400,\\\\\\\"type\\\\\\\":3,\\\\\\\"w\\\\\\\":600,\\\\\\\"wmin\\\\\\\":200}}],\\\\\\\"seq\\\\\\\":0,\\\\\\\"plcmtcnt\\\\\\\":1}\\\",\\n            \\\"ver\\\": \\\"1.0.0.1\\\"\\n        },\\n        \\\"bidfloor\\\": 0.5,\\n        \\\"id\\\": \\\"1\\\"\\n    }],\\n    \\\"device\\\": {\\n        \\\"os\\\": \\\"Android\\\",\\n        \\\"language\\\": \\\"es\\\",\\n        \\\"geo\\\": {\\n            \\\"country\\\": \\\"USA\\\"\\n        },\\n        \\\"osv\\\": \\\"4.0.4\\\",\\n        \\\"dnt\\\": 0,\\n        \\\"devicetype\\\": 1,\\n        \\\"ifa\\\": \\\"3903c43e-d4f6-47c4-b9e3-93558ad8e1aa\\\",\\n        \\\"ip\\\": \\\"107.77.216.229\\\",\\n        \\\"model\\\": \\\"Galaxy Nexus\\\",\\n        \\\"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\\\"\\n    },\\n    \\\"at\\\": 2,\\n    \\\"test\\\": 0,\\n    \\\"tmax\\\": 200,\\n    \\\"id\\\": \\\"8f44a122-9d9c-4ce0-8a52-8b77ad3a43c7\\\",\\n    \\\"user\\\": {\\n        \\\"id\\\": \\\"cf4833b390414c45b76bffd970daba1fdbd51482\\\"\\n    }\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n### 3.1 Native object from above request represented as JSON\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n    \\\"ver\\\": 1,\\n    \\\"assets\\\": [{\\n        \\\"required\\\": 1,\\n        \\\"id\\\": 0,\\n        \\\"title\\\": {\\n            \\\"len\\\": 120\\n        }\\n    }, {\\n        \\\"required\\\": 0,\\n        \\\"data\\\": {\\n            \\\"type\\\": 2,\\n            \\\"len\\\": 200\\n        },\\n        \\\"id\\\": 1\\n    }, {\\n        \\\"required\\\": 0,\\n        \\\"data\\\": {\\n            \\\"type\\\": 1\\n        },\\n        \\\"id\\\": 2\\n    }, {\\n        \\\"required\\\": 0,\\n        \\\"data\\\": {\\n            \\\"type\\\": 12\\n        },\\n        \\\"id\\\": 3\\n    }, {\\n        \\\"required\\\": 0,\\n        \\\"id\\\": 4,\\n        \\\"img\\\": {\\n            \\\"hmin\\\": 60,\\n            \\\"wmin\\\": 60,\\n            \\\"type\\\": 1\\n        }\\n    }, {\\n        \\\"required\\\": 1,\\n        \\\"id\\\": 5,\\n        \\\"img\\\": {\\n            \\\"hmin\\\": 200,\\n            \\\"h\\\": 260,\\n            \\\"type\\\": 3,\\n            \\\"w\\\": 300,\\n            \\\"wmin\\\": 200\\n        }\\n    }],\\n    \\\"seq\\\": 0,\\n    \\\"plcmtcnt\\\": 1,\\n    \\\"adunit\\\": 501\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n## 4. OpenRTB v2.3 Example Bid Response:\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n    \\\"cur\\\": \\\"USD\\\",\\n    \\\"elapsed\\\": 14.0900611877,\\n    \\\"seatbid\\\": [{\\n        \\\"bid\\\": [{\\n            \\\"nurl\\\": \\\"http://example-dsp.com/win-notie-url&price=${AUCTION_PRICE}\\\",\\n            \\\"cid\\\": \\\"78\\\",\\n            \\\"crid\\\": \\\"137\\\",\\n            \\\"price\\\": 2.0,\\n            \\\"adomain\\\": [\\\"example-brand.com\\\"],\\n            \\\"adm\\\": \\\"{\\\\\\\"native\\\\\\\":{\\\\\\\"ver\\\\\\\":1,\\\\\\\"assets\\\\\\\":[{\\\\\\\"id\\\\\\\":0,\\\\\\\"required\\\\\\\":0,\\\\\\\"title\\\\\\\":{\\\\\\\"text\\\\\\\":\\\\\\\"Example Title for An Awesome Brand\\\\\\\"}},{\\\\\\\"id\\\\\\\":1,\\\\\\\"required\\\\\\\":0,\\\\\\\"data\\\\\\\":{\\\\\\\"value\\\\\\\":\\\\\\\"This is some long filler description for that awesome brand\\\\\\\"}},{\\\\\\\"id\\\\\\\":2,\\\\\\\"required\\\\\\\":0,\\\\\\\"data\\\\\\\":{\\\\\\\"value\\\\\\\":\\\\\\\"Awesome Brand\\\\\\\"}},{\\\\\\\"id\\\\\\\":3,\\\\\\\"required\\\\\\\":0,\\\\\\\"data\\\\\\\":{\\\\\\\"value\\\\\\\":\\\\\\\"Read more\\\\\\\"}},{\\\\\\\"id\\\\\\\":4,\\\\\\\"required\\\\\\\":0,\\\\\\\"img\\\\\\\":{\\\\\\\"url\\\\\\\":\\\\\\\"http://example-brand.com/brand_logo.jpg\\\\\\\",\\\\\\\"w\\\\\\\":298,\\\\\\\"h\\\\\\\":224}},{\\\\\\\"id\\\\\\\":5,\\\\\\\"required\\\\\\\":0,\\\\\\\"img\\\\\\\":{\\\\\\\"url\\\\\\\":\\\\\\\"http://example-brand.com/ad_image.jpg\\\\\\\",\\\\\\\"w\\\\\\\":300,\\\\\\\"h\\\\\\\":260}}],\\\\\\\"link\\\\\\\":{\\\\\\\"url\\\\\\\":\\\\\\\"http://example-brand.com/r/some-landing-page/\\\\\\\"}}}\\\",\\n          \\t\\\"impid\\\": \\\"1\\\",\\n            \\\"id\\\": \\\"a34e3b0d-bd1e-11e4-8222-9ecfbe4e50b6\\\"\\n        }],\\n        \\\"group\\\": 0\\n    }],\\n    \\\"id\\\": \\\"7d08ff4e-7304-4609-9c89-8cc796e5826b\\\",\\n    \\\"bidid\\\": \\\"a34e3b0d-bd1e-11e4-8222-5041e5f685b6\\\"\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n\n### 4.1 ‘adm’ native object from above response represented as JSON\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n    \\\"native\\\": {\\n        \\\"ver\\\": 1,\\n        \\\"assets\\\": [{\\n            \\\"id\\\": 0,\\n            \\\"required\\\": 0,\\n            \\\"title\\\": {\\n                \\\"text\\\": \\\"Example Title for An Awesome Brand\\\"\\n            }\\n        }, {\\n            \\\"id\\\": 1,\\n            \\\"required\\\": 0,\\n            \\\"data\\\": {\\n                \\\"value\\\": \\\"This is some long filler description for that awesome brand\\\"\\n            }\\n        }, {\\n            \\\"id\\\": 2,\\n            \\\"required\\\": 0,\\n            \\\"data\\\": {\\n                \\\"value\\\": \\\"Awesome Brand\\\"\\n            }\\n        }, {\\n            \\\"id\\\": 3,\\n            \\\"required\\\": 0,\\n            \\\"data\\\": {\\n                \\\"value\\\": \\\"Read more\\\"\\n            }\\n        }, {\\n            \\\"id\\\": 4,\\n            \\\"required\\\": 0,\\n            \\\"img\\\": {\\n                \\\"url\\\": \\\"http:\\\\/\\\\/example-brand.com\\\\/brand_logo.jpg\\\",\\n                \\\"w\\\": 298,\\n                \\\"h\\\": 224\\n            }\\n        }, {\\n            \\\"id\\\": 5,\\n            \\\"required\\\": 0,\\n            \\\"img\\\": {\\n                \\\"url\\\": \\\"http:\\\\/\\\\/example-brand.com\\\\/ad_image.jpg\\\",\\n                \\\"w\\\": 300,\\n                \\\"h\\\": 260\\n            }\\n        }],\\n        \\\"link\\\": {\\n            \\\"url\\\": \\\"http:\\\\/\\\\/example-brand.com\\\\/r\\\\/some-landing-page\\\\/\\\"\\n        }\\n    }\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n### 4.2 Example of VAST tag supported by ANX showing full extent of supported fields\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"<?xml version=\\\"1.0\\\" encoding=\\\"utf-8\\\"?>\\n<VAST version=\\\"2.0\\\">    \\n    <Ad id=\\\"229\\\">\\n        <InLine>\\n            <AdSystem version=\\\"4.11.1-36\\\">DSP1</AdSystem>\\n            <AdTitle><![CDATA[DSP creative 1]]></AdTitle>\\n            <Description><![CDATA[]]></Description>\\n            <Error><![CDATA[http://t4.liverail.com/?metric=error&erc=[ERRORCODE]&pos=0&coid=135&pid=1331&nid=1331&oid=229&olid=2291331&cid=331&tpcid=&vid=&amid=&cc=default&pp=&vi=0&vv=&sg=&tsg=&pmu=0&pau=0&psz=0&ctx=&tctx=&coty=7&adt=0&did=&buid=&scen=&mca=&mma=&mct=0&url=&trid=554005d777fa11.82693438&bidf=0.10000&bids=0.00000&bidt=1&bidh=0&bidlaf=0&sdk=0&cb=7847.73.223.72.169.0&ver=1&w=&wy=&x=&y=&xy=&redirect=]]></Error>\\n            <Impression id=\\\"LR\\\"><![CDATA[http://t4.liverail.com/?metric=impression&cofl=0&flid=0&pos=0&coid=135&pid=1331&nid=1331&oid=229&olid=2291331&cid=331&tpcid=&vid=&amid=&cc=default&pp=&vi=0&vv=&sg=&tsg=&pmu=0&pau=0&psz=0&ctx=&tctx=&coty=7&adt=0&did=&buid=&scen=&mca=&mma=&mct=0&url=&trid=554005d777fa11.82693438&bidf=0.10000&bids=0.00000&bidt=1&bidh=0&bidlaf=0&sdk=0&cb=7847.73.223.72.169.0&ver=1&w=&wy=&x=121&y=121&xy=0b79&z2=0.00100]]></Impression>\\n            <Impression id=\\\"QC\\\"><![CDATA[http://pixel.quantserve.com/pixel/p-d05JkuPGiy-jY.gif?r=7847]]></Impression>\\n            <Impression id=\\\"CS\\\"><![CDATA[http://b.scorecardresearch.com/p?c1=1&c2=9864668&c3=1331&c4=&c5=09]]></Impression>\\n            <Impression><![CDATA[http://t1.clipkit.de/liverail?action=lr_impression]]></Impression>\\n            <Creatives>\\n                <Creative sequence=\\\"1\\\" id=\\\"331\\\">\\n                    <Linear>\\n                        <Duration>00:00:11</Duration>\\n                        <TrackingEvents>\\n                            <Tracking event=\\\"firstQuartile\\\"><![CDATA[http://t4.liverail.com/?metric=view25&pos=0&coid=135&pid=1331&nid=1331&oid=229&olid=2291331&cid=331&tpcid=&vid=&amid=&cc=default&pp=&vi=0&vv=&sg=&tsg=&pmu=0&pau=0&psz=0&ctx=&tctx=&coty=7&adt=0&did=&buid=&scen=&mca=&mma=&mct=0&url=&trid=554005d777fa11.82693438&bidf=0.10000&bids=0.00000&bidt=1&bidh=0&bidlaf=0&sdk=0&cb=7847.73.223.72.169.0&ver=1&w=&wy=&x=&y=&xy=]]></Tracking>\\n                            <Tracking event=\\\"midpoint\\\"><![CDATA[http://t4.liverail.com/?metric=view50&pos=0&coid=135&pid=1331&nid=1331&oid=229&olid=2291331&cid=331&tpcid=&vid=&amid=&cc=default&pp=&vi=0&vv=&sg=&tsg=&pmu=0&pau=0&psz=0&ctx=&tctx=&coty=7&adt=0&did=&buid=&scen=&mca=&mma=&mct=0&url=&trid=554005d777fa11.82693438&bidf=0.10000&bids=0.00000&bidt=1&bidh=0&bidlaf=0&sdk=0&cb=7847.73.223.72.169.0&ver=1&w=&wy=&x=&y=&xy=]]></Tracking>\\n                            <Tracking event=\\\"thirdQuartile\\\"><![CDATA[http://t4.liverail.com/?metric=view75&pos=0&coid=135&pid=1331&nid=1331&oid=229&olid=2291331&cid=331&tpcid=&vid=&amid=&cc=default&pp=&vi=0&vv=&sg=&tsg=&pmu=0&pau=0&psz=0&ctx=&tctx=&coty=7&adt=0&did=&buid=&scen=&mca=&mma=&mct=0&url=&trid=554005d777fa11.82693438&bidf=0.10000&bids=0.00000&bidt=1&bidh=0&bidlaf=0&sdk=0&cb=7847.73.223.72.169.0&ver=1&w=&wy=&x=&y=&xy=]]></Tracking>\\n                            <Tracking event=\\\"complete\\\"><![CDATA[http://t4.liverail.com/?metric=view100&pos=0&coid=135&pid=1331&nid=1331&oid=229&olid=2291331&cid=331&tpcid=&vid=&amid=&cc=default&pp=&vi=0&vv=&sg=&tsg=&pmu=0&pau=0&psz=0&ctx=&tctx=&coty=7&adt=0&did=&buid=&scen=&mca=&mma=&mct=0&url=&trid=554005d777fa11.82693438&bidf=0.10000&bids=0.00000&bidt=1&bidh=0&bidlaf=0&sdk=0&cb=7847.73.223.72.169.0&ver=1&w=&wy=&x=&y=&xy=]]></Tracking>\\n                            <Tracking event=\\\"mute\\\"><![CDATA[http://t4.liverail.com/?metric=mute&pos=0&coid=135&pid=1331&nid=1331&oid=229&olid=2291331&cid=331&tpcid=&vid=&amid=&cc=default&pp=&vi=0&vv=&sg=&tsg=&pmu=0&pau=0&psz=0&ctx=&tctx=&coty=7&adt=0&did=&buid=&scen=&mca=&mma=&mct=0&url=&trid=554005d777fa11.82693438&bidf=0.10000&bids=0.00000&bidt=1&bidh=0&bidlaf=0&sdk=0&cb=7847.73.223.72.169.0&ver=1&w=&wy=&x=&y=&xy=]]></Tracking>\\n                            <Tracking event=\\\"unmute\\\"><![CDATA[http://t4.liverail.com/?metric=unmute&pos=0&coid=135&pid=1331&nid=1331&oid=229&olid=2291331&cid=331&tpcid=&vid=&amid=&cc=default&pp=&vi=0&vv=&sg=&tsg=&pmu=0&pau=0&psz=0&ctx=&tctx=&coty=7&adt=0&did=&buid=&scen=&mca=&mma=&mct=0&url=&trid=554005d777fa11.82693438&bidf=0.10000&bids=0.00000&bidt=1&bidh=0&bidlaf=0&sdk=0&cb=7847.73.223.72.169.0&ver=1&w=&wy=&x=&y=&xy=]]></Tracking>\\n                            <Tracking event=\\\"pause\\\"><![CDATA[http://t4.liverail.com/?metric=pause&pos=0&coid=135&pid=1331&nid=1331&oid=229&olid=2291331&cid=331&tpcid=&vid=&amid=&cc=default&pp=&vi=0&vv=&sg=&tsg=&pmu=0&pau=0&psz=0&ctx=&tctx=&coty=7&adt=0&did=&buid=&scen=&mca=&mma=&mct=0&url=&trid=554005d777fa11.82693438&bidf=0.10000&bids=0.00000&bidt=1&bidh=0&bidlaf=0&sdk=0&cb=7847.73.223.72.169.0&ver=1&w=&wy=&x=&y=&xy=]]></Tracking>\\n                            <Tracking event=\\\"resume\\\"><![CDATA[http://t4.liverail.com/?metric=resume&pos=0&coid=135&pid=1331&nid=1331&oid=229&olid=2291331&cid=331&tpcid=&vid=&amid=&cc=default&pp=&vi=0&vv=&sg=&tsg=&pmu=0&pau=0&psz=0&ctx=&tctx=&coty=7&adt=0&did=&buid=&scen=&mca=&mma=&mct=0&url=&trid=554005d777fa11.82693438&bidf=0.10000&bids=0.00000&bidt=1&bidh=0&bidlaf=0&sdk=0&cb=7847.73.223.72.169.0&ver=1&w=&wy=&x=&y=&xy=]]></Tracking>\\n                            <Tracking event=\\\"fullscreen\\\"><![CDATA[http://t4.liverail.com/?metric=fullscreen&pos=0&coid=135&pid=1331&nid=1331&oid=229&olid=2291331&cid=331&tpcid=&vid=&amid=&cc=default&pp=&vi=0&vv=&sg=&tsg=&pmu=0&pau=0&psz=0&ctx=&tctx=&coty=7&adt=0&did=&buid=&scen=&mca=&mma=&mct=0&url=&trid=554005d777fa11.82693438&bidf=0.10000&bids=0.00000&bidt=1&bidh=0&bidlaf=0&sdk=0&cb=7847.73.223.72.169.0&ver=1&w=&wy=&x=&y=&xy=]]></Tracking>\\n                            <Tracking event=\\\"close\\\"><![CDATA[http://t4.liverail.com/?metric=close&pos=0&coid=135&pid=1331&nid=1331&oid=229&olid=2291331&cid=331&tpcid=&vid=&amid=&cc=default&pp=&vi=0&vv=&sg=&tsg=&pmu=0&pau=0&psz=0&ctx=&tctx=&coty=7&adt=0&did=&buid=&scen=&mca=&mma=&mct=0&url=&trid=554005d777fa11.82693438&bidf=0.10000&bids=0.00000&bidt=1&bidh=0&bidlaf=0&sdk=0&cb=7847.73.223.72.169.0&ver=1&w=&wy=&x=&y=&xy=]]></Tracking>\\n                            <Tracking event=\\\"acceptInvitation\\\"><![CDATA[http://t4.liverail.com/?metric=accept&pos=0&coid=135&pid=1331&nid=1331&oid=229&olid=2291331&cid=331&tpcid=&vid=&amid=&cc=default&pp=&vi=0&vv=&sg=&tsg=&pmu=0&pau=0&psz=0&ctx=&tctx=&coty=7&adt=0&did=&buid=&scen=&mca=&mma=&mct=0&url=&trid=554005d777fa11.82693438&bidf=0.10000&bids=0.00000&bidt=1&bidh=0&bidlaf=0&sdk=0&cb=7847.73.223.72.169.0&ver=1&w=&wy=&x=&y=&xy=]]></Tracking>\\n                        </TrackingEvents> \\n                        <VideoClicks>\\n                            <ClickThrough><![CDATA[http://t4.liverail.com/?metric=clickthru&pos=0&coid=135&pid=1331&nid=1331&oid=229&olid=2291331&cid=331&tpcid=&vid=&amid=&cc=default&pp=&vi=0&vv=&sg=&tsg=&pmu=0&pau=0&psz=0&ctx=&tctx=&coty=7&adt=0&did=&buid=&scen=&mca=&mma=&mct=0&url=&trid=554005d777fa11.82693438&bidf=0.10000&bids=0.00000&bidt=1&bidh=0&bidlaf=0&sdk=0&cb=7847.73.223.72.169.0&ver=1&w=&wy=&x=&y=&xy=&redirect=http%3A%2F%2Fliverail.com%2F]]></ClickThrough>\\n                        </VideoClicks>\\n                        <MediaFiles>\\n                            <MediaFile delivery=\\\"progressive\\\" bitrate=\\\"256\\\" width=\\\"480\\\" height=\\\"352\\\" type=\\\"video/x-flv\\\"><![CDATA[http://cdn.liverail.com/adasset4/1331/229/331/lo.flv]]></MediaFile>\\n                            <MediaFile delivery=\\\"progressive\\\" bitrate=\\\"256\\\" width=\\\"640\\\" height=\\\"360\\\" type=\\\"video/x-ms-wmv\\\"><![CDATA[http://cdn.liverail.com/adasset4/1331/229/331/lo.wmv]]></MediaFile>\\n                            <MediaFile delivery=\\\"progressive\\\" bitrate=\\\"400\\\" width=\\\"320\\\" height=\\\"180\\\" type=\\\"video/mp4\\\"><![CDATA[http://cdn.liverail.com/adasset4/1331/229/331/lo.mp4]]></MediaFile>\\n                            <MediaFile delivery=\\\"progressive\\\" bitrate=\\\"400\\\" width=\\\"320\\\" height=\\\"180\\\" type=\\\"video/webm\\\"><![CDATA[http://cdn.liverail.com/adasset4/1331/229/331/lo.webm]]></MediaFile>\\n                            <MediaFile delivery=\\\"progressive\\\" bitrate=\\\"512\\\" width=\\\"480\\\" height=\\\"352\\\" type=\\\"video/x-flv\\\"><![CDATA[http://cdn.liverail.com/adasset4/1331/229/331/me.flv]]></MediaFile>\\n                            <MediaFile delivery=\\\"progressive\\\" bitrate=\\\"512\\\" width=\\\"640\\\" height=\\\"360\\\" type=\\\"video/x-ms-wmv\\\"><![CDATA[http://cdn.liverail.com/adasset4/1331/229/331/me.wmv]]></MediaFile>\\n                            <MediaFile delivery=\\\"progressive\\\" bitrate=\\\"600\\\" width=\\\"640\\\" height=\\\"480\\\" type=\\\"video/mp4\\\"><![CDATA[http://cdn.liverail.com/adasset4/1331/229/331/me.mp4]]></MediaFile>\\n                            <MediaFile delivery=\\\"progressive\\\" bitrate=\\\"600\\\" width=\\\"640\\\" height=\\\"480\\\" type=\\\"video/webm\\\"><![CDATA[http://cdn.liverail.com/adasset4/1331/229/331/me.webm]]></MediaFile>\\n                            <MediaFile delivery=\\\"progressive\\\" bitrate=\\\"1024\\\" width=\\\"480\\\" height=\\\"352\\\" type=\\\"video/mp4\\\"><![CDATA[http://cdn.liverail.com/adasset4/1331/229/331/hi.mp4]]></MediaFile>\\n                            <MediaFile delivery=\\\"progressive\\\" bitrate=\\\"1024\\\" width=\\\"480\\\" height=\\\"352\\\" type=\\\"video/webm\\\"><![CDATA[http://cdn.liverail.com/adasset4/1331/229/331/hi.webm]]></MediaFile>\\n                            <MediaFile delivery=\\\"progressive\\\" bitrate=\\\"1024\\\" width=\\\"480\\\" height=\\\"352\\\" type=\\\"video/x-flv\\\"><![CDATA[http://cdn.liverail.com/adasset4/1331/229/331/hi.flv]]></MediaFile>\\n                            <MediaFile delivery=\\\"progressive\\\" bitrate=\\\"1024\\\" width=\\\"640\\\" height=\\\"360\\\" type=\\\"video/x-ms-wmv\\\"><![CDATA[http://cdn.liverail.com/adasset4/1331/229/331/hi.wmv]]></MediaFile>\\n                        </MediaFiles>\\n                    </Linear>\\n                </Creative>\\n            </Creatives>\\n            <Extensions>\\n            </Extensions>\\n        </InLine>\\n    </Ad>\\n</VAST>\",\n      \"language\": \"xml\"\n    }\n  ]\n}\n[/block]","excerpt":"","slug":"open-rtb","type":"basic","title":"DSPs / Open RTB 2.3"}

DSPs / Open RTB 2.3


## AdsNative OpenRTB v2.3 Native Ad Specs ## AdsNative Marketplace is based on OpenRTB 2.3 Specs with Native Objects defined in the Native 1.0 Specs Please see our validator console to test your bidder endpoint with AdsNative - http://openrtbvalidator.com/ ## 1. OpenRTB v2.3 Request ### 1.1 What to Expect in a Bid Request: A. Creative assets in the native object * The AdsNative Marketplace will usually mark the following creative assets as required: URL, Title, Image and Brand Name. * A summary is highly recommended, but not required. * ‘ctatext’ is typically only shown for app install ads in ANX. * The main image asset for the native ad is requested as type 3 from Native 1.0 specs. * ANX bid requests usually contain wmin and hmin, which should be considered as the minimun image size required in the response. * The bid request will also contains ‘w’ and ‘h’ value, which is a good representation of recommended image ratio. DSPs are NOT expected to resize the image to fit to the mentioned image size. ANX will resize or center the image to fit the placement. B. For ‘Recommendation Widgets’, ‘plcmtcnt’ will be greater than 1 otherwise its default is 1. In the case of ‘plcmtcnt’ > 1, DSPs can bid with multiple ‘bid’ objects. C. If the DSP has a cookie sync URL integrated with ANX, they can expect ‘buyeruid’ in ‘user’ object in the bid request. D. ANX uses ‘badv’ field to specify blocked advertiser for current bid request. DSPs are required to not bid with specified blocked advertisers. ### 1.2 Ad Unit Types Supported by AdsNative (Field: adunit in native object): [block:parameters] { "data": { "h-0": "Value", "h-1": "Name", "0-0": "1", "1-0": "2", "2-0": "3", "3-0": "4", "4-0": "5", "5-0": "501", "6-0": "502", "7-0": "503", "0-1": "Paid Search Units", "1-1": "Recommendation Widgets", "2-1": "Promoted Listings", "3-1": "In-Ad (IAB Standard) with Native Element Units", "4-1": "Custom /”Can’t Be Contained”", "5-1": "In-Feed", "6-1": "End-of-Post", "7-1": "In-Article" }, "cols": 2, "rows": 8 } [/block] ### Examples [block:image] { "images": [ { "image": [ "https://files.readme.io/7FbrN6dNQJCh9PwngVlH_multidevice_nativeads.png", "multidevice_nativeads.png", "1399", "561", "#c59a99", "" ] } ] } [/block] ### 1.3 ‘layout’ supported values: [block:parameters] { "data": { "h-0": "Value", "h-1": "Name", "h-2": "Comments", "0-0": "3", "1-0": "7", "0-1": "News Feed", "1-1": "Grid adjoining the content", "0-2": "Passed only for 501 (In-Feed) adunit type", "1-2": "Passed only for 2 (Recommendation Widgets) adunit type" }, "cols": 3, "rows": 2 } [/block] For other ‘adunit’ types the ‘layout’ value is not present. ## 2. OpenRTB v2.3 Response: ### 2.1 What we expect in bid response and additional fields support * ANX supports only ‘imptrackers’ and has no support for ‘jstracker’ * ANX supports viewability tracking of the native ads according to IAB standards i.e. at least 50% of the should be in the view for at least 1 second. DSPs can specify tracking urls for the same in native.ext.viewabilitytrackers as an array of URLs. Please see the example below in section 4.1 * Video Creatives: ANX supports standard video creative specification through VAST 2.0 and 3.0 through ‘vasttag’ value in ‘video’ object as specified by OpenRTB v2.3. Since, VAST allows various fields for variety of video experiences most of which are not applicable for native ads such as companion ads and interactive VPAID ads, we support only subset of VAST specifications. We do not support VPAID. The full extent of the fields supports by ANX is specified in the example below in section 4.2 * ANX requires DSPs to pass ‘nurl’ (seatbid.bid.nurl) for the win notice. ANX supports all macros defined in Table 4.4 in OpenRTB 2.3 specs. The win notice is sent, when an ad impression is served/rendered on the client side. * All of the bid pricing in request and response is only processed in USD. * DSPs are required to pass ‘adomain’ value for each bid request, which is a unique TLD value for each advertiser, for example ‘nike.com’. We accept single value per bid for this field. It’s important that DSPs maintain this mapping of adomain values for each advertiser/campaign/creative. In case a publisher blocks a particular advertiser we will pass this same ‘adomain’ value in ‘badv’ field in bid request next time indicating that current impression doesn’t support specified advertisers. If a DSP responds with the advertiser from ‘badv’ list, AdsNative will block that bid resulting into the lost bid for the DSP. ## 3. OpenRTB v2.3 Example Bid Request: * Web Placement [block:code] { "codes": [ { "code": "{\n \"tmax\": 200,\n \"site\": {\n \"publisher\": {\n \"id\": \"123\"\n },\n \"domain\": \"example.com\",\n \"page\": \"http://example.com/some-page\",\n \"id\": \"1000\",\n \"sectioncat\": [\"IAB17\"]\n },\n \"imp\": [{\n \"tagid\": \"publisher-key\",\n \"bidfloorcur\": \"USD\",\n \"native\": {\n \"request\": \"{\\\"ver\\\":1,\\\"assets\\\":[{\\\"required\\\":1,\\\"id\\\":0,\\\"title\\\":{\\\"len\\\":120}},{\\\"required\\\":0,\\\"data\\\":{\\\"type\\\":2,\\\"len\\\":200},\\\"id\\\":1},{\\\"required\\\":0,\\\"data\\\":{\\\"type\\\":1},\\\"id\\\":2},{\\\"required\\\":0,\\\"data\\\":{\\\"type\\\":12},\\\"id\\\":3},{\\\"required\\\":0,\\\"id\\\":4,\\\"img\\\":{\\\"hmin\\\":60,\\\"wmin\\\":60,\\\"type\\\":1}},{\\\"required\\\":1,\\\"id\\\":5,\\\"img\\\":{\\\"hmin\\\":200,\\\"h\\\":260,\\\"type\\\":3,\\\"w\\\":300,\\\"wmin\\\":200}}],\\\"seq\\\":0,\\\"plcmtcnt\\\":1}\",\n \"ver\": \"1.0.0.1\"\n },\n \"bidfloor\": 0.2,\n \"id\": \"1\"\n }],\n \"device\": {\n \"os\": \"Windows 8\",\n \"language\": \"en\",\n \"ip\": \"207.98.184.143\",\n \"osv\": \"\",\n \"dnt\": 0,\n \"devicetype\": 2,\n \"model\": \"Other\",\n \"ua\": \"Mozilla\\/5.0 (Windows NT 6.2; WOW64) AppleWebKit\\/537.36 (KHTML, like Gecko) Chrome\\/40.0.2214.91 Safari\\/537.36\"\n },\n \"at\": 2,\n \"test\": 0,\n \"id\": \"7d08ff4e-7304-4609-9c89-8cc796e5826b\",\n \"user\": {\n \"buyeruid\": \"6a44c115-bae1-11e4-8cd2-a7bf6ea5c83c\",\n \"id\": \"e3265f488e43f1b240074b63aab77683ef126f1b\"\n }\n}", "language": "json" } ] } [/block] * In App Placement [block:code] { "codes": [ { "code": "{\n \"badv\": [\"someapp.com\"],\n \"app\": {\n \"publisher\": {\n \"domain\": \"apppublisher.com\",\n \"id\": \"734\",\n \"name\": \"app_media\",\n \"cat\": [\"IAB9\", \"IAB12\", \"IAB18\", \"IAB24\"]\n },\n \"domain\": \"apppublisher.com\",\n \"ver\": \"\",\n \"id\": \"11257\",\n \"sectioncat\": [\"IAB9\", \"IAB12\", \"IAB18\", \"IAB24\"]\n },\n \"imp\": [{\n \"tagid\": \"oYJV6Ff-VekO0lWBn_xihcTQznxYO6vT1_UmcRQ0\",\n \"bidfloorcur\": \"USD\",\n \"native\": {\n \"request\": \"{\\\"adunit\\\":5,\\\"ver\\\":1,\\\"assets\\\":[{\\\"required\\\":0,\\\"id\\\":0,\\\"title\\\":{\\\"len\\\":120}},{\\\"required\\\":0,\\\"data\\\":{\\\"type\\\":2,\\\"len\\\":200},\\\"id\\\":1},{\\\"required\\\":0,\\\"data\\\":{\\\"type\\\":1},\\\"id\\\":2},{\\\"required\\\":0,\\\"data\\\":{\\\"type\\\":12},\\\"id\\\":3},{\\\"required\\\":0,\\\"id\\\":4,\\\"img\\\":{\\\"hmin\\\":60,\\\"wmin\\\":60,\\\"type\\\":1}},{\\\"required\\\":0,\\\"id\\\":5,\\\"img\\\":{\\\"hmin\\\":200,\\\"h\\\":400,\\\"type\\\":3,\\\"w\\\":600,\\\"wmin\\\":200}}],\\\"seq\\\":0,\\\"plcmtcnt\\\":1}\",\n \"ver\": \"1.0.0.1\"\n },\n \"bidfloor\": 0.5,\n \"id\": \"1\"\n }],\n \"device\": {\n \"os\": \"Android\",\n \"language\": \"es\",\n \"geo\": {\n \"country\": \"USA\"\n },\n \"osv\": \"4.0.4\",\n \"dnt\": 0,\n \"devicetype\": 1,\n \"ifa\": \"3903c43e-d4f6-47c4-b9e3-93558ad8e1aa\",\n \"ip\": \"107.77.216.229\",\n \"model\": \"Galaxy Nexus\",\n \"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\"\n },\n \"at\": 2,\n \"test\": 0,\n \"tmax\": 200,\n \"id\": \"8f44a122-9d9c-4ce0-8a52-8b77ad3a43c7\",\n \"user\": {\n \"id\": \"cf4833b390414c45b76bffd970daba1fdbd51482\"\n }\n}", "language": "json" } ] } [/block] ### 3.1 Native object from above request represented as JSON [block:code] { "codes": [ { "code": "{\n \"ver\": 1,\n \"assets\": [{\n \"required\": 1,\n \"id\": 0,\n \"title\": {\n \"len\": 120\n }\n }, {\n \"required\": 0,\n \"data\": {\n \"type\": 2,\n \"len\": 200\n },\n \"id\": 1\n }, {\n \"required\": 0,\n \"data\": {\n \"type\": 1\n },\n \"id\": 2\n }, {\n \"required\": 0,\n \"data\": {\n \"type\": 12\n },\n \"id\": 3\n }, {\n \"required\": 0,\n \"id\": 4,\n \"img\": {\n \"hmin\": 60,\n \"wmin\": 60,\n \"type\": 1\n }\n }, {\n \"required\": 1,\n \"id\": 5,\n \"img\": {\n \"hmin\": 200,\n \"h\": 260,\n \"type\": 3,\n \"w\": 300,\n \"wmin\": 200\n }\n }],\n \"seq\": 0,\n \"plcmtcnt\": 1,\n \"adunit\": 501\n}", "language": "json" } ] } [/block] ## 4. OpenRTB v2.3 Example Bid Response: [block:code] { "codes": [ { "code": "{\n \"cur\": \"USD\",\n \"elapsed\": 14.0900611877,\n \"seatbid\": [{\n \"bid\": [{\n \"nurl\": \"http://example-dsp.com/win-notie-url&price=${AUCTION_PRICE}\",\n \"cid\": \"78\",\n \"crid\": \"137\",\n \"price\": 2.0,\n \"adomain\": [\"example-brand.com\"],\n \"adm\": \"{\\\"native\\\":{\\\"ver\\\":1,\\\"assets\\\":[{\\\"id\\\":0,\\\"required\\\":0,\\\"title\\\":{\\\"text\\\":\\\"Example Title for An Awesome Brand\\\"}},{\\\"id\\\":1,\\\"required\\\":0,\\\"data\\\":{\\\"value\\\":\\\"This is some long filler description for that awesome brand\\\"}},{\\\"id\\\":2,\\\"required\\\":0,\\\"data\\\":{\\\"value\\\":\\\"Awesome Brand\\\"}},{\\\"id\\\":3,\\\"required\\\":0,\\\"data\\\":{\\\"value\\\":\\\"Read more\\\"}},{\\\"id\\\":4,\\\"required\\\":0,\\\"img\\\":{\\\"url\\\":\\\"http://example-brand.com/brand_logo.jpg\\\",\\\"w\\\":298,\\\"h\\\":224}},{\\\"id\\\":5,\\\"required\\\":0,\\\"img\\\":{\\\"url\\\":\\\"http://example-brand.com/ad_image.jpg\\\",\\\"w\\\":300,\\\"h\\\":260}}],\\\"link\\\":{\\\"url\\\":\\\"http://example-brand.com/r/some-landing-page/\\\"}}}\",\n \t\"impid\": \"1\",\n \"id\": \"a34e3b0d-bd1e-11e4-8222-9ecfbe4e50b6\"\n }],\n \"group\": 0\n }],\n \"id\": \"7d08ff4e-7304-4609-9c89-8cc796e5826b\",\n \"bidid\": \"a34e3b0d-bd1e-11e4-8222-5041e5f685b6\"\n}", "language": "json" } ] } [/block] ### 4.1 ‘adm’ native object from above response represented as JSON [block:code] { "codes": [ { "code": "{\n \"native\": {\n \"ver\": 1,\n \"assets\": [{\n \"id\": 0,\n \"required\": 0,\n \"title\": {\n \"text\": \"Example Title for An Awesome Brand\"\n }\n }, {\n \"id\": 1,\n \"required\": 0,\n \"data\": {\n \"value\": \"This is some long filler description for that awesome brand\"\n }\n }, {\n \"id\": 2,\n \"required\": 0,\n \"data\": {\n \"value\": \"Awesome Brand\"\n }\n }, {\n \"id\": 3,\n \"required\": 0,\n \"data\": {\n \"value\": \"Read more\"\n }\n }, {\n \"id\": 4,\n \"required\": 0,\n \"img\": {\n \"url\": \"http:\\/\\/example-brand.com\\/brand_logo.jpg\",\n \"w\": 298,\n \"h\": 224\n }\n }, {\n \"id\": 5,\n \"required\": 0,\n \"img\": {\n \"url\": \"http:\\/\\/example-brand.com\\/ad_image.jpg\",\n \"w\": 300,\n \"h\": 260\n }\n }],\n \"link\": {\n \"url\": \"http:\\/\\/example-brand.com\\/r\\/some-landing-page\\/\"\n }\n }\n}", "language": "json" } ] } [/block] ### 4.2 Example of VAST tag supported by ANX showing full extent of supported fields [block:code] { "codes": [ { "code": "<?xml version=\"1.0\" encoding=\"utf-8\"?>\n<VAST version=\"2.0\"> \n <Ad id=\"229\">\n <InLine>\n <AdSystem version=\"4.11.1-36\">DSP1</AdSystem>\n <AdTitle><![CDATA[DSP creative 1]]></AdTitle>\n <Description><![CDATA[]]></Description>\n <Error><![CDATA[http://t4.liverail.com/?metric=error&erc=[ERRORCODE]&pos=0&coid=135&pid=1331&nid=1331&oid=229&olid=2291331&cid=331&tpcid=&vid=&amid=&cc=default&pp=&vi=0&vv=&sg=&tsg=&pmu=0&pau=0&psz=0&ctx=&tctx=&coty=7&adt=0&did=&buid=&scen=&mca=&mma=&mct=0&url=&trid=554005d777fa11.82693438&bidf=0.10000&bids=0.00000&bidt=1&bidh=0&bidlaf=0&sdk=0&cb=7847.73.223.72.169.0&ver=1&w=&wy=&x=&y=&xy=&redirect=]]></Error>\n <Impression id=\"LR\"><![CDATA[http://t4.liverail.com/?metric=impression&cofl=0&flid=0&pos=0&coid=135&pid=1331&nid=1331&oid=229&olid=2291331&cid=331&tpcid=&vid=&amid=&cc=default&pp=&vi=0&vv=&sg=&tsg=&pmu=0&pau=0&psz=0&ctx=&tctx=&coty=7&adt=0&did=&buid=&scen=&mca=&mma=&mct=0&url=&trid=554005d777fa11.82693438&bidf=0.10000&bids=0.00000&bidt=1&bidh=0&bidlaf=0&sdk=0&cb=7847.73.223.72.169.0&ver=1&w=&wy=&x=121&y=121&xy=0b79&z2=0.00100]]></Impression>\n <Impression id=\"QC\"><![CDATA[http://pixel.quantserve.com/pixel/p-d05JkuPGiy-jY.gif?r=7847]]></Impression>\n <Impression id=\"CS\"><![CDATA[http://b.scorecardresearch.com/p?c1=1&c2=9864668&c3=1331&c4=&c5=09]]></Impression>\n <Impression><![CDATA[http://t1.clipkit.de/liverail?action=lr_impression]]></Impression>\n <Creatives>\n <Creative sequence=\"1\" id=\"331\">\n <Linear>\n <Duration>00:00:11</Duration>\n <TrackingEvents>\n <Tracking event=\"firstQuartile\"><![CDATA[http://t4.liverail.com/?metric=view25&pos=0&coid=135&pid=1331&nid=1331&oid=229&olid=2291331&cid=331&tpcid=&vid=&amid=&cc=default&pp=&vi=0&vv=&sg=&tsg=&pmu=0&pau=0&psz=0&ctx=&tctx=&coty=7&adt=0&did=&buid=&scen=&mca=&mma=&mct=0&url=&trid=554005d777fa11.82693438&bidf=0.10000&bids=0.00000&bidt=1&bidh=0&bidlaf=0&sdk=0&cb=7847.73.223.72.169.0&ver=1&w=&wy=&x=&y=&xy=]]></Tracking>\n <Tracking event=\"midpoint\"><![CDATA[http://t4.liverail.com/?metric=view50&pos=0&coid=135&pid=1331&nid=1331&oid=229&olid=2291331&cid=331&tpcid=&vid=&amid=&cc=default&pp=&vi=0&vv=&sg=&tsg=&pmu=0&pau=0&psz=0&ctx=&tctx=&coty=7&adt=0&did=&buid=&scen=&mca=&mma=&mct=0&url=&trid=554005d777fa11.82693438&bidf=0.10000&bids=0.00000&bidt=1&bidh=0&bidlaf=0&sdk=0&cb=7847.73.223.72.169.0&ver=1&w=&wy=&x=&y=&xy=]]></Tracking>\n <Tracking event=\"thirdQuartile\"><![CDATA[http://t4.liverail.com/?metric=view75&pos=0&coid=135&pid=1331&nid=1331&oid=229&olid=2291331&cid=331&tpcid=&vid=&amid=&cc=default&pp=&vi=0&vv=&sg=&tsg=&pmu=0&pau=0&psz=0&ctx=&tctx=&coty=7&adt=0&did=&buid=&scen=&mca=&mma=&mct=0&url=&trid=554005d777fa11.82693438&bidf=0.10000&bids=0.00000&bidt=1&bidh=0&bidlaf=0&sdk=0&cb=7847.73.223.72.169.0&ver=1&w=&wy=&x=&y=&xy=]]></Tracking>\n <Tracking event=\"complete\"><![CDATA[http://t4.liverail.com/?metric=view100&pos=0&coid=135&pid=1331&nid=1331&oid=229&olid=2291331&cid=331&tpcid=&vid=&amid=&cc=default&pp=&vi=0&vv=&sg=&tsg=&pmu=0&pau=0&psz=0&ctx=&tctx=&coty=7&adt=0&did=&buid=&scen=&mca=&mma=&mct=0&url=&trid=554005d777fa11.82693438&bidf=0.10000&bids=0.00000&bidt=1&bidh=0&bidlaf=0&sdk=0&cb=7847.73.223.72.169.0&ver=1&w=&wy=&x=&y=&xy=]]></Tracking>\n <Tracking event=\"mute\"><![CDATA[http://t4.liverail.com/?metric=mute&pos=0&coid=135&pid=1331&nid=1331&oid=229&olid=2291331&cid=331&tpcid=&vid=&amid=&cc=default&pp=&vi=0&vv=&sg=&tsg=&pmu=0&pau=0&psz=0&ctx=&tctx=&coty=7&adt=0&did=&buid=&scen=&mca=&mma=&mct=0&url=&trid=554005d777fa11.82693438&bidf=0.10000&bids=0.00000&bidt=1&bidh=0&bidlaf=0&sdk=0&cb=7847.73.223.72.169.0&ver=1&w=&wy=&x=&y=&xy=]]></Tracking>\n <Tracking event=\"unmute\"><![CDATA[http://t4.liverail.com/?metric=unmute&pos=0&coid=135&pid=1331&nid=1331&oid=229&olid=2291331&cid=331&tpcid=&vid=&amid=&cc=default&pp=&vi=0&vv=&sg=&tsg=&pmu=0&pau=0&psz=0&ctx=&tctx=&coty=7&adt=0&did=&buid=&scen=&mca=&mma=&mct=0&url=&trid=554005d777fa11.82693438&bidf=0.10000&bids=0.00000&bidt=1&bidh=0&bidlaf=0&sdk=0&cb=7847.73.223.72.169.0&ver=1&w=&wy=&x=&y=&xy=]]></Tracking>\n <Tracking event=\"pause\"><![CDATA[http://t4.liverail.com/?metric=pause&pos=0&coid=135&pid=1331&nid=1331&oid=229&olid=2291331&cid=331&tpcid=&vid=&amid=&cc=default&pp=&vi=0&vv=&sg=&tsg=&pmu=0&pau=0&psz=0&ctx=&tctx=&coty=7&adt=0&did=&buid=&scen=&mca=&mma=&mct=0&url=&trid=554005d777fa11.82693438&bidf=0.10000&bids=0.00000&bidt=1&bidh=0&bidlaf=0&sdk=0&cb=7847.73.223.72.169.0&ver=1&w=&wy=&x=&y=&xy=]]></Tracking>\n <Tracking event=\"resume\"><![CDATA[http://t4.liverail.com/?metric=resume&pos=0&coid=135&pid=1331&nid=1331&oid=229&olid=2291331&cid=331&tpcid=&vid=&amid=&cc=default&pp=&vi=0&vv=&sg=&tsg=&pmu=0&pau=0&psz=0&ctx=&tctx=&coty=7&adt=0&did=&buid=&scen=&mca=&mma=&mct=0&url=&trid=554005d777fa11.82693438&bidf=0.10000&bids=0.00000&bidt=1&bidh=0&bidlaf=0&sdk=0&cb=7847.73.223.72.169.0&ver=1&w=&wy=&x=&y=&xy=]]></Tracking>\n <Tracking event=\"fullscreen\"><![CDATA[http://t4.liverail.com/?metric=fullscreen&pos=0&coid=135&pid=1331&nid=1331&oid=229&olid=2291331&cid=331&tpcid=&vid=&amid=&cc=default&pp=&vi=0&vv=&sg=&tsg=&pmu=0&pau=0&psz=0&ctx=&tctx=&coty=7&adt=0&did=&buid=&scen=&mca=&mma=&mct=0&url=&trid=554005d777fa11.82693438&bidf=0.10000&bids=0.00000&bidt=1&bidh=0&bidlaf=0&sdk=0&cb=7847.73.223.72.169.0&ver=1&w=&wy=&x=&y=&xy=]]></Tracking>\n <Tracking event=\"close\"><![CDATA[http://t4.liverail.com/?metric=close&pos=0&coid=135&pid=1331&nid=1331&oid=229&olid=2291331&cid=331&tpcid=&vid=&amid=&cc=default&pp=&vi=0&vv=&sg=&tsg=&pmu=0&pau=0&psz=0&ctx=&tctx=&coty=7&adt=0&did=&buid=&scen=&mca=&mma=&mct=0&url=&trid=554005d777fa11.82693438&bidf=0.10000&bids=0.00000&bidt=1&bidh=0&bidlaf=0&sdk=0&cb=7847.73.223.72.169.0&ver=1&w=&wy=&x=&y=&xy=]]></Tracking>\n <Tracking event=\"acceptInvitation\"><![CDATA[http://t4.liverail.com/?metric=accept&pos=0&coid=135&pid=1331&nid=1331&oid=229&olid=2291331&cid=331&tpcid=&vid=&amid=&cc=default&pp=&vi=0&vv=&sg=&tsg=&pmu=0&pau=0&psz=0&ctx=&tctx=&coty=7&adt=0&did=&buid=&scen=&mca=&mma=&mct=0&url=&trid=554005d777fa11.82693438&bidf=0.10000&bids=0.00000&bidt=1&bidh=0&bidlaf=0&sdk=0&cb=7847.73.223.72.169.0&ver=1&w=&wy=&x=&y=&xy=]]></Tracking>\n </TrackingEvents> \n <VideoClicks>\n <ClickThrough><![CDATA[http://t4.liverail.com/?metric=clickthru&pos=0&coid=135&pid=1331&nid=1331&oid=229&olid=2291331&cid=331&tpcid=&vid=&amid=&cc=default&pp=&vi=0&vv=&sg=&tsg=&pmu=0&pau=0&psz=0&ctx=&tctx=&coty=7&adt=0&did=&buid=&scen=&mca=&mma=&mct=0&url=&trid=554005d777fa11.82693438&bidf=0.10000&bids=0.00000&bidt=1&bidh=0&bidlaf=0&sdk=0&cb=7847.73.223.72.169.0&ver=1&w=&wy=&x=&y=&xy=&redirect=http%3A%2F%2Fliverail.com%2F]]></ClickThrough>\n </VideoClicks>\n <MediaFiles>\n <MediaFile delivery=\"progressive\" bitrate=\"256\" width=\"480\" height=\"352\" type=\"video/x-flv\"><![CDATA[http://cdn.liverail.com/adasset4/1331/229/331/lo.flv]]></MediaFile>\n <MediaFile delivery=\"progressive\" bitrate=\"256\" width=\"640\" height=\"360\" type=\"video/x-ms-wmv\"><![CDATA[http://cdn.liverail.com/adasset4/1331/229/331/lo.wmv]]></MediaFile>\n <MediaFile delivery=\"progressive\" bitrate=\"400\" width=\"320\" height=\"180\" type=\"video/mp4\"><![CDATA[http://cdn.liverail.com/adasset4/1331/229/331/lo.mp4]]></MediaFile>\n <MediaFile delivery=\"progressive\" bitrate=\"400\" width=\"320\" height=\"180\" type=\"video/webm\"><![CDATA[http://cdn.liverail.com/adasset4/1331/229/331/lo.webm]]></MediaFile>\n <MediaFile delivery=\"progressive\" bitrate=\"512\" width=\"480\" height=\"352\" type=\"video/x-flv\"><![CDATA[http://cdn.liverail.com/adasset4/1331/229/331/me.flv]]></MediaFile>\n <MediaFile delivery=\"progressive\" bitrate=\"512\" width=\"640\" height=\"360\" type=\"video/x-ms-wmv\"><![CDATA[http://cdn.liverail.com/adasset4/1331/229/331/me.wmv]]></MediaFile>\n <MediaFile delivery=\"progressive\" bitrate=\"600\" width=\"640\" height=\"480\" type=\"video/mp4\"><![CDATA[http://cdn.liverail.com/adasset4/1331/229/331/me.mp4]]></MediaFile>\n <MediaFile delivery=\"progressive\" bitrate=\"600\" width=\"640\" height=\"480\" type=\"video/webm\"><![CDATA[http://cdn.liverail.com/adasset4/1331/229/331/me.webm]]></MediaFile>\n <MediaFile delivery=\"progressive\" bitrate=\"1024\" width=\"480\" height=\"352\" type=\"video/mp4\"><![CDATA[http://cdn.liverail.com/adasset4/1331/229/331/hi.mp4]]></MediaFile>\n <MediaFile delivery=\"progressive\" bitrate=\"1024\" width=\"480\" height=\"352\" type=\"video/webm\"><![CDATA[http://cdn.liverail.com/adasset4/1331/229/331/hi.webm]]></MediaFile>\n <MediaFile delivery=\"progressive\" bitrate=\"1024\" width=\"480\" height=\"352\" type=\"video/x-flv\"><![CDATA[http://cdn.liverail.com/adasset4/1331/229/331/hi.flv]]></MediaFile>\n <MediaFile delivery=\"progressive\" bitrate=\"1024\" width=\"640\" height=\"360\" type=\"video/x-ms-wmv\"><![CDATA[http://cdn.liverail.com/adasset4/1331/229/331/hi.wmv]]></MediaFile>\n </MediaFiles>\n </Linear>\n </Creative>\n </Creatives>\n <Extensions>\n </Extensions>\n </InLine>\n </Ad>\n</VAST>", "language": "xml" } ] } [/block]