Migracja pakietów SDK

Ta strona zawiera informacje na temat migracji obecnej i poprzednich wersji.

Migracja z wersji 22 do wersji 23

Minimalny poziom interfejsu API Androida to 21.

Od wersji 23.0.0 pakiet SDK do reklam mobilnych Google wymaga, aby wszystkie aplikacje korzystały z interfejsu API Androida na poziomie 21. Aby dostosować poziom interfejsu API, zmień wartość minSdkVersion w pliku build.gradle na poziomie aplikacji na 21 lub wyższą.

Wycofane metody zostały usunięte/zastąpione

Migracja z wersji 21 do wersji 22

Użyj funkcji MobileAds.getVersion(), aby uzyskać wersję pakietu SDK do reklam mobilnych Google

W wersji 22.0.0 metoda MobileAds.getVersionString() została usunięta 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życie nowej metody getVersion() w pakiecie SDK do reklam mobilnych Google.

Usunięte lub zastąpione metody

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

Migracja z wersji 20 do wersji 21

Zaktualizuj parametr minSdkVersion do wersji 19 lub nowszej

Od wersji 21.0.0 pakiet SDK do reklam mobilnych Google wymaga, aby wszystkie aplikacje korzystały z interfejsu API Androida na poziomie 19. Aby dostosować poziom interfejsu API, zmień wartość minSdkVersion w pliku kompilacji aplikacji na 19 lub wyższą.

Egzekwuj ścisłą dopuszczalność wartości null

W ramach przygotowań do wymuszania ścisłej dopuszczalności wartości null do wszystkich interfejsów API, które wcześniej nie definiowały jednoznacznie wartości null, dodawane są adnotacje @NonNull.

Ta zmiana może zakłócić działanie aplikacji i aplikacji Kotlin, które korzystają z platformy sprawdzania null w języku Java, jeśli wystąpiły zerowe naruszenia bezpieczeństwa, a wartości null nie były wcześniej obsługiwane w bezpieczny sposób (zapoznaj się z dokumentacją Kotlin na temat Null-safety).

Usunięto metodę addNetworkExtras()

Metoda addNetworkExtras(), która przekazuje dodatkowe parametry jako wystąpienie NetworkExtras do określonego adaptera sieci reklamowej, została wycofana z pakietu SDK w wersji 20.3.0, a w wersji 21.0.0 zostanie usunięta. Użyj metody addNetworkExtrasBundle() z tej samej klasy AdRequest.Builder.

Usuwanie metod lokalizacji

Te metody lokalizacji zostaną usunięte w wersji 21.0.0:

• Metoda setLocation(Location location) w klasie AdRequest.Builder, która ustawia lokalizację użytkownika na potrzeby kierowania w ramach 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 została zdefiniowana w zasadzie AdRequest.

Google nie używa danych o lokalizacji do kierowania reklam. Do przekazania danych do zewnętrznych sieci reklamowych należy w razie potrzeby użyć interfejsów API innych firm.

Wycofanie interfejsów zdarzeń niestandardowych

Zdarzenia niestandardowe umożliwiają wydawcom korzystanie zzapośredniczenia do konfigurowania kaskadowego źródła reklam, które nie jest jednym z obsługiwanych przez AdMobźródeł reklam.

Wszystkie interfejsy zdarzeń niestandardowych zostały wycofane i zastąpione klasą Adapter oraz interfejsem MediationAdLoadCallback.

Tabela poniżej zawiera listę odpowiednich klas lub interfejsów, których należy używać w przypadku każdego interfejsu zdarzeń niestandardowych, począwszy od wersji 21.0.0:

Migracja z wersji 19 do wersji 20

W wersji 20.0.0 wprowadziliśmy wiele zmian powodujących niezgodność. W wersji 19.7.0 wprowadziliśmy wiele nowych interfejsów API i w ramach przygotowań do wersji 20.0.0 wycofaliśmy lub zmieniła nazwę wielu klas. W tym przewodniku opisujemy główne zmiany wprowadzone w wersji 20.0.0.

Aktualizacje interfejsu API formatu pełnoekranowego

Od wersji 20.0.0 formaty reklam pełnoekranowych, reklam z nagrodą i reklam z nagrodą oraz reklam wyświetlanych przy otwarciu aplikacji są ustandaryzowane tak, aby były zgodne z spójnym interfejsem API.

Wszystkie interfejsy API w formacie pełnoekranowym opierają się na tych zasadach:

• Metoda wczytywania statycznego
• Podobny mechanizm wywołania zwrotnego lub obsługi wczytywania
• Używanie klasy FullScreenContentCallback w przypadku wywołań zwrotnych prezentacji

Usunięcie starszej wersji interfejsu Nagrody VideoAd API

Nowszy interfejs API RewardedAd został po raz pierwszy wprowadzony w marcu 2019 roku i od ponad 18 miesięcy jest preferowanym interfejsem YouTube z nagrodą. W porównaniu do starszej wersji interfejsu API RewardedVideoAd zawiera on więcej ulepszeń, w tym możliwość wczytywania więcej niż 1 reklamy z nagrodą jednocześnie.

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

Wycofanie banerów inteligentnych i zastąpienie banerem adaptacyjnym

Banery inteligentne zostały wycofane i zastąpione banerami adaptacyjnymi. Banery adaptacyjne mają wysoką skuteczność i dają większą elastyczność w ustawianiu szerokości reklamy. Jeśli nadal chcesz używać banerów o pełnej szerokości, możesz to zrobić za pomocą banerów adaptacyjnych, 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)
    }
}

Opuść usuwanie wywołania zwrotnego aplikacji

Wywołanie zwrotne onAdLeftApplication dla wszystkich formatów reklam zostało usunięte i zastąpione ProcessLifecycleOwner. Korzystanie z interfejsu API na poziomie systemu operacyjnego powiadomi Cię za każdym razem, gdy użytkownik opuści 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 do obsługi kliknięć reklamy, a wykorzystanie tego wywołania zwrotnego do raportowania kliknięć nie pozwoliło uzyskać dokładnych danych. Na przykład kliknięcie ikony Informacja, które uruchomiło przeglądarkę zewnętrzną, wywołuje wywołanie zwrotne, ale nie jest liczone jako kliknięcie.

Zmiana nazw zajęć

W tabeli poniżej znajdziesz nazwy konkretnych klas, które zostały zmienione lub usunięte. Podsumowując:

• Większość zajęć związanych z UnifiedNativeAd została zmieniona na NativeAd.
• Klasy i widoki MobileAds.Settings, NativeExpressAdView, NativeAppInstallAd, NativeContentAd oraz InstreamAd zostały usunięte.
• Wszystkie klasy z prefiksem Publisher zostały zastąpione prefiksem AdManager.
• Nazwa pakietu InterstitialAd uległa zmianie.

Metody usunięte/zastąpione

W tabeli poniżej znajdziesz listę konkretnych zmian wprowadzonych w wersji 20.0.0. W skrócie:

• Nieaktualne metody inicjowania zostały usunięte z klasy MobileAds.
• Niektóre metody z klasy AdRequest.Builder() zostały usunięte lub przeniesione do klasy RequestConfiguration.
• Interfejsy API reklam z nagrodą i pełnoekranowych reklam zostały zaktualizowane, aby zapewnić zgodność ze wszystkimi formatami pełnoekranowymi.
• Funkcje korelatora zostały usunięte.