Banner ads

Banner ads aren't always static images. They usually serve as containers, such as an iframe on the web or a WebView in mobile apps, running HTML, CSS, and JavaScript to power HTML5 banners, interactive content, and animations. Banner ads support MRAID versions 2.0 and 3.0.

When sending a request to DSP, you need to accurately describe the ad unit. Here are the main fields for the banner object:

Parameter

Description

format

Dimensions: w for width and h for height.

mimes

MIME types: Used to indicate file formats the ad platform supports. For example: ["image/jpeg", "image/png", "text/html", "application/javascript"]. If the publisher doesn't support HTML5, they won't pass text/html.

pos

Screen position: Parameter used to evaluate viewability. Possible values:

  • 1: Viewable portion of the screen without scrolling (ATF, above the fold).
  • 3: Requires scrolling down (BTF, below the fold).
  • 7: Fullscreen.

battr

Blocked attributes: Publishers can block specific creative types, such as:

  • 1: Creatives with audio.
  • 8: Creatives that trigger pop-ups.
  • 3/4/5: Expandable creatives.

api

Supported frameworks: Used to pass supported standards. Possible values:

  • 3: MRAID 1.0.
  • 5: MRAID 2.0.
  • 6: MRAID 3.0.
  • 7: OMID 1.0 for measuring viewability.

For details on banner field parameters, see the IAB documentation.

Sample request

Let's say a publisher (mobile app) requests a banner. The ad unit supports two sizes, sits above the fold, supports HTML5 and MRAID, and blocks ads with audio:

{
  "id": "req-89b-432a-99ef-12345",
  "imp": [
    {
      "id": "imp-1",
      "bidfloor": 1.50, 
      "bidfloorcur": "USD",
      "banner": {
        "format": [
          { "w": 300, "h": 250 },
          { "w": 320, "h": 250 }
        ],
        "mimes": [
          "image/jpeg",
          "image/png",
          "text/html"
        ],
        "pos": 1,
        "battr": [ 1, 8 ], 
        "api": [ 3, 5, 7 ] 
      }
    }
  ],
  "app": {
    "bundle": "com.developer.coolgame",
    "name": "Cool Puzzle Game",
    "publisher": { "id": "pub-99" }
  },
  "device": {
    "ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 16_4 like Mac OS X)...",
    "ip": "192.168.1.1",
    "ifa": "00000000-0000-0000-0000-000000000000",
    "os": "iOS",
    "osv": "16.4"
  }
}

Sample response:

The DSP evaluates the request, matches a suitable advertiser, and submits a bid. The response must include the actual creative (banner code), the price the DSP is willing to pay, and the advertiser domain.

{
  "id": "req-89b-432a-99ef-12345",
  "seatbid": [
    {
      "seat": "dsp-seat-42",
      "bid": [
        {
          "id": "bid-98765",
          "impid": "imp-1",
          "price": 2.10,
          "w": 300,
          "h": 250,
          "adomain": [ "domain.com" ],
          "crid": "creative-shoes-300x250",
          "adm": "<!-- Start of ad code --><a href='https://click.dsp.com/track?bid=98765' target='_blank'><img src='https://cdn.dsp.com/nike-banner-300x250.jpg' width='300' height='250' border='0'></a><img src='https://imp.dsp.com/track?bid=98765' width='1' height='1' style='display:none;'><!-- End of ad code -->"
        }
      ]
    }
  ],
  "cur": "USD"
}
Examples of display banners

Previous
Main ad formats
Next
Native ads