SDK-Migration

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

Von Version 22 zu Version 23 migrieren

Das mindestens erforderliche Android API-Level ist 21

Ab Version 23.0.0 müssen Apps mit dem Google Mobile Ads SDK mindestens auf Android API-Level 21 ausgeführt werden. Wenn Sie das API-Level anpassen möchten, ändern Sie den Wert von minSdkVersion in der Datei build.gradle auf App-Ebene auf 21 oder höher.

Verworfene Methoden entfernt/ersetzt

Von Version 21 zu Version 22 migrieren

Version des Google Mobile Ads SDK mit „MobileAds.getVersion()“ abrufen

Die Methode MobileAds.getVersionString() wurde 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 Die neue getVersion()-Methode des Google Mobile Ads SDK verwenden.

Entfernte oder ersetzte Methoden

In der folgenden Tabelle sind die spezifischen Änderungen in Version 22.0.0 aufgeführt.

Von Version 20 zu Version 21 migrieren

minSdkVersion auf 19 oder höher aktualisieren

Ab Version 21.0.0 müssen alle Apps über das Android API-Level 19 laufen, damit das Google Mobile Ads SDK genutzt werden kann. 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.

Strikte Null-Zulässigkeit erzwingen

Als Vorbereitung auf das Erzwingen einer strikten Null-Zulässigkeit werden @NonNull-Annotationen in allen APIs hinzugefügt, für die die Null-Zulässigkeit zuvor nicht explizit definiert wurde.

Diese Änderung kann die Kotlin-Anwendungen und -Anwendungen beeinträchtigen, die Frameworks für die Nullprüfung mit Java verwenden, wenn es Null-Sicherheitsverstöße gibt und zuvor null-Werte nicht sicher verarbeitet wurden. Weitere Informationen finden Sie in der Kotlin-Dokumentation zu Null-safety.

Entfernung der Methode addNetworkExtras()

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

Standortmethoden wurden entfernt

Die folgenden Ortungsmethoden 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 das Vermittlungs-Targeting festgelegt wird.
• Die Methode getLocation() in der Klasse AdRequest, die 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, wenn dies durch AdRequest definiert ist.

Die Standortdaten werden von Google nicht zur Anzeigenausrichtung verwendet. Verwenden Sie bei Bedarf APIs von Drittanbietern, um die Informationen für Drittanbieter-Werbenetzwerke bereitzustellen.

Benutzerdefinierte Ereignisoberflächen werden eingestellt

Mit benutzerdefinierten Ereignissen können Publisher, die die AdMobVermittlung verwenden, die abfolgebasierte Vermittlung für ein Werbenetzwerk hinzufügen, das nicht zu den unterstützten Werbenetzwerken von AdMobgehört.

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

In der folgenden Tabelle ist die entsprechende Klasse oder Schnittstelle aufgeführt, die ab Version 21.0.0 für jede benutzerdefinierte Ereignisschnittstelle verwendet werden sollte:

Von Version 19 zu Version 20 migrieren

In Version 20.0.0 wurden zahlreiche funktionsgefährdende Änderungen vorgenommen. Mit Version 19.7.0 wurden viele neue APIs eingeführt und zur Vorbereitung auf Version 20.0.0 wurden viele Klassen eingestellt oder umbenannt. In diesem Leitfaden werden die wichtigsten Änderungen in Version 20.0.0 vorgestellt.

Updates der Vollbild-API

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

Alle APIs für das Vollbildformat folgen den folgenden Prinzipien:

• Eine statische Lademethode
• Ein ähnlicher Callback- oder Handler-Mechanismus zum Laden
• Verwendung der Klasse FullScreenContentCallback für Präsentations-Callbacks

Entfernung der alten RewardVideoAd API

Die neue RewardedAd API wurde erstmals im März 2019 eingeführt und ist seit über 18 Monaten die bevorzugte API mit Prämie. Sie wurde im Vergleich zur alten RewardedVideoAd API weiter verbessert, darunter die Möglichkeit, mehrere Anzeigen mit Prämie gleichzeitig zu laden.

Die alte RewardedVideoAd API wurde in SDK-Version 20.0.0 entfernt.

Einstellung von Smart-Bannern zugunsten von adaptiven Bannern

Smart-Banneranzeigen werden durch adaptive Banneranzeigen ersetzt. Adaptive Banner bieten eine hervorragende Leistung und mehr Flexibilität bei der Festlegung der Anzeigenbreite. Wenn Sie weiterhin Banner in voller Breite verwenden möchten, können Sie weiterhin adaptive Banner verwenden, 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 Anwendungs-Callbacks verlassen

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

Der Callback onAdLeftApplication war nie als Handler für Anzeigenklicks vorgesehen. Die Verwendung dieses Callbacks zum Erfassen von Klicks hat zu keinen genauen Messwerten geführt. Beispiel: Ein Klick auf das Datenschutzinfo-Symbol, mit dem ein externer Browser gestartet, aber nicht als Klick gezählt wurde, wurde der Callback aufgerufen.

Klassenumbenennungen

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

• Die meisten Klassen, die sich auf UnifiedNativeAd beziehen, 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 Name des InterstitialAd-Pakets hat sich geändert.

Methoden entfernt/ersetzt

In der folgenden Tabelle sind die spezifischen Änderungen in Version 20.0.0 aufgeführt. 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 für Anzeigen mit Prämie und InterstitialAd wurden aktualisiert, damit sie an alle Vollbildformate angepasst werden.
• Korrelatorfunktionen wurden entfernt.