Bid Object
Attribute | Type | Description | Example |
---|---|---|---|
id | string; required | Bidder generated bid ID to assist with logging/tracking. | "1fwdsg1gdsgwfdb" |
impid | string; required | ID of the Imp object in the related bid request | "23fsdfsdg-12312fds-44f4-12dfsfa-824f7221d116" |
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). |
1.15 |
adid | string | ID of a preloaded ad to be served if the bid wins. | "1378ygfvn928ouyghf19oiuhg03r" |
nurl | string | Win notice URL called by the exchange if the bid wins; optional means of serving ad markup. | "http://example.com/win/1378ygfvn928ouyghf19oiuhg03r?won=${AUCTION_PRICE}&impid={AUCTION_IMP_ID}&auction=${AUCTION_ID}&bidid=${AUCTON_BID_ID}" |
lurl
|
string | Loss notice URL called by the exchange when a bid is known to have been lost. ${AUCTION_PRICE} macro is supported. | "http://example.com/loss/1378ygfvn928ouyghf19oiuhg03r?final_price=${AUCTION_PRICE}&reason=${AUCTION_LOSS}" |
adm | string | Optional means of conveying ad markup in case the bid wins; supersedes the win notice if markup is included in both. | "AD" |
adomain | string array, required |
Advertiser domain for block list checking. This can be an array of for the case of rotating creatives. Exchanges can mandate that only one domain is allowed. |
["test-domain.com"] |
bundle | string |
Bundle or package name of the app being advertised, if applicable; intended to be a unique ID across exchanges. |
android: "com.test.app" iOS: "8120398" |
iurl | string | URL without cache-busting to an image that is representative of the content of the campaign for ad quality/safety checking. | "http://example.com/i/1378ygfvn928ouyghf19oiuhg03r?won=" |
cid | string | Campaign ID to assist with ad quality checking; the collection of creatives for which iurl should be representative. | "12341" |
crid | string | Creative ID to assist with ad quality checking. | "231" |
cat | string array | IAB content categories of the creative. | ["IAB3-1"] |
attr | integer array | Set of attributes describing the creative. | [1,2,13] |
h | integer | Height of the creative in pixels. | 480 |
w | integer | Width of the creative in pixels. | 320 |
ext | object | Placeholder for bidder-specific extensions to OpenRTB. BidMachine can receive only "imptrackers"here. | |
burl
|
string | Billing notice URL called by the exchange when a winning bid becomes billable (When impressions occures). | "http://example.com/bill_imp/1378ygfvn928ouyghf19oiuhg03r?won=${AUCTION_PRICE}&impid={AUCTION_IMP_ID}&auction=${AUCTION_ID}&bidid=${AUCTON_BID_ID}" |
Updated 12 months ago