BidResponse specification requirements
id
string; required
Specifies the ID of the bid request to which this is a response to, for example, "d7d1e107-fe7c-4a57-9592-d1d41fa702d9"
seatbid
array of objects
An array of Seat Bid objects, see the Seat Bid Object section. The length of the array can be either 1+ (for yes-bid) or 0 (for no-bid).
cur
string; required
Sets the bidding currency using ISO-4217 alphabetic codes. If not provided USD is assumed, "USD"
ext
object
The bid response extension object. This field may be omitted in No Bid Responses, see the Bid Response Ext Object section.
bidid
string; required
Bidder generated response ID to assist with logging/tracking
Object Seatbid.Bid
id
string; required
Bidder generated bid ID to assist with logging/tracking.
impid
string; required
ID of the Imp object in the related bid request.
price
float; required
Bid price expressed as CPM although the actual transaction is for a unit impression only. Note that while the type indicates float, integer math is highly recommended when handling currencies (e.g., BigDecimal in Java).
adomain
string array; required
Advertiser domain for block list checking (e.g., “ford.com”). This can be an array of for the case of rotating creatives. Exchanges can mandate that only one domain is allowed.
adid
string; recommended
ID of a preloaded ad to be served if the bid wins
adm
string; required
Creative markup for ads (banner, native, video).
iurl
string; recommended
URL without cache-busting to an image that is representative
cid
string; recommended
Campaign ID to assist with ad quality checking; the collection of creatives for which iurl should be representative
crid
string; recommended
Creative ID to assist with ad quality checking.
nurl
string; recommended
Win notice URL called by the exchange if the bid wins (not necessarily indicative of a delivered, viewed, or billable ad); optional means of serving ad markup.
burl
string; recommended
Billing notice URL called by the exchange when a winning bid becomes billable based on exchange-specific business policy (e.g., typically delivered, viewed, etc.).
lurl
string; recommended
Loss notice URL called by the exchange when a bid is known to have been lost.
ext.type
string; recommended
Type ads in adm: banner, video, native
Bid Response extension
name
type
description
.ext.bannerd.debug_info
string
Debug info
.ext.agerestrictions
string
Age restriction like "18+" (is added to the beginning of .title.text as "[18+] ")
Loss notification VK Ad Network supports notifications to automatically block creatives when the following statuses are received in ${AUCTION_LOSS}
code
description
200
Creative Filtered - General; reason unknown.
201
201 Creative Filtered - Pending processing by Exchange (e.g., approval, transcoding, etc.)
202
Creative Filtered - Disapproved by Exchange
1001
Creative blocked at Publisher site or app
1002
Publisher site or app using test_mode
Last updated