Request Extension

The ext contains a number of fields required for trading but which are not in the OpenRTB IAB spec and thus supported as extensions.

Item extension Object Properties
Value Type Description
at string

(Recommended) Passes additional auction types used by some Suppliers which fall outside those covered in the Open RTB specification.

  • 501 rubicon AST, Modified First Price
  • 502 rubicon AST, Modified Second Price
ads_txt object (Recommended) Contains the ads.txt information about the Supplier, see the Ads.txt Object and BidSwitch and Ads.txt sections for more details.
dsp_uuids* object key-value user ID pairs to support direct-like user syncs, see the Supplier First-Party User-Matching section for more details.
google_query_id* string

This represents a unique ID for the overall query. In the event that there are multiple call-outs for a query, all call-out requests for that query will contain the same google_query_id, see more here:

It is highly recommended to include this ID if you are selling Exchange Bidding Dynamic Allocation (EDBA) sourced inventory through BidSwitch to Google DV360.

Ads.txt Object

The ext.ads_txt object will contain the verified details of the Supplier and Publisher trading relationship.

Ads.txt Object Properties
Value Type Description
status int

(Required) Indicates what information the ads.txt file contained regarding this Suppliers selling relationship with the publisher:

  • 1 = direct
  • 2 = reseller
  • 3 = unauthorized
auth_id string Passes the TAG ID if present in the ads.txt file, e.g. "8765jfhfg09j"
pub_id string

(Required) The unmodified publisher ID at that Supplier e.g., "123456789"

Note: In the standard Publisher object, BidSwitch passes the field including the SSP prefix, e.g. aol_123456789, see the Publisher Object for more details.

Table Of Contents