Native Display¶
The request.item.spec.placement.display.nativefmt
object defines a display
placement to be specifically a native display placement. It serves as the root of a
structure that includes the specifications for each of the assets that comprise the
native placement.
Value |
Type |
Description |
---|---|---|
asset |
array of objects |
An array of Asset Objects which specify the set of native assets and their permitted formats, see Native Asset Object |
Native Asset Object¶
Value |
Type |
Description |
---|---|---|
id |
integer |
(Required) Unique asset ID, for example |
req |
integer |
Set to |
title* |
object |
(Required) Native title object, see the Native Asset Title Object for more details. |
img* |
object |
(Required) Native image object, see the Native Asset Image Object for more details. |
video* |
object |
(Required) Native video object, see the Native Asset Video Object for more details. |
data* |
object |
(Required) Native asset data object, see the Native Asset Data Object section for more details. |
Note
(*) Exactly one of the fields marked with an asterisk is required in the asset object.
Native Asset Title Object¶
Value |
Type |
Description |
---|---|---|
len |
integer |
Maximum length of the text in the title element, for example, |
Native Asset Image Object¶
The image asset object may contain the exact image size, the minimum image size, or both. If only the exact image size is specified then the image in the bid response should have the corresponding size. If the minimum size is specified then the image asset in the bid response should comply with the following restrictions.
The size of the image should be equal to or larger than the minimum specified
The image asset in the bid response should contain the
w
andh
fields.
Note
It is recommended that the aspect ratio of the image should be close to the one specified by the exact size or by the minimum size; the acceptable aspect ratio deviation is from \(0.8 * (w/h)\) to \(1.25 * (w/h)\)
Value |
Type |
Description |
---|---|---|
type* |
integer |
Image asset type, for example
|
w* |
integer |
Width of the image in pixels, for example, |
wmin* |
integer |
The minimum requested width of the image in pixels, for example,
|
h* |
integer |
Height of the image in pixels, for example, |
hmin* |
integer |
The minimum requested height of the image in pixels, for example,
|
mime* |
array of strings |
Whitelist of content MIME types supported, for example, |
Native Asset Video Object¶
Value |
Type |
Description |
---|---|---|
mime |
array of strings |
(Required) Content MIME types supported. Note: For Google bids all the specified MIME type media files are
required in the VAST response, for example,
|
ptype |
integer |
Placement type for the impression, for example
|
pos |
integer |
Ad Position as defined in OpenRTB, for example
|
delay |
integer |
Indicates the start delay in seconds. If the start delay value is greater than 0, then the position is mid-roll and the value indicates the start delay.
|
skip |
integer |
Indicates if the player will allow the video to be skipped, where |
skipmin |
integer |
Videos of a total duration greater than this value (seconds) can be skippable; only applicable if the ad is skippable. |
skipafter |
integer |
Number of seconds a video must play before skipping is enabled; only applicable if the ad is skippable. |
playmethod |
array of integers |
Allowed playback methods as defined in the OpenRTB, for example
|
playend |
integer |
The event that causes playback to end, for example
|
api* |
array of integers |
List of supported API frameworks for this impression as defined in
OpenRTB, for example,
|
ctype |
integers |
Creative subtypes permitted.
|
w |
integer |
Width of the player in pixels, for example, |
h |
integer |
Height of the player in pixels, for example |
mindur |
integer |
Minimum video ad duration in seconds, for example, |
maxdur |
integer |
Maximum video ad duration in seconds, for example, |
minbitr |
integer |
Minimum bit rate in Kbps, for example |
maxbitr |
integer |
Maximum bit rate in Kbps, for example |
delivery |
array of integers |
Supported delivery methods (e.g., streaming, progressive) as defined
in OpenRTB. If none specified, assume all are supported,
for example,
|
linear |
integer |
Indicates if the impression must be linear or nonlinear, for
example,
|
boxing |
integer |
Indicates if letter-boxing of 4:3 content into a 16:9 window is allowed:
|
comp |
object array |
Array of Banner objects if companion ads are available. See the Companion Ad section for more information. |
comptype |
array of integers |
List of allowed companion ad types, for example
|
Native Asset Data Object¶
Value |
Type |
Description |
---|---|---|
type |
integer |
Data asset type as described in OpenRTB Native specification, for
example,
|
len* |
integer |
The maximum allowed length of the data value, for example, |