Impression Object

Note

Fields marked with asterisk (*) are optional.

Impression Object Properties
Value Type Description
id string ID of the impression being shown, unique within the bid request, for example "1"
banner* object The Banner Object describes the ad properties. Required for banner impressions. One of these objects should be present in the request: banner, video, audio, or native.
video* object The Video Object describes the ad properties. Required for video impressions.
audio* object The Audio Object describes the ad properties. Required for audio impressions. One of these objects should be present in the request: banner, video, audio, or native.
native* object The Native Object describes the ad properties. Required for native impressions. One of these objects should be present in the request: banner, video, audio, or native.
bidfloor* float Bid floor in CPM as set by the Supplier, for example, 0.01080
bidfloorcur* string Bid floor currency specified using ISO-4217 alpha codes, the default is, "USD".
instl* integer

Specifies if the ad is an interstitial.

  • 0 = not interstitial, the default value.
  • 1 = the ad is interstitial or full screen
tagid* string Identifier for specific ad placement or ad tag that was used to initiate the auction.
secure* integer

Specifies if the page is SSL compliant:

  • 0: for insecure pages, the default value.
  • 1: for secure pages. Creative assets for secure pages should be SSL-compliant.
iframebuster* array of strings Array of names of supported iframe busters, for example, ["dc", "rb"], for more information, see the Supported Rich Media Frameworks section.
pmp* object The Private Marketplace Object, used for direct deals between Buyers and Suppliers.
displaymanager* string Name of the ad mediation partner, SDK technology, or native player responsible for rendering the ad (typically video or mobile), for example, "SOMA"
displaymanagerver* string Version of the ad mediation partner, SDK technology, or native player responsible for rendering the ad (typically video or mobile), for example, "1.1"
metric* array of objects The object that is associated with an impression as an array of metrics, see the Metric Object section.
exp* integer Impression expiry timeout, in seconds, the default is "300". An impression will be considered expired if it is registered later than imp.exp seconds after the auction.

Example Impression Object JSON

{
   "imp":[
      {
         "id":"1",
         "metric":[
            {
              "type":"viewability",
              "value":0.85
            }
         ],
         "bidfloor":0.426,
         "banner":{
            "w":300,
            "h":250,
            "pos":1,
            "topframe":0,
            "expdir":[
               1,
               3
            ]
         }
      }
   ]
}