Migracja pakietów SDK

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

Migracja z wersji 22 na wersję 23

Minimalny poziom interfejsu API Androida to 21.

Od wersji 23.0.0 pakiet SDK do reklam mobilnych Google wymaga, aby wszystkie aplikacje działały na co najmniej Androidzie API 21. Aby dostosować poziom interfejsu API, zmień wartość elementu minSdkVersion w pliku build.gradle na poziomie aplikacji na 21 lub wyższy.

Metody AdManagerAdRequest.Builder dziedziczone z superklasy mogą być łączone.

W wersji 23.0.0 metody odziedziczone od rodzica AdManagerAdRequest.Builder mogą być łączone ze sobą, aby tworzyć AdManagerAdRequest za pomocą pojedynczego 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ęcie i zastąpienie wycofanych metod

Migracja z wersji 21 na wersję 22

Uzyskiwanie wersji pakietu SDK do reklam mobilnych Google za pomocą metody MobileAds.getVersion()

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

Nowa metoda zwraca oczekiwany zewnętrzny numer wersji, np. 22.0.0. Więcej informacji o tej zmianie znajdziesz w artykule Korzystanie z nowej metody getVersion() pakietu SDK do reklam mobilnych Google.

Usunięcie wycofanej metody NativeCustomFormatAd.getVideoMediaView()

W wersji 21 pakietu SDK do reklam mobilnych Google udostępniliśmy metodę NativeCustomFormatAd.getVideoMediaView(), która umożliwia pobieranie zasobu multimedialnego w przypadku natywnego formatu reklamy niestandardowej.

Od wersji 22 możesz tworzyć własne MediaView i ustawiać ich zawartość multimedialną, a także korzystać z MediaContent.getVideoController(), aby uzyskać kontrolę nad filmem.

// 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 dotyczącym niestandardowych reklam natywnych.

Usuwane lub zastępowane metody

Tabela poniżej zawiera listę zmian w wersji 22.0.0.

Migracja z wersji 20 na wersję 21

Zaktualizuj parametr minSdkVersion do wersji 19 lub nowszej.

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

Wymuś ścisłe użycie wartości null

W ramach przygotowań do wymuszania ścisłej możliwości wystąpienia do wszystkich interfejsów API, które wcześniej nie definiowały w prosty sposób możliwości wystąpienia, dodano adnotacje @NonNull.

Ta zmiana może spowodować nieprawidłowe działanie aplikacji w Kotlinie i aplikacji, które korzystają z ramek sprawdzania wartości null w Java, jeśli wystąpią naruszenia zasad bezpieczeństwa null, a wartości null nie były wcześniej obsługiwane w bezpieczny sposób (patrz dokumentacja Kotlina na temat bezpieczeństwa null).

Usunięcie metody addNetworkExtras()

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

Usuwanie metod lokalizacji

W wersji 21.0.0 zostaną usunięte te metody określania 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 metodzie setLocation(Location location).
• Metoda getLocation() w klasie MediationAdConfiguration, która zwraca lokalizację użytkownika, jeśli została zdefiniowana przez AdRequest.

Dane o lokalizacji nie są używane przez Google do kierowania reklam. W razie potrzeby należy 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  skonfigurowanie kaskadowego źródła reklam, które nie jest Ad Managerjednym z obsługiwanych źródeł reklam.

Wszystkie interfejsy custom event są wycofywane na rzecz interfejsów Adapter class i MediationAdLoadCallback interface.

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

Migracja z wersji 19 na wersję 20

W wersji 20.0.0 jest wiele zmian powodujących niezgodność. W wersji 19.7.0 udostępniliśmy wiele nowych interfejsów API oraz wycofaliśmy lub zmieniliśmy nazwy wielu klas w ramach przygotowań do wersji 20.0.0. Ten przewodnik zawiera 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ą standaryzowane, aby zachować spójność interfejsu API.

Wszystkie interfejsy API formatu pełnoekranowego działają zgodnie z tymi zasadami:

• Metoda wczytywania statycznego
• podobny mechanizm wywołania ładowania lub mechanizm obsługi;
• Używanie klasy FullScreenContentCallback do wywołań zwrotnych dotyczących prezentacji

Usunięcie starszego interfejsu API RewardedVideoAd

Nowy interfejs RewardedAd API został wprowadzony w marcu 2019 r. i od ponad 18 miesięcy jest preferowanym interfejsem API do wyświetlania reklam z nagrodą. Wprowadziliśmy w nim więcej ulepszeń w porównaniu z starszą wersją interfejsu API RewardedVideoAd, m.in. możliwość wczytania więcej niż 1 reklamy z nagrodą naraz.

Stary interfejs API RewardedVideoAd został usunięty z pakietu SDK w wersji 20.0.0.

wycofanie banerów inteligentnych na rzecz banerów adaptacyjnych

Inteligentne banery zostały wycofane na rzecz adaptacyjnych banerów. Banery adaptacyjne zapewniają większą skuteczność i większą elastyczność w ustalaniu szerokości reklamy. Jeśli wolisz nadal używać banerów o pełnej szerokości, możesz to zrobić, korzystając z 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)
    }
}

Leave application callback removal

W przypadku wszystkich formatów reklam został usunięty wywołanie zwrotne onAdLeftApplication na rzecz wywołania zwrotnego ProcessLifecycleOwner. Korzystanie z interfejsu API na poziomie systemu operacyjnego powoduje, że otrzymujesz powiadomienia o każdej próbie opuszczenia aplikacji przez użytkowników, niezależnie od tego, czy jest ona spowodowana interakcją z reklamą.

Pamiętaj, że funkcja wywołania zwrotnego onAdLeftApplication nigdy nie miała być elementem obsługi kliknięcia reklamy, a używanie jej do zgłaszania kliknięć nie powoduje gromadzenia 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.

Zmiana nazwy zajęć

Tabela poniżej zawiera listę nazw klas, które zostały zmienione lub usunięte. Podsumowując:

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

Metody usunięte/zastąpione

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

• Z klasy MobileAds zostały usunięte przestarzałe metody inicjowania.
• Niektóre metody z klasy AdRequest.Builder() zostały usunięte lub przeniesione do klasy RequestConfiguration.
• Interfejsy API reklam z nagrodą i reklam pełnoekranowych zostały zaktualizowane, aby pasowały do wszystkich formatów pełnoekranowych.
• Funkcje korelacji zostały usunięte.