The MediaGrid Buyer Protocol 1.0navigate_next Bid Requestnavigate_next Banner Object
Quick search
The Media Grid

The MediaGrid UI

  • Getting Started
  • Ad Safety
  • Deals
  • Supply Onboarding
  • Sell-Side Hierarchy
  • UI Video Tutorials
    • UI Intro
    • Submitting Domains For Approval
    • Setting Up New Ad Units
    • Ad Safety Blocking

Buyer Protocol

  • The MediaGrid Buyer Protocol 1.0
    • Protocol Release Notes
    • burl Field Overview
    • Data Compression (gzip)
    • Sensitive Categories and Rich Media
    • Expected s2s Behaviour
    • s2s Headers
    • GDPR FAQs, The MediaGrid
    • Bid Request
      • Impression Object
      • Banner Object
      • Format Object
      • Video Object
      • Audio Object
      • Native Object
      • Native Request Object
      • Device Object
      • Geo Object
      • User Object
      • Site Object
      • App Object
      • Content Object
        • Network Object
        • Channel Object
        • Producer Object
      • DOOH Object
      • Metric Object
      • Private Marketplace Object
      • Source Object
      • Deal Object
      • Publisher Object
      • Ext Object
      • Regs Object
      • Data Object
      • Bid Request JSON Examples
    • Bid Response
      • Bid Response Ext Object
      • Seat Bid Object
      • Bid Object
      • Native Response Object
      • Data Response Object
      • Bid Response JSON Examples

Publisher Integration Guides

  • Getting Started with The MediaGrid
  • Amazon UAM/TAM Integration
  • Server-To-Server Integration
    • Prebid Server Bid Request
      • Impression Object
      • Banner Object
      • Video Object
      • App Object
      • Site Object
      • Content Object
      • Publisher Object
      • Device Object
      • Geo Object
      • Source Object
      • User Object
      • Metric Object
      • Regulation Object
      • Bid Request Example
    • Prebid Server Bid Response
      • Seat Bid Object
      • Bid Object
      • Bid Ext Object
      • Bid Response Example
  • Connected TV Tags
  • Client-side Header Bidding
    • Prebid Client-Side Request
      • Impression Object
      • User Object
      • Data Object
      • Regulation Object
      • Site Object
      • Content Object
      • Source Object
      • Video Object
      • Banner Object
    • Prebid Client-Side Response
      • Seat Bid Object
      • Bid Object

Deal Activation Guides

  • Adelphic
  • Google DV360
  • MediaMath
  • TheTradeDesk (TTD)
  • Yahoo DSP

Real-Time Data Support

  • General Format Guidelines
  • JW Player
  • Permutive

Publisher Information

  • Ads.txt Compliance
  • Auction Tiers
  • The MediaGrid and GDPR

Reporting

  • Reporting Overview
  • Reporting UI
    • All u-Slicer Functions
  • Reporting API
    • Audience Endpoint
    • Export Endpoint
    • Info Endpoint
    • Query Endpoint
    • Time Series Endpoint
  • Reporting Keys and Values
  • u-Slicer API Business Queries
The Media Grid

The MediaGrid UI

  • Getting Started
  • Ad Safety
  • Deals
  • Supply Onboarding
  • Sell-Side Hierarchy
  • UI Video Tutorials
    • UI Intro
    • Submitting Domains For Approval
    • Setting Up New Ad Units
    • Ad Safety Blocking

Buyer Protocol

  • The MediaGrid Buyer Protocol 1.0
    • Protocol Release Notes
    • burl Field Overview
    • Data Compression (gzip)
    • Sensitive Categories and Rich Media
    • Expected s2s Behaviour
    • s2s Headers
    • GDPR FAQs, The MediaGrid
    • Bid Request
      • Impression Object
      • Banner Object
      • Format Object
      • Video Object
      • Audio Object
      • Native Object
      • Native Request Object
      • Device Object
      • Geo Object
      • User Object
      • Site Object
      • App Object
      • Content Object
        • Network Object
        • Channel Object
        • Producer Object
      • DOOH Object
      • Metric Object
      • Private Marketplace Object
      • Source Object
      • Deal Object
      • Publisher Object
      • Ext Object
      • Regs Object
      • Data Object
      • Bid Request JSON Examples
    • Bid Response
      • Bid Response Ext Object
      • Seat Bid Object
      • Bid Object
      • Native Response Object
      • Data Response Object
      • Bid Response JSON Examples

Publisher Integration Guides

  • Getting Started with The MediaGrid
  • Amazon UAM/TAM Integration
  • Server-To-Server Integration
    • Prebid Server Bid Request
      • Impression Object
      • Banner Object
      • Video Object
      • App Object
      • Site Object
      • Content Object
      • Publisher Object
      • Device Object
      • Geo Object
      • Source Object
      • User Object
      • Metric Object
      • Regulation Object
      • Bid Request Example
    • Prebid Server Bid Response
      • Seat Bid Object
      • Bid Object
      • Bid Ext Object
      • Bid Response Example
  • Connected TV Tags
  • Client-side Header Bidding
    • Prebid Client-Side Request
      • Impression Object
      • User Object
      • Data Object
      • Regulation Object
      • Site Object
      • Content Object
      • Source Object
      • Video Object
      • Banner Object
    • Prebid Client-Side Response
      • Seat Bid Object
      • Bid Object

Deal Activation Guides

  • Adelphic
  • Google DV360
  • MediaMath
  • TheTradeDesk (TTD)
  • Yahoo DSP

Real-Time Data Support

  • General Format Guidelines
  • JW Player
  • Permutive

Publisher Information

  • Ads.txt Compliance
  • Auction Tiers
  • The MediaGrid and GDPR

Reporting

  • Reporting Overview
  • Reporting UI
    • All u-Slicer Functions
  • Reporting API
    • Audience Endpoint
    • Export Endpoint
    • Info Endpoint
    • Query Endpoint
    • Time Series Endpoint
  • Reporting Keys and Values
  • u-Slicer API Business Queries

Banner Object¶

Note

Fields marked with an asterisk (*) are optional.

Banner Object Properties¶

Value

Type

Description

format*

array or objects

(Recommended) An array of format objects, see Format Object, denoting the alternative sizes that may be used for bidding. If one of the alternative ad sizes is used in the bid response, then the seatbid.bid.h and seatbid.bid.w fields are required in the bid response.

w

integer

Width of the impression in pixels, for example, 300

h

integer

Height of the impression in pixels, for example 250

battr*

array of integers

Blocked creative attributes as defined in the OpenRTB protocol, for example, [1, 23]

btype*

array of integers

Blocked banner ad types as defined in the OpenRTB protocol, for example, [4, 21]

pos*

integer

Ad Position as defined in the OpenRTB protocol, for example, 1

topframe*

integer

Indicates if the banner is in the top frame as opposed to an iframe.

  • 0 = no

  • 1 = yes.

mimes*

array of strings

Specifies the content MIME types supported, common MIME types include "text/html", "application/x-shockwave-flash", and "image/gif". For example:

[ "video/mp4", "image/jpg"]

expdir*

array of integers

Possible expansion directions for an expandable ad, for example, [2,5]. This can take the following values:

  • 1: Left

  • 2: Right

  • 3: Up

  • 4: Down

  • 5: Full screen

If the field is not present, expandable creatives are not allowed.

api*

array of integers

List of supported API frameworks for this impression as defined in the OpenRTB, for example [3, 5]. If an API is not explicitly listed, it is assumed not to be supported.

id*

string

Unique identifier for this banner object. Recommended when Banner objects are used with a Video object to represent an array of companion ads. Values usually start at 1 and increase with each object; should be unique within an impression.

vcm*

integer

Relevant only for Banner objects used with a Video object in an array of companion ads. Indicates the companion banner rendering mode relative to the associated video, where 0 = concurrent, 1 = end-card.

Banner JSON Example¶

{
   "banner":{
      "w":300,
      "h":250,
      "pos":1,
      "topframe":0,
      "btype":[
         2,
         3
      ],
      "mimes":[
         "text/html",
         "application/x-shockwave-flash"
      ],
      "format":[
         {
            "h":50,
            "w":300
         }
      ]
   }
}

  • Banner Object
    • Banner JSON Example
arrow_back
Previous
Impression Object
arrow_forward
Next
Format Object
© 2019-2023 The MediaGrid.

All rights reserved. This document contains IPONWEB proprietary information.

About Us
IPONWEB Policy
Privacy Policy
News & Insights


Last updated Jul 04, 2023