Ext Object

Note

Fields marked with asterisk (*) are optional.

Ext Object Properties

Value

Type

Description

dsp_uuids*

object

key-value user ID pairs for partners that have a direct cookie sync with Buyers. Contact your account manager to request activation.

This field doesn’t override the BidSwitch cookie sync — it works as an addition. That is, when BidSwitch doesn’t have a Buyer cookie or buyeruid is not set, this field is used for Buyer buyeruid. In all other cases, it’s ignored.

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: https://developers.google.com/authorized-buyers/rtb/openrtb-guide#bidrequestext

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

google_audiences*

string

Passes the case-sensitive value of "Collectable" when the request is eligible to be collected for processing as part of Google Affinity Audiences. This field is only relevant to DV360. If you need more details, contact your Account manager. If an empty string or another different/incorrect value is present, the request will not be considered eligible for Google Affinity Audiences:

{
  "ext":{
    "google_audiences":"Collectable"
  }
}

purch*

integer

The Purchased Traffic parameter is the traffic that is redirected from properties other than owned, acquired, or otherwise incentivized activity. The following values are supported:

  • 0 (default): unknown (will show as undefined in buyer reporting)

  • 1: purchased

  • 2: non purchased (organic)

Note: this field is Google DV360 specific, refer to Google documentation for details

ads_txt*

object

Contains the ads.txt information about the Supplier, see the ads.txt Object and BidSwitch and Ads.txt sections for more details.

 
{
  "ext":{
    "dsp_uuids":{
      "dsp1_id":"dsp1_uuid",
      "dsp1_id":"dsp2_uuid"
    }
  }
}

ads.txt Object

Ads.txt Object Properties

Value

Type

Description

status

int

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

  • 1 = direct

  • 2 = reseller

  • 3 = unauthorized

pub_id

string

Exchange-specific publisher ID, e.g “abc-123”. Note: Do not use any of the following symbols in the publisher ID, as doing so may cause issues:

, # % $ @ * & ? ! ` ~ " ' / \ | ( ) { } [ ]+ = ^

auth_id*

string

Passes the TAG ID if present in the ads.txt file, e.g. 8765jfhfg09j

supplier_domain*

string

Passes the Supplier’s domain listed in the publisher’s ads.txt file, e.g. "openx.com"