Bid Request Specification
BidMachine Ad Exchange currently works with openRTB 2.3 and 2.5. This documentation is only valid for openRTB 2.3.
Bid Request Object Properties
|id||string||Unique ID of the bid request, provided by the exchange.||d5260eec-75d9-4f7d-86bc-22b01b4c779e|
|imp||object array||Array of Imp objects representing the impressions offered.|
At least 1 Imp object is required.
|app||object||Details about the publisher’s app (i.e., non-browser applications).|
Only applicable and recommended for apps.
|device||object||Details about the user’s device to which the impression will be delivered.|
|user||object||Details about the human user of the device; the advertising audience.|
|test||integer; default 0||Indicator of test mode in which auctions are not billable, where 0 = live mode, 1 = test mode||0|
|at||integer; default 2||Auction type, where 1 = First Price, 2 = Second Price Plus. BidMachine currently supports only type 2||2|
|tmax||integer||Maximum time in milliseconds to submit a bid to avoid timeout.|
This value is commonly communicated offline.
|cur||string array||Array of allowed currencies for bids on this bid request using ISO-4217 alpha codes.|
Recommended only if the exchange accepts multiple currencies.
|bcat||string array||Blocked advertiser categories using the IAB content categories.||["IAB2-1"]|
|badv||string array||Block list of advertisers by their domains.||["blocked.domain.com"]|
|reg||object||A Regs object that specifies any industry, legal, or governmental regulations in force for this request.|
|source||object||This object describes the nature and behavior of the entity that is the source of the bid request|
upstream from the exchange.
|ext||object||Placeholder for exchange-specific extensions to OpenRTB|
Updated almost 2 years ago