Server Based Global Default Request (PBS-Go only)

This allows a defaut stored request to be defined that allows the server to set up some defaults for all incoming requests. A request specified stored request will override these defaults, and of course any options specified directly in the stored request override both. The default stored request is only read on server startup, it is meant as an installation static default rather than a dynamic tuning option.

A common use case is to “hard code” aliases into the server. This saves having to specify them on all incoming requests, and/or on all stored requests. To help support automation and alias discovery we can flag that any aliases found in the file be added to the bidder info endpoints.

Config Options

Three config options are exposed to support this feature.

default_request:
    type: "file"
    file:
        name : /path/to/aliases.json
    alias_info     : false

The filename option is the path/filename of a JSON file containing the default stored request JSON as documented in the openrtb2 docs and stored request docs

{
    "tmax": "<auction_timeouts_ms.default>",
    "regs": {
        "ext": {
            "gdpr": 1
        }
    },
    "ext": {
        "prebid": {
            "aliases": {
                "districtm": "appnexus"
            }
        }
    }
}

This will be JSON merged into the incoming requests at the top level. These will be used as fallbacks which can be overridden by both Stored Requests and the incoming HTTP request payload.

The info option determines if the alised bidders will be exposed on the /info endpoints. If true the alias name will be added to the list returned by /info/bidders and the info JSON for the core bidder will be coppied into /info/bidder/{biddername} with the addition of the field "alias_of": "{coreBidder}" to indicate that it is an aliases, and of which core bidder. Turning the info support on may be useful for hosts that want to support automation around the /info endpoints that will include the predefined aliases. This config option may be deprecated in a future version to promote a consistency in the endpoint functionality, depending on the perceived need for the option.