Bid Request

This is the top level object that is sent to the Buyer. Each bid request sent from Metax to a Buyer will contain the following fields.

Note

Fields marked with asterisk (*) are optional.

Parameter	Type	Description
id	string	Unique ID of the bid request, provided by Metax, for example, “b5ba5ed2-547e-4e86-8a84-34a440dad6db”
imp	array of objects	Array of objects representing the impressions offered, for more information, see the Impression Object section.
device	object	Device object with details about the device to which the impression will be delivered, for more information, see the Device Object section.
user	object	User Object which describes the user, for more information, see the User Object section.
tmax	integer	Maximum time in milliseconds the exchange allows for bids to be received to avoid timeout, including internet latency.
cur	array of strings	Array of allowed currencies for bids on this bid request using ISO-4217 alpha codes, for example, [“USD”, “EUR”].
wlang*	array of strings	Allowed list of languages for creatives using ISO-639-1-alpha-2. Omission implies no specific restrictions. Only one of wlang or wlangb should be present.
wlangb*	array of strings	Allowed list of languages for creatives using IETF BCP 47I. Omission implies no specific restrictions. Only one of wlang or wlangb should be present.
source*	object	Indicates the entity responsible for the final impression sale decision, see the Source Object.
site*	object	The Site Object describing the site. One of these objects should be present in the request: site, app.
app*	object	The App Object describing the mobile application. One of these objects should be present in the request: site, app.
bcat*	array of strings	Blocked Advertiser Categories, using the IAB taxonomy, and extended with additional sensitive categories listed in the Sensitive Categories and Rich Media section.
badv*	array of strings	Array of strings of blocked top-level domains of advertisers, for example, [“mysite.com”, “mysite2.com”].
bapp*	array of strings	A list of applications blocked from being advertised, specified using their their platform-specific identifiers, i.e. the app bundle ID. On Android, these should be app bundle and on iOS numeric IDs e.g. [“com.app.example”, “012987652”].
wseat*	array of strings	An array of Buyer seats allowed to bid on this auction, for example [“58”, “61”, “99”]. The bid response should contain the appropriate seat value corresponding to one of the values of the wseat field, for more details see the Seat Bid Object section.
bseat*	array of strings	An array of Buyer seats disallowed to bid on this auction, for example [“58”, “61”, “99”].
allimps*	integer	A flag to indicate if the Supplier can verify that the impressions offered represent all of the impressions available in context (e.g., all on the web page, all video spots such as pre/mid/post roll) to support road-blocking.
regs*	object	A regulations object that specifies any industry, legal, or governmental regulations in force for this request, for more information, see the Regs Object section.