Note di rilascio

Versione	Data di uscita	Note
1.5.0	2026-09-24	Sono state aggiunte API di generazione e rendering dei segnali 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 icone, consentendo agli editori di escludere facoltativamente un elenco di ID app dalle risposte degli annunci con icone.
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à con accesso limitato.
1.3.0	2026-07-21	È stato modificato AdView.loadAd() per mettere in pausa i 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 icone non produce annunci disponibili, l'SDK ora restituisce un errore NO_FILL anziché un errore 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 consente di disattivare manualmente il gestore di 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 evento personalizzato, ResponseInfo.getAdapterClassName() ora restituisce il nome della classe dell'evento personalizzato 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 dalla chiamata errata dei metodi Webkit su un thread in background.
1.2.0	2026-06-11	È stato corretto 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 icone, è stato aggiunto IconAd.load(IconAdRequest, int, IconAdLoadCallback) ed è stato ritirato IconAd.load(IconAdRequest, int, AdLoadCallback<IconAd>). IconAdLoadCallback include un metodo onAdLoadingCompleted() per segnalare il termine del caricamento di tutti gli annunci. Adattatori di mediazione: È stato aggiunto il metodo RequestConfiguration.getAgeRestrictedTreatment() per consentire agli adattatori di leggere l'impostazione del trattamento in base all'età. Modificato untrackView() per accettare View anziché View? per mantenere la compatibilità con gli adattatori creati in base a 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() Sono state aggiunte 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 icone.
1.0.1	30/04/2026	È stato risolto un problema per cui gli annunci che utilizzano window.open() o 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 AdPreloader.numAdsAvailable() obsoleto. Utilizza invece AdPreloader.getNumAdsAvailable(). Aggiornamento di org.chromium.net:cronet-api alla versione 143.7445.0 per evitare violazioni dello spazio dei nomi univoco. È stato corretto un bug per cui MediaContent.currentTime e NativeAdMapper.getCurrentTime() restituivano sempre 0.
0.25.0-beta01	2026-03-24	È stato 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	È stato risolto un problema per cui AdView.destroy() non riusciva a interrompere i tentativi di caricamento degli annunci dopo un errore. 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 nell'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	È stato risolto un problema di caricamento della classe di dipendenza di terze parti che influiva sulla generazione di indicatori di richiesta di annuncio server-server.
0.24.0-beta01	2026-02-13	È stato aggiunto il supporto per i banner adattivi ancorati di grandi dimensioni. I banner adattivi ancorati di grandi dimensioni 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 obsoleti: getCurrentOrientationAnchoredAdaptiveBannerAdSize() getLandscapeAnchoredAdaptiveBannerAdSize() getPortraitAnchoredAdaptiveBannerAdSize() È stato corretto un bug per cui gli annunci banner potrebbero smettere di aggiornarsi se la piattaforma richiama onViewAttachedToWindow() e onViewDetachedFromWindow() in modo non sequenziale quando viene mostrato un nuovo annuncio.
0.23.0-beta01	2026-01-26	È stata aggiornata la versione minima richiesta del plug-in Android per Gradle (AGP) alla 8.3.0. È stato corretto un bug per cui il costruttore AdView generava un java.lang.NoSuchMethodError quando veniva chiamato da Kotlin. È stato corretto un bug per cui gli adattatori di eventi personalizzati non venivano richiamati durante l'esecuzione a cascata. RtbSignalData aggiornato per fornire un contesto dell'attività a RtbAdapter.collectSignals() quando 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. È stato annullato il ritiro di AdPreloader.getConfiguration() e AdPreloader.getConfigurations().
0.22.0-beta04	2025-12-04	È stato risolto un problema nella versione 0.22.0-beta02 dell'SDK in cui i metadati di anteprima di Java 17 erano inclusi in modo errato nei file delle classi.
0.22.0-beta03	25/11/2025	È stato corretto un bug per cui le richieste di annuncio server-server che utilizzano NativeSignalRequest.Builder.setAdSize() non impostavano correttamente le dimensioni dell'annuncio richiesto.
0.22.0-beta02	2025-11-24	È stato risolto un bug di caricamento di Ad Manager in cui le richieste di annunci server-server che utilizzano NativeSignalRequest non venivano visualizzate se la risposta all'annuncio era di tipo NativeAd.NativeAdType.BANNER.
0.22.0-beta01	2025-11-20	Aggiorna l'API per gli annunci banner: Aggiunta la classe AdView. BannerAd.load() e BannerAd.loadFromAdResponse() deprecati. Per caricare un singolo annuncio banner, utilizza 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(). È stato corretto un bug negli annunci con mediazione in cui NativeAdRequest.Builder.setAdChoicesPlacement() non veniva rispettato, causando un posizionamento errato dell'icona Scelte pubblicitarie. È stata ridotta la versione minima richiesta del plug-in Android per Gradle (AGP) dalla 8.2.0 alla 7.3.1. Deprecati AdPreloader.getConfigurations() e AdPreloader.getConfiguration(preloadId). Non è previsto alcun 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. Miglioramento dell'utilizzo dell'inizializzazione di WebView per ridurre gli errori ANR. È stato eseguito il downgrade della dipendenza androidx.webkit dalla versione 1.13.0 alla versione 1.12.1. Rimossa l'autorizzazione android.permission.RECEIVE_BOOT_COMPLETED utilizzata dal pacchetto androidx.work. È stato corretto un campo con nome errato nella classe NativeAdMapper.
0.20.0-beta01	2025-09-19	È stato corretto un bug per cui alcuni annunci video nativi non vengono riprodotti automaticamente.
0.19.0-beta01	2025-08-14	Versioni precedenti di due dipendenze. androidx.work:work-runtime dalla versione 2.10.0 alla 2.7.0. androidx.core:core and androidx.core:core-ktx dalla versione 1.15.0 alla 1.12.0. È stata rinominata la proprietà loadedAdSourceResponse su ResponseInfo 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 supportano l'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	È stato corretto 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. Annotazioni MobileAds.registerCustomTabsSession() con @JvmStatic. È stato corretto un bug per cui gli annunci banner caricati utilizzando la cascata della Rete AdMob smettevano di aggiornarsi.
0.17.0-alpha02	2025-06-23	È stato corretto un bug dell'asta di mediazione nativa per cui gli adattatori che implementano l'asta ma non la struttura a cascata (ad es. Meta Audience Network) non riuscivano sempre a eseguire il rendering degli annunci nativi. È stato corretto 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 rilasciata per errore e non contiene le nuove funzionalità previste. Utilizza invece la versione 0.17.0-alpha02.
0.16.0-alpha01	2025-05-23	Non è più necessario abilitare il supporto per il desugaring dell'API Java 8+. È stata aggiornata la dipendenza dell'SDK User Messaging Platform alla versione 3.2.0. Risolto un bug di mediazione degli annunci nativi che causava arresti anomali negli adattatori che fanno riferimento alla classe com.google.android.gms.ads.formats.MediaView. Precaricamento degli annunci: è stato aggiunto getNumAdsAvailable() e numAdsAvailable() è stato ritirato. È 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 i servizi di pubblicazione di annunci specifici per l'API.
0.15.1-alpha01	2025-04-28	Ora è necessario abilitare il supporto della rimozione dello zucchero sintattico dell'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 NativeAdLoader.load(NativeAdRequest, numberOfAds, NativeAdLoaderCallback) metodo che richiede più annunci contemporaneamente. È stato aggiunto un callback NativeAdLoaderCallback.onAdLoadingCompleted() che viene attivato quando tutti gli annunci nativi hanno completato il caricamento. Per supportare il caricamento asincrono di Kotlin, è stato aggiunto un metodo NativeAdLoader.load(NativeAdRequest, numberOfAds) che restituisce un Flow<NativeAdLoadResult>. Aggiornamento della 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	Aggiunto MediationRewardedAdCallback.onUserEarnedReward() e deprecato MediationRewardedAdCallback.onUserEarnedReward(RewardItem). Sono state aggiunte 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 AdMob, è 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 Ad Manager.
0.11.0-alpha01	12/12/2024	È stata aggiornata la dipendenza dall'SDK User Messaging Platform alla versione 3.1.0. È stato aggiunto il supporto per i gesti di clic personalizzati negli annunci nativi.
0.10.0-alpha01	2024-11-08	Sono state 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 API di sospensione Kotlin per il caricamento degli annunci e la generazione di indicatori. IconAd.LoadAdResult è stato rimosso 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 da API Java 8+ disponibili tramite desugaring dalla release 0.6.0-alpha01. Le app che utilizzano minSdkVersion inferiore a 26 non devono più abilitare Supporto della rimozione dello zucchero dalle API Java 8+. È stato aggiunto il supporto per lo strumento di controllo degli annunci. È stato aggiunto il supporto video per il formato degli annunci nativi personalizzato. Release ufficiale delle API di raccolta e rendering degli indicatori.
0.8.0-alpha01	2024-08-22	È stata aggiornata la dipendenza dall'SDK User Messaging Platform alla versione 3.0.0. Annunci nativi: Versione di rilascio ufficiale per il formato dell'annuncio nativo. È stato aggiunto il supporto per la pubblicazione di video nell'asset MediaContent. Sono stati aggiunti callback del ciclo di vita dei video. Sono stati aggiunti controlli personalizzati per la riproduzione video. È stata attivata la misurazione aperta per gli annunci nativi e nativi personalizzati. signalType è ora un campo obbligatorio quando crei un SignalRequest.
0.6.0-alpha01	20/06/2024	È stato aggiunto codice che utilizza API Java 8+ disponibili tramite desugarizzazione. Le app che utilizzano minSdkVersion inferiore a 26 devono abilitare il supporto della rimozione dello zucchero sintattico dell'API Java 8+. È stato aggiunto il supporto per i formati degli annunci nativi e nativi personalizzati che non includono asset video. È stato aggiunto il supporto per MRAID v3. È stata aggiunta la dipendenza dalla versione 2.2.0 dell'SDK User Messaging Platform. Dominio di errore aggiornato per gli errori di Google da com.google.android.gms.ads a com.google.android.libraries.ads.mobile.sdk. È stato 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 è stato rinominato in OnAdapterInitializationCompleteListener. AdapterResponseInfo è stato rinominato in AdSourceResponseInfo. AdRequest.Builder.putAdNetworkExtrasBundle() è stato rinominato in AdRequest.Builder.putAdSourceExtrasBundle(). È stato corretto un bug per cui le classi dell'adattatore di offerta non venivano istanziate 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 Mobile Ads attuale sono compatibili con GMA Next-Gen SDK. È stata aggiunta la dipendenza dall'SDK Open Measurement versione 1.4.10.