Display Placement

The item.spec.placement.display object signals that the placement may be a display placement. It provides additional detail about permitted display ads including simple banners, AMPHTML (i.e., Accelerated Mobile Pages), and native.

Placement Display Object Properties

Value

Type

Description

pos

int

Placement position on screen. Placement Positions.

  • 1 Above The Fold

  • 2 Locked (i.e., fixed position)

  • 3 Below The Fold

  • 4 Header

  • 5 Footer

  • 6 Sidebar

  • 7 Fullscreen

instl

int

Indicates if this is an interstitial placement, where 0 = no, 1 = yes.

topframe

int

Indicates if the placement will be loaded into an iframe or not:

  • 0 = unfriendly iframe or unknown

  • 1 = top frame, friendly iframe, or SafeFrame. A value of 1 can be understood to mean that expandable ads are technically capable of being delivered.

ifrbust

array of strings

Array of supported iframe busters, for example, [“dc”, “rb”], for more information, see the Sensitive Categories and Rich Media section.

ifrbust

array of strings

Array of supported iframe busters, for example, [“dc”, “rb”], for more

ptype

int

(Recommended) The display placement type, can take the following values:

  • 1 In the feed of content (e.g., in a feed, grid, listing, carousel, etc.).

  • 2 In the atomic unit of the content (e.g., in the article page or single image page).

  • 3 Outside the core content (e.g., in the ads section on the right rail, as a banner-style placement near the content, etc.).

  • 4 Recommendation widget; most commonly presented below article content.

  • 500+ Vendor-specific codes.

context

int

(Recommended) The context of the placement. The following are types of context in which a native ad may appear (i.e., the type of content surrounding the ad on the page). This is intended to denote primary content although other content may also appear on the page. Note that there are two levels of detail grouped by 10s (i.e., 12 is a refined case of 10).

  • 10 Content-centric context (e.g., newsfeed, article, image gallery, video gallery, etc.).

  • 11 Primarily article content, which could include images, etc. as part of the article.

  • 12 Primarily video content.

  • 13 Primarily audio content.

  • 14 Primarily image content.

  • 15 User-generated content (e.g., forums, comments, etc.).

  • 20 Social-centric context (e.g., social network feed, email, chat, etc.).

  • 21 Primarily email content.

  • 22 Primarily chat/IM content.

  • 30 Product context (e.g., product listings, details, recommendations, reviews, etc.).

  • 31 App store/marketplace.

  • 32 Product reviews site primarily, which may sell product secondarily.

  • 500+ Vendor-specific codes.

mime

array of strings

Array of supported mime types (e.g., ["image/jpeg", "image/gif"]). If omitted, all types are assumed.

api

array of int

List of supported APIs. If an API is not explicitly listed, it is assumed to be unsupported:

  • 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

  • 500+ Vendor-specific codes.

ctype

array of int

Creative subtypes permitted.

  • 1 HTML

  • 2 AMPHTML

  • 3 Structured Image Object

  • 4 Structured Native Object

w

int

Width of the placement in pixels. Note: this size applies to the placement itself; permitted creative sizes are specified in the displayfmt field or nativefmt.asset.img field.

h

int

Height of the placement in pixels. Note: this size applies to the placement itself; permitted creative sizes are specified in the displayfmt field or nativefmt.asset.img field.

displayfmt

array of objects

Array of objects that sets the attributes (e.g., sizes) of a banner display placement. See the Display Format

nativefmt

object

This object specifies the required and permitted assets and attributes of a native display placement. See Native Display

event

array of objects

Array of supported ad tracking events. See Display Event

Display Format

This spec.placement.display.displayfmt object represents an allowed set of parameters for a banner display ad and often appears as an array when multiple sizes are permitted.

Placement Display Format Object Properties

Value

Type

Description

w

int

Absolute width of the creative in pixels. Note that mixing absolute and relative sizes is not recommended.

h

int

Absolute height of the creative in pixels. Note that mixing absolute and relative sizes is not recommended.

wratio

int

Relative width of the creative when expressing size as a ratio. Note that mixing absolute and relative sizes is not recommended.

hratio

int

Relative height of the creative when expressing size as a ratio. Note that mixing absolute and relative sizes is not recommended.

expdir

array of integers

Directions in which the creative is permitted to expand:

  • 1 Left

  • 2 Right

  • 3 Up

  • 4 Down

  • 5 Full Screen

Display JSON Example

{
    "display":{
        "pos":1,
        "ptype":2,
        "context":11,
        "api":[
            3,
            5,
            6
        ],
        "ctype":[
            2,
            3
        ],
        "ampren":0,
        "instl":0,
        "displayfmt":[
            {
                "w":320,
                "h":50,
                "expdir":1
            },
            {
                "w":320,
                "h":250,
                "expdir":[
                    2,
                    5
                ]
            }
        ],
        "event":[
            {
                "type":1,
                "method":[
                    1
                ]
            }
        ]
    }
}