Installa l'SDK GMA di nuova generazione

Per adottare i miglioramenti della latenza e della stabilità di Android, utilizza GMA Next-Gen SDK. Questa guida illustra la configurazione di Google Mobile Ads Flutter Plugin per utilizzare GMA Next-Gen SDK per Android.

Prerequisiti

Prima di continuare, completa queste operazioni:

Configurare le impostazioni di Android Gradle

Per utilizzare GMA Next-Gen SDK su Android, devi aggiornare le configurazioni di Gradle:

Esegui con la dichiarazione dell'ambiente

Per utilizzare GMA Next-Gen SDK durante la creazione e l'esecuzione dell'app per Android, devi fornire la dichiarazione dell'ambiente USE_NEXT_GEN_SDK impostata sul valore true.

Ogni volta che crei o esegui la tua app, esegui quanto segue:

flutter run --dart-define USE_NEXT_GEN_SDK=true

Esegui con la configurazione IDE

Se esegui l'app utilizzando un ambiente di sviluppo integrato (IDE), puoi configurare le dichiarazioni dell'ambiente nella configurazione di avvio anziché passare il flag utilizzando la riga di comando.

Ad esempio, puoi definire queste variabili in un file JSON e aggiungerle alla configurazione dell'IDE. Per maggiori dettagli, vedi Specificare le dichiarazioni di ambiente.

Aggiornare i modelli di annunci nativi

Se utilizzi i modelli di annunci nativi, apporta i seguenti aggiornamenti per supportare GMA Next-Gen SDK:

Aggiorna l'importazione del pacchetto NativeAdFactory

Per Android, aggiorna l'istruzione di importazione per la classe 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

Aggiorna le visualizzazioni XML del layout di visualizzazione degli annunci nativi

Nei file XML di layout per gli annunci nativi, aggiorna la classe di visualizzazione dell'annuncio nativo:

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

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

Configura le dipendenze per entrambe le configurazioni

Se il tuo progetto deve supportare sia Google Mobile Ads SDK sia GMA Next-Gen SDK, puoi configurare il file android/app/build.gradle per definire in modo condizionale le dipendenze in base alla dichiarazione dell'ambiente.

Google Mobile Ads Flutter Plugin fornisce una configurazione di esempio nel file dell'app di esempio build.gradle.