SDK-Versionen migrieren

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

Von Version 24 zu Version 25 migrieren

In den folgenden Unterabschnitten werden die Breaking Changes 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 erfordert Google Mobile Ads SDK (Legacy), dass alle Apps mindestens auf Android-API-Level 24 ausgeführt werden. Wenn Sie die API-Ebene anpassen möchten, ändern Sie den Wert minSdk in der Datei build.gradle auf App-Ebene in 24 oder höher.

Eingestellte Anzeigen-Callbacks entfernt

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

Änderungen an 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 Video-Nachfrage für Banneranzeigen mit den neuen APIs für große adaptive Ankerbanner bedienen.

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

Entfernung der Klasse mediation.VersionInfo

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

Entfernung der Methode getConfiguration() in der Klasse RtbSignalData

Die eingestellte 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 Unterabschnitten werden die Breaking Changes 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 erfordert Google Mobile Ads SDK (Legacy), dass alle Apps mindestens auf 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 dem 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.

Abhängigkeiten „firebase-ads“ und „firebase-ads-lite“ entfernt

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

Benutzerdefinierte Targeting-Parameter festlegen

Mit addCustomTargeting() können Sie benutzerdefiniertes Targeting für eine Anzeigenanfrage festlegen.

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

• Die AppOpenAd.load()-Methoden, die einen Ausrichtungsparameter akzeptieren, wurden entfernt. Verwenden Sie stattdessen AppOpenAd.load()-Methoden, die keine Ausrichtung erfordern.
• Die Enumeration AppOpenAdOrientation wurde entfernt.

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

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

Beim Weiterleiten von Callbacks von Vermittlungsadaptern wird bei allen Google Mobile Ads SDK (Legacy)-Versionen die in der Ad Manager-Benutzeroberfläche definierte Prämie in OnUserEarnedRewardListener zurückgegeben.

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 Version 22 zu Version 23 migrieren

In den folgenden Unterabschnitten werden die funktionsgefährdenden Änderungen und Verhaltensunterschiede zwischen Hauptversion 22 und 23 von Google Mobile Ads SDK (Legacy) beschrieben.

Das Mindest-Android-API‑Level ist 21.

Ab Version 23.0.0 erfordert Google Mobile Ads SDK (Legacy), dass alle Apps mindestens das Android-API-Level 21 haben, um ausgeführt werden zu können. Wenn Sie das API-Level anpassen möchten, ändern Sie den Wert von minSdkVersion in der Datei build.gradle auf App-Ebene in 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 ihrem übergeordneten Element geerbt wurden, verkettet werden, um ein AdManagerAdRequest mit einem einzigen Aufruf 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.

Verworfene Methoden entfernt/ersetzt

Von v21 zu v22 migrieren

In den folgenden Unterabschnitten werden die Breaking Changes und Verhaltensunterschiede zwischen den Hauptversionen 21 und 22 von Google Mobile Ads SDK (Legacy) beschrieben.

Mit MobileAds.getVersion() die Version Google Mobile Ads SDK (Legacy) 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 Neue Methode getVersion() des Google Mobile Ads SDK verwenden.

Entfernen von „NativeCustomFormatAd.getVideoMediaView()“

In Version 21 wurde die Methode Google Mobile Ads SDK (Legacy) eingeführt, mit der Sie das Media-Asset für ein benutzerdefiniertes natives Anzeigenformat abrufen können.NativeCustomFormatAd.getVideoMediaView()

Ab Version 22 erstellen Sie Ihr eigenes MediaView und legen dessen Medieninhalte fest. Mit MediaContent.getVideoController() erhalten Sie die Videosteuerung.

// 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 für benutzerdefinierte native 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 Unterabschnitten werden die Breaking Changes 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.

Strikte Null-Zulässigkeit erzwingen

Zur Vorbereitung auf die Erzwingung der strengen 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 dazu führen, dass Kotlin-Apps und Apps, die Java-Frameworks zur Null-Prüfung verwenden, nicht mehr funktionieren, wenn Null-Sicherheitsverstöße auftreten und null-Werte nicht auf sichere Weise 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 Werbenetzwerkadapter übergeben werden, ist in SDK-Version 20.3.0 veraltet und wird in Version 21.0.0 entfernt. Verwenden Sie stattdessen die Methode addNetworkExtrasBundle() aus derselben AdRequest.Builder-Klasse.

Entfernen 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 das Mediations-Targeting festgelegt wird.
• Die Methode getLocation() in der Klasse AdRequest, die die Standort-Targeting-Informationen 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 er durch 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 benutzerdefinierter Ereignisschnittstellen

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

Alle benutzerdefinierten Ereignis-Schnittstellen sind zugunsten der Klasse Adapter und der Schnittstelle MediationAdLoadCallback veraltet.

In der folgenden Tabelle finden Sie die entsprechende Klasse oder Schnittstelle, die Sie für jede benutzerdefinierte Ereignisschnittstelle ab Version 21.0.0 verwenden müssen:

Von Version 19 zu Version 20 migrieren

Version 20.0.0 enthält viele funktionsgefährdende Änderungen. In Version 19.7.0 wurden viele neue APIs eingeführt und viele Klassen wurden verworfen oder umbenannt, um die Vorbereitung auf Version 20.0.0 zu erleichtern. In diesem Leitfaden werden die wichtigsten Änderungen in Version 20.0.0 beschrieben.

Aktualisierungen der API für Vollbildformate

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

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

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

Entfernung der Legacy 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. Sie wurde im Vergleich zur alten RewardedVideoAd API weiter verbessert. So ist es jetzt beispielsweise möglich, mehr als eine Anzeige mit Prämie gleichzeitig zu laden.

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

Smart-Banner werden zugunsten adaptiver Banner eingestellt

Smart-Banner-Anzeigen werden zugunsten von adaptiven Banneranzeigen eingestellt. Adaptive Banner bieten eine bessere Leistung und mehr Flexibilität bei der Festlegung der Anzeigenbreite. Wenn Sie weiterhin Banner in voller Breite verwenden möchten, ist das 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)
    }
}

Callback zum Verlassen der Anwendung entfernen

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.

Der onAdLeftApplication-Callback war nie als Handler für Anzeigenklicks gedacht. Wenn Sie sich auf diesen Callback verlassen haben, um Klicks zu erfassen, haben Sie keinen genauen Messwert erhalten. Wenn ein Nutzer beispielsweise auf das Datenschutzinfo-Symbol klickt, wodurch ein externer Browser gestartet wird, wird der Callback aufgerufen, aber nicht als Klick gezählt.

Klassen umbenennen

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

• Die meisten Klassen, die mit UnifiedNativeAd zusammenhängen, 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 ein 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 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 anzugleichen.
• Correlator-Funktionen wurden entfernt.