Banner Request & Response

Modified on Wed, 4 Nov at 5:55 AM

bideaseSAMPLES
Sample OpenRTB bid request and response for a banner placement.
SAMPLES
Banner Request & Response
1
Request sample
BID REQUEST
{
  "app": {
    "bundle": "587366035",
    "cat": [
      "IAB24",
      "IAB9",
      "IAB9-23",
      "photography",
      "social_networking"
    ],
    "id": "991e7160652a478e83a6c1b50bb1032d",
    "name": "PicsArt Photo Studio iOS",
    "publisher": {
      "id": "f31ec0bf2ad14c00a0ba18b91d7585c0",
      "name": "Picsart Inc"
    },
    "storeurl": "https://itunes.apple.com/us/app/picsart-photo-studio/id587366035?mt=8&uo=4",
    "ver": "14.5.1"
  },
  "at": 2,
  "badv": [
    "adobe",
    "airbrush",
    "aliexpress",
    "alipay",
    "amolatina",
    "b612",
    "beauty",
    "beeline",
    "brazzers.com",
    "zyrtec.com"
  ],
  "bcat": [
    "IAB11-1",
    "IAB11-2",
    "IAB11-3",
    "IAB11-4",
    "IAB11-5",
    "IAB14-1",
    "IAB14-3",
    "IAB14-8",
    "IAB23-1",
    "IAB23-10",
    "IAB23-2",
    "IAB23-3",
    "IAB23-4",
    "IAB23-5",
    "IAB23-6",
    "IAB23-7",
    "IAB23-8",
    "IAB23-9",
    "IAB25",
    "IAB26",
    "IAB7-39",
    "IAB8-18",
    "IAB8-5",
    "IAB9-12",
    "IAB9-22",
    "IAB9-23",
    "IAB9-9"
  ],
  "device": {
    "carrier": "250-99",
    "connectiontype": 2,
    "dnt": 0,
    "geo": {
      "city": "",
      "country": "USA",
      "region": "",
      "zip": "140093"
    },
    "h": 2436,
    "ifa": "F870AB9D-7422-4A00-A114-3E8DAF197700",
    "ip": "93.157.175.0",
    "js": 1,
    "language": "en",
    "make": "Apple",
    "model": "iPhone12,3",
    "os": "iOS",
    "osv": "13.4.1",
    "pxratio": 3,
    "ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 13_4_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148",
    "w": 1125
  },
  "id": "d66d1923-06f7-4a99-8ed6-f932ad5e32b4_00ab9777000451af",
  "imp": [
    {
      "banner": {
        "api": [
          3,
          5
        ],
        "battr": [
          1,
          3,
          8,
          9,
          10,
          13,
          14,
          17,
          6,
          7
        ],
        "btype": [
          4
        ],
        "format": [
          {
            "h": 50,
            "w": 320
          },
          {
            "h": 50,
            "w": 300
          }
        ],
        "h": 50,
        "pos": 1,
        "w": 320
      },
      "bidfloor": 0.02,
      "displaymanager": "displaymanager",
      "displaymanagerver": "displaymanagerver",
      "exp": 14400,
      "ext": {
        "reward": 0
      },
      "id": "1",
      "instl": 0,
      "metric": [
        {
          "type": "viewability",
          "vendor": "moat"
        }
      ],
      "pmp": {
        "deals": [
          {
            "at": 2,
            "bidfloor": 0.02,
            "id": "ip_0cfeaebb190d47df8b86399232853e23"
          }
        ],
        "private_auction": 0
      },
      "secure": 1,
      "tagid": "a2dc3bcafa95493da5afc8f233ef3b24"
    }
  ],
  "regs": {
    "ext": {
      "gdpr": 0
    }
  },
  "source": {
    "pchain": "74b46c0ea83967ca:f31ec0bf2ad14c00a0ba18b91d7585c0"
  },
  "tmax": 300,
  "user": {
    "keywords": ""
  }
}
2
Response sample
BID RESPONSE
{
  "id": "d66d1923-06f7-4a99-8ed6-f932ad5e32b4_00ab9777000451af",
  "cur": "USD",
  "seatbid": [
    {
      "bid": [
        {
          "id": "MqG6nOvWopaqdddl",
          "adid": "146704",
          "cid": "example_cid",
          "crid": "09b0fc6cb417bdc45394b9ac2e0a77ed",
          "impid": "1",
          "price": 0.24,
          "adomain": [
            "example.com"
          ],
          "bundle": "example_bundle",
          "cat": [
            "IAB22"
          ],
          "nurl": "https://track-win-us.bidease.com/win?x=MqG6nOvWoddl&win_price=${AUCTION_PRICE}",
          "lurl": "https://track-loss-us.bidease.com/loss?x=MqG6nOvWodddl&loss_reason=${AUCTION_LOSS}&win_price=${AUCTION_PRICE}",
          "burl": "https://proxy-track-us.bidease.com/imp?x=MqG6nOvWodddl&win_price=${AUCTION_PRICE}",
          "adm": "<!DOCTYPE html>\n<html>\n<head>\n<meta charset=\"UTF-8\">\n<meta name=\"authoring-tool\" content=\"Adobe_Animate_CC\">\n<title>Banner</title>\n<script src=\"mraid.js\"></script>\n<script src='https://creative.bidease.com/media/2019/09/example_creative.js'></script>\n</head>\n<body style=\"margin:0px;\">\n\t<div id=\"animation_container\" style='background-color:rgba(255, 255, 255, 1.00); width:320px; height:50px'>\n\t\t<canvas id=\"canvas\" width=\"320\" height=\"50\" style='position: absolute; display: block; background-color:rgba(255, 255, 255, 1.00);'></canvas>\n\t\t<div id=\"dom_overlay_container\" style=\"pointer-events:none; overflow:hidden; width:320px; height:50px; position: absolute; left: 0px; top: 0px; display: block;\">\n\t\t</div>\n\t</div>\n\t<script type=\"text/javascript\">\n var mraid;\n var impressionTrackers = [\"https://proxy-track-us.bidease.com/impcr?x=MqG6nOvWopaqdddl\"];\n var clickTrackers = /adx/i.test(\"mopub\") ? [\"%%CLICK_URL_UNESC%%\"] : [];\n var targetClickLink = \"https://proxy-track-us.bidease.com/click?x=MqG6nOvWopaqdddl\";\n var targetLink = \"\";\n var impressionTracked = false;\n var clickTracked = false;\n\n var trackClick = function() {\n sendClicks();\n mraid ? mraid.open(targetLink) : window.open(targetLink);\n };\n var trackViewableChange = function(viewable) {\n if (viewable) {\n mraid.removeEventListener(\"viewableChange\", trackViewableChange);\n showAd();\n }\n };\n var sendClicks = function() {\n if (!impressionTracked) {\n sendImpression();\n }\n if (!clickTracked) {\n var hiddenSpan = document.createElement(\"span\");\n hiddenSpan.style.display = \"none\";\n clickTrackers.forEach(function(tracker) {\n var img = document.createElement(\"img\");\n img.src = tracker;\n hiddenSpan.appendChild(img);\n document.body.appendChild(hiddenSpan);\n });\n clickTracked = true;\n }\n };\n var sendImpression = function() {\n if (!impressionTracked) {\n var hiddenSpan = document.createElement(\"span\");\n hiddenSpan.style.display = \"none\";\n impressionTrackers.forEach(function(tracker) {\n var img = document.createElement(\"img\");\n img.src = tracker;\n hiddenSpan.appendChild(img);\n document.body.appendChild(hiddenSpan);\n });\n impressionTracked = true;\n }\n };\n if (mraid && mraid.getState() === \"loading\") {\n mraid.addEventListener(\"ready\", showAd);\n } else {\n showAd();\n }\n function showAd() {\n if (mraid) {\n mraid.removeEventListener(\"ready\", showAd);\n if (mraid.isViewable()) {\n sendImpression();\n\n init();\n window.dispatchEvent(new Event('resize'));\n } else {\n mraid.addEventListener(\"viewableChange\", trackViewableChange);\n }\n } else {\n init();\n window.dispatchEvent(new Event('resize'));\n }\n };\n window.addEventListener(\"touchend\", function(e) {\n var cx = parseInt(e.changedTouches[0].clientX) || 0;\n var cy = parseInt(e.changedTouches[0].clientY) || 0;\n var winWidth = parseInt(window.innerWidth) || 0;\n var winHeight = parseInt(window.innerHeight) || 0;\n targetLink = targetClickLink + \"&cx=\" + cx + \"&cy=\" + cy + \"&cw=\" + winWidth + \"&ch=\" + winHeight;\n trackClick();\n }, false);\n\t</script>\n</body>\n</html>",
          "w": 320,
          "h": 50,
          "ext": {}
        }
      ]
    }
  ],
  "ext": {}
}
bidease
Grow Your App with Ease
Questions? Contact your Bidease account manager
support@bidease.com

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article