> For the complete documentation index, see [llms.txt](https://docs.exoclick.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.exoclick.com/rtb/advertisers/open-rtb/open-rtb-adv-code-examples-2.5.md). # Open RTB 2.5 Examples ## Open RTB 2.5 Advertiser Request ### Banner ```json { "id": "d4b5c697-41f3-4c1c-a3d5-5fd01b5ef2aa", "at": 1, "imp": [ { "id": "974090632", "banner": { "w": 300, "h": 250 } } ], "site": { "id": "12345", "domain": "sitedomain.com", "cat": [ "IAB25-3" ], "page": "https://sitedomain.com/page", "keywords": "lifestyle, humour" }, "device": { "ua": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.63 Safari/537.36", "sua": { "architecture": "x86", "bitness": "64", "model": "Windows", "mobile": 0, "source": 2, "platform": { "brand": "Windows", "version": [ "10", "0", "0" ] }, "browsers": [ { "brand": "Chromium", "version": [ "136", "0", "7103", "93" ] }, { "brand": "Microsoft Edge", "version": [ "136", "0", "3240", "64" ] }, { "brand": "Not.A\/Brand", "version": [ "99", "0", "0", "0" ] } ] }, "ip": "192.0.2.1", "geo": { "country": "IRL" }, "language": "en", "os": "Linux & UNIX", "js": 0, "ext": { "remote_addr": "192.0.2.1", "x_forwarded_for": "", "accept_language": "en-GB;q=0.8,pt-PT;q=0.6,en;q=0.4,en-US;q=0.2,de;q=0.2,es;q=0.2,fr;q=0.2" } }, "user": { "id": "57592f333f8983.043587162282415065", "ext": { "consent": "CO9A8QHPAbnHWBcADBENBJCoAAAAAAAAAAqIHKJU9VybLh0Dq4A170B0OAEYN_r_v40zigeds-8Myd-X3DsX50M7vFy6pr4AuR4km3CBIQFkHOmcTUmw6IkVrRPsak2Mr7NKJ7PEinsbe2dYEHtfn9VTuZKZr97s___zf_-___3_75f__-3_3_vp9UAAAABA5QAkgkDYAKAQRAAJIwKhQAhAuJDoBAAUUIwtE1hASuCmYVAR-ggYAIDUBGAECDEEGIIIAAAAAkgiAkAPBAAgCIBAACAFSAhAARoAgsAJAwCAAUA0LACKAIQJCDI4KjlICAiRaKCeSMASi72MMIQSigAAAAAAAA" } }, "ext": { "sub": 1221 } } ``` ### Direct Links ```json { "id": "d4b5c697-41f3-4c1c-a3d5-5fd01b5ef2aa", "imp": [ { "id": "974090632", "instl": 0, "el": "dGVzdGVAZW1haWwuY29t" } ], "site": { "id": "12345", "domain": "sitedomain.com", "cat": ["IAB25-3"], "page": "https://sitedomain.com/page", "keyword": "lifestyle", "ext": { "exchangecat": 508, "idzone": 445566 } }, "device": { "ua": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.63 Safari/537.36", "ip": "192.0.2.1", "geo": { "country": "PRT" }, "language": "en", "os": "Linux & UNIX", "js": 0, "ext": { "remote_addr": "192.0.2.1", "x_forwarded_for": "192.0.2.1" } }, "user": { "id": "57592f333f8983.043587162282415065" }, "ext": { "sub": 1221 } } ``` ### Native ```json { "id": "d4b5c697-41f3-4c1c-a3d5-5fd01b5ef2aa", "at":1, "imp": [ { "id": "2d099176-9feb-44e9-85f9-f385b34123a1", "native": { "request": "{\"native\":{\"ver\":\"1.2\"\n,\"context\":1\n,\"contextsubtype\":10\n,\"plcmttype\":4\n,\"plcmtcnt\":4\n,\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"len\":124}},{\"id\":2,\"data\":{\"type\":1,\"len\":50}},{\"id\":3,\"required\":1,\"img\":{\"type\":3,\"wmin\":150,\"hmin\":150}}]\n}}", "ver": "1.2" }, "tagid": "2812", "bidfloor": 0.035, "secure": 1 } ], "site": { "id": "2812", "domain": "example.com", "keywords": "lifestyle, humour", "page": "https://example.com/", "mobile": 1 }, "device": { "ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 11_4_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15G77 Version/11.4.1 Safari/604.1 AlohaBrowser/2.10.0b17", "ip": "192.0.2.1", "js": 1, "language": "en" }, "user": { "id": "37d1951a-7184-4b7f-b227-5571a1ea7467" } } ``` ### Popunder ```json { "id": "d4b5c697-41f3-4c1c-a3d5-5fd01b5ef2aa", "at":1, "imp": [ { "id": "974090632", "instl": 1 } ], "site": { "id": "12345", "domain": "sitedomain.com", "name": "site domain", "cat": ["IAB25-3"], "page": "https://sitedomain.com/page", "keywords": "lifestyle, humour" }, "device": { "ua": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.63 Safari/537.36", "ip": "192.0.2.1", "geo": { "country": "IRL" }, "language": "en", "os": "Linux & UNIX", "js": 0, "ext": { "remote_addr": "192.0.2.1", "x_forwarded_for": "192.0.2.1" } }, "user": { "id": "57592f333f8983.043587162282415065" }, "ext": { "sub": 1221 } } ``` ### Video ```json { "id": "d4b5c697-41f3-4c1c-a3d5-5fd01b5ef2aa", "site": { "domain": "sitedomain.nl", "page": "https://sitedomain.com/page", "id": "718990", "keywords": "lifestyle,humour", "cat": [ "IAB25-3" ], "ext": { "exchangecat": 508, "idzone": 4998567, "keyword": "%" }, "publisher": { "id": "195600" } }, "device": { "ua": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/95.0.4638.54 Safari/537.36", "sua": { "architecture": "x86", "bitness": "64", "model": "Windows", "mobile": 0, "source": 2, "platform": { "brand": "Windows", "version": [ "10", "0", "0" ] }, "browsers": [ { "brand": "Chromium", "version": [ "136", "0", "7103", "93" ] }, { "brand": "Microsoft Edge", "version": [ "136", "0", "3240", "64" ] }, { "brand": "Not.A\/Brand", "version": [ "99", "0", "0", "0" ] } ] }, "ip": "192.0.2.1", "geo": { "country": "IRL", "ipservice": "3" }, "language": "en", "os": "MacOS", "js": 1, "ext": { "remote_addr": "192.0.2.1", "x_forwarded_for": "" } }, "imp": [ { "id": "568094473", "video": { "mimes": [ "video/mp4" ], "minduration": "1", "maxduration": "7200", "ext": { "zone_type": "exchange_video_slider" }, "protocols": "3,6", "linearity": "1", "boxingallowed": "1", "pos": "0" }, "instl": "0", "ext": { "video_cta": "1", "type": "video" }, "secure": "0" } ], "user": { "id": "57592f333f8983.043587162282415065" }, "tmax": 300 } ``` You can find more examples [here](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf). ### Push Notifications - 720 x 480 ```json { "id": "d4b5c697-41f3-4c1c-a3d5-5fd01b5ef2aa", "at":1, "imp": [ { "id": "90180978", "native": { "request":"{\"native\":{\"ver\":\"1.2\",\"plcmttype\":500,\"plcmtcnt\":1,\"assets\":[{\"id\":1,\"required\":1,\"img\":{\"type\":1,\"w\":720,\"h\":480,\"wmin\":720,\"hmin\":480}},{\"id\":2,\"required\":1,\"title\":{\"len\":60}},{\"id\":3,\"required\":1,\"data\":{\"type\":2,\"len\":110}}]}}", "ver": "1.2" }, "secure": 1 } ], "site": { "id": "12345", "domain": "sitedomain.com", "cat": ["IAB25-3"], "page": "https://sitedomain.com/page", "keyword": "lifestyle", "ext": { "exchangecat": 508, "idzone": 445566 } }, "device": { "ua": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.63 Safari/537.36", "ip": "192.0.2.1", "geo": { "country": "IRL" }, "language": "en", "os": "Linux & UNIX", "js": 0, "ext": { "remote_addr": "192.0.2.1", "x_forwarded_for": "", "accept_language": "en-GB;q=0.8,pt-PT;q=0.6,en;q=0.4,en-US;q=0.2,de;q=0.2,es;q=0.2,fr;q=0.2" } }, "user": { "id": "57592f333f8983.043587162282415065" }, "ext": { "sub": 445566 } } ``` ### Push Notifications - 192 x 192 ```json { "id": "d4b5c697-41f3-4c1c-a3d5-5fd01b5ef2aa", "at":1, "imp": [ { "id": "90180978", "native": { "request":"{\"native\":{\"ver\":\"1.2\",\"plcmttype\":500,\"plcmtcnt\":1,\"assets\":[{\"id\":1,\"required\":1,\"img\":{\"type\":1,\"w\":192,\"h\":192,\"wmin\":192,\"hmin\":192}},{\"id\":2,\"required\":1,\"title\":{\"len\":60}},{\"id\":3,\"required\":1,\"data\":{\"type\":2,\"len\":110}}]}}", "ver": "1.2" }, "secure": 1 } ], "site": { "id": "12345", "domain": "sitedomain.com", "cat": ["IAB25-3"], "page": "https://sitedomain.com/page", "keyword": "lifestyle", "ext": { "exchangecat": 508, "idzone": 445566 } }, "device": { "ua": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.63 Safari/537.36", "ip": "192.0.2.1", "geo": { "country": "IRL" }, "language": "en", "os": "Linux & UNIX", "js": 0, "ext": { "remote_addr": "192.0.2.1", "x_forwarded_for": "", "accept_language": "en-GB;q=0.8,pt-PT;q=0.6,en;q=0.4,en-US;q=0.2,de;q=0.2,es;q=0.2,fr;q=0.2" } }, "user": { "id": "57592f333f8983.043587162282415065" }, "ext": { "sub": 445566 } } ``` ### Fullpage Interstitial Desktop ```json { "id": "d4b5c697-41f3-4c1c-a3d5-5fd01b5ef2aa", "at":1, "imp": [ { "id": "974090632", "instl": 1, "banner": { "w": 1600, "h": 900, "mimes": [ "image/jpg", "image/png", "video/mp4", "image/webp" ] } } ], "site": { "id": "12345", "domain": "sitedomain.com", "name": "site domain", "cat": ["IAB25-3"], "page": "https://sitedomain.com/page", "keywords": "lifestyle, humour" }, "device": { "ua": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.63 Safari/537.36", "ip": "192.0.2.1", "geo": { "country": "PRT" }, "language": "en", "os": "Linux & UNIX", "js": 0, "ext": { "remote_addr": "192.0.2.1", "x_forwarded_for": "192.0.2.1" } }, "user": { "id": "57592f333f8983.043587162282415065" }, "ext": { "sub": 1221 } } ``` ### Fullpage Interstitial Mobile ```json { "id": "d4b5c697-41f3-4c1c-a3d5-5fd01b5ef2aa", "at":1, "imp": [ { "id": "974090632", "instl": 1, "banner": { "w": 900, "h": 1600, "mimes": [ "image/jpg", "image/png", "video/mp4", "image/webp" ] } } ], "site": { "id": "12345", "domain": "sitedomain.com", "name": "site domain", "cat": ["IAB25-3"], "page": "https://sitedomain.com/page", "keywords": "lifestyle, humour" }, "device": { "ua": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.63 Safari/537.36", "ip": "192.0.2.1", "geo": { "country": "PRT" }, "language": "en", "os": "Linux & UNIX", "js": 0, "ext": { "remote_addr": "192.0.2.1", "x_forwarded_for": "192.0.2.1" } }, "user": { "id": "57592f333f8983.043587162282415065" }, "ext": { "sub": 1221 } } ``` ## Open RTB 2.5 Advertiser Response ### Banner / In-Stream Video / Push Notifications JSON ```json { "id": "d4b5c697-41f3-4c1c-a3d5-5fd01b5ef2aa", "seatbid": [ { "bid": [ { "id": "e3852965cc7b28d03ff3069debcc83cb6d68e753", "impid": "974090632", "price": 3.19, "adm": "", "ext": { "btype": 1 }, "nurl": "https://dsp.com/my_win_notification_url", "burl": "https://dsp.com/my_billing_notification_url", "cid": "5834901", "crid": "83232831" } ] } ] } ``` ### Direct Links / Email Clicks JSON ```json { "id": "d4b5c697-41f3-4c1c-a3d5-5fd01b5ef2aa", "bidid": 123, "seatbid": [{ "bid": [{ "id": "12ab3d", "adid": 1, "impid": "90180978", "price": 0.12, "adm": "http://mysite.com/landingpages/mypage", "ext":{ "btype": 2 }, "burl": "https://mysite.com/my_billing_notification_url" }] }] } ``` ### Popunder JSON ```json { "id": "d4b5c697-41f3-4c1c-a3d5-5fd01b5ef2aa", "seatbid": [ { "bid": [ { "id": "e3852965cc7b28d03ff3069debcc83cb6d68e753", "impid": "974090632", "price": 3.19, "adm": "http://mysite.com/landingpages/mypage", "ext": { "btype": 1 }, "nurl": "https://dsp.com/my_win_notification_url", "burl": "https://dsp.com/my_billing_notification_url", "cid": "5834901", "crid": "83232831" } ] } ] } ``` ### Fullpage Interstitial (Mobile and Desktop) JSON ```json { "id": "d4b5c697-41f3-4c1c-a3d5-5fd01b5ef2aa", "seatbid": [ { "bid": [ { "id": "54f6f08b2e323e32ea9ec4fd6944d652c842699a", "impid": "974090632", "price": 0.05, "adm": "http://network-domain.com/fpi-render.php?data=TVRjME9UZ31", "ext": { "btype": 1, "asset_mime_type": [ "video/mp4" ] }, "nurl": "http://network-domain.com/win-notification", "iurl": "http://network-domain.com/your_video.mp4", "cid": "7561981", "crid": "195600_115116261", "cat": [], "adomain": [ "www.test.com" ], "w": 900, "h": 1600, "attr": [] } ] } ], "cur": "EUR" } ``` ### Native JSON ```json { "id": "d4b5c697-41f3-4c1c-a3d5-5fd01b5ef2aa", "seatbid": [ { "bid": [ { "id": "12ab3d", "impid": "90180978", "price": 0.71, "nurl": "https://mysite.com/my_notification_url", "burl": "https://mysite.com/my_billing_notification_url", "adm": "", "ext": { "btype": 1 }, "iurl": "https://examplesite.net/library/4168260c416e688f5c64939044e178a84c00fca2419c2.mp4", "crid": "22334455" } ] }, { "bid": [ { "id": "12ab3e", "impid": "1915966848", "price": 0.62, "nurl": "https://mysite.com/my_notification_url_2", "burl": "https://mysite.com/my_billing_notification_url", "adm": "", "ext": { "btype": 1 }, "iurl": "https://examplesite.net/library/4168260c416e688f5c64939044e178a84c00fca2419c2.mp4", "crid": "22334455" } ] } ] } ``` {% hint style="info" %} **Note**: Direct Link, Email Clicks, Popunder and Full Page Interstitial response objects already have the ADM included. {% endhint %} ## ADM ### Banner: HTML (a tag) ```html ``` ### Native Ads ``` {\"native\":{\"link\":{\"url\":\"http:\/\/mysite.com\/landingpages\/mypage\"},\"assets\":[{\"id\":1,\"required\":1,\"img\":{\"url\":\"http:\/\/mysite.com\/images\/myad.jpg\",\"w\":300,\"h\":300,\"ext\":{\"crop_anchor_point\":1}}},{\"id\":2,\"title\":{\"text\":\"Ad Title\"}},{\"id\":3,\"data\":{\"type\":2,\"value\":\"Ad description\"}},{\"id\":4,\"data\":{\"type\":1,\"value\":\"Ad brand\"}},{\"id\":5,\"ext\":{\"crop_anchor_point\":1}}],\"imptrackers\":[\"https://mytracker1.com\"],\"eventtrackers\":[{\"event\":1,\"method\":1,\"url\":\"https://myEventTracker1.com\"}]}} ``` Which is based on the following JSON object: ```json { "native": { "link": { "url": "http://mysite.com/landingpages/mypage" }, "assets": [ { "id": 1, "required": 1, "img": { "url": "http://mysite.com/images/myad.jpg", "w": 300, "h": 300, "ext": { "crop_anchor_point": 1 } } }, { "id": 2, "title": { "text": "Ad Title" } }, { "id": 3, "data": { "type": 2, "value": "Ad description" } }, { "id": 4, "data": { "type": 1, "value": "Ad brand" } } ], "imptrackers": [ "https://mytracker1.com", "https://mytracker2.com" ], "eventtrackers": [ { "event": 1, "method": 1, "url": "https://myEventTracker1.com" }, { "event": 1, "method": 1, "url": "https://myEventTracker2.com" } ] } } ``` ### Push Notifications ``` {\"native\":{\"link\":{\"url\":\"http:\/\/mysite.com\/landingpages\/mypage\"},\"assets\":[{\"id\":1,\"required\":1,\"img\":{\"url\":\"http:\/\/mysite.com\/images\/myad.jpg\",\"w\":720,\"h\":480}},{\"id\":2,\"title\":{\"text\":\"Ad Title\"}},{\"id\":3,\"data\":{\"type\":2,\"value\":\"Ad description\"}}],\"imptrackers\":[\"https://mytracker1.com\"]}} ``` Which is based on the following JSON object: ```json { "native": { "link": { "url": "http://mysite.com/landingpages/mypage" }, "assets": [ { "id": 1, "required": 1, "img": { "url": "http://mysite.com/images/myad.jpg", "w": 720, "h": 480 } }, { "id": 2, "title": { "text": "Ad Title" } }, { "id": 3, "data": { "type": 2, "value": "Ad description" } } ], "imptrackers": [ "https://mytracker1.com" ] } } ``` {% hint style="info" %} * Only one imptracker URL is allowed in the case of Push Notification ads * We use the `native` object for push notification ads {% endhint %} ### Video: XML ```xml ExoClick ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.exoclick.com/rtb/advertisers/open-rtb/open-rtb-adv-code-examples-2.5.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.