SDK-Migration

Auf dieser Seite werden Migrationen für die aktuelle und die vorherige Version beschrieben.

Von v22 zu v23 migrieren

Das Mindest-API-Level für Android ist 21

Ab Version 23.0.0 muss das Google Mobile Ads SDK für alle Apps Android API-Level 21 oder höher haben, damit sie ausgeführt werden können. Wenn Sie die API-Ebene anpassen möchten, ändern Sie den Wert von minSdkVersion in der Datei build.gradle auf App-Ebene auf 21 oder höher.

Eingestellte Methoden entfernt/ersetzt

Von v21 zu v22 migrieren

Google Mobile Ads SDK-Version mit MobileAds.getVersion() abrufen

Die Methode MobileAds.getVersionString() wird in Version 22.0.0 zugunsten von MobileAds.getVersion() entfernt.

Die neue Methode gibt die erwartete externe Versionsnummer zurück, z. B. 22.0.0. Weitere Informationen zu dieser Änderung finden Sie unter Neue getVersion()-Methode des Google Mobile Ads SDK verwenden.

Entfernte oder ersetzte Methoden

Die folgende Tabelle enthält die spezifischen Änderungen in Version 22.0.0.

Von Version 20 zu Version 21 migrieren

MinSdkVersion auf 19 oder höher aktualisieren

Ab Version 21.0.0 muss das Google Mobile Ads SDK für alle Apps Android API-Level 19 oder höher haben, damit sie ausgeführt werden können. Wenn Sie das API-Level anpassen möchten, ändern Sie den Wert von minSdkVersion in der Build-Datei Ihrer App auf 19 oder höher.

Strenge Nullbarkeit erzwingen

Als Vorbereitung auf die strikte Null-Zulässigkeit werden @NonNull-Annotationen in allen APIs hinzugefügt, in denen die Null-Zulässigkeit zuvor nicht explizit definiert wurde.

Diese Änderung kann die Kotlin-Apps und -Apps, die Java-Frameworks für die Nullprüfung verwenden, nicht mehr nutzen, wenn keine Sicherheitsverstöße vorliegen und null-Werte zuvor nicht sicher verarbeitet wurden. Weitere Informationen finden Sie in der Kotlin-Dokumentation zur Nullsicherheit.

Entfernung der Methode "addNetworkExtras()"

Die addNetworkExtras()-Methode, die zusätzliche Parameter als NetworkExtras-Instanz an einen bestimmten Anzeigennetzwerkadapter übergibt, wurde in der SDK-Version 20.3.0 eingestellt und wird in Version 21.0.0 entfernt. Verwenden Sie stattdessen die Methode addNetworkExtrasBundle() aus derselben AdRequest.Builder-Klasse.

Entfernung von Standortmethoden

Die folgenden Standortmethoden werden in Version 21.0.0 entfernt:

• Die Methode setLocation(Location location) in der Klasse AdRequest.Builder, mit der der Standort des Nutzers für die Ausrichtung der Vermittlung festgelegt wird.
• Die Methode getLocation() in der Klasse AdRequest, die Informationen zur geografischen Ausrichtung des Nutzers zurückgibt, die zuvor an die Methode setLocation(Location location) übergeben wurden.
• Die Methode getLocation() in der Klasse MediationAdConfiguration, die den Standort des Nutzers zurückgibt, sofern von der AdRequest definiert.

Die Standortdaten werden von Google nicht für das Targeting von Anzeigen verwendet. Verwenden Sie APIs von Drittanbietern, um die Informationen gegebenenfalls an Drittanbieter-Werbenetzwerke zur Verfügung zu stellen.

Einstellung der Benutzeroberflächen für benutzerdefinierte Ereignisse

Mit benutzerdefinierten Ereignissen können Publisher, die dieAdMob Mediation nutzen, eine abfolgebasierte Anzeigenquelle einrichten, die nicht zu den unterstützten Anzeigenquellen von AdMobgehört.

Alle Schnittstellen für benutzerdefinierte Ereignisse wurden zugunsten der Klasse Adapter und der Schnittstelle MediationAdLoadCallback verworfen.

In der folgenden Tabelle sind die entsprechenden Klassen oder Schnittstellen aufgeführt, die ab Version 21.0.0 für jede Schnittstelle für benutzerdefinierte Ereignisse verwendet werden sollten:

Von Version 19 zu Version 20 migrieren

Version 20.0.0 enthält viele Änderungen, die die Kompatibilität beeinträchtigen. In Version 19.7.0 wurden viele neue APIs eingeführt und viele Klassen wurden in Vorbereitung auf Version 20.0.0 eingestellt oder umbenannt. In diesem Leitfaden werden die wichtigsten Änderungen in Version 20.0.0 hervorgehoben.

API-Aktualisierungen für Vollbildformat

Ab Version 20.0.0 sind Interstitial-, Anzeigen mit Prämie, Interstitial-Anzeigen mit Prämie und App-Start-Anzeigen standardisiert, um einem einheitlichen API-Design zu folgen.

Alle Vollbild-APIs basieren auf den folgenden Prinzipien:

• Statische Lademethode
• Einen ähnlichen Lade-Callback oder einen ähnlichen Handler-Mechanismus
• Bei Präsentations-Callbacks auf die Klasse FullScreenContentCallback zurückgreifen

Einstellung der Legacy RewardedVideoAd API

Die neue RewardedAd API wurde im März 2019 eingeführt und ist seit über 18 Monaten die bevorzugte API mit Prämie. Im Vergleich zur alten RewardedVideoAd API wurden mehr Verbesserungen vorgenommen. Unter anderem kann jetzt mehr als eine Anzeige mit Prämie gleichzeitig geladen werden.

Die alte RewardedVideoAd API wird in der SDK-Version 20.0.0 entfernt.

Einstellung von Smart-Bannern durch adaptive Banner

Smart-Banneranzeigen werden eingestellt und durch adaptive Banneranzeigen ersetzt. Adaptive Banner bieten eine bessere Leistung und mehr Flexibilität bei der Einstellung der Anzeigenbreite. Wenn Sie weiterhin Banner in voller Breite verwenden möchten, ist das auch mit adaptiven Bannern möglich, wie im folgenden Code-Snippet gezeigt:

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

Entfernung des Rückrufs für die Anwendung

Der onAdLeftApplication-Callback für alle Anzeigenformate wurde zugunsten von ProcessLifecycleOwner entfernt. Wenn Sie eine API auf Betriebssystemebene verwenden, werden Sie jedes Mal benachrichtigt, wenn Nutzer Ihre App verlassen, unabhängig davon, ob dies auf eine Anzeigeninteraktion zurückzuführen ist oder nicht.

Der onAdLeftApplication-Callback war nie als Handler für Anzeigenklicks gedacht. Wenn Sie diesen Callback zum Melden von Klicks verwendet haben, war der Messwert nicht korrekt. Beispiel: Ein Klick auf das Datenschutzinfo-Symbol, durch den ein externer Browser gestartet wird, hat den Callback aufgerufen, zählt aber nicht als Klick.

Umbenannte Kurse

In der folgenden Tabelle sind bestimmte Klassennamen aufgeführt, die sich geändert oder entfernt haben. Zusammenfassung:

• Die meisten mit UnifiedNativeAd verwandten Kurse wurden in NativeAd umbenannt.
• Die Klassen und Ansichten MobileAds.Settings, NativeExpressAdView, NativeAppInstallAd, NativeContentAd und InstreamAd wurden entfernt.
• Alle Klassen mit dem Präfix Publisher wurden durch das Präfix AdManager ersetzt.
• Der Paketname von InterstitialAd hat sich geändert.

Entfernte/ersetzte Methoden

Die folgende Tabelle enthält die spezifischen Änderungen in Version 20.0.0. Zusammenfassung:

• Veraltete Initialisierungsmethoden wurden aus der MobileAds-Klasse entfernt.
• Einige Methoden aus der Klasse AdRequest.Builder() wurden entweder entfernt oder in die Klasse RequestConfiguration verschoben.
• Die APIs „RewardAd“ und „InterstitialAd“ wurden aktualisiert, damit sie mit allen Vollbildformaten übereinstimmen.
• Korrelatorfunktionen wurden entfernt.