iOS Migration guide

This page will walk you through the migration process from a SDK version to newer one, starting from the version 8.0.0.

We advise you to update your SDK version on regular basis to avoid making the migration process more tedious, and to have access to new features and bug fixes.

Table of contents

  1. Migration from version 7.x to 8.3.0
    1. Native ad
  2. Migration from version 7.x to 8.1.0
    1. Parallax banner
  3. Migration from version 7.x to 8.0.0
    1. Integration changes
    2. APIs related to dropped or yet to come features
    3. APIs related to supported features

Migration from version 7.x to 8.3.0

Native ad

The native ad format has been added to the Equativ Display SDK 8.3.0.

Everything have changed compared to the native ad integration in the Smart Display SDK v7.x. The native ad rendering is now done by the SDK. For more details, please check the native ad integration article.

Migration from version 7.x to 8.1.0

Parallax banner

The parallax banner has been added to the Equativ Display SDK 8.1.0.

The parallaxInfos property of SASBannerView which was used to setup the parallax creative margins has been replaced by the parallaxMargins property, which is an instance of the new SASParallaxMargins class.

For more detail, please refer to the banner integration guide.

Migration from version 7.x to 8.0.0

Integration changes

All the integration related information can be found here.

Pod name

The name of the pod has changed with this version 8.0.0.

You will have to update your Podfile import from pod 'Smart-Display-SDK', '~> 7.0' to pod 'Equativ-Display-SDK', '~> 8.0'.

Minimum iOS version

The minimum supported iOS version has been bumped from iOS 12 to iOS 13. You will have to target at least iOS 13 in order to use the Equativ Display SDK.

The following lists wraps up all the classes, protocols and APIs related to features that are not currently available in the Equativ Display SDK 8.0.0, but were in the previous versions.

Some of those features will be supported in future releases, some others will not be anymore. Please have a look to our roadmap for more information about the upcoming features.

  • SASParallaxInfos model class.
  • parallaxInfos property on SASBannerView.
  • SASNativeAdManager class.
  • SASNativeAd class and its delegate SASNativeAdDelegate.
  • SASNativeAdImage model class.
  • SASNativeAdMediaView class and its delegate SASNativeAdMediaViewDelegate.
  • SASRewardedVideoManager class and its delegate SASRewardedVideoManagerDelegate.
  • SASReward model class.
  • SASMediationBannerAdapter class and its delegate SASMediationBannerAdapterDelegate.
  • SASMediationInterstitialAdapter class and its delegate SASMediationInterstitialAdapterDelegate.
  • SASMediationRewardedVideoAdapter class and its delegate SASMediationRewardedVideoAdapterDelegate.
  • SASMediationNativeAdAdapter class, its delegate SASMediationNativeAdAdapterDelegate and the model class SASMediationNativeAdInfo.
  • SASBiddingManager class and its delegate SASBiddingManagerDelegate.
  • SASBiddingAdPrice and SASBiddingAdResponse model classes.
  • SASBiddingAdFormatType enum.
  • SASBidderAdapter class.
  • SASBidderAdapterProtocol protocol and all its public implementations:
    • SASBannerBidderAdapter class and its delegate SASBannerBidderAdapterDelegate.
    • SASInterstitialBidderAdapter class and its delegate SASInterstitialBidderAdapterDelegate.
  • SASBidderAdapterCompetitionType and SASBidderAdapterCreativeRenderingType enums.

SASConfiguration

The SASConfiguration singleton class remains available, but some features were removed or updated.

The main change is that the configure() methods (that must be called before prior to any SDK usage) is now fully automated and does not requires any parameter anymore.

Removed APIs
  • siteId property.
  • baseURL property.
  • manualBaseURL property.
  • customIdentifier property.
Updated APIs

SASAdPlacement

Initializer methods

The init methods now only exists for the following parameters:

  • the site id
  • the page id
  • the format id
  • an optional string as keyword targeting

All other optional parameters that are still supported can be set using the SASAdPlacement properties.

Removed APIs
  • pageName property.
  • master property.
  • mediationExtraParameters property.
  • contentURL property.
Updated APIs

SASBannerView

Removed APIs
  • init(frame:loaderType:) initializer method.
  • load(biddingAdResponse:) method.
  • load(with:bidderAdapter:) method.
  • optimalAdViewHeight(forContainer:) method.
  • refresh() method.
  • sendMessageToWebView(message:) method.
  • expandsFromTop property.
  • refreshInterval property.
  • parallaxInfos property.
  • webViewRendering property.
  • ratio property (you can use the new SASAdInfo class instead).
Updated APIs
  • load(with:) was renamed to loadAd(with:).
Delegate

The SASBannerViewDelegate protocol was completely redefined in the SDK 8.

Some methods were updated:

Some methods were removed:

  • bannerView(_:didDownloadAd:) method.
  • all deprecated methods.
  • all methods related to MRAID events.
  • all methods related to native audio playback.
  • all methods related to sticky creatives.
  • all methods related to modal opening & closing

SASInterstitialView

Removed APIs
  • init(biddingAdResponse:delegate:) initializer method.
  • init(placement:delegate:) initializer methods (use init(placement:) instead and set the delegate using the delegate property).
  • sendMessageToWebView(_:) method.
  • load(bidderAdapter:) method.
Updated APIs
  • load() was renamed to loadAd().
Delegate

The SASInterstitialManagerDelegate protocol was completely redefined in the SDK 8.

Some methods were updated:

Some methods were removed:

  • interstitialManager(_:didSend:) method.
  • all deprecated methods.
  • all methods related to the MRAID send message feature.
  • all methods related to native audio playback.
  • all methods related to modal opening & closing

Back to top

Copyright Equativ © 2024. All right reserved.

Page last modified: Dec 2 2024.