Compatibility and support

Here you will find information about Smart Display SDK features, compatibility and technology support.

Supported platforms
Features
Creative support
MRAID support
Open Measurement SDK support
Outstream video support

Features
Supported VAST 4.x macros

Supported platforms

Smart Display SDK is supported on the following platforms.

Plaform	Version
iOS	iOS 12.0+
Android	Android 4.4+ (API level 19)

Features

Here is the list of supported features.

Feature	Supported	Additional Information
Rich Media
MRAID 2.0 support		See Compatibility page in MRAID support section
MRAID 3.0 support
MRAID Custom APIs
Outstream Video
Direct media file (mp4, webm, ...)
Prefetching video ad		The video asset is partially preloaded to guarantee that it can be played on the device
Video events tracking
`<ViewableImpression>` (Starting with VAST 4)
VAST / VPAID support		See Compatibility page in Outstream Video features section.
Video 360°
Video Go-to-vertical
Mediation
Open mediation as primary SDK		See Integrate Adapters page to have an easy mediation integration.
Mediation as secondary SDK
In-App Bidding
Open In-App Bidding		See In-app Bidding page.
Exclusive Smart Formats
Parallax		See Parallax page.
Targeting
Custom keywords
User location		Automatic use of user location if permission is granted to the application and if automatic location is manually enabled on the `SASConfiguration` object.
Custom User Identifier
User Privacy
Do not track compliant
GDPR & CCPA compliant		See Privacy laws compliancy page.
Clickthrough
Deep linking
In-app App Store link
Viewability
Smart Viewability Tracking (MRC compliant)
IAB Open Measurement SDK support		See Viewability page.

Creative support

Here is the list of supported creative files per placement type.

Creative Type	Placement Type
	Banner		Interstitial	Rewarded Video		Native
Image ⁽¹⁾	Standard	Parallax		Video	EndCard (optional)
JPEG
PNG
GIF
Rich Media
HTML5
MRAID ⁽²⁾		⁽³⁾
Media Files ⁽⁴⁾
MP4		⁽⁵⁾				⁽⁷⁾
WebM ⁽⁶⁾		⁽⁵⁾				⁽⁷⁾
HLS		⁽⁵⁾				⁽⁷⁾
VPAID ⁽⁸⁾						⁽⁷⁾

(1) Image rendering is made through a webview and HTML template except for Parallax (native platform component)
(2) Check MRAID support section for more info
(3) Limited MRAID support for Parallax: getState and isViewable for methods and ready, stateChange, viewableChange for events
(4) Video rendering uses native platfom component, except for VPAID (Video HTML5 tag)
(5) Native video rendering is not supported in Parallax but you can still rely on Video HTML5 tag
(6) Only on Android platform
(7) SASNativeAdMediaView should be integrated in your app, check Native Ads integration guide (iOS, Android) for more info
(8) Check Video features section for more info

MRAID support

Smart Display SDK supports MRAID 2.0

Here is the list of supported features from the IAB MRAID common API.

Feature	Supported	Additional Information
IAB MRAID Method
addEventListener
createCalendarEvent		Deprecated since SDK 6.5.
close
expand
getCurrentPosition
getDefaultPosition
getExpandProperties
getMaxSize
getPlacementType
getResizeProperties
getScreenSize
getState
getVersion
isViewable		See `viewableChange` event for more details about how Smart Display SDK handles the viewable value.
open
playVideo
removeEventListener
resize		Please note: resized ads do not follow the original banner frame, meaning that if a banner is placed in a scrolling view, the resized ad does not scroll with the banner.
setExpandProperties
setResizeProperties
storePicture		This method has never been available.
supports		Method `storePicture` has never been available, `mraid.supports("storePicture")` always returns `false`. Starting with SDK 6.5, `mraid.supports("calendar")` always returns `false`.
useCustomClose		Not supported since version 7.24.0
IAB MRAID Event
error
ready		For the Interstitial, this event is only fired when it's shown.
sizeChange
stateChange
viewableChange		Smart Display SDK handles `viewableChange` event in those cases: Banner is present or not in the view hierarchy and visible Banner integrated in a scrollview Keyboard presence on top of a Banner Interstitial is shown App background / foreground states
Custom MRAID Method
sasSendMessage		Send a message (string) to the app, see Messaging documentation in Custom MRAID API section.
Custom MRAID Event
sasReceiveMessage		Receive a message (string) from the app, see Messaging documentation in Custom MRAID API section.

Open Measurement SDK support

The Smart Display SDK 7.25 embeds the IAB Open Measurement SDK with OMID API version 1.4.12
It therefore supports Open Measurement third-party verification tags included in your ads.

Here is the list of supported formats.

Placement Type	Creative Type			Additional Information
Banner	Standard	HTML5
	Standard	MRAID
	Video	HTML5 Video
		VPAID 2.0	VAST 3.0	Through VAST 3.0 extensions*
		VPAID 2.0	VAST 4.2	Through VAST 4.1 `<AdVerifications>` tag, VAST 3.0 extensions* only as a fallback
		Native (Standard/360°)	Uploaded media file
			VAST 3.0	Through VAST 3.0 extensions*
			VAST 4.2	Through VAST 4.1 `<AdVerifications>` tag, VAST 3.0 extensions* only as a fallback
	Parallax			Due to the specificities of the Parallax format, the IAB Open Measurement SDK v1 cannot be applied.
Interstitial	Standard	HTML5
	Standard	MRAID
	Video	HTML5 Video
		VPAID 2.0	VAST 3.0	Through VAST 3.0 extensions*
		VPAID 2.0	VAST 4.2	Through VAST 4.1 `<AdVerifications>` tag, VAST 3.0 extensions* only as a fallback
		Native (Standard/360°)	Uploaded media file
			VAST 3.0	Through VAST 3.0 extensions*
			VAST 4.2	Through VAST 4.1 `<AdVerifications>` tag, VAST 3.0 extensions* only as a fallback
Rewarded Video	Video	VPAID 2.0	VAST 3.0	Through VAST 3.0 extensions*
		VPAID 2.0	VAST 4.2	Through VAST 4.1 `<AdVerifications>` tag, VAST 3.0 extensions* only as a fallback
		Native (Standard/360°)	Uploaded media file
			VAST 3.0	Through VAST 3.0 extensions*
			VAST 4.2	Through VAST 4.1 `<AdVerifications>` tag, VAST 3.0 extensions* only as a fallback
	HTML5 End Card (Direct only)
Native Ad	Native assets views

* Ads must be configured to traffic <Extension type="AdVerifications"> in their VAST as AdVerification tag is only available from VAST 4.1.

For example:


...
<Extensions>
	<Extension type="AdVerifications">
		<AdVerifications>
			<Verification vendor="company.com-omid">
				<JavaScriptResource>
					<![CDATA[ https://company.com/omid.js ]]>
				</JavaScriptResource>
				<VerificationParameters>
					<![CDATA[parameter1=value1&parameter2=value2&parameter3=value3]]>
				</VerificationParameters>
			</Verification>
		</AdVerifications>
	</Extension>
</Extensions>
...

Outstream Video support

Here is the list of supported features from the IAB Digital Video Suite.

Features

Format	Supported
IAB Video Suite
VAST 2.0
VAST 3.0
VAST 4.2
VPAID 2.0
VAST Wrapper
VMAP
Video features
Linear ads
Non-linear ads
Audio ads
Skippable ads
Ad pods
Companions	⁽¹⁾
Overlays
Icons
VAST tracking events
ViewableImpression
Asset Preloading	⁽²⁾

(1) Companion image can be used as a background image for the video interstitial (template setting)
(2) The video asset is partially preloaded to guarantee that it can be played on the device

Supported VAST 4.x macros

Smart Instream SDK supports the following IAB VAST 4.x macros.

Those Macros are supported in <VASTAdTagURI>, <Tracking>, <Impression> VAST nodes

Macro	Supported	Description
[APIFRAMEWORKS]		List of frameworks supported by the player. Values are defined in the AdCOM 1.0 "API Frameworks" list.
[OMIDPARTNER]		An identifier of the OM SDK integration. Please note: for SmartAdServer Instream SDKs it will be: `Smartadserver1` for mobile device integration `-1` for OTT Video Context
[VASTVERSIONS]		List of VAST versions supported by the player. Values are defined in the AdCOM 1.0 "Creative Subtypes" list.
[CACHEBUSTING]		Random 8-digit integer.
[TIMESTAMP]		The date and time at which the URI using this macro is accessed.

For additional information, please refer to the IAB VAST 4.x Macros Documentation