Руководство по обновлению

Upgrading The iOS SDK From 3.12.0 To 4.0.0

1. Обновите Podfile. Посмотреть актуальные версии можно в Руководстве CocoaPods

# pod 'Appodeal', '~> 3.11.0'
pod 'Appodeal', '~> 4.0.0'

2. Переименуйте все адаптеры в Podfile, заменив префикс APD- на префикс Appodeal

# pod 'APDBidMachineAdapter'
pod 'AppodealBidMachineAdapter'

Обновление iOS SDK С 3.11.0 До 3.12.0

Cocoa Pods

1. Обновите Podfile. Посмотреть актуальные версии можно в Руководстве CocoaPods

# pod 'Appodeal', '~> 3.11.0'
pod 'Appodeal', '~> 3.12.0'

# pod 'ISBidonCustomAdapter'
# pod 'AppLovinMediationBidonAdapter'
# pod 'BidMachineAmazonAdapter'
# pod 'BidMachineMetaAudienceAdapter'
# pod 'BidMachineMintegralAdapter'
# pod 'BidMachineMyTargetAdapter'
# pod 'BidMachineVungleAdapter'
# pod 'BidMachinePangleAdapter'
# pod 'AppLovinMediationOguryPresageAdapter'
# pod 'AppLovinMediationSmaatoAdapter'
# pod 'IronSourceAppLovinAdapter'
# pod 'IronSourceAPSAdapter'
# pod 'IronSourceOguryAdapter'
# pod 'IronSourceSmaatoAdapter'

Обновление iOS SDK С 3.10.0 До 3.11.0

1. Установите xcode 16.4 или более новую версию

Cocoa Pods

1. Обновите Podfile. Посмотреть актуальные версии можно в Руководстве CocoaPods

# pod 'Appodeal', '~> 3.10.0'
pod 'Appodeal', '~> 3.11.0'

Обновление iOS SDK С 3.9.0 До 3.10.0

1. Установите xcode 16.1 или более новую версию

Cocoa Pods

1. Обновите Podfile. Посмотреть актуальные версии можно в Руководстве CocoaPods

# pod 'Appodeal', ''~> 3.9.0'
pod 'Appodeal', '~> 3.10.0'

Обновление iOS SDK С 3.8.1 До 3.9.0

1. Установите xcode 16.1 или более новую версию

Cocoa Pods

1. Обновите Podfile. Посмотреть актуальные версии можно в Руководстве CocoaPods

# pod 'Appodeal', ''~> 3.8.1'
pod 'Appodeal', '~> 3.9.0'

Ручная интеграция

1. Скачайте последнюю версию архива Appodeal.zip
2. Добавьте загруженные файлы в Framework, Libraries, and Embedded Content в General вкладке проекта.

Обновление iOS SDK С 3.8.0 До 3.8.1

Cocoa Pods

1. Обновите Podfile. Посмотреть актуальные версии можно в Руководстве CocoaPods

# pod 'Appodeal', ''~> 3.8.0'
pod 'Appodeal', '~> 3.8.1'

Ручная интеграция

1. Скачайте последнюю версию архива Appodeal.zip
2. Добавьте загруженные файлы в Framework, Libraries, and Embedded Content в General вкладке проекта.

Обновление iOS SDK С 3.7.0 До 3.8.0

Cocoa Pods

1. Обновите Podfile. Посмотреть актуальные версии можно в Руководстве CocoaPods

# pod 'Appodeal', ''~> 3.7.0'
pod 'Appodeal', '~> 3.8.0'

Ручная интеграция

1. Скачайте последнюю версию архива Appodeal.zip
2. Добавьте загруженные файлы в Framework, Libraries, and Embedded Content в General вкладке проекта.

Обновление iOS SDK С 3.6.0 До 3.7.0

Cocoa Pods

1. Обновите Podfile. Посмотреть актуальные версии можно в Руководстве CocoaPods

# pod 'Appodeal', ''~> 3.6.0'
pod 'Appodeal', '~> 3.7.0'

Ручная интеграция

1. Скачайте последнюю версию архива Appodeal.zip
2. Добавьте загруженные файлы в Framework, Libraries, and Embedded Content в General вкладке проекта.

Обновление iOS SDK С 3.5.2 До 3.6.0

Cocoa Pods

1. Обновите Podfile. Посмотреть актуальные версии можно в Руководстве CocoaPods

# pod 'Appodeal', ''~> 3.5.2'
pod 'Appodeal', '~> 3.6.0'

Ручная интеграция

1. Скачайте последнюю версию архива Appodeal.zip
2. Добавьте загруженные файлы в Framework, Libraries, and Embedded Content в General вкладке проекта.

Обновление iOS SDK С 3.5.1 До 3.5.2

Cocoa Pods

1. Обновите Podfile. Посмотреть актуальные версии можно в Руководстве CocoaPods

# pod 'Appodeal', ''~> 3.5.1'
pod 'Appodeal', '~> 3.5.2'

Ручная интеграция

1. Скачайте последнюю версию архива Appodeal.zip
2. Добавьте загруженные файлы в Framework, Libraries, and Embedded Content в General вкладке проекта.

Обновление iOS SDK С 3.4.2 До 3.5.0

Скачайте Xcode версии 16.0 или выше, теперь это минимальная поддерживаемая версия.

Обновление iOS SDK С 3.5.0 До 3.5.1

Cocoa Pods

1. Обновите Podfile. Посмотреть актуальные версии можно в Руководстве CocoaPods

# pod 'Appodeal', ''~> 3.5.0'
pod 'Appodeal', '~> 3.5.1'

Ручная интеграция

1. Скачайте последнюю версию архива Appodeal.zip
2. Добавьте загруженные файлы в Framework, Libraries, and Embedded Content в General вкладке проекта.

Cocoa Pods

1. Обновите Podfile. Посмотреть актуальные версии можно в Руководстве CocoaPods

# pod 'Appodeal', ''~> 3.4.2'
pod 'Appodeal', '~> 3.5.0'

Ручная интеграция

Ручная интеграция недоступна

Обновление iOS SDK С 3.4.1 До 3.4.2

Cocoa Pods

1. Обновите Podfile. Посмотреть актуальные версии можно в Руководстве CocoaPods

# pod 'Appodeal', ''~> 3.4.1'
pod 'Appodeal', '~> 3.4.2'

Ручная интеграция

1. Скачайте последнюю версию архива Appodeal.zip
2. Добавьте загруженные файлы в Framework, Libraries, and Embedded Content в General вкладке проекта.

Обновление iOS SDK С 3.4.0 До 3.4.1

Cocoa Pods

1. Обновите Podfile. Посмотреть актуальные версии можно в Руководстве CocoaPods

# pod 'Appodeal', ''~> 3.4.0'
pod 'Appodeal', '~> 3.4.2'

Ручная интеграция

1. Скачайте последнюю версию архива Appodeal.zip
2. Добавьте загруженные файлы в Framework, Libraries, and Embedded Content в General вкладке проекта.

Обновление iOS SDK С 3.4.0-beta.2 До 3.4.0

Cocoa Pods

1. Обновите Podfile. Посмотреть актуальные версии можно в Руководстве CocoaPods

2. Удалите APDSmaatoAdapter и BidMachineSmaatoAdapter для совместимости с iOS 18

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

Ручная интеграция

1. Скачайте последнюю версию архива Appodeal.zip
2. Добавьте загруженные файлы в Framework, Libraries, and Embedded Content в General вкладке проекта.

Обновление iOS SDK С 3.4.0-beta.1 До 3.4.0-beta.2

Cocoa Pods

1. Обновите Podfile. Посмотреть актуальные версии можно в Руководстве CocoaPods

2. Удалите APDSmaatoAdapter и BidMachineSmaatoAdapter для совместимости с iOS 18

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

Ручная интеграция

1. Скачайте последнюю версию архива Appodeal.zip
2. Добавьте загруженные файлы в Framework, Libraries, and Embedded Content в General вкладке проекта.

Обновление iOS SDK С 3.3.2 До 3.4.0-beta.1

Скачайте Xcode версии 15.3 или выше, теперь это минимальная поддерживаемая версия.

Cocoa Pods

1. Обновите Podfile. Посмотреть актуальные версии можно в Руководстве CocoaPods

2. Удалите APDSmaatoAdapter и BidMachineSmaatoAdapter для совместимости с iOS 18

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

Ручная интеграция

1. Скачайте последнюю версию архива Appodeal.zip
2. Добавьте загруженные файлы в Framework, Libraries, and Embedded Content в General вкладке проекта.

Обновление iOS SDK С 3.3.1 До 3.3.2

Скачайте Xcode версии 15.2 или выше, теперь это минимальная поддерживаемая версия.

Cocoa Pods

1. Обновите Podfile. Посмотреть актуальные версии можно в Руководстве CocoaPods

# pod 'Appodeal', '~> 3.3.1'
pod 'Appodeal', '~> 3.3.2'

Ручная интеграция

1. Скачайте последнюю версию архива Appodeal.zip
2. Добавьте загруженные файлы в Framework, Libraries, and Embedded Content в General вкладке проекта.

Обновление iOS SDK С 3.3.0 До 3.3.1

Cocoa Pods

1. Обновите Podfile. Посмотреть актуальные версии можно в Руководстве CocoaPods

# pod 'Appodeal', '~> 3.3.0'
pod 'Appodeal', '~> 3.3.1'

Ручная интеграция

1. Скачайте последнюю версию архива Appodeal.zip
2. Добавьте загруженные файлы в Framework, Libraries, and Embedded Content в General вкладке проекта.

Обновление iOS SDK С 3.3.0-beta.4 До 3.3.0

Cocoa Pods

1. Обновите Podfile. Посмотреть актуальные версии можно в Руководстве CocoaPods

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

Ручная интеграция

1. Скачайте последнюю версию архива Appodeal.zip
2. Добавьте загруженные файлы в Framework, Libraries, and Embedded Content в General вкладке проекта.

Обновление iOS SDK С 3.3.0-beta.3 До 3.3.0-beta.4

APDTapjoyAdapter был удален

APDCriteoAdapter был удален

APDStackCrashReporter был удален

Cocoa Pods

1. Обновите Podfile. Посмотреть актуальные версии можно в Руководстве CocoaPods

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

Ручная интеграция

1. Скачайте последнюю версию архива Appodeal.zip
2. Добавьте загруженные файлы в Framework, Libraries, and Embedded Content в General вкладке проекта.

Обновление iOS SDK С 3.3.0-beta.2 До 3.3.0-beta.3

APDAdColonyAdapter был помечен как устаревший и теперь удален

APDStackAnalyticsAdapter был помечен как устаревший и теперь удален

Cocoa Pods

1. Обновите Podfile. Посмотреть актуальные версии можно в Руководстве CocoaPods

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

Ручная интеграция

1. Скачайте последнюю версию архива Appodeal.zip
2. Добавьте загруженные файлы в Framework, Libraries, and Embedded Content в General вкладке проекта.

Обновление iOS SDK С 3.2.1 До 3.3.0-beta.2

APDAdColonyAdapter помечен как устаревший и будет удален в следующем релизе

APDStackAnalyticsAdapter помечен как устаревший и будет удален в следующем релизе

Cocoa Pods

1. Обновите Podfile. Посмотреть актуальные версии можно в Руководстве CocoaPods

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

Ручная интеграция

1. Скачайте последнюю версию архива Appodeal.zip
2. Добавьте загруженные файлы в Framework, Libraries, and Embedded Content в General вкладке проекта.
3. Добавьте фреймворки libc++, libresolv, libz, libc++abi в Framework, Libraries, and Embedded Content в General вкладке проекта

Обновление iOS SDK С 3.2.1 До 3.3.0-beta.1

+updateUserConsentGDPR был ранее помечен как устаревший и теперь удален из SDK

+updateUserConsentCCPA был ранее помечен как устаревший и теперь удален из SDK

+updateConsentReport был ранее помечен как устаревший и теперь удален из SDK

Если вы использовали данные методы, просто удалите их, это не повлияет на работу SDK

Cocoa Pods

1. Обновите Podfile. Посмотреть актуальные версии можно в Руководстве CocoaPods

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

Ручная интеграция

1. Скачайте последнюю версию архива Appodeal.zip
2. Добавьте загруженные файлы в Framework, Libraries, and Embedded Content в General вкладке проекта.
3. Добавьте фреймворки libc++, libresolv, libz, libc++abi в Framework, Libraries, and Embedded Content в General вкладке проекта

Обновление iOS SDK С 3.0 До 3.2.1

Выпущена новая версия StackConsentManager. При ручном управлении окном согласия ознакомьтесь с GDPR and CCPA

+updateUserConsentGDPR помечен как устаревший и будет удален в следующем релизе

+updateUserConsentCCPA помечен как устаревший и будет удален в следующем релизе

+updateConsentReport помечен как устаревший и будет удален в следующем релизе

Cocoa Pods

1. Обновите Podfile. Посмотреть актуальные версии можно в Руководстве CocoaPods

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

Ручная интеграция

1. Скачайте последнюю версию архива Appodeal.zip
2. Добавьте загруженные файлы в Framework, Libraries, and Embedded Content в General вкладке проекта.
3. Добавьте фреймворки libc++, libresolv, libz, libc++abi в Framework, Libraries, and Embedded Content в General вкладке проекта

Обновление iOS SDK С 3.0 До 3.2

APDStackAnalyticsAdapter помечен как устаревший, он будет удален в следующем релизе.

Были добавлены следующие адаптеры

• APDBidonAdapter - адаптер для Bidon SDK используемого для Post Bid. Данный SDK предоставляет логику опроса рекланых сетей основанную на смешанной водопадно-аукционной модели. Данный SDK имеет собственные адаптеры рекламных сетей. Убедитесь, что в проект добавлены следующие компоненты:

  • BidonAdapterAppLovin
  • BidonAdapterBidMachine
  • BidonAdapterBigoAds
  • BidonAdapterDTExchange
  • BidonAdapterGoogleMobileAds
  • BidonAdapterInMobi
  • BidonAdapterMetaAudienceNetwork
  • BidonAdapterMintegral
  • BidonAdapterUnityAds
  • BidonAdapterVungle

• APDBigoAdsAdapter - адаптер для BigoAds

• APDDTExchangeAdapter - адаптер для DTExchange

• APDInMobiAdapter - адаптер для InMobi

• APDMintegralAdapter - адаптер для Mintegral

Cocoa Pods

1. Обновите Podfile. Посмотреть актуальные версии можно в Руководстве CocoaPods

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

Ручная интеграция

1. Скачайте последнюю версию архива Appodeal.zip
2. Добавьте загруженные файлы в Framework, Libraries, and Embedded Content в General вкладке проекта.

💥 Критические изменения AdMob Bidding

AdMob Bidding теперь доступен.

Установите нашу новую версию Admob Sync инструмента по ссылке и выполните синхронизацию.

Можете прочитать подробнее про Admob Sync в нашей инструкции.

Обновление iOS SDK С 2.11 До 3.0

Cocoa Pods

1. Обновите Podfile. Посмотреть актуальные версии можно в Руководстве CocoaPods

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

Ручная интеграция

1. Скачайте последнюю версию архива Appodeal.zip
2. Добавьте загруженные файлы в Framework, Libraries, and Embedded Content в General вкладке проекта.
3. Добавьте фреймворки libc++, libresolv, libz, libc++abi в Framework, Libraries, and Embedded Content в General вкладке проекта

Изменения Интеграции

1. Инициализация с Consent Manager. Начиная с Appodeal SDK 3.0.0 Stack Consent Managet встроен в ядро Appodeal SDK и синхронизируется по умолчанию. Весь код, связанный с Consent Manager, удален из проекта. Вызовите метод инициализации в AppDelegate вашего приложения -application:didFinishLaunchingWithOptions::

   Swift

   @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 
       }   
   }

   Objective C

   @interface MyAppDelegate () <AppodealInitializationDelegate> 
   
   @end 
   
   @implementation MyAppDelegate 
   
   - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { 
       /// Any pre-initialization 
       /// app specific logic 
       [Appodeal initializeWithApiKey:@"APP KEY" types:AppodealAdTypeInterstitial];
       return YES; 
   } 
   
   @end

   ---

   Если вы все еще хотите использовать свою собственную реализацию интеграции Stack Consent Manager, вы можете сделать это. В этом случае Appodeal SDK пропустит процесс синхронизации согласия во время инициализации и будет использовать предоставленный отчет о согласии.

2. Инициализация без Consent Manager. Вам не нужно передавать логический флаг в метод инициализации. Вместо этого вызовите + updateUserConsentGDPR: или + updateUserConsentCCPA: перед инициализацией. В случае, если SDK имеет хотя бы одно неизвестное согласие пользователя для зон GDPR или CCPA, он пропустит процесс синхронизации согласия во время инициализации.

   Swift

   @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 
       }   
   }

   Objective C

   @interface MyAppDelegate () <AppodealInitializationDelegate> 
   
   @end 
   
   @implementation MyAppDelegate 
   - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {        
       // App specific logic to dertmine regulation zone and user consent
       [self requestUserCosent:^(Zone zone, BOOL userConsent) {
           switch (zone) {
               case GDPR: [Appodeal updateUserConsentGDPR:userConsent ? APDGDPRUserConsentPersonalized : APDGDPRUserConsentNonPersonalized]; break;
               case CCPA: [Appodeal updateUserConsentCCPA:userConsent ? APDCCPAUserConsentOptIn : APDCCPAUserConsentOptOut]; break;
               default: break;
           }
           [Appodeal initializeWithApiKey:@"APP KEY" types:AppodealAdTypeInterstitial];
       }];  
       return YES; 
   } 
   
   @end

   ---

3. Пользовательские данные*. Если ваше приложение устанавливает возраст или пол пользователя в Appodeal SDK, вам необходимо удалить текущую реализацию и использовать следующий код:

   Swift

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

   Objective C

   [Appodeal setCustomStateValue:AppodealUserGenderMale forKey: kAppodealUserGenderKey];
   [Appodeal setCustomStateValue:40 forKey: kAppodealUserAgeKey];

   ---

Изменения Требований

1. Требуется Xcode версии 14.3 или выше

Обновление iOS SDK С 2.10 До 2.11

Cocoa Pods

1. Обновите Podfile. Посмотреть актуальные версии можно в Руководстве CocoaPods

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

Ручная интеграция

1. Скачайте последнюю версию архива Appodeal.zip
2. Добавьте загруженные файлы в Framework, Libraries, and Embedded Content in General настройу проекта

Изменения Требований

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

Обновление iOS SDK С 2.7 До 2.8

Cocoa Pods

1. Обновите Podfile. Посмотреть актуальные версии можно в Руководстве CocoaPods

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

Ручная интеграция

1. Скачайте последнюю версию архива Appodeal.zip
2. Добавьте загруженные файлы в Framework, Libraries, and Embedded Content in General настройу проекта.

Изменения Требований

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

Обновление iOS SDK С 2.5 До 2.6

Cocoa Pods

1. Обновите Podfile. Посмотреть актуальные версии можно в Руководстве CocoaPods

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

Ручная интеграция

1. Скачайте последнюю версию архива Appodeal.zip
2. Добавьте загруженные файлы в Framework, Libraries, and Embedded Content in General настройу проекта.

Изменения Требований

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

Обновление iOS SDK С 2.5.12 До 2.5.13

Изменения Интеграции

1. Вы можете использовать метод + updateConsent: для предоставления согласия пользователей GDPR к рекламным сетям в Appodeal SDK в любом месте вашего приложения. Appodeal SDK не сохраняет согласие пользователей GDPR между сеансами, это означает, что вы должны предоставлять согласие каждый раз, иначе Appodeal SDK будет использовать значение по умолчанию или значение с сервера. По умолчанию значение согласия - true.

Обновление iOS SDK С 2.5.11 До 2.5.12

Cocoa Pods

1. Обновите Podfile. Посмотреть актуальные версии можно в Руководстве CocoaPods

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

Ручная интеграция

1. Скачайте последнюю версию архива Appodeal.zip
2. Добавьте загруженные файлы в Framework, Libraries, and Embedded Content in General настройу проекта.

Обновление iOS SDK С 2.5.8 До 2.5.9

1. Обновите Podfile. Посмотреть актуальные версии можно в Руководстве CocoaPods

2. Если вы используете только некоторые части Appodeal SDK (типы рекламы), процесс обновления файла pod будет таким же. Например: от pod 'Appodeal/Banner', '2.5.8' до pod 'Appodeal/Banner', '2.5.9' а целевая платформа остается той же, что и для версии 2.5.8 (она должна быть 9.0).

Ручная интеграция

1. Скачайте последнюю версию архива Appodeal.zip
2. Добавьте загруженные файлы в Framework, Libraries, and Embedded Content in General настройу проекта.

Изменения Требований

1. Добавьте GADApplicationIdentifier в info.plist

   <key>GADApplicationIdentifier</key>
   <string>ca-app-pub-3940256099942544~1458002511</string>