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
            ]
        }
    ]
}