SDK-Versionen migrieren

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

Von v24 zu v25 migrieren

In den folgenden Abschnitten werden funktionsgefährdende Änderungen und Verhaltensunterschiede zwischen den Hauptversionen 24 und 25 von Google Mobile Ads SDK (Legacy) beschrieben.

Das Mindest-Android-API-Level ist 24.

Ab Version 25.5.0 müssen alle Apps, die Google Mobile Ads SDK (Legacy) verwenden, auf einem Gerät mit mindestens Android API-Level 24 ausgeführt werden. Wenn Sie das API-Level anpassen möchten, ändern Sie den Wert minSdk in der Datei build.gradle auf App-Ebene in 24 oder höher.

Veraltete Anzeigen-Callbacks wurden entfernt.

Die folgenden verworfenen Anzeigen-Callbacks wurden aus den folgenden Klassen entfernt:

Änderungen an den APIs für die Größe adaptiver Ankerbanner

In Version 25.0.0 werden die vorhandenen APIs für die Größe adaptiver Ankerbanner eingestellt und APIs für die Größe großer adaptiver Ankerbanneranzeigen eingeführt. Google Mobile Ads SDK (Legacy) kann die Videonachfrage für Banneranzeigen über die neuen APIs für große adaptive Ankerbanner bedienen.

In der folgenden Tabelle sind die eingestellten Größen-APIs und ihre Ersatz-APIs aufgeführt:

Klasse mediation.VersionInfo wurde entfernt.

Die Klasse „VersionInfo“ im Paket com.google.android.gms.ads.mediation wurde entfernt. Verwenden Sie stattdessen das Paket com.google.android.gms.ads.VersionInfo.

Entfernung der Methode getConfiguration() in der Klasse RtbSignalData

Die verworfene Methode getConfiguration() API in RtbSignalData wurde entfernt. Verwenden Sie stattdessen die Methode getConfigurations(), die eine List<MediationConfiguration>-Liste zurückgibt.

Von v23 zu v24 migrieren

In den folgenden Abschnitten werden funktionsgefährdende Änderungen und Verhaltensunterschiede zwischen den Hauptversionen 23 und 24 von Google Mobile Ads SDK (Legacy) beschrieben.

Das Mindest-Android-API-Level ist 23.

Ab Version 24.0.0 müssen alle Apps, die Google Mobile Ads SDK (Legacy) verwenden, auf einem Gerät mit mindestens Android API-Level 23 ausgeführt werden. Wenn Sie das API-Level anpassen möchten, ändern Sie den Wert von minSdk in der Datei build.gradle auf App-Ebene auf 23 oder höher.

Änderungen an der optimierten Initialisierung und am optimierten Laden

Standardmäßig sind die Flags OPTIMIZE_INITIALIZATION und OPTIMIZE_AD_LOADING auf true gesetzt. Weitere Informationen zu diesen Flags finden Sie unter Initialisierung und Laden optimieren.

Die Abhängigkeiten „firebase-ads“ und „firebase-ads-lite“ wurden entfernt.

Ab Version 24.0.0 werden die Abhängigkeiten firebase-ads und firebase-ads-lite nicht mehr in SDK-Releases bereitgestellt. Verwenden Sie stattdessen die Abhängigkeit play-services-ads.

Benutzerdefinierte Targeting-Parameter festlegen

Verwenden Sie addCustomTargeting(), um benutzerdefiniertes Targeting für eine Anzeigenanfrage festzulegen.

Verworfene Ausrichtungs-APIs für App-Start-Anzeigen entfernt

• AppOpenAd.load()-Methoden entfernt, die einen Eingabeparameter für die Ausrichtung akzeptieren. Verwenden Sie stattdessen AppOpenAd.load()-Methoden, die keine Ausrichtung erfordern.
• Enum AppOpenAdOrientation entfernt.

Vereinfachter Callback zur Freigabe der Prämie für Vermittlungsadapter

In Version 24.0.0 wird der Callback onUserEarnedReward() in MediationRewardedAdCallback hinzugefügt und onUserEarnedReward(RewardItem) wird verworfen. Vermittlungsadapter müssen onUserEarnedReward() aufrufen, wenn der Nutzer eine Prämie erhält.

Wenn Callbacks von Vermittlungsadaptern weitergeleitet werden, geben alle Google Mobile Ads SDK (Legacy)-Versionen die in der Ad Manager-Benutzeroberfläche in OnUserEarnedRewardListener definierte Prämie zurück.

Kurse entfernt

Die folgenden Klassen wurden ohne Ersatz entfernt:

• DynamicHeightSearchAdRequest
• SearchAdRequest
• SearchAdView

Entfernte Methoden

Die folgenden Methoden wurden ohne Ersatz entfernt:

Eingestellte Methoden

Die folgenden Methoden werden ohne Ersatz eingestellt:

Von v22 zu v23 migrieren

In den folgenden Abschnitten werden funktionsgefährdende Änderungen und Verhaltensunterschiede zwischen den Hauptversionen 22 und 23 von Google Mobile Ads SDK (Legacy) beschrieben.

Das Mindest-Android-API-Level ist 21.

Ab Version 23.0.0 müssen alle Apps mindestens auf Android API-Level 21 ausgerichtet sein, damit Google Mobile Ads SDK (Legacy) ausgeführt werden kann. 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.

AdManagerAdRequest.Builder Methoden, die von der Basisklasse übernommen wurden, können verkettet werden

In Version 23.0.0 können AdManagerAdRequest.Builder-Methoden, die von der übergeordneten Klasse übernommen wurden, miteinander verkettet werden, um mit einem einzigen Aufruf ein AdManagerAdRequest zu erstellen:

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.

Veraltete Methoden entfernt/ersetzt

Von v21 zu v22 migrieren

In den folgenden Abschnitten werden funktionsgefährdende Änderungen und Verhaltensunterschiede zwischen den Hauptversionen 21 und 22 von Google Mobile Ads SDK (Legacy) beschrieben.

Verwenden Sie MobileAds.getVersion(), um die Google Mobile Ads SDK (Legacy)-Version abzurufen.

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 Neue Google Mobile Ads SDK-Methode getVersion() verwenden.

Entfernen der verworfenen Methode „NativeCustomFormatAd.getVideoMediaView()“

In Version 21 wurde mit Google Mobile Ads SDK (Legacy) die Methode NativeCustomFormatAd.getVideoMediaView() eingeführt, um das Media-Asset für ein benutzerdefiniertes natives Anzeigenformat abzurufen.

Ab Version 22 erstellen Sie Ihre eigene MediaView, legen deren Medieninhalte fest und rufen mit MediaContent.getVideoController() die Videosteuerelemente ab.

// 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());
    }
}

Weitere Informationen finden Sie im Leitfaden zu benutzerdefinierten nativen Anzeigen.

Entfernte oder ersetzte Methoden

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

Von v20 zu v21 migrieren

In den folgenden Abschnitten werden funktionsgefährdende Änderungen und Verhaltensunterschiede zwischen den Hauptversionen 20 und 21 von Google Mobile Ads SDK (Legacy) beschrieben:

„minSdkVersion“ auf 19 oder höher aktualisieren

Ab Version 21.0.0 erfordert Google Mobile Ads SDK (Legacy), dass alle Apps mindestens das Android API-Level 19 haben, um ausgeführt werden zu 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 Null-Zulässigkeit erzwingen

In Vorbereitung auf die Durchsetzung der strikten Null-Zulässigkeit werden in allen APIs, in denen die Null-Zulässigkeit zuvor nicht explizit definiert wurde, @NonNull-Anmerkungen hinzugefügt.

Diese Änderung kann zu Fehlern in Kotlin-Apps und Apps führen, die Java-Frameworks für die Null-Prüfung verwenden, wenn es zu Null-Sicherheitsverletzungen kommt und null-Werte zuvor nicht sicher verarbeitet wurden (siehe Kotlin-Dokumentation zur Null-Sicherheit).

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 wird in Version 21.0.0 entfernt. Verwenden Sie stattdessen die Methode addNetworkExtrasBundle() aus derselben AdRequest.Builder-Klasse.

Entfernen von Standortmethoden

Die folgenden Methoden zur Standortermittlung 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 Vermittlungsausrichtung festgelegt wird.
• Die Methode getLocation() in der Klasse AdRequest, die die Informationen zum geografischen Targeting 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 dieser durch die AdRequest definiert ist.

Die Standortdaten werden von Google nicht für das Targeting von Anzeigen verwendet. Sie sollten Drittanbieter-APIs verwenden, um die Informationen bei Bedarf an Drittanbieter-Werbenetzwerke weiterzugeben.

Einstellung von Schnittstellen für benutzerdefinierte Ereignisse

Mit benutzerdefinierten Ereignissen können Publisher, die die Vermittlung verwenden, eine abfolgebasierte Anzeigenquelle einrichten, die nicht zu den von Ad Manager unterstützten Anzeigenquellen gehört.

Alle benutzerdefinierten Ereignisschnittstellen wurden zugunsten der Klasse Adapter und der Schnittstelle MediationAdLoadCallback eingestellt.

In der folgenden Tabelle sind die entsprechenden Klassen oder Schnittstellen aufgeführt, die Sie ab Version 21.0.0 für jede Schnittstelle für benutzerdefinierte Ereignisse verwenden müssen:

Von v19 zu v20 migrieren

In Version 20.0.0 gibt es viele funktionsgefährdende Änderungen. In Version 19.7.0 wurden viele neue APIs eingeführt und viele Klassen wurden im Hinblick auf Version 20.0.0 verworfen oder umbenannt. In diesem Leitfaden werden die wichtigsten Änderungen in Version 20.0.0 beschrieben.

API-Updates für Vollbildformate

Ab Version 20.0.0 sind die Anzeigenformate Interstitial, Anzeige mit Prämie, Interstitial mit Prämie und App-Start-Anzeige standardisiert, um ein einheitliches API-Design zu ermöglichen.

Für alle APIs für Vollbildformate gelten die folgenden Grundsätze:

• Eine statische Lademethode
• Ein ähnlicher Lade-Callback- oder Handler-Mechanismus
• Abhängigkeit von der Klasse FullScreenContentCallback für Präsentations-Callbacks

Entfernung der alten RewardedVideoAd API

Die neuere RewardedAd API wurde im März 2019 eingeführt und ist seit über 18 Monaten die bevorzugte API für Anzeigen mit Prämie. Im Vergleich zur alten RewardedVideoAd API wurden weitere Verbesserungen vorgenommen, 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 adaptiver Banner

Smart-Banner-Anzeigen wurden zugunsten von adaptiven Banneranzeigen eingestellt. Adaptive Banner bieten eine bessere Leistung und mehr Flexibilität beim Festlegen der Anzeigenbreite. Wenn Sie weiterhin Banner mit voller Breite verwenden möchten, können Sie das mit adaptiven Bannern tun, 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 Callbacks beim Verlassen der Anwendung

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 oder nicht.

Der Callback onAdLeftApplication war nie als Anzeigenklick-Handler gedacht. Wenn Sie sich auf diesen Callback verlassen, um Klicks zu erfassen, erhalten Sie keinen genauen Messwert. Beispiel: Ein Klick auf das Datenschutzinfo-Symbol, durch den ein externer Browser gestartet wurde, hat den Callback aufgerufen, wurde aber nicht als Klick gezählt.

Umbenennung von Kursen

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

• 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 spezifischen Änderungen in Version 20.0.0 aufgeführt:

• Veraltete Initialisierungsmethoden wurden aus der Klasse „MobileAds“ entfernt.
• Einige Methoden 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.
• Korrelatorfunktionen wurden entfernt.