Item Object¶
The item
represents a unit of goods being offered for sale either on the
open market or in relation to a private marketplace deal. The item.id
attribute is
required since there may be multiple items being offered in the same bid request and
bids must reference the specific item of interest. There may be a maximum of 5 items
per bid request.
Value |
Type |
Description |
---|---|---|
id |
string |
A unique identifier for this item within the context of the offer (typically
starts with |
qty* |
int |
The quantity of items being offered, e.g. multiple identical impressions in a digital out-of-home scenario. |
seq* |
int |
If multiple items are offered in the same bid request, the sequence number allows for the coordinated delivery. |
flr* |
float |
Minimum bid price for this item expressed in CPM. |
flrcur* |
str |
Currency of the flr attribute specified using ISO-4217 alpha codes. The
default is |
exp* |
int |
Impression expiry time. Advisory as to the number of seconds that may elapse between auction and fulfilment. |
dt* |
int |
Delivery time. The timestamp when the item is expected to be fulfilled. This field can be used to signify day-parting, (e.g. when a DOOH impression will be displayed) in Unix format (i.e., milliseconds since the epoch). |
dlvy* |
int |
The supported item (e.g., an Ad object) delivery method required, where:
Note: that if an exchange does not supported prior upload, then the default of 0 is effectively the same as 1 since there can be no items to reference. |
metric* |
array of objects |
An array of metric objects, see the Item Metric |
deal* |
array of objects |
An array of deal objects relevant to this item, see the Deal Object |
private* |
int |
Indicates a private deal:
|
spec |
object |
(Required) This holds the Item Placement object, and objects within this come from those defined in the AdCom specification. |
Item JSON Example¶
{
"item":[
{
"id":"1",
"exp":300,
"ext":{
"ssp":"google",
"at":1,
"ads_txt":{
"status":2,
"auth_id":"1kjgh7653",
"pub_id":"537120563"
}
},
"qty":1,
"flr":1.23,
"flrcur":"usd",
"seq":1,
"private":0,
"spec":{
"placement":{
}
},
"dt":1243
}
]
}