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