BidSwitch supplier 1.1

BidSwitch's supplier protocol is the contract a supply partner follows to send inventory to BidSwitch, run by BidSwitch GmbH. Version 1.1 is separate from the buyer protocol and has its own required fields and Native form.

Direction and version

Suppliers send bid requests to BidSwitch, and BidSwitch returns bid responses to the supplier.

Supplier protocol 1.1, listed under BidSwitch's OpenRTB 2.6 section, while 1.0 sits under 2.5. Flags are 0 or 1 integers, Native requests are objects in imp.native.request_native, and Native responses are objects in bid.adm_native.

The RTBlint profile bidswitch-supplier checks requests and responses against the published contract.

Rules beyond the OpenRTB spec

Only id, imp, and device are required at the top level. Unlike the buyer protocol, user, tmax, cur, and ext are optional.
Each impression offers banner, video, audio, or native. A request has site or app, and a DOOH request carries neither.
The supplier table requires device geo.
Supplier Native requests must use Native version 1.2.
at defaults to 2 and cur defaults to USD. When wseat and bseat both list a seat, wseat takes precedence.
Each returned bid carries burl, adomain, and crid, plus adm for banner, video, and audio or adm_native for native.
burl should carry ${AUCTION_PRICE}. Creative markup may contain the supplier click tracking macro at most once.
Where a supplier accepts a single advertiser domain, BidSwitch forwards only the first adomain entry.

Documented extensions

Path	Meaning
`bid.ext.advertiser_name`	Name of the advertiser.
`bid.ext.agency_name`	Name of the agency; `bid.ext.agency_id` carries its ID.
`bid.ext.third_party_buyer_token`	Google buyer token that must be passed through unchanged.
`bid.ext.data`	Name and value pairs from the buyer.
`bid.ext.skadn`	SKAdNetwork response, version 2.0 or later; from 2.2 the signature fields sit in `fidelities`.
`bid.ext.skadn.sourceidentifier`	Four-digit source identifier for SKAdNetwork 4.0 and later.
`bid.ext.dsa`	DSA transparency for the bid.
`bid.ext.autostore`	Video Auto Store settings: `present`, `click`, and `show_on_skip`.

What the validator checks for this profile

openrtb.profile.bidswitch.click_macro Creative markup may contain the supplier click tracking macro at most once.
openrtb.profile.bidswitch.native_version Supplier native markup requires version 1.2.

Validate against this contract

Open the tester with the BidSwitch supplier 1.1 profile, or run:

rtblint validate --profile bidswitch-supplier request.json