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.
Value |
Type |
Description |
---|---|---|
pos |
int |
Placement position on screen. Placement Positions.
|
instl |
int |
Indicates if this is an interstitial placement, where |
topframe |
int |
Indicates if the placement will be loaded into an iframe or not:
|
ifrbust |
array of strings |
Array of supported |
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:
|
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).
|
mime |
array of strings |
Array of supported mime types (e.g., |
api |
array of int |
List of supported APIs. If an API is not explicitly listed, it is assumed to be unsupported:
|
ctype |
array of int |
Creative subtypes permitted.
|
w |
int |
Width of the placement in pixels. Note: this size applies to the
placement itself; permitted creative sizes are specified in the |
h |
int |
Height of the placement in pixels. Note: this size applies to the
placement itself; permitted creative sizes are specified in the |
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.
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:
|
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
]
}
]
}
}