Integrations (RTB)
      Back to home
      1. Yeesshh Help Center
      2. Publishers corner
      3. Integrations (RTB)

      JSON/XML (myDSP RTB Integration)

      myDSP RTB Integration Guidelines SRTB JSON XRTB XML GET

      Related articles:

      Base URL

      Parametres

      Jason/XML

      Stats

      Traffic rules

       

      !IMPORTANT!

      Please limit Unique IP requests to 1 request per second AT MOST.

      Spamming requests for unique IPs won't yield more bids and will only waste server resources for everyone involved. If these limits aren't respected and excessive requests occur (e.g., overloading servers to the point where they can't serve others), we may take the following measures:

      1. Your feed may be disabled until you implement appropriate restrictions
      2. If the DNS entry for your assigned domain exists independently, it will be removed from the list; otherwise, it will be redirected to 127.0.0.1 or a local network IP (e.g., 192.168.253.254)
      3. All IPs used for sending requests will be firewall blocked—this affects all your feeds if you have multiple feeds sharing the same requesting IPs

      While other measures exist to prevent malicious publisher behavior, these are the most common consequences you'll face if your feed becomes problematic.

      Requests and response Example XML (xrtb):

      Request example (xrtb)

      Example url of a request with a few important parameters:

      http://[DOMAIN_GIVEN_TO_YOU]/api/v1/xrtb?sid=941_13&k=apartments,villas&l=en-GB&url=https%3A%2F%2Fwww.google.com%2Fsearch%3Fq%3Dab&ip=8.8.8.8&ua=Mozilla%2F5.0%20(Macintosh%3B%20Intel%20Mac%20OS%20X%2010_15_7)%20AppleWebKit%2F537.36%20(KHTML%2C%20like%20Gecko)%20Chrome%2F92.0.4515.131%20Safari%2F537.36

      Response Format (xrtb)

      <?xml version="1.0" encoding="UTF-8"?> <result> <link bid="0.0031" url="https://redirectdomain.com/r?d=ikWpRKCvs6WfUDNIcFSaRLeMIsk4rAojO0x8A2T0" nurl="http://nurldomain.com/nurl?d=ikWpRKCvs6WfUDNIcFSaRLeMIsk4rAojO0x8A2T0"/> </result>

        • Redirect Link for users -> adm

        • Win notification link for S2S pinging -> nurl

      Key points about responses:

        • Default response returns CPC float values

      Note: If you require CPM values please contact your account manager

        • Bids are valid for 5 minutes
        • Redirect Link for users -> url
        • Win notification link for S2S pinging -> nurl

      All publishers should send the nurl win notifications. It is not required, however, it will improve redirect performance and reduce discrepancies. Nurl returns status code 200 if successful, no body. The link that you should send your users to is contained in the "url" parameter. DO NOT SEND USERS TO THE "nurl" LINK!

      Requests and response Example JASON (srtb):

      Requests Example (srtb)

      Example url of a request with a few important parameters:

      http://[DOMAIN_GIVEN_TO_YOU]/api/v1/srtb?sid=941_13&k=apartments,villas&l=en-GB&url=https%3A%2F%2Fwww.google.com%2Fsearch%3Fq%3Dab&ip=8.8.8.8&ua=Mozilla%2F5.0%20(Macintosh%3B%20Intel%20Mac%20OS%20X%2010_15_7)%20AppleWebKit%2F537.36%20(KHTML%2C%20like%20Gecko)%20Chrome%2F92.0.4515.131%20Safari%2F537.36

      Response Format (srtb)

      {"id":"1","seatbid":[{"bid":[{"id":"1","impid":"1","price":0,"adm":"https://redirectdomain.com/r?d=ikWpRKCvs6WfUDNIcFSaRLeMIsk4rAojO0x8A2T0","nurl":"http://nurldomain.com/nurl?d=ikWpRKCvs6WfUDNIcFSaRLeMIsk4rAojO0x8A2T0"}],"seat":"1"}]}

      Redirect Link for users -> adm

      Win notification link for S2S pinging -> nurl

      Key points about responses:

        • Default response returns CPC float values

      Note: If you require CPM values please contact your account manager

        • Bids are valid for 5 minutes
        • Redirect Link for users -> adm
        • Win notification link for S2S pinging -> nurl

      All publishers should send the nurl win notifications. It is not required, however, it will improve redirect performance and reduce discrepancies. Nurl returns status code 200 if successful, no body. The link that you should send your users to is contained in the "adm" parameter. DO NOT SEND USERS TO THE "nurl" LINK!

      Example of brand requests URL

      • SRTB I JSON

      Example brand request URL:

      http://[DOMAIN_GIVEN_TO_YOU]/api/v1/srtb?sid=[SUBID]&ip=[IPV4]&ua=[USER_AGENT]&brand=[BRAND_DOMAIN]&brandct=[BRAND_CLASSIFICATION_TYPE]&to=[MAX_TIMEOUT]&l=[BROWSER_LANGUAGE]&uid=[USER_ID]&ch-ua=[CLIENT_HINTS_UA]&ch-mob=[CLIENT_HINTS_MOBILE]&ch-os=[CLIENT_HINTS_OS]&ch-osv=[CLIENT_HINTS_PLATFORM_VERSION]
      • XRTB I XML

      Example brand request URL:

      http://[DOMAIN_GIVEN_TO_YOU]/api/v1/xrtb?sid=[SUBID]&ip=[IPV4]&ua=[USER_AGENT]&brand=[BRAND_DOMAIN]&brandct=[BRAND_CLASSIFICATION_TYPE]&to=[MAX_TIMEOUT]&l=[BROWSER_LANGUAGE]&uid=[USER_ID]&ch-ua=[CLIENT_HINTS_UA]&ch-mob=[CLIENT_HINTS_MOBILE]&ch-os=[CLIENT_HINTS_OS]&ch-osv=[CLIENT_HINTS_PLATFORM_VERSION]

      Technical Requirements

      Important Requirements

      Critical implementation details:

        • Use keep-alive connections

      Note: In case of no keep-alives your requests might end up being throttled.

        • Stick to HTTP over HTTPS for s2s requests
        • Servers located in New York/Toronto areas
        • Minimum timeout value is 50ms

      Note: If required parameters are missing from the request the keep-alive connection will be closed

      If you would like to receive gzipped responses feel free to add the Accept-Encoding header with gzip as a value to your requests (recommended only if are you receiving 3+ bids per request, otherwise it might not be worth it and it'll most likely be counter-productive)