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
    }
}