Bid Object¶
Each seatbid.bid
bid object relates to an item.id
. Multiple bids can relate to
the same item.
Value |
Type |
Description |
---|---|---|
id |
string |
A bidder generated ID for the bid object, used for tracking and debugging
purposes, for example |
item |
string |
(Required) The ID of the request item object, |
deal |
string |
Reference to the If responding to an open or private deal, it is strongly recommended to always
reply with the matching request |
price |
float |
(Required) The bid price as a float value, expressed as CPM. All prices
assumed to be in USD if the |
cid* |
string |
Campaign ID or similar that is used by the Buyer to track and organize their
campaigns, for example, |
burl |
string |
(Required) Specifies the billing notice URL called by BidSwitch using a server-to-server call when BidSwitch records a billable impression, e.g.
|
mid |
string |
ID to enable media to be specified by reference if previously uploaded to the exchange rather than including it by value in the domain objects. |
macro |
array of objects |
An array of macro objects that enable bid specific values to be substituted
into markup; especially useful for previously uploaded media referenced using
the |
media |
objects |
Used to hold the |
ext* |
object |
This field may be required under certain circumstances, see Bid Extension. |
Bid Extension¶
Value |
Type |
Description |
---|---|---|
at1* |
int |
Indicates that the Buyer wishes their bid to be used in the Supplier 1st price auction before being passed to any upstream auction e.g. header bidding. This field currently only takes the following value:
|
asid* |
string |
Required only for Microad premium inventor responses. If you are
using a 3rd party ad server you must specify which one, for example,
|
country* |
string |
Required only for Microad premium inventory responses and uses
ISO 3166-1 Alpha-3 country codes, for example |
advertiser_name* |
string |
The name of the advertiser serving the creative, for example,
|
agency_name* |
string |
The name of the agency representing the advertiser, for example,
REQUIRED in bids responses to Ströer (AdScale) bids. |
agency_id* |
string |
ID of the agency representing the advertiser, for example, |
google* |
object |
Contains additional information for Google bids. This field is recommended. See the Supplier Specific Fields section for more details. |
Required per Supplier¶
Supplier |
Required field(s) |
---|---|
BrightRoll Video (brx) |
|
BrightRoll SSP (rmx) |
|
Centro |
|
MicroAd (For Premium Inventory) |
|
Millennial Media (nexage) |
|
MoPub |
|
Rubicon |
|
Smaato |
|
Ströer (adscale) |
|
YieldOne |
|