GMA Next-Gen SDK installieren

Wenn Sie die Verbesserungen der Latenz und Stabilität von Android nutzen möchten, verwenden Sie GMA Next-Gen SDK. In diesem Leitfaden wird beschrieben, wie Sie Google Mobile Ads Flutter Plugin für die Verwendung von GMA Next-Gen SDK für Android konfigurieren.

Vorbereitung

Führen Sie die folgenden Schritte aus, bevor Sie fortfahren:

Android-Gradle-Einstellungen konfigurieren

Wenn Sie GMA Next-Gen SDK unter Android verwenden möchten, müssen Sie Ihre Gradle-Konfigurationen aktualisieren:

Mit Umgebungsdeklaration ausführen

Wenn Sie GMA Next-Gen SDK beim Erstellen und Ausführen Ihrer Android-App verwenden möchten, müssen Sie die Umgebungsdeklaration USE_NEXT_GEN_SDK mit dem Wert true angeben.

Führen Sie jedes Mal, wenn Sie Ihre Anwendung erstellen oder ausführen, Folgendes aus:

flutter run --dart-define USE_NEXT_GEN_SDK=true

Mit IDE-Konfiguration ausführen

Wenn Sie Ihre Anwendung mit einer integrierten Entwicklungsumgebung (IDE) ausführen, können Sie die Umgebungsdeklarationen in der Startkonfiguration konfigurieren, anstatt das Flag über die Befehlszeile zu übergeben.

Sie können diese Variablen beispielsweise in einer JSON-Datei definieren und Ihrer IDE-Einrichtung hinzufügen. Weitere Informationen finden Sie unter Umgebungsdeklarationen angeben.

Vorlagen für native Anzeigen aktualisieren

Wenn Sie Vorlagen für native Anzeigen verwenden, nehmen Sie die folgenden Aktualisierungen vor, um GMA Next-Gen SDK zu unterstützen:

Paketimport für NativeAdFactory aktualisieren

Aktualisieren Sie für Android die Importanweisung für die Klasse NativeAdFactory:

Java

// Replace this import:
import io.flutter.plugins.googlemobileads.GoogleMobileAdsPlugin.NativeAdFactory;

// With this import:
import io.flutter.plugins.googlemobileads.NativeAdFactory;

Kotlin

// Replace this import:
import io.flutter.plugins.googlemobileads.GoogleMobileAdsPlugin.NativeAdFactory

// With this import:
import io.flutter.plugins.googlemobileads.NativeAdFactory

XML-Ansichten des Layouts für native Anzeigen aktualisieren

Aktualisieren Sie in den Layout-XML-Dateien für Ihre nativen Anzeigen die Klasse für die Ansicht nativer Anzeigen:

<!-- Replace this element: -->
<com.google.android.gms.ads.nativead.NativeAdView ... />

<!-- With this element: -->
<com.google.android.libraries.ads.mobile.sdk.nativead.NativeAdView ... />

Abhängigkeiten für beide Konfigurationen konfigurieren

Wenn Ihr Projekt sowohl Google Mobile Ads SDK (Legacy) als auch GMA Next-Gen SDK unterstützen muss, können Sie die Datei android/app/build.gradle so konfigurieren, dass Abhängigkeiten bedingt anhand der Umgebungsdeklaration definiert werden.

Google Mobile Ads Flutter Plugin stellt eine Beispielkonfiguration in der Beispiel-App-Datei build.gradle bereit.