Как перенести версии SDK

На этой странице описан перенос для текущей и предыдущих версий.

Переход с версии 24 на версию 25

В следующих подразделах описаны критические изменения и различия в поведении между основными версиями 24 и 25 Google Mobile Ads SDK (Legacy).

Минимальный уровень Android API – 24.

Начиная с версии 25.5.0, для работы Google Mobile Ads SDK (Legacy) требуется, чтобы все приложения работали на минимальном уровне Android API 24. Чтобы изменить уровень API, задайте для minSdk в файле build.gradle на уровне приложения значение 24 или выше.

Удалены устаревшие обратные вызовы объявлений.

Из перечисленных ниже классов удалены следующие устаревшие обратные вызовы:

Изменения в API размеров фиксированных адаптивных баннеров

В версии 25.0.0 прекращена поддержка существующих API для размеров фиксированных адаптивных баннеров и добавлены API для размеров больших фиксированных адаптивных баннеров. Google Mobile Ads SDK (Legacy) может показывать видеорекламу в баннерах, используя новые API для больших фиксированных адаптивных баннеров.

В таблице ниже перечислены устаревшие API для работы с размерами и их замены.

Удален класс mediation.VersionInfo.

Класс VersionInfo в пакете com.google.android.gms.ads.mediation удален. Вместо этого используйте пакет com.google.android.gms.ads.VersionInfo.

Удален метод getConfiguration() в классе RtbSignalData.

Устаревший метод getConfiguration() API в RtbSignalData удален. Вместо этого используйте метод getConfigurations(), который возвращает список List<MediationConfiguration>.

Переход с версии 23 на версию 24

В следующих подразделах описаны критические изменения и различия в поведении между основными версиями 23 и 24 Google Mobile Ads SDK (Legacy).

Минимальный уровень Android API – 23.

Начиная с версии 24.0.0, для работы Google Mobile Ads SDK (Legacy) требуется, чтобы все приложения работали на Android с минимальным уровнем API 23. Чтобы изменить уровень API, укажите для параметра minSdk в файле build.gradle на уровне приложения значение 23 или выше.

Изменения в оптимизированной инициализации и загрузке

По умолчанию для параметров OPTIMIZE_INITIALIZATION и OPTIMIZE_AD_LOADING задано значение true. Подробнее об этих флагах читайте в статье Оптимизация инициализации и загрузки.

Удалены зависимости firebase-ads и firebase-ads-lite.

Начиная с версии 24.0.0 в выпусках SDK больше не распространяются зависимости firebase-ads и firebase-ads-lite. Используйте вместо нее зависимость play-services-ads.

Как задать параметры таргетинга со специальными настройками

Чтобы задать таргетинг со специальными настройками в запросе объявления, используйте addCustomTargeting().

Удалены устаревшие API ориентации для объявлений при запуске приложения.

• Удалены методы AppOpenAd.load(), которые принимают входной параметр ориентации. Используйте методы AppOpenAd.load(), которые не принимают ориентацию.
• Удалено перечисление AppOpenAdOrientation.

Упрощенный обратный вызов для вознаграждений в адаптерах медиации

В версии 24.0.0 в MediationRewardedAdCallback добавлен обратный вызов onUserEarnedReward(), а onUserEarnedReward(RewardItem) объявлен устаревшим. Адаптеры медиации должны вызывать onUserEarnedReward(), когда пользователь получает вознаграждение.

При переадресации обратных вызовов от адаптеров медиации все версии Google Mobile Ads SDK (Legacy) возвращают вознаграждение, заданное в интерфейсе Менеджера рекламы в OnUserEarnedRewardListener.

Курсы удалены.

Следующие классы были удалены без замены:

• DynamicHeightSearchAdRequest
• SearchAdRequest
• SearchAdView

Способы удалены.

Следующие методы были удалены без замены:

Устаревшие методы

Поддержка следующих методов прекращена без замены:

Переход с версии 22 на версию 23

В следующих подразделах описаны критические изменения и различия в поведении между основными версиями 22 и 23 Google Mobile Ads SDK (Legacy).

Минимальный уровень Android API – 21.

Начиная с версии 23.0.0 для работы Google Mobile Ads SDK (Legacy) требуется, чтобы в приложениях использовался уровень API Android не ниже 21. Чтобы изменить уровень API, задайте для параметра minSdkVersion в файле build.gradle на уровне приложения значение 21 или выше.

AdManagerAdRequest.Builder методов, унаследованных от надкласса, можно объединить в цепочку

В версии 23.0.0 методы AdManagerAdRequest.Builder, унаследованные от родительского класса, можно объединять в цепочки, чтобы создавать объекты AdManagerAdRequest с помощью одного вызова:

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
    .addCustomTargeting("age", "25") // AdManagerAdRequest.Builder method.
    .setContentUrl("https://www.example.com") // Method inherited from parent.
    .build(); // Builds an AdManagerAdRequest.

var request = AdManagerAdRequest.Builder()
  .addCustomTargeting("age", "25") // AdManagerAdRequest.Builder method.
  .setContentUrl("https://www.example.com") // Method inherited from parent.
  .build() // Builds an AdManagerAdRequest.

Удаление или замена устаревших методов

Переход с версии 21 на версию 22

В следующих подразделах описаны критические изменения и различия в поведении между основными версиями 21 и 22 Google Mobile Ads SDK (Legacy).

Чтобы получить версию Google Mobile Ads SDK (Legacy), используйте MobileAds.getVersion().

Метод MobileAds.getVersionString() удален в версии 22.0.0. Вместо него используйте MobileAds.getVersion().

Новый метод возвращает ожидаемый номер внешней версии, например 22.0.0. Подробную информацию об этом изменении вы найдете в статье Использование нового метода Google Mobile Ads SDK getVersion().

Удаление устаревшего метода NativeCustomFormatAd.getVideoMediaView()

В версии 21 класс Google Mobile Ads SDK (Legacy) предоставлял метод NativeCustomFormatAd.getVideoMediaView(), позволяющий получить медиаобъект для собственного формата нативного объявления.

Начиная с версии 22, вы создаете собственный объект MediaView, задаете его медиаконтент и используете MediaContent.getVideoController(), чтобы получить элементы управления видео.

// Called when a custom native ad loads.
@Override
public void onCustomFormatAdLoaded(NativeCustomFormatAd ad) {
    // Assumes you have a FrameLayout in your view hierarchy with the ID media_placeholder.
    FrameLayout mediaPlaceholder = (FrameLayout) findViewById(R.id.media_placeholder);

    MediaContent mediaContent = ad.getMediaContent();
    if (mediaContent != null && mediaContent.hasVideoContent()) {
        // Create a MediaView and set its media content.
        MediaView mediaView = new MediaView(mediaPlaceholder.getContext());
        mediaView.setMediaContent(mediaContent);
        mediaPlaceholder.addView(mediaView);
    }
}

// Called when a custom native ad loads.
@Override
public void onCustomFormatAdLoaded(NativeCustomFormatAd ad) {
    // Assumes you have a FrameLayout in your view hierarchy with the ID media_placeholder.
    FrameLayout mediaPlaceholder = (FrameLayout) findViewById(R.id.media_placeholder);

    VideoController videoController = ad.getVideoController();
    if (videoController.hasVideoContent()) {
        // Add the media view provided by the native ad.
        mediaPlaceholder.addView(ad.getVideoMediaView());
    }
}

Подробную информацию вы найдете в руководстве по специальным нативным объявлениям.

Удаленные или замененные методы

В таблице ниже перечислены изменения в версии 22.0.0.

Переход с версии 20 на версию 21

В следующих подразделах описаны критические изменения и различия в поведении между основными версиями 20 и 21 Google Mobile Ads SDK (Legacy).

Обновите minSdkVersion до версии 19 или выше

Начиная с версии 21.0.0 для работы Google Mobile Ads SDK (Legacy) требуется, чтобы все приложения использовали Android API уровня 19 или выше. Чтобы изменить уровень API, укажите значение minSdkVersion в файле сборки приложения, равное 19 или выше.

Принудительно использовать строгую допустимость значения NULL

Чтобы обеспечить строгое соблюдение допустимости значения NULL, во все API, в которых ранее не была явно определена допустимость значения NULL, добавляются аннотации @NonNull.

Это изменение может нарушить работу приложений Kotlin и приложений, использующих фреймворки проверки значений null в Java, если в них есть нарушения безопасности null и ранее не обрабатывались значения null (см. документацию Kotlin по безопасности null).

Удаление метода addNetworkExtras()

Метод addNetworkExtras(), который передает дополнительные параметры в виде экземпляра NetworkExtras определенному адаптеру рекламной сети, был объявлен устаревшим в SDK версии 20.3.0 и будет удален в версии 21.0.0. Вместо него используйте метод addNetworkExtrasBundle() из того же класса AdRequest.Builder.

Удаление методов определения местоположения

В версии 21.0.0 будут удалены следующие методы:

• Метод setLocation(Location location) в классе AdRequest.Builder, который задает местоположение пользователя для таргетинга медиации.
• Метод getLocation() в классе AdRequest, который возвращает информацию о геотаргетинге, ранее переданную методу setLocation(Location location).
• Метод getLocation() в классе MediationAdConfiguration, который возвращает местоположение пользователя, если оно определено в AdRequest.

Google не использует данные о местоположении для таргетинга рекламы. При необходимости вы можете использовать сторонние API, чтобы передавать информацию сторонним рекламным сетям.

Прекращение поддержки интерфейсов специальных событий

Специальные события позволяют издателям, использующим медиацию, настроить источник объявлений в каскаде, который не входит в число поддерживаемых источников объявлений Менеджера рекламы.

Все интерфейсы специальных событий заменены классом Adapter и интерфейсом MediationAdLoadCallback.

В таблице ниже перечислены классы и интерфейсы, которые нужно использовать для каждого интерфейса пользовательского события, начиная с версии 21.0.0.

Переход с версии 19 на версию 20

В версии 20.0.0 много критических изменений. В версии 19.7.0 появилось много новых API, а также были переименованы или объявлены устаревшими многие классы. Это было сделано в рамках подготовки к выпуску версии 20.0.0. В этом руководстве описаны основные изменения в версии 20.0.0.

Обновления API для полноэкранных форматов

Начиная с версии 20.0.0 межстраничные объявления, объявления с вознаграждением, межстраничные объявления с вознаграждением и объявления при запуске приложения стандартизированы в соответствии с единым дизайном API.

Все API для полноэкранных форматов работают по следующим принципам:

• Статический метод загрузки
• Аналогичный механизм обратного вызова или обработчика загрузки.
• Использование класса FullScreenContentCallback для обратных вызовов показа

Удаление устаревшего API RewardedVideoAd

Новый API RewardedAd был представлен в марте 2019 года и уже более 18 месяцев является предпочтительным API для объявлений с вознаграждением. Он имеет больше улучшений по сравнению с устаревшим API RewardedVideoAd, включая возможность загружать более одного объявления с вознаграждением за раз.

Устаревший API RewardedVideoAd удален из SDK версии 20.0.0.

Прекращение поддержки смарт-баннеров в пользу адаптивных баннеров

Смарт-баннеры больше не поддерживаются. Вместо них рекомендуется использовать адаптивные баннеры. Адаптивные баннеры более эффективны и позволяют гибко настраивать ширину объявлений. Если вы хотите и дальше использовать баннеры во всю ширину экрана, это можно сделать с помощью адаптивных баннеров, как показано в следующем фрагменте кода:

public class MyActivity extends AppCompatActivity {
  ...
  private AdSize getFullWidthAdaptiveSize() {
    Display display = getWindowManager().getDefaultDisplay();
    DisplayMetrics outMetrics = new DisplayMetrics();
    display.getMetrics(outMetrics);

    float widthPixels = outMetrics.widthPixels;
    float density = outMetrics.density;

    int adWidth = (int) (widthPixels / density);
    return AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(this, adWidth);
  }
}

class MyActivity : AppCompatActivity() {
  ...
  private val adaptiveAdSize: AdSize
    get() {
      val display = windowManager.defaultDisplay
      val outMetrics = DisplayMetrics()
      display.getMetrics(outMetrics)

      val density = outMetrics.density

      var adWidthPixels = ad_view_container.width.toFloat()
      if (adWidthPixels == 0f) {
        adWidthPixels = outMetrics.widthPixels.toFloat()
      }

      val adWidth = (adWidthPixels / density).toInt()
      return AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(this, adWidth)
    }
}

Удаление обратного вызова при выходе из приложения

Обратный вызов onAdLeftApplication для всех форматов объявлений удален. Вместо него используется ProcessLifecycleOwner. При использовании API на уровне ОС вы будете получать уведомления каждый раз, когда пользователи покидают ваше приложение, независимо от того, связано ли это с взаимодействием с объявлением.

Обратите внимание, что обратный вызов onAdLeftApplication не предназначен для обработки кликов по объявлениям, и его использование для регистрации кликов не позволяет получить точные данные. Например, нажатие на значок "Выбор рекламы", которое запускает внешний браузер, вызывает обратный вызов, но не считается кликом.

Переименование классов

В таблице ниже перечислены названия классов, которые были изменены или удалены.

• Большинство классов, связанных с UnifiedNativeAd, переименованы в NativeAd.
• Классы и представления MobileAds.Settings, NativeExpressAdView, NativeAppInstallAd, NativeContentAd и InstreamAd удалены.
• Все классы с префиксом Publisher заменены на классы с префиксом AdManager.
• Название пакета InterstitialAd изменилось.

Удаленные или замененные методы

В таблице ниже перечислены изменения, внесенные в версию 20.0.0.

• Из класса MobileAds удалены устаревшие методы инициализации.
• Некоторые методы из класса AdRequest.Builder() были удалены или перенесены в класс RequestConfiguration.
• API RewardedAd и InterstitialAd были обновлены для поддержки всех полноэкранных форматов.
• Функции коррелятора удалены.