Skip to main content
Version: 3.4.0

Upgrade guide

Upgrading The iOS SDK From 3.4.0-beta.2 To 3.4.0

Cocoa Pods

  1. Update your Podfile. See pod versions in CocoaPods integration guide

  2. Remove APDSmaatoAdapter and BidMachineSmaatoAdapter to make your app compatible with iOS 18

# pod 'Appodeal', '~> 3.4.0-beta.2'
pod 'Appodeal', '~> 3.4.0'

Manual

  1. Download the latest version of Appodeal.zip
  2. Add all downloaded content to Framework, Libraries, and Embedded Content in General settings of project.

Upgrading The iOS SDK From 3.4.0-beta.1 To 3.4.0-beta.2

Cocoa Pods

  1. Update your Podfile. See pod versions in CocoaPods integration guide

  2. Remove APDSmaatoAdapter and BidMachineSmaatoAdapter to make your app compatible with iOS 18

# pod 'Appodeal', '~> 3.4.0-beta.1'
pod 'Appodeal', '~> 3.4.0-beta.2'

Manual

  1. Download the latest version of Appodeal.zip
  2. Add all downloaded content to Framework, Libraries, and Embedded Content in General settings of project.

Upgrading The iOS SDK From 3.3.2 To 3.4.0-beta.1

Download Xcode 15.3 or higher, now it's minimum supported version.

Cocoa Pods

  1. Update your Podfile. See pod versions in CocoaPods integration guide

  2. Remove APDSmaatoAdapter and BidMachineSmaatoAdapter to make your app compatible with iOS 18

# pod 'Appodeal', '~> 3.3.2'
pod 'Appodeal', '~> 3.4.0-beta.1'

Manual

  1. Download the latest version of Appodeal.zip
  2. Add all downloaded content to Framework, Libraries, and Embedded Content in General settings of project.

Upgrading The iOS SDK From 3.3.1 To 3.3.2

Download Xcode 15.2 or higher, now it's minimum supported version.

Cocoa Pods

  1. Update your Podfile. See pod versions in CocoaPods integration guide
# pod 'Appodeal', '~> 3.3.1'
pod 'Appodeal', '~> 3.3.2'

Manual

  1. Download the latest version of Appodeal.zip
  2. Add all downloaded content to Framework, Libraries, and Embedded Content in General settings of project.

Upgrading The iOS SDK From 3.3.0 To 3.3.1

Cocoa Pods

  1. Update your Podfile. See pod versions in CocoaPods integration guide
# pod 'Appodeal', '~> 3.3.0'
pod 'Appodeal', '~> 3.3.1'

Manual

  1. Download the latest version of Appodeal.zip
  2. Add all downloaded content to Framework, Libraries, and Embedded Content in General settings of project.

Upgrading The iOS SDK From 3.3.0-beta.4 To 3.3.0

Cocoa Pods

  1. Update your Podfile. See pod versions in CocoaPods integration guide

    # pod 'Appodeal', '~> 3.3.0-beta.4' 
    pod 'Appodeal', '~> 3.3.0'

Manual

  1. Download the latest version of Appodeal.zip
  2. Add all downloaded content to Framework, Libraries, and Embedded Content in General settings of project.

Upgrading The iOS SDK From 3.3.0-beta.3 To 3.3.0-beta.4

APDTapjoyAdapter was removed

APDCriteoAdapter was removed

APDStackCrashReporter was removed

Cocoa Pods

  1. Update your Podfile. See pod versions in CocoaPods integration guide

    # pod 'Appodeal', '~> 3.3.0-beta.3' 
    pod 'Appodeal', '~> 3.3.0-beta.4'

Manual

  1. Download the latest version of Appodeal.zip
  2. Add all downloaded content to Framework, Libraries, and Embedded Content in General settings of project.

Upgrading The iOS SDK From 3.3.0-beta.2 To 3.3.0-beta.3

APDAdColonyAdapter was deprecated and is removed now

APDStackAnalyticsAdapter was deprecated and is removed now

Cocoa Pods

  1. Update your Podfile. See pod versions in CocoaPods integration guide

    # pod 'Appodeal', '~> 3.3.0-beta.2' 
    pod 'Appodeal', '~> 3.3.0-beta.3'

Manual

  1. Download the latest version of Appodeal.zip
  2. Add all downloaded content to Framework, Libraries, and Embedded Content in General settings of project.

Upgrading The iOS SDK From 3.2.1 To 3.3.0-beta.2

APDAdColonyAdapter is now deprecated and will be removed in the next release

APDStackAnalyticsAdapter is now deprecated and will be removed in the next release

Cocoa Pods

  1. Update your Podfile. See pod versions in CocoaPods integration guide

    # pod 'Appodeal', '~> 3.2.1' 
    pod 'Appodeal', '~> 3.3.0-beta.2'

Manual

  1. Download the latest version of Appodeal.zip
  2. Add all downloaded content to Framework, Libraries, and Embedded Content in General settings of project.
  3. Add libc++, libresolv, libz, libc++abi frameworks to Framework, Libraries, and Embedded Content in General settings of project

Upgrading The iOS SDK From 3.0 To 3.3.0-beta.1

+updateUserConsentGDPR was deprecated is removed now

+updateUserConsentCCPA was deprecated is removed now

+updateConsentReport was deprecated is removed now

If you used these methods, just remove them, it will not affect the SDK functionality

Cocoa Pods

  1. Update your Podfile. See pod versions in CocoaPods integration guide

    # pod 'Appodeal', '~> 3.0' 
    pod 'Appodeal', '~> 3.3.0-beta.1'

Manual

  1. Download the latest version of Appodeal.zip
  2. Add all downloaded content to Framework, Libraries, and Embedded Content in General settings of project.
  3. Add libc++, libresolv, libz, libc++abi frameworks to Framework, Libraries, and Embedded Content in General settings of project

Upgrading The iOS SDK From 3.0 To 3.2.1

New version of StackConsentManager has been released. If you manually managed consent window, please visit page GDPR and CCPA

+updateUserConsentGDPR is now deprecated and will be removed in the next release

+updateUserConsentCCPA is now deprecated and will be removed in the next release

+updateConsentReport is now deprecated and will be removed in the next release

Cocoa Pods

  1. Update your Podfile. See pod versions in CocoaPods integration guide

    # pod 'Appodeal', '~> 3.0' 
    pod 'Appodeal', '~> 3.2.1'

Manual

  1. Download the latest version of Appodeal.zip
  2. Add all downloaded content to Framework, Libraries, and Embedded Content in General settings of project.
  3. Add libc++, libresolv, libz, libc++abi frameworks to Framework, Libraries, and Embedded Content in General settings of project

Upgrading The iOS SDK From 3.0 To 3.2

APDStackAnalyticsAdapter is deprecated. Please remove it from your project.

The next adapters have been added:

  • APDBidonAdapter - adapter for Bidon SDK used as Post Bid engine based on mixed waterfall and bidding mediation model. This SDK uses own adapters for ad networks. Make sure that you are added following modules into your project:

    • BidonAdapterAppLovin
    • BidonAdapterBidMachine
    • BidonAdapterBigoAds
    • BidonAdapterDTExchange
    • BidonAdapterGoogleMobileAds
    • BidonAdapterInMobi
    • BidonAdapterMetaAudienceNetwork
    • BidonAdapterMintegral
    • BidonAdapterUnityAds
    • BidonAdapterVungle
  • APDBigoAdsAdapter - adapter for BigoAds

  • APDDTExchangeAdapter - adapter for DTExchange

  • APDInMobiAdapter - adapter for InMobi

  • APDMintegralAdapter - adapter for Mintegral

Cocoa Pods

  1. Update your Podfile. See pod versions in CocoaPods integration guide

    # pod 'Appodeal', '~> 3.0' 
    pod 'Appodeal', '~> 3.2'

Manual

  1. Download the latest version of Appodeal.zip
  2. Add all downloaded content to Framework, Libraries, and Embedded Content in General settings of project.
  3. Add libc++, libresolv, libz, libc++abi frameworks to Framework, Libraries, and Embedded Content in General settings of project

💥 Breaking changes for AdMob Bidding

AdMob Bidding is now available.

Download our newest version of AdMob Sync tool from this page and perform sync.

You can read more about AdMob Sync in our guide.

Upgrading The iOS SDK From 2.11 To 3.0

Cocoa Pods

  1. Update your Podfile. See pod versions in CocoaPods integration guide

    # pod 'Appodeal', '~> 2.11' 
    pod 'Appodeal', '~> 3.0'

Manual

  1. Download the latest version of Appodeal.zip
  2. Add all downloaded content to Framework, Libraries, and Embedded Content in General settings of project.

Code Changes

  1. Initilization with consent manager. Since Appodeal SDK 3.0.0 Stack Consent Manager is embdedded in Appodeal SDK core and synchronising by default. Removes all consent manager related logic from project. Call initialization method in your app delegate -application:didFinishLaunchingWithOptions: method:

    @UIApplicationMain 
    final class MyAppDelegate: UIResponder, UIApplicationDelegate, AppodealInitializationDelegate {
    func application(
    _ application: UIApplication, didFinishLaunchingWithOptions
    launchOptions: [UIApplication.LaunchOptionsKey : Any]? = nil ) -> Bool {
    /// Any pre-initialization
    /// app specific logic
    Appodeal.initialize(
    withApiKey: "APP_KEY",
    types: .interstitial
    )
    return true
    }
    }

    If you still want to use your own implementation of Stack Consent Manager integration, you are able to keep it. In this case Appodeal SDK will skip consent synchronisation process during initialization and will use given consent report.

  2. Initilization without consent manager. You don't need to pass boolean flag into initialization method. Instead of this approach call the one of + updateUserConsentGDPR: or + updateUserConsentCCPA: before initialization. In case the SDK will have at least one non unknown user consent for GDPR or CCPA zone it will skip consent synchronisation process during initialization.

    @UIApplicationMain 
    final class MyAppDelegate: UIResponder, UIApplicationDelegate, AppodealInitializationDelegate {
    func application(
    _ application: UIApplication, didFinishLaunchingWithOptions
    launchOptions: [UIApplication.LaunchOptionsKey : Any]? = nil
    ) -> Bool {

    // App specific logic to dertmine regulation zone and user consent
    requestUserConsent { zone, userConsent in
    switch (zone, userConsent) {
    case .GDPR, true: Appodeal.updateUserConsentGDPR(.personalized)
    case .GDPR, false: Appodeal.updateUserConsentGDPR(.nonPersonalized)
    case .CCPA, true: Appodeal.updateUserConsentCCPA(.optIn)
    case .CCPA, false: Appodeal.updateUserConsentCCPA(.optOut)
    }
    Appodeal.initialize(
    withApiKey: "APP_KEY",
    types: .interstitial
    )
    }
    return true
    }
    }

  3. User data. If your app is setting user age or user gender in Appodeal SDK, you will need to removes current implementation and use the next code.

    Appodeal.setCustomStateValue(AppodealUserGender.male.rawValue, forKey: kAppodealUserGenderKey)
    Appodeal.setCustomStateValue(40, forKey: kAppodealUserAgeKey)

Requirements Changes

  1. Xcode 14.3 or higher is required

Upgrading The iOS SDK From 2.10 To 2.11

Cocoa Pods

  1. Update your Podfile. See pod versions in CocoaPods integration guide

    # pod 'Appodeal', '~> 2.10.0' 
    pod 'Appodeal', '~> 2.11.0'

Manual

  1. Download the latest version of Appodeal.zip
  2. Add all downloaded content to Framework, Libraries, and Embedded Content in General settings of project

Requirements Changes

  1. Xcode 13 or higher is required
  2. iOS 10 or higher is required

Upgrading The iOS SDK From 2.7 To 2.8

Cocoa Pods

  1. Update your Podfile. See pod versions in CocoaPods integration guide

    # pod 'Appodeal', '~> 2.7.0' 
    pod 'Appodeal', '~> 2.8.0'

Manual

  1. Download the latest version of Appodeal.zip
  2. Add all downloaded content to Framework, Libraries, and Embedded Content in General settings of project.

Requirements Changes

  1. Xcode 12 or higher is required
  2. iOS 10 or higher is required

Upgrading The iOS SDK From 2.5 To 2.6

Cocoa Pods

  1. Update your Podfile. See pod versions in CocoaPods integration guide

    # pod 'Appodeal', '~> 2.5.0' 
    pod 'Appodeal', '~> 2.6.0'

Manual

  1. Download the latest version of Appodeal.zip
  2. Add all downloaded content to Framework, Libraries, and Embedded Content in General settings of project.

Requirements Changes

  1. If your project is a pure Objective-C project, you should add an empty Swift file. For example Dummy.swift.

Upgrading The iOS SDK From 2.5.12 To 2.5.13

Code Changes

  1. You can use the + updateConsent: method to provide the GDPR user consent to ad networks in Appodeal SDK anywhere in your application. Appodeal SDK doesn't keep the GDPR user consent between sessions, that means you have to provide consent every time, otherwise, Appodeal SDK uses default or server value. By default, consent value is true.

Upgrading The iOS SDK From 2.5.11 To 2.5.12

Cocoa Pods

  1. Update your Podfile. See pod versions in CocoaPods integration guide

    # pod 'Appodeal', '~> 2.5.11' 
    pod 'Appodeal', '~> 2.5.12'
    pod 'Appodeal/AppodealAdExchangeAdapter', '2.5.12'
    pod 'Appodeal/IronSourceAdapter', '2.5.12'

Manual

  1. Download the latest version of Appodeal.zip
  2. Add all downloaded content to Framework, Libraries, and Embedded Content in General settings of project.

Upgrading The iOS SDK From 2.5.8 To 2.5.9

  1. Update your Podfile. See pod versions in CocoaPods integration guide

  2. If you use only some parts of Appodeal SDK (ad types), pod file updating process will be the same. For example: from pod 'Appodeal/Banner', '2.5.8' to pod 'Appodeal/Banner', '2.5.9' and deployment target stays the same as for 2.5.8 (it should be 9.0).

Manual

  1. Download the latest version of Appodeal.zip
  2. Add all downloaded content to Framework, Libraries, and Embedded Content in General settings of project.

Requirements Changes

  1. Add your GADApplicationIdentifier into info.plist file
<key>GADApplicationIdentifier</key>
<string>ca-app-pub-3940256099942544~1458002511</string>