Documentation

Documentation

  • General
  • Advertisers
  • Publishers
  • RTB
  • API
  • News

›EXADS RTB

Advertisers

  • Advertisers RTB Overview
  • Ad Exchange Partners
  • Integrating Advertising Demand
  • Open RTB

    • Open RTB Integration
    • Open RTB 2.4 Bid Request
    • Open RTB 2.4 Bid Response
    • Open RTB 2.5 Bid Request
    • Open RTB 2.5 Bid Response
    • Prebid / OpenRTB 2.5 Bid Request
    • Prebid / OpenRTB 2.5 Bid Response

    EXADS RTB

    • EXADS RTB Integration
    • EXADS RTB Bid Request
    • EXADS RTB Bid Response

Publishers

  • Publishers RTB Overview
  • Ad Exchange Partners
  • Integrating Publishing Supply
  • Open RTB

    • Open RTB Integration
    • Open RTB 2.4 Bid Request
    • Open RTB 2.4 Bid Response
    • Open RTB 2.5 Bid Request
    • Open RTB 2.5 Bid Response
    • Prebid / Open RTB 2.5 Bid Request
    • Prebid / Open RTB 2.5 Bid Response

    EXADS RTB

    • EXADS RTB Integration
    • EXADS RTB Bid Request
    • EXADS RTB Bid Response

IP Networks

  • IP Networks

EXADS RTB Bid Request Specifications


Note: The EXADS RTB Bid Request is done using JSON for POST.


Bid Request Headers

  • EXADS RTB Version HTTP Header: x-exadsrtb-version: 1.0
  • Keep-Alive HTTP Header: Connection: Keep-Alive
  • Content JSON: Content-Type: application/json
  • Data Encoding Header: Accept-Encoding

 

Bid Request Object

We allow one HTTP method for requests: POST.

When requesting bids for a specific context, the platform will perform an HTTP request with a timeout of 300ms. It will send the following object encoded as JSON in the request body as POST:

AttributeDescription
idUnique bid request ID (string)*
ipIP address of the user (string)*
languageBrowser language using ISO-639-1-alpha-2 (string)*
remote_addrMain IP address of the user (string)
x_forwarded_forX-FORWARDED-FOR IP address of the user or empty if not set (string)
typeRequest type. Can be "banner", "popunder" or "push_notification" (string)*
uaBrowser user agent (string)*
urlFull URL of the page where the ad will be shown (string)*
user_idUnique user ID (string)*
exportResponse type. Can be "json" or "xml" (string)*
keywordkeyword (string)
sizePublisher ad type size (string)**
subThe sub will be an integer number representing the ID of the zone where the request was originated from

* mandatory fields
** mandatory only for type banner  

Bid request POST: JSON


Note: EXADS POST Bid requests are done using JSON only, so there are no XML examples below.


 

Banner: JSON

{
    "id": "d4b5c697-41f3-4c1c-a3d5-5fd01b5ef2aa",
    "ip": "131.34.123.159",
    "language": "en",
    "type": "banner",
    "remote_addr": "131.34.123.159",
    "x_forwarded_for": "",
    "ua": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/66.0.3359.139 Safari/537.36",
    "url": "https://sitedomain.com/page",
    "user_id": "57592f333f8983.043587162282415065",
    "export": "json",
    "keyword": "Lifestyle",
    "size": "300x250",
    "sub": 445566
}

 

Popunder: JSON

{
    "id": "d4b5c697-41f3-4c1c-a3d5-5fd01b5ef2aa",
    "ip": "131.34.123.159",
    "language": "en",
    "type": "popunder",
    "remote_addr": "131.34.123.159",
    "x_forwarded_for": "120.52.73.97",
    "ua": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/66.0.3359.139 Safari/537.36",
    "url": "https://sitedomain.com/page",
    "user_id": "57592f333f8983.043587162282415065",
    "export": "json",
    "keyword": "Lifestyle",
    "sub": 445566
}

 

Push Notifications 720x480: JSON

{
    "id": "d4b5c697-41f3-4c1c-a3d5-5fd01b5ef2aa",
    "ip": "131.34.123.159",
    "language": "en",
    "type": "push_notification",
    "remote_addr": "131.34.123.159",
    "x_forwarded_for": "120.52.73.97",
    "ua": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/66.0.3359.139 Safari/537.36",
    "url": "https://sitedomain.com/page",
    "user_id": "57592f333f8983.043587162282415065",
    "export": "json",
    "keyword": "Lifestyle",
    "size": "720x480",
    "sub": 445566
}

 

Push Notifications 192 x 192: JSON

Here size parameter may be omitted. It will just be assumed as 192x192 by default for backwards compatibility.

{
    "id": "d4b5c697-41f3-4c1c-a3d5-5fd01b5ef2aa",
    "ip": "131.34.123.159",
    "language": "en",
    "type": "push_notification",
    "remote_addr": "131.34.123.159",
    "x_forwarded_for": "120.52.73.97",
    "ua": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/66.0.3359.139 Safari/537.36",
    "url": "https://sitedomain.com/page",
    "user_id": "57592f333f8983.043587162282415065",
    "export": "json",
    "keyword": "Lifestyle",
    "size": "192x192",
    "sub": 445566
}
← EXADS RTB IntegrationEXADS RTB Bid Response →
  • Bid Request Headers
  • Bid Request Object
  • Bid request POST: JSON
    • Banner: JSON
    • Popunder: JSON
    • Push Notifications 720x480: JSON
    • Push Notifications 192 x 192: JSON
Documentation
Community
Github
Useful Links
EXADS
Copyright © 2025 EXADS