Skip to content

Image Display Ads (2.5)

Here you will find example bid requests and responses for Image Display Ads with OpenRTB 2.5

Bid Request

json
{
  "allimps": 0,
  "app": {
    "bundle": "defaultBundleId",
    "cat": [
      "IAB7-42"
    ],
    "id": "272",
    "name": "app-1",
    "publisher": {
      "id": "5020371",
      "name": "PublisherNameFromSPX"
    },
    "storeurl": "https://itunes.apple.com/app/apple-store/id953922567567341232323"
  },
  "at": 2,
  "bcat": [
    "IAB17-18",
    "IAB7-42",
    "IAB23",
    "IAB7-28",
    "IAB26",
    "IAB25",
    "IAB9-9",
    "IAB24"
  ],
  "device": {
    "connectiontype": 0,
    "devicetype": 4,
    "didmd5": "d1c553888076489a45af4b6dfb9392eb",
    "didsha1": "81407cd1808b59681f2da1341d8ac62dfa9293fa",
    "geo": {
      "city": "Boston",
      "country": "USA",
      "ipservice": 3,
      "lat": 42.360504,
      "lon": -71.0548,
      "metro": "506",
      "region": "MA",
      "type": 2,
      "zip": "02109"
    },
    "h": 480,
    "ip": "50.255.150.200",
    "js": 0,
    "language": "en",
    "make": "Apple",
    "model": "iPhone",
    "os": "iOS",
    "osv": "4.3.2",
    "pxratio": 1,
    "ua": "Mozilla/5.0 (iPhone; U; CPU iPhone OS 4_3_2 like Mac OS X; en-us) AppleWebKit/533.17.9 (KHTML, like Gecko) Version/5.0.2 Mobile/8H7 Safari/6533.18.5",
    "w": 320
  },
  "id": "820e63f1-d68a-4267-ad8d-c63b9329d3db",
  "imp": [
    {
      "banner": {
        "btype": [
          1,
          3
        ],
        "format": [
          {
            "h": 50,
            "w": 320
          }
        ],
        "h": 50,
        "mimes": [
          "image/jpeg",
          "image/png",
          "image/gif"
        ],
        "pos": 0,
        "w": 320
      },
      "displaymanager": "SOMA",
      "ext": {
        "strictbannersize": 0
      },
      "id": "1",
      "instl": 0,
      "secure": 0,
      "tagid": "5020497"
    }
  ],
  "regs": {
    "coppa": 0,
    "ext": {
      "gdpr": 0
    }
  },
  "source": {
    "pchain": "07bcf65f187117b4:5020371"
  },
  "tmax": 1500,
  "user": {
    "ext": {
      
    },
    "gender": "M",
    "yob": 1977
  }
}

Bid Response

json
{
    "id": "820e63f1-d68a-4267-ad8d-c63b9329d3db",
    "bidid":"76fd96e67525bcfbe7ffe930e78079a1",
    "cur":"USD",
    "seatbid": [
        {
            "bid": [
                {
                    "id": "820e63f1-d68a-4267-ad8d-c63b9329d3db:1",
                    "impid": "1",
                    "adid": "3",
                    "cid": "41",
                    "crid": "31",
                    "price": 0.175,
                    "adomain": [
                        "example.com"
                    ],
                    "nurl": "https://www.example.com/dsp/nurl/?id=40ee9162748b87ecfbcd12a651f40bbd&price=${AUCTION_PRICE}",
                    "burl": "https://www.example.com/dsp/burl/?id=40ee9162748b87ecfbcd12a651f40bbd&price=${AUCTION_PRICE}",
                    "lurl": "https://www.example.com/dsp/lurl/?id=40ee9162748b87ecfbcd12a651f40bbd&code=${AUCTION_LOSS}",
                    "adm": "[NEXUS_XML_AD_MARKUP]"
                }
            ],
            "seat":"25"
        }
    ]
}

XML Ad Markup - Image Display Ads

xml
<?xml version="1.0" encoding="ISO-8859-1"?>
<ad>
    <imageAd>
        <clickUrl><![CDATA[https://www.example.com]]></clickUrl>
        <imgUrl><![CDATA[https://www.example.com/images.jpg]]></imgUrl>
        <width>320</width>
        <height>50</height>
    </imageAd>
</ad>

White-label Nexus API documentation