Protocol Release Notes

24 January, 2024

Added support for multiple fields as part of supporting Protected Audience API:

Bid Response Ext Object, new fields added:

  • ext.igbid

  • ext.igbid.id

  • ext.igbid.igbuyer

  • ext.igbid.igbuyer.origin

  • ext.igbid.igbuyer.buyerdata

Impression Object, new field added:

  • imp.ext.ae

8 November, 2023

Added support for the device.ext.cdep field, see the Device Object section for details

13 July, 2023

Added support for the seatbid.bid.lurl field, see the Bid Object section for details

9th June 2023

Added support for the CBD Products BidSwitch category, see the Sensitive Categories and Rich Media section

26 April 2023

Added support for the data.ext.segtax bid request field, see the Ext Object for more details

11th April 2023

Added support for the imp.ext.gpid field, see the Impression Object section for details

15th March 2023

Added support for the imp.ext.skadn.productpage bid request field and:

  • seatbid.bid.ext.skadn.productpageid

  • seatbid.bid.ext.skadn.sourceidentifier

bid response fields, see SkAdNetwork Extension and SkAdNetwork Extension sections for more details

19th July 2022

Added the pmp.deals.ext.deal_type extension to support passing the category of deal from Supplier to Buyer. See the Deal Object for more details.

3rd February 2022

Changes made to how headers are passed on s2s BURL calls, now both the x-forwarded-for and x-user-agent headers are filled when available, see the Server-to-Server (s2s) Calls section for more details.

24th September 2021

Added support for the site|app.ext.inventorypartnerdomain bid request field. This field was added in the (app-)ads.txt v1.0.3 specification update. See the App Object or Site Object section for more details.

18th August 2021

Added support for the optional seatbid.bid.bundle field in bid responses; see Bid Object for details.

31st May 2021

  • user.ext.xuid Removed BidSwitch’s own cross-platform User ID. This earlier field has been superseded by the industry standard Extended Identifiers field that fulfils the same function, see the Extended Identifiers section for more details.

28th May 2021

Support updated for the SKAdNetwork protocol response extension to include the addition of the fidelities object. See the SkAdNetwork Extension section for more details.

  • seatbid.bid.ext.skadn.fidelities

  • seatbid.bid.ext.skadn.fidelities.fidelity

  • seatbid.bid.ext.skadn.fidelities.nonce

  • seatbid.bid.ext.skadn.fidelities.timestamp

  • seatbid.bid.ext.skadn.fidelities.signature

14th April 2021

Added support for passing the Federated Learning of Cohorts (FLOC) ID using the Google format, user.ext.floc, see the User Object section for details.

Note

Due to how the FLoC ID is supported in Prebid, its value may also be passed in the user.ext.eids field with its source specified as chrome.com, see the Extended Identifiers section or details.

30th March 2021

Added support for the following fields:

  • site.ext.amp

  • geo.accuracy

  • geo.metro

25th February 2021

Updated support for the IAB SKAdNetwork Specification, which resulted in the following bid request additions.

  • imp.ext.skadn.versions,see the Impression Ext section for more details

  • imp.ext.skadn.skadnetlist

  • imp.ext.skadn.skadnetlist.max

  • imp.ext.skadn.skadnetlist.excl

  • imp.ext.skadn.skadnetlist.addl

  • device.ext.atts, see the Device Object section for more details

21st December 2020

7th December 2020

  • Added the native.ext.adchoicesurl_required request field to indicate when a Buyer must return an adchoices URL in the response, see the Native Extension Object section for more details.

  • Added the imp.pmp.deals.ext.buyer_wseat field. This specifies the Advertisers/ Agencies that should have access to this deal in the DSP’s system, see the Deal Extension Object section for more details.

  • Added support for the blocked apps bapp field, see the Bid Request v5.3 section for details

12th November 2020

Added fields to complete support for the IAB Tech Lab OTT/CTV Store Assigned App Identification Guidelines and the Guidelines for Identifier for Advertising (IFA) on CTV/OTT platforms

15th September 2020

Added support for the content object, see Content Object. This object can be passed in site.content or app.content

7th September 2020

The release adds support for iOS 14 based on the OpenRTB SKAdNetwork Extension.

Bid Request Fields

  • imp.ext.skadn See the Impression Ext section for more details

  • imp.ext.skadn.version

  • imp.ext.skadn.sourceapp

  • imp.ext.skadn.skadnetids

  • imp.ext.skadn.skadnhsh

  • device.ext.idfv See the Device Object for more details

  • user.ext.impdepth See the User Object for more details

  • user.ext.sessionduration

  • device.ifa Updated validation to support Apple’s deprecation of the IDFA as part of iOS 14, this field should be passed using all zeros, rather than removed or an empty string, as all zeros is the expected format, e.g. "00000000-0000-0000-0000-000000000000"

  • See the In App iOS 14 section for an iOS 14 bid request example

Bid Response Fields

  • seatbid.bid.ext.skadn.version See the Bid Ext Object section for more details.

  • seatbid.bid.ext.skadn.network

  • seatbid.bid.ext.skadn.campaign

  • seatbid.bid.ext.skadn.itunesitem

  • seatbid.bid.ext.skadn.nonce

  • seatbid.bid.ext.skadn.sourceapp

  • seatbid.bid.ext.skadn.timestamp

  • seatbid.bid.ext.skadn.signature

  • See the Response to iOS 14 section for an iOS 14 response example

30th April 2020

  • Added seatbid.bid.ext.data, which can be used to return arbitrary data from Buyers, if the SSP supports this response field.

2nd February 2020

  • Added ext.tgroup, to indicate the targeting group which the request matched, see the BidSwitch Targeting Groups section for more details

5th January 2020

15th November 2019

15th October 2019

Added support for the following fields.

5th September 2020

  • Removed support for device.didmd5 and device.didsha1

16th August 2019

  • Added user.ext.xuid to support Cross-platform User IDs (UUIDs), see the Extended Identifiers section for more details

25th July 2019

  • Added imp.ext.ssai which signals support for stitching an ad into an audio or video stream, see the Impression Ext section for more details.

27th May 2019

  • Added imp.ext.notification_type, see the Impression Ext section for more details.

  • Added ext.google_query_id

v5.3 - November 2017

New Protocol Fields

Bid Request fields:

  • deals.ext.type, see Deal Object

  • regs.ext.us_privacy

  • regs.ext.gdpr, user.ext.consent, user.ext.google_consent and user.ext.consented_providers_settings added to support GDPR compliance, see the BidSwitch and GDPR section for more details

  • imp.native.request.plcmttype, see Native Request Object

  • imp.native.request.privacy

  • imp.native.request.context, see Native Request Object and Context Type Description

  • imp.native.request.contextsubtype, see Native Request Object and Context SubType ID Description

  • imp.native.request.eventtrackers, see Event Tracker Request Object

  • ext.ads_txt added to support BidSwitch and Ads.txt

  • ext.ads_txt.status

  • ext.ads_txt.auth_id

  • ext.ads_txt.pub_id

  • ext.ads_txt.supplier_domain

  • ext.google_query_id

  • ext.rubicon.ast

  • ext.media_src

  • imp.ext.s2s_nurl

  • imp.ext.ssai

  • imp.ext.wpov

  • imp.pmp.deal.ext

  • imp.pmp.deal.ext.data_src

  • imp.video.skipmin

  • imp.video.skipafter

  • imp.video.ext.rewarded

  • imp.ext.notification_type

  • publisher.domain

  • user.ext.digitrust

  • user.ext.xuid

  • source.pchain

  • source.ext.schain

  • source.ext.omidpv

  • source.ext.omidpn

Bid Response fields:

Updated Protocol Fields

  • ext.ssp

Deprecated Protocol Fields

  • ext.s2s_nurl, replaced by imp.ext.s2s_nurl

  • Both the seatbid.bid.ext.native.jstracker and seatbid.bid.ext.native.imptracker fields have been replaced by seatbid.bid.ext.native.eventtrackers

  • device.didmd5 and device.didsha1

Updated or New Sections

v5.2 - February 2017

New Protocol Fields

Bid Request fields:

  • imp.video.placement

  • imp.video.playbackend

  • imp.video.skip

  • device.mccmnc

  • source.fd

  • imp.native.request.assets.video.ext see, Native Request Object

  • imp.native.request.assets.video.ext.playbackmethod

  • imp.native.ext see Native Object

  • imp.native.ext.triplelift

  • imp.native.ext.triplelift.formats

  • imp.metric, see Metric Object

Bid Response fields:

  • seatbid.bid.burl, and see the Using the burl Field section for more details.

  • seatbid.bid.language

  • seatbid.bid.ext.native.jstracker

  • seatbid.bid.ext.native.assets.video.ext, see Native Asset Video Object

  • seatbid.bid.ext.native.assets.video.ext.playbackmethod

Updated Protocol Fields

  • seatbid.bid.nurl

  • ext.s2s_nurl

Deprecated Fields

  • imp.ext.viewability bid request field, replaced by the use of the Metric Object

Recently Added or Updated Sections

v5.1 - October 2016

New Protocol Fields

Added the following bid request fields:

  • ext.dooh

  • video.ext.vast_url_rq

  • user.data.segment.name

  • publisher.cat

Updated Protocol Fields

  • The seatbid.bid.ext.vast_url description, this field can be omitted for some bid requests.

v5.0 - July 2016

New Sections

Updated Sections

  • Updated the seatbid.bid.ext.vast_url description, this field can only be used for video trading.

  • Updated the adm and nurl fields, see the Bid Object section.

  • Updated the Macros section with added win price macro usage options.

  • Updated the nurl Response Difference section with information about how to use the nurl and adm fields correctly.

v4.3 - May 2016

Added

Added the Compatibility and Deprecation and Protocol Version Differences sections to help users keep their BidSwitch integration up to date.

Added the following bid response fields:

  • seatbid.bid.ext.native.ext.viewtracker

  • seatbid.bid.ext.native.ext.adchoiceurl

Added the following bid request fields:

  • imp.audio

  • device.geo.utcoffset

  • video.ext.outstream

  • ext.tv

  • imp.banner.format

Added programmatic TV bid request example.

Updated

  • Updated the badv, site and app field descriptions.

  • Bid response fields seatbid.bid.ext.native.assets.img.h and seatbid.bid.ext.native.assets.img.w are now required.

  • The imp.pmp.private_auction field is now optional.

  • Deprecated the imp.banner.ext.extra_sizes bid request field.

  • The ext.vast_url field now supports DAAST (audio) creatives.

Removed

  • Removed fields and objects deprecated in v4.0 - May 2015.

  • Removed the ext.creative_params and data bid request fields.

v4.2 - March 2016

Added

Added support for the following bid request fields:

  • allimps

  • ext.s2s_nurl

  • imp.exp

  • imp.video.maxextended

  • imp.video.boxingallowed

  • imp.video.playbackmethod

  • imp.video.delivery

  • imp.video.sequence

  • device.w

  • device.h

  • device.lmt

  • device.pxratio

  • site.privacypolicy

  • app.privacypolicy

  • user.yob

  • user.gender

  • user.data

  • user.ext.ug

  • user.ext.cookie_age

Added the following bid response fields:

  • seatbid.bid.crid

  • seatbid.bid.ext.agency_id

Updated

  • BidSwitch now supports Compressed JSON as an alternative bid request and bid response data format.

  • The seatbid.bid.adid bid response field is now optional, and the seatbid.bid.crid field may be used instead of it.

  • Removed fields and objects deprecated in v2.6 - February 2015.

v4.1 - September 2015

Added

Added the following bid request fields:

  • site.ref

  • ext.clktrkrq

  • ext.gumgum.cat

  • imp.tagid

  • imp.native.request.assets.img.mimes

  • user.keywords

  • imp.ext.yieldone.cat

  • imp.bidfloorcur

  • pmp.deal.bidfloorcur

Updated

  • Updated the bid request currency array so that it may contain multiple values.

  • Extended enumeration for the imp.video.ext.player_type bid request field.

  • Updated the imp.video.mimes bid request field description.

  • Updated the seatbid.bid.nurl bid response field description.

  • Changed the accepted seatbid.bid.cat type bid response field to a strings array.

  • Updated the Supplier Click Tracking URL Macro section.

  • Updated the Bid Request JSON Examples section, added new example requests and responses.

Removed

Removed fields and objects deprecated in v2.5 - December 2014.

v4.0 - May 2015

Added

Added the following bid request fields:

  • site.mobile

  • device.geo.type

  • imp.iframebuster

Added the following bid response fields:

  • seatbid.bid.cat

  • seatbid.bid.adm

  • seatbid.bid.ext.native

Updated

  • Updated the imp.banner.btype bid request field description.

  • Updated the seatbid.bid.nurl bid response field description.

  • Updated the Macros section, ${CLICK_URL} is no longer supported.

  • Bid response fields seatbid.seat and seatbid.bid.nurl are now required.

  • Bid response seatbid.bid.iurl field is now required for banner ads.

Removed

  • Removed fields and objects deprecated in v2.4 - October 2014.

  • Removed the Creative approval and Additional Features sections.

  • Deprecated site.ext.mobile_site and ext.ghostery bid request fields.

  • Deprecated seatbid.bid.ext.cat bid response field.

Removed the following bid response fields. See this Protocol Version Differences section for more details about how this affects the different major versions.

  • seatbid.bid.ext.js_url

  • seatbid.bid.ext.img_url

  • seatbid.bid.ext.click_url

v2.6 - February 2015

Added

Added the following bid request fields:

  • imp.secure

  • imp.banner.ext.extra_sizes

  • imp.ext.viewability

Added the following bid response fields:

  • seatbid.bid.ext.lpdomain

  • seatbid.bid.h

  • seatbid.bid.w

  • seatbid.bid.iurl bid

Deprecated

  • Deprecated the ext.is_secure bid request field. The new imp.secure field replaces this, see the Impression Object section for more details.

General

  • Removed creative preview section.

  • Removed fields and objects deprecated in v2.3 - September 2014.

  • Updated request and response samples.

v2.5 - December 2014

Added

Added the following bid request fields:

  • imp.video.ext.player_type

  • imp.ext.yieldone.allowed_creative_category_id

Added the following bid response fields:

  • seatbid.bid.ext.yieldone.creative_category_id

  • ext.protocol

  • seatbid.bid.attr

  • seatbid.bid.dealid

Updated

  • Click tracking macro is now required in OpenX bids.

  • The field imp.pmp.deal.at is now optional.

Removed

  • Removed fields and objects deprecated in v2.2 - June 2014.

  • Deprecated the seatbid.bid.ext.deal bid response field.

v2.4 - October 2014

Added

Added the following bid request fields:

  • tmax

  • app.paid

  • regs.coppa

  • device.dnt

  • device.ipv6

  • device.js

  • device.flashver

  • device.devicetype

  • site.name

  • imp.instl

  • imp.displaymanagerapp

  • imp.displaymanagerver

  • imp.ext.yieldone.allowed_creative_types

  • imp.video.pos

  • imp.ext.inventory_class

Added the following bid response field:

  • seatbid.bit.ext.yieldone.creative_type

Updated

Changed the imp.pmp.deals.at values to comply with OpenRTB 2.2.

Removed

Deprecated the imp.ext.yieldone.inventory_class bid request field.

v2.3 - September 2014

Added

Added the following bid requests fields:

  • site.ext.mobile_site

  • imp.banner.mimes

Added the following bid request objects:

  • imp.ext.yieldone

  • imp.pmp

  • ext.creative_params

Added the following bid response fields:

  • seatbid.bid.ext.duration

  • seatbid.bid.ext.img_url

  • seatbid.bid.ext.click_url

Updated

  • Updated the Buyer User Matching section.

  • The field imp.video.linearity is now an optional field.

  • Updated the btype field description.

    Important

    Usage of nurl, ext.js_url or ext.liveintent.img_url bid response fields depends on the btype bid request field value.

Removed

  • Deprecated seatbid.bid.ext.liveintent and pmp objects.

v2.2 - June 2014

Added

  • Added the following bid request fields:

    • imp.video.protocols

    • imp.banner.api

    • site.publisher.name

    • app.publisher.name

    • app.name

    • video.companionad.id

    • device.os

    • device.osv

    • device.make

    • device.model

  • Added extended sensitive categories, used in bcat field.

  • Added imp.ext.google and ext.ghostery bid request objects.

Removed

  • Deprecated the following bid request fields:

    • imp.video.protocol

    • ext.google.excluded_attribute

    • ext.google.allowed_vendor_type

v2.1 - April 2014

Added

  • Added seatbid.bid.ext.js_url bid response field.

  • Added the following bid request fields:

    • pmp.deals.wseat

    • imp.banner.expdir

    • at

Updated

  • Bid response seatbid.bid.nurl field is optional now.

v2.0 - February 2014

Added

  • Added application traffic support.

  • Added the following bid request fields:

    • ext.google.excluded_attribute

    • ext.google.allowed_vendor_type

  • Added the following bid response fields:

    • seatbid.bid.ext.google

    • Added seatbid.bid.cid

Updated

  • Bid request site object is optional now.