Source Object

This object carries data about the source of the transaction including the unique ID of the transaction itself, source authentication information, and the chain of custody.

Source Object Properties
Value Type Description
fd integer

Indicates the entity responsible for the final impression sale decision, using the following values:

  • 0 = The exchange behind BidSwitch
  • 1 = An upstream source (usually header bidder)

For example a bid request containing ext.ssp='rubicon' and source.fd=0 implies that the auction is run at Rubicon SSP. If the same request has source.fd=1 then the auction is run at a header bidder upstream from Rubicon SSP.

Note: The BidSwitch platform never acts as the decision maker.

tid string (Recommended) Transaction ID that must be common across all participants throughout the entire supply chain of this transaction. This also applies across all participating exchanges in a header bidding or similar publisher-centric broadcast scenario.
ts int (Recommended) Timestamp when the request originated at the beginning of the supply chain in Unix format (i.e., milliseconds since the epoch). This value must be held as immutable throughout subsequent intermediaries.
ds string (Recommended) Digital signature used to authenticate the origin of this request computed by the publisher or its trusted agent from a digest string composed of a set of immutable attributes found in the bid request.
cert string (Recommended) public key to sign the request, should be similar to ads.txt file: example.com/ads-cert.txt
pchain string Payment ID chain string containing embedded syntax described in the TAG Payment ID Protocol v1.0.

Source Object Example

{
    "source":{
        "tid":"FEDCBA9876543210",
        "ts":1541796182157,
        "ds":"AE23865DF890100BECCD76579DD4769DBBA9812CEE8ED90BF",
        "fd":0
    }
}