BidSwitch and Ads.txt¶
BidSwitch is a technology and infrastructure provider within the Ad Tech space, enabling
integrations between Suppliers and Buyers. As it is not a Supplier, it will never appear in
an ads.txt
file as an approved seller of inventory. BidSwitch supports Ads.txt
through a mapping file enabling the conversion of Supplier names from BidSwitch-specific
names to those listed in Ads.txt files.
For any Buyer seeking to leverage Ads.txt, the process would be very similar to a direct connection, except with the additional step of converting the name using the mapping document prior to validation. This mapping can be found in the following formats. You can also read more in the Ads.txt API section.
Type |
URL |
---|---|
JSON |
|
CSV |
Valid and Invalid SSP Domains
In addition to these mapping files, BidSwitch also provides two lists of domains that its Ads.txt crawler encounters daily. In doing so, it also validates whether each Supplier domain in a publishers Ads.txt file exists, or if the domain is invalid.
Type |
URL |
---|---|
JSON |
|
CSV |
Type |
URL |
---|---|
JSON |
|
CSV |
Publisher Enforcement
Publisher can also ensure BidSwitch only accepts Supplier requests that comply with their ads.txt file. The list of publishers who have requested this is available at from the following URLs.
Type |
URL |
---|---|
JSON |
|
CSV |
Note
The information above was previously available from these files, but they are not as up-to-date as querying the endpoint. If you are using the below files please update your integration to the above resources:
Ads.txt Targeting¶
Buyers can configure their BidSwitch integration to only pass bid requests with
authorised ads.txt traffic. This setting allows Buyers to receive bid
requests only from Suppliers authorised by publishers in the site ads.txt
file.
To enable this feature, contact support@bidswitch.com
You can check if this is enabled or disabled on the myBidSwitch UI Settings page
Note
This targeting will not filter out Private Deal bid requests
Bid Request Ads.txt Fields¶
Bid Requests from BidSwitch contain the data related to the ads.txt
status of
the publisher. Buyers can now use this information in their bidding logic
without the need to crawl ads.txt
files themselves.
BidSwitch collects data from the
ads.txt
filesUpon receiving the Supplier Bid Request, BidSwitch will check if that Supplier and Publisher are allowed to sell inventory from the specific site
This information will be provided to Buyers in Bid Requests, see the ads.txt Object section for more details
Note
Some Buyers are not buying any inventory that fails ads.txt authorisation and this applies to both open deals and private deals. This may be the cause of some questions when looking at a Deal’s performance in Deals Insights reporting, see the Deals Insights FAQ section for more details.
Value |
Type |
Description |
---|---|---|
status |
int |
Indicates what information the Ads.txt file contained regarding this Suppliers selling relationship with the publisher
|
auth_id* |
string |
Passes the TAG ID if present in the |
pub_id |
string |
The unmodified Note: In the standard Publisher object BidSwitch passes the
|
supplier_domain* |
string |
Passes the Supplier’s domain listed in the publisher’s ads.txt file, e.g.
|
{
"site":{
"domain":"dailymail.co.uk",
"publisher":{
"id":"openx_537120563"
}
},
"ext":{
"ssp":"openx",
"media_src":"openx",
"ads_txt":{
"status":2,
"auth_id":"1kjhwk98691",
"pub_id":"537120563",
"supplier_domain":"openx.com"
}
}
}