❗️

Attention:

If you are a publisher that has a custom adapter or intends to have a custom integration, please contact our Sales Engineering team before you begin.

On this page

• Integrating an iOS App
  • Prerequisites
  • Add SDK Dependencies
  • Choose Ad Formats
  • Framework Requirements by Ad Format
  • Important Note About Fullscreen Adspaces

Integrating an iOS App

Prerequisites

To integrate the NextGen SDK into your iOS project, you need:

• Xcode: 15.1 or later
• Minimum iOS Deployment Target: iOS 12.0
• Supported Languages: Swift and Objective-C
• Architectures: arm64, x86_64 (simulator)

Add SDK Dependencies

Choose one of the following integration methods:

Option 1: Swift Package Manager (SPM)

1. In Xcode, go to File → Add Package Dependencies…
2. Enter the repository URL:

https://github.com/vervegroup/Smaato-ios-sdk-standalone

3. Set the version rule to Exact 23.0.1 (or Up to Next Major Version)
4. Select Products When prompted, select the products you need:

SmaatoSDK — core SDK (required)
SmaatoSDKAdaptersAdMob — AdMob adapter (optional)
SmaatoSDKAdaptersAppLovinWaterfall — AppLovin adapter (optional)

Click Add Package.

5. Add -ObjC Linker Flag

In your target's Build Settings, find Other Linker Flags and add: -ObjC

Option 2: CocoaPods

Add the CocoaPods source and the Smaato SDK to your Podfile:

source 'https://cdn.cocoapods.org/'

SDK Full Version (includes all ad formats):

target 'YourAppTarget' do
  use_frameworks!
  pod 'smaato-ios-sdk', '23.0.1'
end

Or include only the ad formats you need:

# Banner Ads
pod 'smaato-ios-sdk/Banner', '23.0.1'
# Interstitial Ads
pod 'smaato-ios-sdk/Interstitial', '23.0.1'
# Rewarded Ads
pod 'smaato-ios-sdk/RewardedAds', '23.0.1'
# Native Ads
pod 'smaato-ios-sdk/Native', '23.0.1'
# In-App Bidding (required for bidding partner)
pod 'smaato-ios-sdk/InApp', '23.0.1'

Then run:

pod install

Option 3: Manual Integration (xcframework)

Download the Smaato iOS SDK xcframework from the GitHub releases page:

• Repository: https://github.com/vervegroup/Smaato-ios-sdk-standalone
• Tag: 23.0.1
• Download the xcframework from the releases page and add it to your Xcode project.

Choose Ad Formats

The SDK is split into modular frameworks to keep binary size smaller:

• SmaatoSDKCore.framework
• SmaatoSDKBanner.framework
• SmaatoSDKInterstitial.framework
• SmaatoSDKRewardedAds.framework
• SmaatoSDKNative.framework
• SmaatoSDKRichMedia.framework
• SmaatoSDKVideo.framework
• SmaatoSDKOutstream.framework
• SmaatoSDKOpenMeasurement.framework
• SmaatoSDKUnifiedBidding.framework

Framework Requirements by Ad Format

📘

Note:

SmaatoSDKCore and SmaatoSDKOpenMeasurement are mandatory in any configuration. SmaatoSDKUnifiedBidding is optional and used for revenue maximization.

Important Note About Fullscreen Adspaces

Currently, only the Interstitial Multi-Ad Format is compatible for Fullscreen Adspaces with Smaato NextGen SDK.
For fullscreen monetization in SPX, select Interstitial (Display & Video) as the ad format. Three creative type options are available:

• Display Only — Rich Media Ads
• Video Only — Video Ads
• Display and Video — either Rich Media or Video Ads