Migracja wersji pakietu SDK

Ta strona dotyczy migracji w przypadku bieżącej i poprzednich wersji.

Migracja z wersji 24 do wersji 25

W sekcjach poniżej opisujemy zmiany powodujące niezgodność i różnice w działaniu między wersjami głównymi 24 i 25 pakietu Google Mobile Ads SDK (Legacy).

Minimalny poziom interfejsu API Androida to 24.

Od wersji 25.5.0 pakiet Google Mobile Ads SDK (Legacy) wymaga, aby wszystkie aplikacje działały na Androidzie z interfejsem API na poziomie co najmniej 24. Aby dostosować poziom interfejsu API, zmień wartość minSdk w pliku build.gradle na poziomie aplikacji na 24 lub wyższą.

Usunięto wycofane wywołania zwrotne reklam.

Z tych klas usunięto te wycofane wywołania zwrotne reklam:

Zmiany w interfejsach API rozmiarów zakotwiczonych banerów adaptacyjnych

W wersji 25.0.0 wycofano dotychczasowe interfejsy API do zarządzania rozmiarami zakotwiczonych banerów adaptacyjnych i wprowadzono interfejsy API do zarządzania rozmiarami dużych zakotwiczonych banerów adaptacyjnych. Google Mobile Ads SDK (Legacy) może wyświetlać reklamy wideo w banerach reklamowych, korzystając z nowych interfejsów API do zarządzania dużymi zakotwiczonymi banerami adaptacyjnymi.

W tabeli poniżej znajdziesz wycofane interfejsy API do określania rozmiaru i ich odpowiedniki:

Usunięcie zajęć mediation.VersionInfo

Klasa VersionInfo w pakiecie com.google.android.gms.ads.mediation została usunięta. Zamiast tego użyj pakietu com.google.android.gms.ads.VersionInfo.

Usunięcie metody getConfiguration() w klasie RtbSignalData

Wycofana metoda getConfiguration() interfejsu API w RtbSignalData została usunięta. Zamiast tego użyj metody getConfigurations(), która zwraca listę List<MediationConfiguration>.

Migracja z wersji 23 do wersji 24

W sekcjach poniżej opisujemy zmiany powodujące niezgodność i różnice w działaniu między wersjami głównymi 23 i 24 pakietu Google Mobile Ads SDK (Legacy).

Minimalny poziom interfejsu Android API to 23.

Od wersji 24.0.0 pakiet Google Mobile Ads SDK (Legacy) wymaga, aby wszystkie aplikacje działały na Androidzie z interfejsem API na poziomie co najmniej 23. Aby dostosować poziom interfejsu API, zmień wartość minSdk w pliku build.gradle na poziomie aplikacji na 23 lub wyższą.

Zmiany w zoptymalizowanej inicjalizacji i wczytywaniu

Domyślnie flagi OPTIMIZE_INITIALIZATION i OPTIMIZE_AD_LOADING są ustawione na true. Więcej informacji o tych flagach znajdziesz w artykule o optymalizacji inicjowania i wczytywania.

Usunięto zależności firebase-ads i firebase-ads-lite

Od wersji 24.0.0 pakiety SDK nie zawierają już zależności firebase-ads i firebase-ads-lite. Zamiast tego użyj zależności play-services-ads.

Ustawianie parametrów kierowania niestandardowego

Aby ustawić kierowanie niestandardowe w żądaniu reklamy, użyj addCustomTargeting().

Usunięto wycofane interfejsy API orientacji w przypadku reklam wyświetlanych przy otwarciu aplikacji.

• Usunięto metody AppOpenAd.load(), które akceptują parametr wejściowy orientacji. Zamiast tego używaj metod AppOpenAd.load(), które nie wymagają orientacji.
• Usunięto typ wyliczeniowy AppOpenAdOrientation.

Uproszczone wywołanie zwrotne dotyczące nagrody w przypadku adapterów zapośredniczenia

Wersja 24.0.0 dodaje wywołanie zwrotne onUserEarnedReward() w MediationRewardedAdCallback i wycofuje onUserEarnedReward(RewardItem). Gdy użytkownik zdobędzie nagrodę, adaptery zapośredniczenia muszą zacząć wywoływać metodę onUserEarnedReward().

Podczas przekazywania wywołań zwrotnych z adapterów zapośredniczenia wszystkie wersje Google Mobile Ads SDK (Legacy) zwracają nagrodę zdefiniowaną w interfejsie Ad Managera w obiekcie OnUserEarnedRewardListener.

Usunięto zajęcia

Te klasy zostały usunięte bez zastąpienia:

• DynamicHeightSearchAdRequest
• SearchAdRequest
• SearchAdView

Usunięte metody

Te metody zostały usunięte bez zastąpienia:

Wycofane metody

Te metody zostały wycofane bez zastąpienia:

Migracja z wersji 22 do wersji 23

W sekcjach poniżej opisujemy zmiany powodujące niezgodność i różnice w działaniu między wersjami głównymi 22 i 23 pakietu Google Mobile Ads SDK (Legacy).

Minimalny poziom interfejsu API Androida to 21.

Od wersji 23.0.0 pakiet Google Mobile Ads SDK (Legacy) wymaga, aby wszystkie aplikacje były uruchamiane na Androidzie z interfejsem API na poziomie co najmniej 21. Aby dostosować poziom interfejsu API, zmień wartość minSdkVersion w pliku build.gradle na poziomie aplikacji na 21 lub wyższą.

Metody AdManagerAdRequest.Builder odziedziczone z klasy nadrzędnej można łączyć w łańcuchy

W wersji 23.0.0 metody AdManagerAdRequest.Builder odziedziczone po klasie nadrzędnej można łączyć w łańcuchy, aby utworzyć obiekt AdManagerAdRequest za pomocą jednego wywołania:

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.

Usunięte lub zastąpione wycofane metody

Migracja z wersji 21 do wersji 22

W poniższych sekcjach opisano zmiany powodujące niezgodność i różnice w działaniu między wersjami głównymi 21 i 22 pakietu Google Mobile Ads SDK (Legacy).

Użyj MobileAds.getVersion(), aby uzyskać wersję Google Mobile Ads SDK (Legacy)

Metoda MobileAds.getVersionString() została usunięta w wersji 22.0.0 na rzecz MobileAds.getVersion().

Nowa metoda zwraca oczekiwany numer wersji zewnętrznej, na przykład 22.0.0. Więcej informacji o tej zmianie znajdziesz w artykule Używanie nowej metody getVersion() pakietu SDK do reklam mobilnych Google.

Usunięcie wycofanej metody NativeCustomFormatAd.getVideoMediaView()

W wersji 21 klasa Google Mobile Ads SDK (Legacy) udostępnia metodę NativeCustomFormatAd.getVideoMediaView(), która umożliwia pobranie zasobu multimedialnego na potrzeby niestandardowego formatu reklamy natywnej.

Począwszy od wersji 22, tworzysz własny obiekt MediaView i ustawiasz jego zawartość multimedialną, a następnie używasz metody MediaContent.getVideoController(), aby uzyskać elementy sterujące odtwarzaniem filmu.

// 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());
    }
}

Więcej informacji znajdziesz w przewodniku po niestandardowych reklamach natywnych.

Usunięte lub zastąpione metody

W tabeli poniżej znajdziesz listę konkretnych zmian w wersji 22.0.0:

Migracja z wersji 20 na wersję 21

W sekcjach poniżej opisujemy zmiany powodujące niezgodność i różnice w działaniu między wersjami głównymi 20 i 21 interfejsu Google Mobile Ads SDK (Legacy):

Zaktualizuj minSdkVersion do wersji 19 lub nowszej

Od wersji 21.0.0 Google Mobile Ads SDK (Legacy) wymaga, aby wszystkie aplikacje były na poziomie interfejsu API Androida 19 lub wyższym. Aby dostosować poziom interfejsu API, zmień wartość minSdkVersion w pliku kompilacji aplikacji na 19 lub wyższą.

Wymuszanie rygorystycznej dopuszczalności wartości null

W ramach przygotowań do egzekwowania ścisłej dopuszczalności wartości null we wszystkich interfejsach API, które wcześniej nie definiowały jej jednoznacznie, dodano adnotacje @NonNull.

Ta zmiana może spowodować błędy w aplikacjach Kotlin i aplikacjach, które używają platform sprawdzania wartości null w języku Java, jeśli występują naruszenia bezpieczeństwa wartości null i wcześniej nie obsługiwały wartości null w bezpieczny sposób (zobacz dokumentację Kotlina dotyczącą bezpieczeństwa wartości null).

Usunięcie metody addNetworkExtras()

Metoda addNetworkExtras(), która przekazuje dodatkowe parametry jako instancję NetworkExtras do konkretnego adaptera sieci reklamowej, została wycofana w pakiecie SDK w wersji 20.3.0 i zostanie usunięta w wersji 21.0.0. Zamiast tego użyj metody addNetworkExtrasBundle() z tej samej klasy AdRequest.Builder.

Usunięcie metod lokalizacji

W wersji 21.0.0 zostaną usunięte te metody lokalizacji:

• Metoda setLocation(Location location) w klasie AdRequest.Builder, która ustawia lokalizację użytkownika na potrzeby kierowania zapośredniczenia.
• Metoda getLocation() w klasie AdRequest, która zwraca informacje o kierowaniu na lokalizację użytkownika przekazane wcześniej do metody setLocation(Location location).
• Metoda getLocation() w klasie MediationAdConfiguration, która zwraca lokalizację użytkownika, jeśli jest ona zdefiniowana przez AdRequest.

Google nie używa danych o lokalizacji do kierowania reklam. W razie potrzeby możesz używać interfejsów API innych firm, aby przekazywać informacje do zewnętrznych sieci reklamowych.

Wycofanie interfejsów zdarzeń niestandardowych

Zdarzenia niestandardowe umożliwiają wydawcom korzystającym z zapośredniczenia skonfigurowanie kaskadowego źródła reklam, które nie jest jednym z obsługiwanych źródeł reklam w usłudze Ad Manager.

Wszystkie interfejsy zdarzeń niestandardowych zostały wycofane na rzecz klasy Adapter i interfejsu MediationAdLoadCallback.

W tabeli poniżej znajdziesz odpowiednią klasę lub interfejs, których musisz używać w przypadku każdego interfejsu zdarzenia niestandardowego, począwszy od wersji 21.0.0:

Migracja z wersji 19 do wersji 20

W wersji 20.0.0 wprowadzono wiele zmian powodujących niezgodność. W wersji 19.7.0 wprowadzono wiele nowych interfejsów API oraz wycofano lub zmieniono nazwy wielu klas w ramach przygotowań do wersji 20.0.0. W tym przewodniku opisujemy najważniejsze zmiany w wersji 20.0.0.

Aktualizacje interfejsu API formatu pełnoekranowego

Począwszy od wersji 20.0.0, formaty reklam pełnoekranowych, reklam z nagrodą, reklam pełnoekranowych z nagrodą i reklam wyświetlanych przy otwarciu aplikacji są ustandaryzowane, aby zapewnić spójny interfejs API.

Wszystkie interfejsy API formatów pełnoekranowych korzystają z tych zasad:

• metoda wczytywania statycznego,
• podobny mechanizm wywołania zwrotnego lub obsługi wczytywania.
• Poleganie na klasie FullScreenContentCallback w przypadku wywołań zwrotnych dotyczących prezentacji

Usunięcie starszego interfejsu RewardedVideoAd API

Nowszy interfejs API RewardedAd został wprowadzony w marcu 2019 r. i od ponad 18 miesięcy jest preferowanym interfejsem API do reklam z nagrodą. W porównaniu ze starszym interfejsem API RewardedVideoAd wprowadzono w nim więcej ulepszeń, w tym możliwość wczytywania więcej niż 1 reklamy z nagrodą naraz.

Starsza wersja interfejsu API RewardedVideoAd została usunięta z pakietu SDK w wersji 20.0.0.

Wycofanie banerów inteligentnych na rzecz banerów adaptacyjnych

Banery inteligentne zostały wycofane na rzecz banerów adaptacyjnych. Banery adaptacyjne zapewniają większą skuteczność i elastyczność w ustawianiu szerokości reklamy. Jeśli chcesz nadal używać banerów o pełnej szerokości, możesz to zrobić za pomocą banera adaptacyjnego, jak pokazano w tym fragmencie kodu:

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

Usuwanie wywołania zwrotnego aplikacji Leave

Wywołanie zwrotne onAdLeftApplication dla wszystkich formatów reklam zostało usunięte na rzecz ProcessLifecycleOwner. Korzystanie z interfejsu API na poziomie systemu operacyjnego powoduje, że otrzymujesz powiadomienie za każdym razem, gdy użytkownicy opuszczają aplikację, niezależnie od tego, czy jest to spowodowane interakcją z reklamą.

Pamiętaj, że wywołanie zwrotne onAdLeftApplication nigdy nie miało być modułem obsługi kliknięć reklam, a poleganie na nim w celu raportowania kliknięć nie dawało dokładnych danych. Na przykład kliknięcie ikony Informacja, które spowodowało uruchomienie zewnętrznej przeglądarki, wywołało wywołanie zwrotne, ale nie zostało zliczone jako kliknięcie.

zmiany nazw zajęć,

W tabeli poniżej znajdziesz listę konkretnych nazw klas, które zostały zmienione lub usunięte:

• Większość klas związanych z UnifiedNativeAd została przemianowana na NativeAd.
• Usunięto klasy i widoki MobileAds.Settings, NativeExpressAdView, NativeAppInstallAd, NativeContentAd i InstreamAd.
• Wszystkie klasy z prefiksem Publisher zostały zastąpione prefiksem AdManager.
• Nazwa pakietu InterstitialAd uległa zmianie.

Usunięte lub zastąpione metody

W tabeli poniżej znajdziesz listę konkretnych zmian w wersji 20.0.0:

• Z klasy MobileAds usunięto nieaktualne metody inicjowania.
• Niektóre metody z klasy AdRequest.Builder() zostały usunięte lub przeniesione do klasy RequestConfiguration.
• Interfejsy API RewardedAd i InterstitialAd zostały zaktualizowane, aby były zgodne ze wszystkimi formatami pełnoekranowymi.
• Funkcje korelatora zostały usunięte.