Bid on adaptive banner inventory

With adaptive banners, a portion of inventory can accommodate flexible ad sizes. To compete for this inventory, your integration must interpret the multi-size fields in the bid request.

By interpreting multi-size bid requests, you can do the following:

• Access more inventory: Bid on a larger pool of impressions from users adopting adaptive banners.
• Increase win rate: By considering a wider size range of eligible banner ads for flexible ad slots, you can submit competitive bids to increase bid rate.

This guide covers supporting multi-size bid requests.

Read multi-size requests

To bid on adaptive banner inventory, you must do either of the following:

• Read the BidRequest.imp.banner.format array. This array contains:
  • The requested size, which might be non-IAB standard.
  • IAB-standard sizes that are smaller than the requested size.
• Read the minimum and maximum width and height from the BidRequest.imp.banner.ext.flexslot extension. This Google-specific extension provides information about the full range of accepted sizes. For more details, see FlexSlot.

Using these fields, identify the best size match for your supported inventory rather than defaulting to the first available size in the format array.

Example multi-size request

The following example shows a bid request for a flexible ad slot:

imp {
  banner {
    w: 800
    h: 50
    format {
      w: 800
      h: 50
    }
    format {
      w: 375
      h: 50
    }
    format {
      w: 300
      h: 50
    }
    format {
      w: 320
      h: 50
    }
    adx_ext {
      flexslot {
        wmin: 300
        wmax: 800
        hmin: 50
        hmax: 50
      }
    }
  }
}

In this example, the primary size is 800x50. The formats array indicates you can also bid with creatives of the following sizes:

• 375x50
• 300x50
• 320x50

The BidRequest.imp.banner.ext.flexslot field indicates you can bid with any creative with a width between 300 to 800, and a height of 50.