Bid Request Object
Triplelift supported objects in the bid request
The body of Triplelift request/responses follows the standard IAB's OpenRTB 2.x specification. For more information on the OpenRTB 2.x syntax, please refer to the following specification:
Any elements of the syntax that may be unique to Triplelift however will be documented below.
BidRequest Object
The following object is the top-level or root object of the bid request that s2s supply partners are expected to send to the Triplelift Exchange. This table summarizes all of the objects within the BidRequest object and also highlights the objects that Triplelift requires:
| Object Name | Triplelift Required | Type | Description |
|---|---|---|---|
| id | yes | string | The unique ID of the respective auction. |
| imp | yes | array | An array of impression objects. At least 1 impression object is required. |
| site | no (recommended) | object | Provides details about the publisher's web page. Only applicable for websites. |
| app | no (recommended) | object | Provides details about the publisher's app. Only applicable for non-browser applications. |
| device | no (recommended) | object | Provides details about the user's device to which the impression will be delivered. |
| user | no (recommended) | object | Provides details about the human user of the device. |
| test | no | integer | Defaults to 0. Used when testing (test = 1). |
| at | no | integer | Auction type. First price auction, second price auction, etc. |
| tmax | no | integer | Maximum time in milliseconds that the exchange allows for bids to be received to avoid timing out. |
| wseat | no | array of strings | An allowlist of buyer seats that are permitted to bid on the respective impression. |
| bseat | no | array of strings | A blocklist of buyer seats that are NOT permitted to bid on the respective impression. |
| allimps | no | integer | A flag that indicates whether or not the impressions present in the request are representative of all available impressions in the given context. Defaults to 0. |
| cur | no | array of strings | An array of allowed currencies for bids on this respective request; following ISO-4217 alpha codes. |
| wlang | no | array of strings | An allowlist of languages for creatives; following ISO-639-1-alpha-2. Omission implies NO restrictions. |
| bcat | no | array of strings | A list of blocked advertiser categories; following the IAB's content category definitions. |
| badv | no | array of strings | A list of blocked advertisers by their domain. |
| bapp | no | array of strings | A list of blocked applications by their platform-specific exchange-independent application identifiers. |
| source | no | object | Provides data about the inventory source and which entity makes the final decision. |
| regs | no | object | Specifies any industry, legal, or governmental regulations on the respective inventory. |
| ext | no | object | Any exchange-specific extensions to OpenRTB. |
Updated 3 months ago