SKOverlay

Digital Turbine supports Apple’s SKOverlay class to allow DSPs to drive increased app installs and give a native user experience to their iOS 14+ audience.

The adoption of SKOverlay allows our buy-side partners to maximize creative optimization, by adding a high engagement feature to their ads. We are dedicated to ensuring SKOverlay is adopted in an efficient and optimal manner for real-time bidding.

Bid Request

Unless requested otherwise, DT includes a new SKOverlay attribute in the BidRequest.imp.ext.skadn object in the bid request, that provides the relevant fields which are used to control the SKOverlay. The attribute is only present if both the DT SDK version and the OS version (iOS 14 and above) support SKOverlay.

BidRequest.imp.ext.skadn

Attribute Description Type Example
version Version of SKAdNetwork supported. Always "2.0" or higher. Dependent on both the OS version and the SDK version. String "version":"2.0"
sourceapp ID of publisher app in Apple’s App Store. Should match BidRequest.app.bundle String "sourceapp":"880047117"
skadnetids A subset of SKAdNetworkIdentifier entries in the publisher app’s info.plist that are relevant to the DSP. String Array ["SKAdNetwork1.skadnetwork"," SKAdNetwork2.skadnetwork"]
skoverlay List of attributes that should be provided on the bid response Array "skoverlay":["dismissible","delay","present,
"pos","endcard","autoclose"]

Bid Response

If the bid request includes the BidRequest.imp.ext.skadn.skoverlay array, then a DSP is able to pass all of the following parameters using the below object on their bid response. If the object is present in the response, then DT will show the SKOverlay on the ad while following the guidelines set in the response. 

BidResponse.seatbid.bid.ext.skadn.skoverlay

Attribute

Description

Type

Example

dismissible

Should overlay be dismissable by the user or not

boolean

“dismissible”:0

delay

Delay in seconds before showing the overlay (0-60)

int

“delay”:5

present

Present the overlay or not

boolean

“present”:1

pos

Position of the overlay;
0 = bottom, 1 = bottom raised

boolean

“pos”:0

endcard

Show overlay on the endcard or not

boolean

“endcard”:1

autoclose

Time in seconds to automatically dismiss the overlay (0-60)

int

“autoclose”:0

ext

Placeholder for exchange-specific extensions to OpenRTB.

object

“ext”:{}

FAQ

Will Digital Turbine pass the new BidRequest.imp.ext.skadn.skoverlay array when the supply doesn’t support it?

No, this array will only be sent when supported.

In what cases is the BidRequest.imp.ext.skadn.skoverlay array sent?

BidRequest.imp.ext.skadn.skoverlay will only be sent for iOS 14+ inventory using DT Exchange SDK 8.1.9+.

How will Digital Turbine determine which app to show on the overlay?

Using the value we get on BidResponse.seatbid.bid.ext.skadn.itunesitem.

Back to Top ⇧