This implementation supports both the regular OpenRTB 2.5 implementation and the Prebid Server implementation. In order to use the Prebid Server implementation, the campaign needs to be created with the Prebid Server template.
The Prebid Server implementation has an ext.prebid.storedrequest field where the id of the StoredRequest is provided. An example can be found in the specs below.
We have added additional fields regarding privacy, regs.ext.gdpr and user.ext.consent , which are compliant with the IAB privacy specifications (in the Advised Extensions section). There is more information about this here.
Bid Request Headers
OpenRTB Version HTTP Header: x-openrtb-version: 2.5
Keep-Alive HTTP Header: Connection: Keep-Alive
Content JSON: Content-Type: application/json
Data Encoding Header: Accept-Encoding
Bid Request 2.5
When requesting bids for a specific context, the platform will perform an HTTP request with a timeout of 300ms and send the following object encoded as JSON in the request body. HTTP is recommended due to extra latency when using HTTPS.
Unique bid request ID (string)
Details via a Site object about the publisher’s website(object).
Details via a Device object about the user’s device to which the impression will be delivered(object).
Details via a User object about the human user of the device; the advertising audience(object).
Placeholder for extensions to OpenRTB.
Unique Site ID (string)
Domain name of the site (string)
IAB category ID (string array)
Full URL of the page where the ad will be shown (string)
Keywords can be used to ensure ad zones get the right type of advertising. Keywords should be a string of comma-separated words
Placeholder for exchange-specific extensions
Custom Paradox category ID (integer)
Custom Paradox Ad Zone ID (integer)
Matching keyword if any (string)
Browser user agent (string)
Location of the device assumed to be the user’s current location defined by a Geo object.
IP address of the user (string)*
IPv6 address of the user (string)*
Browser language (string)
Operating System (string)
Placeholder for exchange-specific extensions to OpenRTB
Main IP address of the user (string)
X-FORWARDED-FOR IP address of the user or empty if not set (string)
Unique user ID (string)
user.ext.consent: This is the consent string required by the IAB standards. Negative consent only for now (string)
Prebid Server specific data (object)
List of buyer uids (array)
Used for stored request matching on partners servers format: sr_odadsrv_ (string)
regs.ext.gdpr: This is 0 if the caller believes that the user is not under GDPR, and 1 if the user is under GDPR. If neither, this parameter will be undefined.