SDK-Migration

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

Von Version 22 zu Version 23 migrieren

Das Mindest-Android-API-Level ist 21.

Ab Version 23.0.0 des Google Mobile Ads SDK müssen alle Apps mindestens Android API-Level 21 unterstützen, um ausgeführt werden zu 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 Version 21 zu Version 22 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

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

Von Version 20 zu Version 21 migrieren

Aktualisieren Sie „minSdkVersion“ auf 19 oder höher.

Ab Version 21.0.0 muss für das Google Mobile Ads SDK in allen Apps mindestens Android API-Level 19 verwendet werden. Wenn Sie die API-Ebene anpassen möchten, ändern Sie den Wert von minSdkVersion in der Build-Datei Ihrer App auf mindestens 19.

Strenge Nullbarkeit erzwingen

Zur Vorbereitung auf die Erzwingung der strikten Nullbarkeit werden in allen APIs, in denen die Nullbarkeit bisher nicht explizit definiert wurde, @NonNull-Anmerkungen hinzugefügt.

Diese Änderung kann dazu führen, dass Kotlin-Apps und Apps, die Java-Null-Prüfungs-Frameworks verwenden, nicht mehr funktionieren, wenn es Verstöße gegen die Null-Sicherheit gibt und null-Werte zuvor nicht sicher verarbeitet wurden (siehe Kotlin-Dokumentation zur Null-Sicherheit).

Entfernung der Methode „addNetworkExtras()“

Die addNetworkExtras()-Methode, mit der zusätzliche Parameter als NetworkExtras-Instanz an einen bestimmten Anzeigennetzwerkadapter übergeben werden, 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 Standortermittlungsmethoden 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 die Informationen zum Standorttargeting 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. Sie sollten Drittanbieter-APIs verwenden, um die Informationen bei Bedarf an Werbenetzwerke von Drittanbietern weiterzugeben.

Einstellung der Benutzeroberflächen für benutzerdefinierte Ereignisse

Mit benutzerdefinierten Ereignissen können Publisher, die die AdMob-Vermittlung AdMobverwenden, eine abfolgebasierte Anzeigenquelle einrichten, die nicht zu den unterstützten Anzeigenquellen von AdMobgehört.

Alle Benutzerdefinierten Ereignisschnittstellen werden zugunsten der Adapter-Klasse und der MediationAdLoadCallback-Schnittstelle eingestellt.

In der folgenden Tabelle sind die entsprechenden Klassen oder Schnittstellen aufgeführt, die ab Version 21.0.0 für jede benutzerdefinierte Ereignisschnittstelle 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.

Für alle APIs für Vollbildformate gelten die folgenden Prinzipien:

• Statische Lademethode
• Einen ähnlichen Ladeb callback oder Handlermechanismus
• Verwendung der Klasse FullScreenContentCallback für Callbacks für Präsentationen

Einstellung der Legacy RewardedVideoAd API

Die neuere RewardedAd API wurde bereits im März 2019 eingeführt und ist seit über 18 Monaten die bevorzugte API für Anzeigen mit Prämie. Sie wurde im Vergleich zur bisherigen RewardedVideoAd API weiter optimiert. So können jetzt beispielsweise mehrere Anzeigen mit Prämie gleichzeitig geladen werden.

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

Einstellung von Smart-Bannern zugunsten adaptiver Banner

Smart-Banner-Anzeigen werden zugunsten von adaptiven Banneranzeigen eingestellt. 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 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. Ein Klick auf das Symbol „Datenschutzinfo“, durch den ein externer Browser geöffnet wird, löst beispielsweise den Callback aus, wird aber nicht als Klick gezählt.

Umbenannte Kurse

In der folgenden Tabelle sind bestimmte Klassennamen aufgeführt, die sich geändert oder entfernt haben. 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 Paketname von InterstitialAd hat sich geändert.

Entfernte/ersetzte Methoden

In der folgenden Tabelle sind die Ä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 „RewardedAd“ und „InterstitialAd“ wurden aktualisiert, um sie an alle Vollbildformate anzupassen.
• Korrelationsfunktionen wurden entfernt.