Display Event

The placement.display.event object specifies a type of ad tracking event and which methods of tracking are available for it. This object may appear as an array for a given placement indicating various types of available tracking events.

Event Object Properties
Value Type Description
type integer

(Required) Type of supported ad tracking event. The following types refer to the actual event, timing, etc.; not the method of firing. Scripts that are performing measurement should be deployed at the “loaded” event.

  • 1 loaded: Delivered as a part of the creative markup. Creative may be pre-cached or pre-loaded; prior to initial rendering.
  • 2 impression: Ad impression per IAB/MRC Ad Impression Measurement Guidelines.
  • 3 viewable-mrc50: Visible impression using MRC definition of 50% in view for 1 second.
  • 4 viewable-mrc100: 100% in view for 1 second (i.e., the GroupM standard).
  • 5 viewable-video50: Visible impression for video using MRC definition of 50% in view for 2 seconds.
method array of integers

Array of supported event tracking methods for this event type:

  • 1 Image-Pixel: URL provided will be inserted as a 1x1 pixel at the time of the event.
  • 2 JavaScript: URL provided will be inserted as a JavaScript tag at the time of the event
api array of integers

Event tracking APIs available for use, only relevant for JavaScript method trackers:

  • 1 VPAID 1.0
  • 2 VPAID 2.0
  • 3 MRAID 1.0
  • 4 ORMMA
  • 5 MRAID 2.0
  • 6 MRAID 3.0
  • 7 OMID 1.0
ext object See Event Extension Object

Event Extension Object

Event Extension Object Properties
Value Type Description
clktrkrq integer Indicated that a click tracker is required. 1 for bid requests that require click tracking macro in the bid response, 0 otherwise.

Event JSON example

{
    "event":[
        {
            "type":1,
            "method":[
                2
            ]
        },
        {
            "type":2,
            "method":[
                3,
                4
            ]
        }
    ]
}