Перейти к основному содержимому
Версия:

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

Обновление Android SDK с 4.3.0 до 4.4.0​

compileSdk и Android Gradle Plugin​

Этот шаг нужен, только если приложение использует Start.io SDK 5.3.2 или новее. Он объявляет minCompileSdk = 37, поэтому приложение должно компилироваться против API 37 (Android 17) или новее. Рекомендуемая конфигурация использует более раннюю версию Start.io, и её это не касается. API 37 опубликован как платформа с минорной версией android-37.0, которую умеет разрешать только Android Gradle Plugin 8.10.0 или новее. Обновите оба параметра в проекте:

// settings.gradle или корневой build.gradle
plugins {
    id 'com.android.application' version '8.10.0' apply false
}
// build.gradle модуля
android {
    compileSdk 37
}

targetSdk не меняется: оставьте значение, которое уже использует приложение.

Версия Kotlin​

Appodeal SDK 4.4.0 собран на Kotlin 2.3.0. Если приложение написано на Kotlin и использует Kotlin Gradle Plugin старше 2.2.0, обновите его до 2.2.0 или новее там, где он объявлен в проекте — в блоке plugins, в buildscript classpath или в каталоге версий:

plugins {
    id 'org.jetbrains.kotlin.android' version '2.2.0'
}

Более старые плагины не могут прочитать Kotlin-метаданные SDK, и сборка падает с ошибкой Module was compiled with an incompatible version of Kotlin. Приложений только на Java это не касается.

Других действий для обновления до версии 4.4.0 не требуется.

Обновление Android SDK с 4.2.0 до 4.3.0​

Обновление до версии 4.3.0 не требует дополнительных действий.

Обновление Android SDK с 4.1.0 до 4.2.0​

Минимальная поддерживаемая версия Android​

В Appodeal SDK 4.2.0 минимальная поддерживаемая версия Android повышена до API 24 (Android 7.0). Если значение minSdkVersion в вашем приложении ниже 24, обновите его в файле build.gradle уровня модуля:

android {
    defaultConfig {
        minSdkVersion 24
    }
}

Других действий для обновления до версии 4.2.0 не требуется.

Обновление Android SDK с 4.0.0 до 4.1.0​

Обновление до версии 4.1.0 не требует дополнительных действий.

Обновление Android SDK с 3.12.0 до 4.0.0​

💥 Критические изменения в Gradle-зависимостях​

Версионирование адаптеров полностью отвязано от ядра Appodeal SDK и перенесено на новые Maven-координаты.

  1. Обновите ваш build.gradle файл. Посетите страницу Настройка рекламных сетей для генерации новых зависимостей.

  2. Замените старые зависимости адаптеров на новые координаты:

// Старый формат (удалён)
// implementation 'com.appodeal.ads.sdk:full:3.12.0'

// Новый формат - каждый адаптер теперь отдельно
implementation 'com.appodeal.ads.sdk:core:4.0.0'
implementation 'com.appodeal.ads.sdk.adapters:admob:X.X.X'
implementation 'com.appodeal.ads.sdk.adapters:applovin:X.X.X'
// ... добавьте другие адаптеры по необходимости

Ключевые изменения:

  • Зависимость full bundle удалена
  • Каждый адаптер теперь является отдельной зависимостью под com.appodeal.ads.sdk.adapters
  • Версии адаптеров теперь соответствуют версии SDK рекламной сети, а не версии Appodeal SDK
  • Это обеспечивает более гибкий и детальный контроль над обновлениями адаптеров

Обновление Android SDK C 3.11.0 До 3.12.0​

Обновление до версии 3.12.0 не требует дополнительных действий.

Обновление Android SDK C 3.10.0 До 3.11.0​

Обновление до версии 3.11.0 не требует дополнительных действий.

Обновление Android SDK C 3.9.0 До 3.10.0​

Обновление до версии 3.10.0 не требует дополнительных действий.

Обновление Android SDK C 3.8.1 До 3.9.0​

Обновление до версии 3.9.0 не требует дополнительных действий.

Обновление Android SDK C 3.8.0 До 3.8.1​

Обновление до версии 3.8.1 не требует дополнительных действий.

Обновление Android SDK C 3.7.0 До 3.8.0​

Обновление до версии 3.8.0 не требует дополнительных действий.

Обновление Android SDK C 3.6.0 До 3.7.0​

Обновление до версии 3.7.0 не требует дополнительных действий.

Обновление Android SDK C 3.5.2 До 3.6.0​

Обновление до версии 3.6.0 не требует дополнительных действий.

Обновление Android SDK C 3.5.1 До 3.5.2​

Обновление до версии 3.5.2 не требует дополнительных действий.

Обновление Android SDK C 3.5.0 До 3.5.1​

Обновление до версии 3.5.1 не требует дополнительных действий.

Обновление Android SDK C 3.4.2 До 3.5.0​

Обновление до версии 3.5.0 не требует дополнительных действий.

Обновление Android SDK C 3.4.1 До 3.4.2​

Обновление до версии 3.4.2 не требует дополнительных действий.

Обновление Android SDK C 3.4.0 До 3.4.1​

Обновление до версии 3.4.1 не требует дополнительных действий.

Обновление Android SDK C 3.4.0-beta.1 До 3.4.0​

Обновление до версии 3.4.0 не требует дополнительных действий.

Обновление Android SDK C 3.3.3 До 3.4.0-beta.1​

Обновление до версии 3.4.0-beta.1 не требует дополнительных действий.

Обновление Android SDK C 3.3.2 До 3.3.3​

Обновление до версии 3.3.3 не требует дополнительных действий.

Обновление Android SDK C 3.3.1 До 3.3.2​

Обновление до версии 3.3.2 не требует дополнительных действий.

Обновление Android SDK C 3.3.0 До 3.3.1​

Обновление до версии 3.3.1 не требует дополнительных действий.

Обновление Android SDK C 3.3.0-beta.5 До 3.3.0​

Обновление до версии 3.3.0 не требует дополнительных действий.

Обновление Android SDK C 3.3.0-beta.4 До 3.3.0-beta.5​

Обновление до версии 3.3.0-beta.5 не требует дополнительных действий.

Обновление Android SDK C 3.3.0-beta.3 До 3.3.0-beta.4​

Обновление до версии 3.3.0-beta.4 не требует дополнительных действий.

Обновление Android SDK C 3.3.0-beta.2 До 3.3.0-beta.3​

Обновление до версии 3.3.0-beta.3 не требует дополнительных действий.

Обновление Android SDK C 3.3.0-beta.1 До 3.3.0-beta.2​

Обновление до версии 3.3.0-beta.2 не требует дополнительных действий.

Обновление Android SDK C 3.2.1 До 3.3.0-beta.1​

  • Обновлён Kotlin до версии 1.8.22

  • Классы из пакета com.appodeal.consent были удалены:

    • Consent
    • Consent.Zone
    • Consent.Status

  • Классы из пакета com.appodeal.ads.regulator были удалены:

    • GDPRUserConsent
    • CCPAUserConsent
    • UserConsent

  • Методы в классе Appodeal были удалены:

    • updateGDPRUserConsent(consent: GDPRUserConsent)
    • updateCCPAUserConsent(consent: CCPAUserConsent)
    • updateConsent(consent: Consent?)

Обновление Android SDK C 3.2.1-beta.1 До 3.2.1​

Обновление до версии 3.2.1 не требует дополнительных действий.

Обновление Android SDK с 3.2.0 до 3.2.1-beta.1​

Обновление до версии 3.2.1-beta.1 не требует дополнительных действий. Консет будет запрашиваться автоматически при инициализации SDK. Если вы хотите использовать ConsentManager в ручную, то следуйте этому руководству

  • Классы из пакета com.appodeal.consent помечены как устаревшие:

    • Consent;
    • Consent.Zone;
    • Consent.Status.

  • Классы из пакета com.appodeal.ads.regulator помечены как устаревшие:

    • GDPRUserConsent;
    • CCPAUserConsent;
    • UserConsent,

  • Методы в классе Appodeal помечены как устаревшие:

    • updateGDPRUserConsent(consent: GDPRUserConsent)
    • updateCCPAUserConsent(consent: CCPAUserConsent)
    • updateConsent(consent: Consent?)

Обновление Android SDK C 3.2.0-beta.2 До 3.2.0​

Admob Bidding доступен. Вам необходимо загрузить нашу новейшую версию инструмента Admob Sync с этой страницы и выполнить синхронизацию. Подробнее о Admob Sync вы можете прочитать в нашем руководстве.

Обновление Android SDK C 3.2.0-beta.1 До 3.2.0-beta.2​

Обновление до версии 3.2.0-beta.2 не требует дополнительных действий.

Обновление Android SDK C 3.1.3 до 3.2.0-beta.1​

💥 Критические изменения в нативной рекламе​

Используйте этот руководство для реализации новой логики нативной рекламы.

  • Добавлен класс NativeMediaViewContentType

  • Удален класс MediaAssetType

  • Удален метод из класса Appodeal:

    • Appodeal.setRequiredNativeMediaAssetType

  • Удалены методы из интерфейса NativeAd:

    • NativeAd.getAgeRestrictions
    • NativeAd.getProviderView

  • Следующие классы перемещены в новый пакет com.appodeal.ads.nativead:

    • NativeAdView
    • NativeAdViewAppWall
    • NativeAdViewNewsFeed
    • NativeAdViewContentStream
    • NativeIconView
    • NativeMediaView

  • Методы в классе NativeAdView переименованы следующим образом:

    • NativeAdView.setNativeAd в NativeAdView.registerView
    • NativeAdView.unregisterViewForInteraction в NativeAdView.unregisterView

  • Класс NativeAdType заменен на новый класс NativeMediaViewContentType

  • Методы в классе Appodeal заменены следующим образом:

    • Метод Appodeal.setNativeAdType на Appodeal.setPreferredNativeContentType. Используйте Appodeal.setPreferredNativeContentType для установки предпочтительного типа контента нативной рекламы.
    • Метод Appodeal.getNativeAdType на Appodeal.getPreferredNativeContentType. Используйте Appodeal.getPreferredNativeContentType для получения предпочтительного типа медиа-контента нативной рекламы.

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

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

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

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

Обновление Android SDK C 3.1.3-beta.2 До 3.1.3​

Обновление до версии 3.1.3 не требует дополнительных действий.

Обновление Android SDK C 3.1.3-beta.1 До 3.1.3-beta.2​

Обновление до версии 3.1.3-beta.2 не требует дополнительных действий.

Обновление Android SDK C 3.1.3-alpha.1 До 3.1.3-beta.1​

Обновление до версии 3.1.3-beta.1 не требует дополнительных действий.

Обновление Android SDK C 3.0.2 До 3.1.3-alpha.1​

  • Удалены устаревшие методы. Используйте альтернативную реализацию.
Appodeal.initialize(Activity activity, String appKey, int adTypes, boolean hasConsent);
Appodeal.initialize(Activity activity, String appKey, int adTypes, Consent consent);
Appodeal.initialize(Activity activity, String appKey, int adTypes);
Appodeal.updateConsent(Boolean hasConsent);
Appodeal.disableNetwork(Context context, String network);
Appodeal.setUserGender(Gender gender);
Appodeal.getUserGender();
Appodeal.setUserAge(int age);
Appodeal.getUserAge();

Обновление Android SDK C 3.0.1 До 3.0.2​

Обновление до версии 3.0.2 не требует дополнительных действий.

Обновление Android SDK C 3.0.0 До 3.0.1​

Обновление до версии 3.0.1 не требует дополнительных действий.

Обновление Android SDK С 2.11.1 До 3.0.0​

Appodeal 3.0 совместим со всеми методами из предыдущей версии.

  • Добавлен предпочтительный метод инициализации SDK:
@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    Appodeal.initialize(activity, appKey, adTypes, new ApdInitializationCallback() {
        @Override public void onInitializationFinished(@Nullable List<ApdInitializationError> list) {
            //Appodeal initialization finished
        }
    });
}

  • Другие перегрузки методов Appodeal.initialize() помечены как устаревшие и будут удалены в будущих версиях.

  • Библиотека ConsentManager теперь является частью Appodeal SDK и работает автоматически. Сигнатура методов ConsentManager не изменилась и может использоваться для получения Согласия вручную, но пакет был изменен с com.explorestack.consent на com.appodeal.consent.

  • В будущих выпусках Content Manager станет внутренней частью Appodeal SDK и станет недоступен для использования пользователями.

  • Добавлены общедоступные методы:

Appodeal.initialize(activity, appKey, adTypes, ApdInitializationCallback());
Appodeal.validateInAppPurchase(Context context, InAppPurchase purchase, InAppPurchaseValidateCallback callback);
Appodeal.logEvent(String eventName, Map<String, Object> params);
Appodeal.updateGDPRUserConsent(GDPRUserConsent consent);
Appodeal.updateCCPAUserConsent(CCPAUserConsent consent);
Appodeal.disableNetwork(String network);
  • Устаревшие методы:
Appodeal.initialize(Activity activity, String appKey, int adTypes, boolean hasConsent);
Appodeal.initialize(Activity activity, String appKey, int adTypes, Consent consent);
Appodeal.initialize(Activity activity, String appKey, int adTypes);
Appodeal.updateConsent(Boolean hasConsent);
Appodeal.setTriggerOnLoadedOnPrecache(int adTypes, boolean triggerOnLoadedOnPrecache);
Appodeal.disableNetwork(Context context, String network);
Appodeal.setUserGender(Gender gender);
Appodeal.getUserGender();
Appodeal.setUserAge(int age);
Appodeal.getUserAge();

Обновление Android SDK С 2.11.0 До 2.11.1​

  • Расширены методы в AppodealRequestCallbacks интерфейсе.

Обновление Android SDK С 2.10.3 До 2.11.0​

  • Удалены методы Appodeal.requestAndroidMPermissions(), Appodeal.disableLocationPermissionCheck() и Appodeal.disableWriteExternalStoragePermissionCheck().

  • Методы Appodeal.sharedAdsInstanceAcrossActivities() , Appodeal.isSharedAdsInstanceAcrossActivities() помечены как устаревшие.

Обновление Android SDK С 2.10.2 До 2.10.3​

Обновление до версии 2.10.3 не требует дополнительных действий.

Обновление Android SDK С 2.10.1 До 2.10.2​

  • Минимальная поддерживаемая версия Android SDK поднята до 16 API.

  • Методы Appodeal.requestAndroidMPermissions(), Appodeal.disableLocationPermissionCheck() иAppodeal.disableWriteExternalStoragePermissionCheck() помечены как устаревшие.

Обновление Android SDK С 2.10.0 До 2.10.1​

Обновление до версии 2.10.1 не требует дополнительных действий.

Обновление Android SDK С 2.9.3 До 2.10.0​

Обновление до версии 2.10.0 не требует дополнительных действий.

Обновление Android SDK С 2.9.2 До 2.9.3​

Обновление до версии 2.9.3 не требует дополнительных действий.

Обновление Android SDK С 2.9.1 До 2.9.2​

Обновление до версии 2.9.2 не требует дополнительных действий.

Обновление Android SDK С 2.9.0 До 2.9.1​

Обновление до версии 2.9.1 не требует дополнительных действий.

Обновление Android SDK С 2.8.1 До 2.9.0​

Обновление до версии 2.9.0 не требует дополнительных действий.

Обновление Android SDK 2.8.0 До 2.8.1​

  • Начиная с SDK 2.8.1, Appodeal SDK связывает View рекламу (Banner/MREC) с текущим Activity, передаваемым методу show в Appodeal.

  • Будьте осторожны, при изменении ориентации или переходе к новому Activity View реклама не будет отображаться, так как она будет привязана к предыдущему Activity.

  • Если вы хотите скрыть View рекламу, вам необходимо вызвать метод Appodeal.hide() с параметром Activity, к которой был привязан показ View рекламы.

  • Если вы хотите скрыть показ View рекламы со всех Activity и очистить память, вызовите метод Appodeal.destroy().

  • Новый метод Appodeal.setSharedAdsInstanceAcrossActivities() для использования одного рекламного View (Banner/MREC) для всех Activities. По умолчанию логика отключена. (Подробнее: Использование одного рекламного View для всех Activities)

  • Метод Appodeal.onResume() был удален. Теперь при необходимости вы должны использовать Appodeal.show(). Теперь вы можете вызывать метод Appodeal.show() в вызовах onBannerLoaded/onMrecLoaded, но обратите внимание - если автоматическое кеширование отключено, мы не отслеживаем интервалы показов, и это остается на ваше усмотрение.

Обновление Android SDK С 2.7.3 До 2.8.0​

  • Подготовьте Gradle сборку для Android 11 В Android 11 изменился способ запроса приложений и взаимодействия с другими приложениями, установленными пользователем на устройстве. По этой причине убедитесь, что вы используете версию Gradle, которая соответствует одной из перечисленных здесь.

Обновление Android SDK С 2.7.2 До 2.7.3​

  • Метод Appodeal.setSegmentFilter() помечен как устаревший(deprecated). Если вы используете этот метод, то замените его на Appodeal.setCustomFilter()

Обновление Android SDK С 2.7.1 До 2.7.2​

Начиная с SDK 2.7.2 мы перешли на AndroidX из библиотеки поддержки. Обратите внимание на соответствующий пункт в документации по интеграции .

Обновление Android SDK С 2.7.0 До 2.7.1​

Обновление до версии 2.7.1 не требует дополнительных действий.

Обновление Android SDK С 2.6.x До 2.7.0​

Начиная с версии 2.7.0 вы можете использовать Stack Consent Manager SDK для обработки и передачи согласия пользователя:

  • Новый метод initialize(..., Consent consent) Appodeal SDK с Consent объектом от Stack Consent Manager SDK с текущим согласием пользователя
// NOTE: getConsent() - должен быть вызван после обработки согласия от пользователя
Consent consent = ConsentManager.getInstance(this).getConsent();
Appodeal.initialize(this, "YOUR_APPODEAL_APP_KEY", adTypes, consent);
  • Новый метод updateConsent(Consent consent), чтобы предоставить согласие пользователя GDPR/CCPA для рекламных сетей в Appodeal SDK в любом месте вашего приложения. Appodeal SDK не сохраняет согласие пользователя GDPR/CCPA между сессиями, это означает, что вы должны предоставлять согласие каждый раз, в противном случае Appodeal SDK использует значение по умолчанию или значение сервера.
// NOTE: getConsent() - должен быть вызван после обработки согласия от пользователя
Consent consent = ConsentManager.getInstance(context).getConsent();
Appodeal.updateConsent(consent);

Обновление Android SDK С 2.6.1 До 2.6.2

Обновление до версии 2.6.2 не требует дополнительных действий.

Обновление Android SDK С 2.6.0 До 2.6.1​

Обновление до версии 2.6.1 не требует дополнительных действий.

Обновление Android SDK С 2.5.10 До 2.6.0​

  • Все обратные вызовы теперь имеют соответствующий метод showFailed для каждого типа рекламы, например:
    public interface BannerCallbacks {
        // ... other callbacks

        /**
         * Called when banner show fail
         */
        void onBannerShowFailed();
    }
  • Appodeal.getUserSettigns(...) данный метод с версии 2.6.0 считается устаревшим(deprecated), вместо этого используйте методы:
    /**
     * Set user id
     */
    Appodeal.setUserId(YOUR_USER_ID)

    /**
     * Set user age
     */
    Appodeal.setUserAge(YOUR_USER_AGE)

    /**
     * Set user gender
     */
    Appodeal.setUserGender(YOUR_USER_GENDER)
  • Изменена логика установки значения для ограничения сбора информации в детских приложения(COPPA) . Пожалуйста, посмотрите более детальную информацию здесь.

Обновление Android SDK С 2.5.9 До 2.5.10​

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

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

Обновление до версии 2.5.9 не требует дополнительных действий.

Обновление Android SDK С 2.5.7 До 2.5.8​

  • Интеграция через Скачивание : myTarget, Facebook и Applovin теперь распространяются как AAR вместо JAR

Обновление Android SDK С 2.5.6 До 2.5.7​

Обновление до версии 2.5.7 не требует дополнительных действий.

Обновление Android SDK С 2.5.5 До 2.5.6​

  • Интеграция через Импорт: com.appodeal.optional:picasso:2.5.2 теперь является частью необходимых зависимостей SDK, и вы не должны добавлять ее самостоятельно

Обновление Android SDK С 2.5.4 До 2.5.5​

Обновление до версии 2.5.5 не требует дополнительных действий.

Обновление Android SDK С 2.5.3 До 2.5.4​

Обновление до версии 2.5.4 не требует дополнительных действий.

Обновление Android SDK С 2.5.2 До 2.5.3​

Обновление до версии 2.5.3 не требует дополнительных действий.

Обновление Android SDK С 2.5.1 До 2.5.2​

Обновление до версии 2.5.2 не требует дополнительных действий.

Обновление Android SDK С 2.5.0 До 2.5.1​

Обновление до версии 2.5.1 не требует дополнительных действий.

Обновление Android SDK С 2.4.10 До 2.5.0​

Обновление до версии 2.5.0 не требует дополнительных действий.