Note di rilascio

Versione	Data di uscita	Note
1.6.0	2026-10-22	Aggiornato il foglio di condivisione dello strumento di controllo degli annunci durante l'esportazione della richiesta di annuncio e della risposta per fornire anteprime di testo, un pulsante di copia e suggerimenti di condivisione diretta. È stato corretto un bug negli annunci con premio e negli annunci interstitial con premio per cui il metodo OnUserEarnedRewardListener.onUserEarnedReward() poteva essere richiamato dopo il metodo AdEventCallback.onAdDismissedFullScreenContent(). Aggiornata la dipendenza com.google.android.play:hsdp alla versione 2.2.0 per correggere un arresto anomalo di java.lang.IllegalStateException. Aggiornate le regole ProGuard per i consumatori per evitare un arresto anomalo di java.lang.RuntimeException nella classe androidx.work.WorkManagerInitializer quando è attiva la modalità completa R8. È stato corretto un bug per cui un contesto Activity disponibile non veniva passato agli SDK di terze parti durante la visualizzazione di annunci a schermo intero con mediazione.
1.5.0	2026-09-24	Aggiunte API di generazione e rendering degli indicatori per il formato SwipeableInterstitialAd. Questa funzionalità è in versione beta privata. Contatta il tuo account manager per richiedere l'accesso. È stata aggiunta un'API excludedAppIds alle richieste di annunci con icona, che consente ai publisher di escludere facoltativamente un elenco di ID app dalle risposte degli annunci con icona.
1.4.0	2026-08-20	È stato aggiunto il supporto per il formato PictureInPictureAd. Gli annunci Picture in picture sono in versione beta aperta. Aggiunto onInitializationFailed(AdError) e deprecato onInitializationFailed(String) in InitializationCompleteCallback. Gli adattatori di mediazione ora possono segnalare all'SDK gli errori di inizializzazione dell'SDK di terze parti con il codice di errore, il dominio di errore e il messaggio di errore.
1.3.1	2026-07-29	Correzioni di bug e miglioramenti delle prestazioni per una funzionalità ad accesso limitato.
1.3.0	2026-07-21	Modificato AdView.loadAd() per mettere in pausa i nuovi tentativi automatici per le richieste di annunci non riuscite quando l'aggiornamento automatico è disattivato per l'unità pubblicitaria. Quando una richiesta di annuncio per più annunci nativi o annunci con icona non genera annunci disponibili, l'SDK ora restituisce un errore NO_FILL anziché INTERNAL_ERROR. È stato aggiunto un flag del manifest per disattivare lo strumento di controllo degli annunci. È stato aggiunto il metodo Ad.getAdUnitId() per identificare l'ID unità pubblicitaria utilizzato per richiedere l'annuncio. È stato aggiunto il metodo InitializationConfig.Builder.disableSdkCrashReporting(), che fornisce una disattivazione manuale per il gestore degli arresti anomali predefinito in GMA Next-Gen SDK. Per impostazione predefinita, l'SDK delega comunque gli arresti anomali ad altri gestori registrati (come Crashlytics). Quando utilizzi la mediazione con origini annuncio di eventi personalizzati, ResponseInfo.getAdapterClassName() ora restituisce il nome della classe di eventi personalizzati anziché com.google.ads.mediation.customevent.CustomEventAdapter.
1.2.1	2026-06-15	Per le app che utilizzano l'API WebView per gli annunci, è stato risolto un problema che impediva all'SDK di fornire indicatori ai tag annuncio supportati (codice AdSense, Tag publisher di Google, IMA per HTML5). Questo problema è stato causato da metodi Webkit chiamati in modo errato su un thread in background.
1.2.0	2026-06-11	Risolto un bug che causava un java.lang.NullPointerException in androidx.webkit.internal.PrefetchOperationCallbackAdapter. Aggiunto il formato SwipeableInterstitialAd. Questa funzionalità è in versione beta privata. Contatta il tuo account manager per richiedere l'accesso. Per le app che richiedono più annunci con icona, è stato aggiunto IconAd.load(IconAdRequest, int, IconAdLoadCallback) ed è stato ritirato IconAd.load(IconAdRequest, int, AdLoadCallback<IconAd>). IconAdLoadCallback include un metodo onAdLoadingCompleted() per segnalare quando termina il caricamento di tutti gli annunci. Adattatori di mediazione: È stato aggiunto il metodo RequestConfiguration.getAgeRestrictedTreatment() per consentire agli adattatori di leggere l'impostazione per il trattamento in base all'età. untrackView() modificato per accettare View anziché View? per mantenere la compatibilità con gli adattatori creati con Google Mobile Ads SDK (Legacy).
1.1.1	2026-05-27	Risolto un problema per cui i pod di annunci con premio potevano bloccarsi durante le transizioni, impedendo agli utenti di chiudere l'annuncio.
1.1.0	2026-05-18	È stato aggiunto RequestConfiguration.Builder.setAgeRestrictedTreatment() e sono stati ritirati i seguenti metodi: RequestConfiguration.Builder.setTagForChildDirectedTreatment() RequestConfiguration.Builder.setTagForUnderAgeOfConsent() Aggiunta di destroyAll() e peekAdResponseInfo() alle classi di precaricamento degli annunci. Sono stati aggiunti i metodi load() a IconAd che supportano il caricamento di più annunci con icona.
1.0.1	30/04/2026	Risolto un problema per cui gli annunci che utilizzano window.open() o i link con target="_blank" non riuscivano ad aprire le pagine di destinazione.
1.0.0	2026-04-14	Modifiche che provocano un errore: Rimosso il metodo deprecato AdPreloader.numAdsAvailable(). Utilizza invece AdPreloader.getNumAdsAvailable(). org.chromium.net:cronet-api aggiornato alla versione 143.7445.0 per evitare violazioni dello spazio dei nomi univoco. Risolto un bug per cui MediaContent.currentTime e NativeAdMapper.getCurrentTime() restituivano sempre 0.
0.25.0-beta01	2026-03-24	Risolto un problema per cui Ad.getResponseInfo() non restituiva i metadati ResponseInfo aggiornati quando un annuncio banner veniva aggiornato.
0.24.0-beta03	2026-03-07	Risolto un problema per cui AdView.destroy() non riusciva a interrompere i nuovi tentativi di caricamento degli annunci dopo un caricamento non riuscito. Sono stati aggiunti costruttori senza argomenti a NativeAdMapper e UnifiedNativeAdMapper per migliorare la compatibilità con Kotlin. È stata aggiunta la proprietà packageName all'interfaccia IconAd. È stata aggiunta un'opzione per forzare l'SDK a utilizzare Cronet anziché OkHttp per le operazioni di rete. Per risolvere gli errori di runtime nei progetti che utilizzano OkHttp 5, ti consigliamo di forzare Cronet per le operazioni di rete. Per forzare Cronet, imposta l'extra force_use_cronet su true in InitializationConfig.Builder quando chiami MobileAds.initialize(): val config = InitializationConfig.Builder() .setExtras(bundleOf("force_use_cronet" to true)) .build() MobileAds.initialize(this, config) È stato aggiunto il supporto per Java 11. Per utilizzare Java 11, aggiungi il seguente codice al blocco android nel file build.gradle: android { compileOptions { sourceCompatibility JavaVersion.VERSION_11 targetCompatibility JavaVersion.VERSION_11 } kotlinOptions { jvmTarget = '11' } }
0.24.0-beta02	03/03/2026	Risolto un problema di caricamento della classe di dipendenza di terze parti che influiva sulla generazione degli indicatori delle richieste di annunci server-server.
0.24.0-beta01	2026-02-13	Aggiunto il supporto per i banner adattivi ancorati di grandi dimensioni. I banner adattivi ancorati grandi sono progettati per aumentare il coinvolgimento e le entrate. Richiedi banner adattivi ancorati di grandi dimensioni utilizzando i seguenti metodi nella classe AdSize: getLargePortraitAnchoredAdaptiveBannerAdSize() getLargeLandscapeAnchoredAdaptiveBannerAdSize() getLargeAnchoredAdaptiveBannerAdSize() I seguenti metodi della classe AdSize sono deprecati: getCurrentOrientationAnchoredAdaptiveBannerAdSize() getLandscapeAnchoredAdaptiveBannerAdSize() getPortraitAnchoredAdaptiveBannerAdSize() È stato corretto un bug per cui gli annunci banner potevano interrompere l'aggiornamento se la piattaforma richiamava onViewAttachedToWindow() e onViewDetachedFromWindow() in modo non ordinato quando veniva mostrato un nuovo annuncio.
0.23.0-beta01	2026-01-26	La versione minima richiesta del plug-in Android per Gradle (AGP) è stata aggiornata alla 8.3.0. È stato corretto un bug per cui il costruttore AdView generava un java.lang.NoSuchMethodError quando veniva chiamato da Kotlin. Risolto un bug per cui gli adattatori di eventi personalizzati non venivano richiamati durante l'esecuzione della cascata. Aggiornamento di RtbSignalData per fornire un contesto dell'attività a RtbAdapter.collectSignals(), se disponibile. Aggiornata la dipendenza androidx.webkit alla versione 1.15.0. È stata aggiornata la dipendenza dell'SDK User Messaging Platform alla versione 4.0.0. Ripristino del ritiro di AdPreloader.getConfiguration() e AdPreloader.getConfigurations().
0.22.0-beta04	2025-12-04	Risolto un problema nella versione 0.22.0-beta02 dell'SDK per cui i metadati di anteprima di Java 17 venivano inclusi erroneamente nei file di classe.
0.22.0-beta03	25/11/2025	È stato corretto un bug per cui le richieste di annunci server-server che utilizzavano NativeSignalRequest.Builder.setAdSize() non impostavano correttamente le dimensioni dell'annuncio richieste.
0.22.0-beta02	2025-11-24	Risolto un bug di caricamento di Ad Manager per cui il rendering delle richieste di annunci server-server che utilizzavano NativeSignalRequest non riusciva se la risposta all'annuncio era di tipo NativeAd.NativeAdType.BANNER.
0.22.0-beta01	2025-11-20	Aggiorna l'API degli annunci banner: Aggiunta della classe AdView. Ritirato BannerAd.load() e BannerAd.loadFromAdResponse(). Per caricare un singolo annuncio banner, utilizza invece AdView.loadAd() e AdView.loadFromAdResponse(). BannerAd.getView() deprecato. Per eseguire il rendering di un BannerAd caricato con BannerAdPreloader, crea un'istanza AdView e utilizza AdView.registerBannerAd(). Risolto un bug negli annunci con mediazione in cui NativeAdRequest.Builder.setAdChoicesPlacement() non veniva rispettato, causando un posizionamento errato dell'icona Scegli Tu!. La versione minima richiesta del plug-in Android per Gradle (AGP) è stata ridotta da 8.2.0 a 7.3.1. AdPreloader.getConfigurations() e AdPreloader.getConfiguration(preloadId) deprecati. Non esiste un sostituto.
0.21.0-beta01	2025-10-08	Aggiunto il metodo InitializationConfig.Builder.disableMediationAdapterInitialization(). Chiama questo metodo prima di inizializzare GMA Next-Gen SDK per disattivare l'inizializzazione dell'adattatore di mediazione. Migliorato l'utilizzo dell'inizializzazione di WebView per ridurre gli errori ANR. Eseguito il downgrade della dipendenza androidx.webkit da 1.13.0 a 1.12.1. È stata rimossa l'autorizzazione android.permission.RECEIVE_BOOT_COMPLETED utilizzata dal pacchetto androidx.work. È stato corretto un campo con un nome errato nella classe NativeAdMapper.
0.20.0-beta01	2025-09-19	Corretto un bug per cui alcuni annunci video nativi non venivano riprodotti automaticamente.
0.19.0-beta01	2025-08-14	Eseguito il downgrade delle versioni di due dipendenze. androidx.work:work-runtime dalla versione 2.10.0 alla versione 2.7.0. androidx.core:core and androidx.core:core-ktx dalla versione 1.15.0 alla versione 1.12.0. La proprietà loadedAdSourceResponse su ResponseInfo è stata rinominata in loadedAdSourceResponseInfo. È stato corretto un bug che consentiva agli utenti di chiudere prematuramente alcuni annunci a schermo intero con il pulsante Indietro. I publisher con accesso alla funzionalità ora dispongono del supporto dell'ID posizionamento per tutti i formati degli annunci. È stato aggiunto un callback destroy() a NativeAdMapper per gli adattatori di mediazione nativi.
0.18.0-beta01	2025-07-17	Risolto un bug della mediazione nativa che interrompeva la pubblicazione di annunci per gli adattatori che facevano riferimento a com.google.android.gms.ads.NativeAd.MediaView. MobileAds.registerCustomTabsSession() annotato con @JvmStatic. È stato corretto un bug per cui gli annunci banner caricati utilizzando la struttura a cascata della Rete AdMob interrompevano l'aggiornamento.
0.17.0-alpha02	2025-06-23	Risolto un bug relativo alle offerte di mediazione nativa per cui gli adattatori che implementano le offerte, ma non la struttura a cascata (ad es. Meta Audience Network), non riuscivano sempre a eseguire il rendering degli annunci nativi. Risolto un arresto anomalo che si verificava quando un adattatore di mediazione richiamava più metodi MediationAdLoadCallback per una singola richiesta di annuncio.
0.17.0-alpha01	2025-06-18	La versione 0.17.0-alpha01 è stata una release accidentale che non contiene le nuove funzionalità previste. Utilizza invece 0.17.0-alpha02.
0.16.0-alpha01	2025-05-23	Non è più necessario attivare il supporto del desugaring delle API Java 8 e versioni successive. Aggiornata la dipendenza dell'SDK User Messaging Platform alla versione 3.2.0. Risolto un bug della mediazione degli annunci nativi che causava arresti anomali negli adattatori che facevano riferimento alla classe com.google.android.gms.ads.formats.MediaView. Precaricamento degli annunci: è stato aggiunto getNumAdsAvailable() ed è stato ritirato numAdsAvailable(). È stato rimosso il tag della proprietà android.adservices.AD_SERVICES_CONFIG dal file manifest dell'SDK per evitare conflitti di unione per le app che configurano servizi pubblicitari specifici per l'API.
0.15.1-alpha01	2025-04-28	Ora è necessario attivare il supporto del desugaring delle API Java 8+. Per le app sviluppate utilizzando Kotlin, la versione minima richiesta di Kotlin è stata ridotta da 2.1 a 1.9.
0.15.0-alpha01	2025-04-24	Annunci nativi: è stato aggiunto il supporto per il caricamento di più annunci nativi. È stato aggiunto un metodo NativeAdLoader.load(NativeAdRequest, numberOfAds, NativeAdLoaderCallback) che richiede più annunci contemporaneamente. È stato aggiunto un callback NativeAdLoaderCallback.onAdLoadingCompleted() che viene attivato quando tutti gli annunci nativi completano il caricamento. Per supportare il caricamento asincrono di Kotlin, è stato aggiunto un metodo NativeAdLoader.load(NativeAdRequest, numberOfAds) che restituisce un Flow<NativeAdLoadResult>. Aggiornata la dipendenza kotlinx-coroutines-android dalla versione 1.7.3 alla 1.9.0.
0.14.0-alpha01	2025-03-20	Le richieste di annunci non vanno a buon fine se inizializzi l'SDK con un ID applicazione non valido. Il metodo AdPreloader.start() non richiede più un callback PreloadCallback. La proprietà bufferSize è facoltativa quando crei un oggetto tramite la classe di dati PreloadConfiguration. Per consentire a Google di ottimizzare la dimensione del buffer, non impostare la proprietà bufferSize. È stata rimossa la proprietà maxAdsPerSession nella classe di dati PreloadConfiguration. Aggiunte le proprietà shouldRequestMultipleImages e shouldReturnUrlsForImageAssets alla classe NativeAdOptions.
0.13.0-alpha01	2025-02-26	Aggiunta di MediationRewardedAdCallback.onUserEarnedReward() e ritiro di MediationRewardedAdCallback.onUserEarnedReward(RewardItem). Sono state aggiunte le API di precaricamento degli annunci.
0.12.0-alpha01	22/01/2025	È stato corretto un bug per cui alcuni metodi all'interno di AdRequest, AdRequest.Builder, SignalRequest e SignalRequest.Builder erano offuscati. Per gli utenti dell'API WebView per gli annunci che non dispongono di un ID applicazione Ad Manager, è stato aggiunto InitializationConfig.WEBVIEW_APIS_FOR_ADS_APPLICATION_ID che può essere trasmesso durante l'inizializzazione dell'SDK. È stato aggiunto il supporto per la combinazione di annunci nativi e banner nelle richieste di annunci di Ad Manager.
0.11.0-alpha01	12/12/2024	Aggiornata la dipendenza dall'SDK User Messaging Platform alla versione 3.1.0. Aggiunto il supporto per i gesti di clic personalizzati negli annunci nativi. È stato aggiunto il supporto per il conteggio manuale delle impressioni degli annunci banner nelle prenotazioni di Ad Manager.
0.10.0-alpha01	2024-11-08	Aggiunte funzioni DSL per VideoOptions e RequestConfiguration per un migliore supporto di Kotlin. Aggiunto il supporto per l'API Publisher Privacy Treatment con RequestConfiguration.setPublisherPrivacyPersonalizationState(). Sono state aggiunte le API di sospensione di Kotlin per il caricamento degli annunci e la generazione di indicatori. Rimosso IconAd.LoadAdResult e sostituito con AdLoadResult. È stato risolto un problema per cui le sessioni OMID non venivano avviate per gli annunci video nativi.
0.9.0-alpha01	2024-10-02	È stata rimossa la dipendenza dalle API Java 8 e versioni successive disponibili tramite desugaring dalla release 0.6.0-alpha01. Le app che utilizzano minSdkVersion precedente a 26 non devono più attivare il supporto del desugaring delle API Java 8+. È stato aggiunto il supporto per lo strumento di controllo degli annunci. Aggiunto il supporto dei video per il formato dell'annuncio nativo personalizzato. Release ufficiale per le API di raccolta e rendering degli indicatori.
0.8.0-alpha01	2024-08-22	Aggiornata la dipendenza dall'SDK User Messaging Platform alla versione 3.0.0. Annunci nativi: Versione di release ufficiale per il formato dell'annuncio nativo. Aggiunto il supporto per la pubblicazione di video nell'asset MediaContent. Aggiunta di callback del ciclo di vita dei video. Aggiunti controlli personalizzati per la riproduzione dei video. Abilitazione di Open Measurement per gli annunci nativi e nativi personalizzati. signalType è ora un campo obbligatorio durante la creazione di un SignalRequest.
0.6.0-alpha01	20/06/2024	È stato aggiunto un codice che utilizza le API Java 8 e versioni successive disponibili tramite desugaring. Le app che utilizzano minSdkVersion precedente a 26 devono attivare il supporto del desugaring delle API Java 8 e versioni successive. È stato aggiunto il supporto per i formati degli annunci nativi e nativi personalizzati che non includono asset video. Aggiunto il supporto per MRAID v3. Aggiunta la dipendenza dall'SDK User Messaging Platform versione 2.2.0. Aggiornato il dominio di errore per gli errori di Google da com.google.android.gms.ads a com.google.android.libraries.ads.mobile.sdk. Aggiunto il metodo MobileAds.isInitialized() per verificare se l'SDK è già stato inizializzato. È stato aggiunto BannerAd.isCollapsible() per verificare se l'annuncio banner restituito è comprimibile. È stato aggiunto MobileAds.registerCustomTabsSession() per migliorare la monetizzazione degli annunci nelle schede personalizzate. OnInitializationCompleteListener rinominato in OnAdapterInitializationCompleteListener. AdapterResponseInfo rinominato in AdSourceResponseInfo. AdRequest.Builder.putAdNetworkExtrasBundle() rinominato in AdRequest.Builder.putAdSourceExtrasBundle(). Risolto un bug per cui le classi dell'adattatore di asta non venivano create correttamente.
0.3.0-alpha01	2024-03-20	Release iniziale di GMA Next-Gen SDK. Supporta annunci banner, interstitial, con premio, interstitial con premio e apertura app. Supporta la mediazione per tutti i formati degli annunci. Gli adattatori scritti per l'SDK per gli annunci mobile corrente sono compatibili con le versioni successive di GMA Next-Gen SDK. Aggiunta la dipendenza dall'SDK Open Measurement versione 1.4.10.