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