Unity Exchange

Unity Exchange is Unity's programmatic exchange for in-app inventory. DSPs receive its bid requests and bid in a first-price auction.

Direction and version

Unity Exchange sends bid requests to DSP bidders over HTTPS, and bidders return bid responses to Unity.

Unity's pages mix OpenRTB 2.6 integration guidance with OpenRTB 2.5 field descriptions. Flags are 0 or 1 integers, and Native is not documented.

The RTBlint profile unity checks requests and responses against the published contract.

Each request carries exactly one impression whose imp.id is the string "1". at is 1 (first price) and imp.secure is 1.
Video requests use minduration 5, maxduration 30, pos 7, and placement 1 or 5. Banner-only impressions set instl to 0, and video impressions set it to 1.
Responses need cur, seatbid.seat, adm, cat, and bid.ext.crtype. The creative type is a case-insensitive name such as VAST 3.0, MRAID 2.0, BANNER, or HTML.
price must be above zero with at most three decimal places.
adomain holds exactly one root domain with no protocol, path, or www prefix. Other subdomains are allowed.
Tracking needs burl, or nurl together with bid.ext.imptrackers. Unity returns loss code 1011 when both are missing.
App ads need bid.bundle and bid.ext.storeurl, and banner bids need w and h.
A dealid must match a deal offered on the impression.
SKAdNetwork responses must match the impression's sourceapp and one of its skadnetids, and bid.ext.skadn.itunesitem must match bid.bundle. Versions 2 and 3 use campaign strings from 1 to 100, and version 4 uses a four-digit sourceidentifier.
Unity publishes its own loss codes from 1000 upward in ${AUCTION_LOSS}, such as 1004 for a missing crtype.

Path	Meaning
`imp.ext.skadn`	SKAdNetwork data, sent only when the DSP's network ID is in the app's list.
`imp.ext.skadn.skoverlay`	Whether SKOverlay is allowed.
`imp.ext.skadn.productpage`	Whether custom product pages are allowed.
`imp.ext.skadn.ext.ask`	Whether Auto StoreKit is allowed.
`source.ext.omidpn`	Open Measurement partner name, Unity3d.
`source.ext.header_bidding`	1 for bidding traffic, 0 for waterfall.
`device.ext.ifv`	iOS identifier for vendors.
`device.ext.atts`	App Tracking Transparency status, 0 to 3.
`bid.ext.crtype`	Required creative type of the markup.
`bid.ext.storeurl`	App store URL of the advertised app.
`bid.ext.imptrackers`	Impression tracker URLs.
`bid.ext.skadn`	SKAdNetwork response, including SKOverlay settings and the product page ID.

openrtb.profile.unity.advertiser_domain Unity accepts exactly one advertiser domain.
openrtb.profile.unity.creative_type Unity ext.crtype must be a documented creative type (case-insensitive).
openrtb.profile.unity.deal_not_offered Unity response dealid must match a deal ID offered by the referenced impression.
openrtb.profile.unity.impression_count Unity emits exactly one impression per request.
openrtb.profile.unity.impression_id Unity's sole impression has the string id 1.
openrtb.profile.unity.price_invalid Unity bid price must be greater than zero.
openrtb.profile.unity.price_precision Unity accepts at most three decimal places in bid price.
openrtb.profile.unity.skadn_campaign Unity SKAdNetwork 2.x and 3.x campaign is an integer string from 1 through 100.
openrtb.profile.unity.skadn_mismatch Unity SKAdNetwork sourceapp must identify the publisher app.bundle.
openrtb.profile.unity.skadn_sourceidentifier Unity SKAdNetwork sourceidentifier is a four-digit string.
openrtb.profile.unity.skadn_timestamp Unity SKAdNetwork timestamp must be a Unix-milliseconds integer string.
openrtb.profile.unity.type_invalid Unity SKAdNetwork fidelities entries must be objects.
openrtb.profile.unity.value_invalid Unity video placement is 1 or 5.

rtblint validate --profile unity request.json