Questa pagina è stata tradotta dall'API Cloud Translation.

Note di rilascio

Versione	Data di uscita	Note
23.5.0	29‑10‑2024	Aggiornamento dei messaggi logcat relativi agli errori di caricamento degli annunci introdotti nella release 23.4.0 dal livello di errore a quello di informazioni. Monetizzazione degli annunci personalizzati migliorata nelle schede personalizzate per l'API WebView per gli annunci.
23.4.0	30‑09‑2024	Gli errori di caricamento degli annunci ora richiamano un messaggio logcat che indica `ad failed to load` nella traccia dello stack dell'errore. L'analisi dello stack registra questo messaggio come errore, ma non implica alcun arresto anomalo. Consulta Eseguire il debug dei messaggi di log degli errori comuni per interpretare i problemi di caricamento degli annunci più comuni. Se riscontri un errore ricorrente relativo alla pubblicazione degli annunci non documentato, condividi la traccia dello stack con il team di assistenza dell'SDK Mobile Ads. Sono stati aggiunti metodi `addCustomTargeting()` a `AdRequest`.
23.3.0	12-08-2024	È stata aggiornata la dipendenza dall'SDK User Messaging Platform alla versione 3.0.0.
23.2.0	27-06-2024	È stato aggiunto `AdView.isCollapsible()` per indicare se l'ultimo banner caricato è comprimibile.
23.1.0	09‑05‑2024	Richiede un valore minimo di `compileSdkVersion` pari a 34. Adattatori di Mediazione nativa: `loadNativeAd` e `loadRtbNativeAd()` sono stati ritirati in favore di `loadNativeAdMapper()` e `loadRtbNativeAdMapper()`. Gli adattatori devono eseguire la migrazione all'utilizzo di questi nuovi metodi di caricamento e degli oggetti correlati.
23.0.0	07‑03‑2024	Questa release è un aggiornamento PRINCIPALE della versione con diverse modifiche che provocano errori. Per ulteriori informazioni su come eseguire la migrazione, consulta la sezione Eseguire la migrazione all'SDK v23. Modifiche che provocano un errore: È stato aumentato il livello API Android minimo a 21. Per continuare a raccogliere le metriche utente in AdMob, collega l'app AdMob a Firebase e integra l'SDK Google Analytics for Firebase nella tua app. È stata rimossa l'API `MobileAds.enableSameAppKey()` deprecata e aggiornato il metodo alternativo `MobileAds.putPublisherFirstPartyIdEnabled()` per restituire un valore booleano che indica se la persistenza del controllo ha esito positivo o meno. `Native Ads`: `AdLoader.forUnifiedNativeAd()` rimosso. Utilizza invece `AdLoader.forNativeAd()`. `AdLoader.forCustomTemplateAd()` rimosso. Utilizza invece `AdLoader.forCustomFormatAd()`. `AdFormat.UNKNOWN` rimosso senza sostituzione. Le app che utilizzano `QueryInfo.generate()` devono trasmettere un formato dell'annuncio. I metodi `AdManagerAdRequest.Builder` ereditati dall'elemento padre possono ora essere concatenati per creare un oggetto da una singola chiamata. Ciò ha richiesto una modifica nella struttura di ereditarietà in modo che `AdManagerAdRequest.Builder` non erediti più da `AdRequest.Builder`. Aggiunge MobileAds.registerCustomTabsSession() per migliorare la monetizzazione degli annunci nelle schede personalizzate. Per ulteriori informazioni, consulta Ottimizzare le schede personalizzate. È stata aggiornata la dipendenza dall'SDK User Messaging Platform alla versione 2.2.0.
22.6.0	06‑12‑2023	È stato deprecato `MobileAds.setSameAppKeyEnabled()` e il metodo è stato rinominato in `MobileAds.putPublisherFirstPartyIdEnabled()`. `AdFormat.UNKNOWN` è stato ritirato senza alcuna sostituzione. Le app che utilizzano `QueryInfo.generate()` devono passare un formato dell'annuncio.
22.5.0	30‑10‑2023	È stata aggiornata la dipendenza dall'SDK User Messaging Platform alla versione 2.1.0. È stato aggiunto il metodo `setPublisherPrivacyPersonalizationState()` per Publisher Privacy Treatment API (beta).
22.4.0	13‑09‑2023	Richiede un `compileSdkVersion` minimo di `33`. Strumento di controllo degli annunci: è stato aggiunto il supporto dell'SDK per la richiesta e la visualizzazione degli annunci richiesti tramite l'interfaccia utente dello strumento di controllo degli annunci. È stato aggiunto un nuovo metodo `QueryInfo.generate()` che accetta un ID unità pubblicitaria. Consente i primi test delle API incentrate sulla tutela della privacy Attribution Reporting beta e Topics beta. Per saperne di più, consulta la guida AdMob Privacy Sandbox su Android.
22.3.0	22‑08‑2023	È stato aggiunto il supporto per la creazione di dimensioni adattabili utilizzando `AdSize.FULL_WIDTH` come larghezza. In precedenza, le dimensioni degli annunci create utilizzando `AdSize.FULL_WIDTH` venivano trattate come `AdSize.SMART_BANNER`.
22.2.0	5-07-2023	Eventi personalizzati: Obsoleta `AdRequest.Builder.addCustomEventExtrasBundle()`. Estendi l'adattatore e interagisci con i parametri aggiuntivi tramite `AdRequest.Builder.addNetworkExtrasBundle()`. `AdRequest.getCustomEventExtrasBundle()` obsoleto. Estendi l'adattatore e interagisci con i parametri aggiuntivi tramite `AdRequest.getNetworkExtrasBundle()`.
22.1.0	18‑05‑2023	Strumento di controllo degli annunci: è stata attivata la possibilità di attivare le richieste di annunci dall'interfaccia utente dello strumento di controllo degli annunci sui dispositivi che non dispongono di Google Play Services.
22.0.0	29-03-2023	Questa release è un aggiornamento PRINCIPALE della versione con diverse modifiche che provocano errori. Per ulteriori informazioni su come eseguire la migrazione, consulta la pagina Eseguire la migrazione all'SDK v22. Modifiche che provocano un errore: Rimossi `NativeCustomFormatAd.getVideoController()` e `NativeCustomFormatAd.getVideoMediaView()` in favore di `NativeCustomFormatAd.getMediaContent()`. `MobileAds.getVersionString()` è stato rimosso in favore di `MobileAds.getVersion()`. `AdRequest.Builder.setAdInfo()` è stato rimosso in favore di `AdRequest.Builder.setAdString()`. `AdManager.Builder.setAdString()` ora restituisce un tipo `AdRequest.Builder`. `MediationRewardedVideoAdAdapter` e le API associate sono state rimosse a favore di `Adapter`. `AdRequest.getRequestAgent()` aggiunti. Mediazione: il valore restituito per `Adapter.getVersionInfo()` e `Adapter.getSDKVersionInfo()` è passato dal tipo `com.google.android.gms.ads.mediation.VersionInfo` a `com.google.android.gms.ads.VersionInfo`. Consigliamo agli adattatori di restituire il nuovo tipo poiché `com.google.android.gms.ads.mediation.VersionInfo` è stato ritirato.
21.5.0	31-01-2023	Annunci di apertura dell'app: sono stati ritirati i metodi `AppOpenAd.load()` che accettano un parametro di input di orientamento e sono stati aggiunti nuovi metodi che non accettano un input di orientamento. I nuovi metodi determinano l'orientamento al momento della richiesta, in modo da corrispondere al comportamento di altri formati a schermo intero. Mediazione: è stato aggiunto il supporto della mediazione per gli annunci apertura app. È stata rimossa l'autorizzazione `RECEIVE_BOOT_COMPLETED` dalla dipendenza `androidx.work:work-runtime`. Se utilizzi versioni di Gradle precedenti alla 7.2.0 e richiedi l'autorizzazione per la tua app, potresti dover dichiarare l'autorizzazione esplicitamente nel file manifest di Android.
21.4.0	14‑12‑2022	L'ID app Ad Manager è ora obbligatorio per tutte le app Ad Manager e richiede il formato `ca-app-pub-################~##########`. Per ulteriori dettagli, consulta Configurare l'app. Strumento di controllo degli annunci: espandi il supporto dell'SDK per la visualizzazione di annunci banner e annunci nativi richiesti tramite l'interfaccia utente dello strumento di controllo degli annunci. È stato aggiunto il supporto per l'ID proprietario del publisher (precedentemente noto come stessa chiave dell'app) per aiutarti a pubblicare annunci più pertinenti e personalizzati utilizzando i dati raccolti dalle tue app. Versione release ufficiale per la generazione `QueryInfo`.
21.3.0	10-10-2022	Strumento di controllo degli annunci: è stato aggiunto il supporto dell'SDK per la richiesta e la visualizzazione degli annunci richiesti tramite l'interfaccia utente dello strumento di controllo degli annunci. Annunci nativi: `getMediaContent()` è stato aggiunto a `MediaView`. Annunci nativi personalizzati: `getMediaContent()` è stato aggiunto a `NativeCustomFormatAd`. `getVideoMediaView()` deprecato. Crea il tuo `MediaView` e utilizza `NativeCustomFormatAd.getMediaContent()`. `getVideoController()` deprecato. Utilizza invece `NativeCustomFormatAd.getMediaContent().getVideoController()`.
21.2.0	06‑09‑2022	Strumento di controllo degli annunci: è stato aggiunto il supporto dell'SDK per l'esportazione dei log delle richieste di annunci tramite la scheda Condivisione di Android.
21.1.0	14‑07‑2022	È stato aggiunto il supporto per la monetizzazione degli annunci in `WebView`. Per ulteriori dettagli, consulta Integrare l'API WebView per gli annunci. È stato aggiunto `getResponseExtras()` a `ResponseInfo` che potrebbe restituire informazioni aggiuntive sulla risposta all'annuncio. Beta: l'API `getResponseExtras()` è in versione beta. Il valore restituito potrebbe cambiare senza una release dell'SDK.
21.0.0	25-05-2022	Questa release è un aggiornamento PRINCIPALE della versione con diverse modifiche che provocano errori. Per ulteriori informazioni su come eseguire la migrazione, consulta la guida Eseguire la migrazione all'SDK v21. Modifiche che provocano un errore: Per poter funzionare, l'SDK Google Mobile Ads ora richiede che tutte le app siano almeno al livello API Android 19. Sono state aggiunte annotazioni `@NonNull` in ogni metodo che in precedenza non definiva esplicitamente i valori null. Metodo `AdRequest.Builder.addNetworkExtras()` rimosso. Usa invece `AdRequest.Builder.addNetworkExtrasBundle()`. Sono stati rimossi i seguenti metodi di geolocalizzazione: `setLocation()` su `AdRequest.Builder` `getLocation()` su `AdRequest` `getLocation()` su `MediationAdConfiguration` Sono stati aggiunti flag del file manifest per ottimizzare l'inizializzazione e il caricamento degli annunci. Per ulteriori dettagli, consulta la guida all'inizializzazione e al caricamento degli annunci di Optimize. `MobileAds.getVersionString()` obsoleto. Utilizza `MobileAds.getVersion()` al suo posto. È stato aggiunto il metodo `getLoadedAdapterResponseInfo()` in `ResponseInfo`. Sono stati aggiunti i seguenti metodi in `AdapterResponseInfo`: `getAdSourceName()` `getAdSourceId()` `getAdSourceInstanceName()` `getAdSourceInstanceId()` Beta: queste API sono in versione beta. I valori restituiti potrebbero cambiare senza una release dell'SDK. Aggiunto il supporto per gli eventi personalizzati nello strumento di controllo degli annunci.
20.6.0	22‑02‑2022	Sono state ritirate tutte le interfacce degli eventi personalizzati. Utilizza invece la classe `Adapter` e `MediationAdLoadCallback`. È stato aggiunto il supporto per SharedPreferences `gad_has_consent_for_cookies`. L'SDK Google Mobile Ads attiverà gli annunci con limitazioni (LTD) quando la preferenza `gad_has_consent_for_cookies` è impostata su 0. Per maggiori dettagli, consulta Impostare il consenso per i cookie. L'SDK Google Mobile Ads disattiva la trasmissione dell'identificatore pubblicità di Android (AAID) quando viene chiamato `RequestConfiguration.Builder.setTagForChildDirectedTreatment()` con `TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE` (vedi impostazione per siti o servizi destinati ai minori) o viene chiamato `RequestConfiguration.Builder.setTagForUnderAgeOfConsent()` con `TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE` (vedi impostazione per gli utenti di età inferiore all'età del consenso digitale).
20.5.0	18‑11‑2021	Aggiunto il supporto dei dispositivi Android 12 per le app che hanno come target l'API 31. È stato aggiunto il supporto per l'ID set di app per casi d'uso come generazione di report e prevenzione delle frodi.
20.4.0	22‑09‑2021	Questa release e tutte le versioni precedenti richiedono una dipendenza esplicita da `androidx.work:work-runtime:2.7.0` per correggere un bug che causa arresti anomali dell'app su Android S con la seguente analisi dello stack: Fatal Exception: java.lang.IllegalArgumentException: com.mycompany.myapp: Targeting S+ (version 10000 and above) requires that one of FLAG_IMMUTABLE or FLAG_MUTABLE be specified when creating a PendingIntent. Strongly consider using FLAG_IMMUTABLE, only use FLAG_MUTABLE if some functionality depends on the PendingIntent being mutable, e.g. if it needs to be used with inline replies or bubbles. at android.app.PendingIntent.checkFlags(PendingIntent.java:386) at android.app.PendingIntent.getBroadcastAsUser(PendingIntent.java:657) at android.app.PendingIntent.getBroadcast(PendingIntent.java:644) at androidx.work.impl.utils.ForceStopRunnable.getPendingIntent(ForceStopRunnable.java:174) at androidx.work.impl.utils.ForceStopRunnable.isForceStopped(ForceStopRunnable.java:108) at androidx.work.impl.utils.ForceStopRunnable.run(ForceStopRunnable.java:86) at androidx.work.impl.utils.SerialExecutor$Task.run(SerialExecutor.java:75) at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1167) at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:641) at java.lang.Thread.run(Thread.java:920) Per risolvere il bug, aggiungi le seguenti dipendenze per l'SDK Google Mobile Ads al file Gradle a livello di app del tuo modulo: dependencies { implementation 'com.google.android.gms:play-services-ads:20.4.0' // For apps targeting Android 12, add WorkManager dependency. constraints { implementation('androidx.work:work-runtime:2.7.0') { because '''androidx.work:work-runtime:2.1.0 pulled from play-services-ads has a bug using PendingIntent without FLAG_IMMUTABLE or FLAG_MUTABLE and will fail in Apps targeting S+.''' } } } A partire dalla versione 20.4.0, l'SDK Google Mobile Ads include l'autorizzazione `com.google.android.gms.permission.AD_ID` nel manifest dell'SDK, che viene unita automaticamente al manifest dell'app dagli strumenti di compilazione di Android. Per scoprire di più sulla dichiarazione delle autorizzazioni `AD_ID` , inclusa la modalità di disattivazione, consulta questo articolo del Centro assistenza Play Console. È stato aggiunto il callback `onAdClicked()` a `FullScreenContentCallback`. È stato attivato il callback `onAdClicked()` nella classe `AdListener` per il formato dell'annuncio nativo.
20.3.0	23-08-2021	Deprecato il metodo `AdRequest.Builder.addNetworkExtras()` . Utilizza `AdRequest.Builder.addNetworkExtrasBundle()` al suo posto. Annunci nativi: `AdLoader.Builder.forCustomFormatAd()` ora accetta un valore `OnCustomClickListener` nullo. Adattatori di mediazione: è stata corretta l'annotazione della nullità per il parametro `mediationExtras` in tutte le chiamate di caricamento dell'adattatore di mediazione.
20.2.0	08‑06‑2021	È stato aggiunto il supporto della funzionalità di controllo degli annunci (beta) per i publisher di Google Ad Manager.
20.1.0	29‑04‑2021	Banner adattivo: è stata aggiunta la funzionalità per richiedere annunci banner adattivi in linea con un'altezza massima. `AdSize.getInlineAdaptiveBannerAdSize()` È stato aggiunto `AdError.toString()` per semplificare il logging.
20.0.0	05‑04‑2021	Questa release è un aggiornamento PRINCIPALE della versione con diverse modifiche che provocano errori. Per ulteriori informazioni sulla migrazione, consulta la guida su come prepararsi all'SDK v20. Modifiche che provocano un errore: API `Interstitial` precedente rimossa. È stata rimossa l'API `RewardedVideoAd` precedente. Sono stati rimossi i corsi con prefisso `Publisher` (ad es. `PublisherAdView`). `CustomRenderedAd` rimosso. `InstreamAd` rimosso. `SearchAdRequest` rimosso. `AdListener.onAdLeftApplication()` rimosso. `NativeAppInstallAd`, `NativeContentAd` e `UnifiedNativeAd` sono stati rimossi. Ora è disponibile un formato dell'annuncio nativo denominato `NativeAd`. `RewardedAd` è ora una classe astratta. Utilizza il metodo statico `RewardedAd.load()` per caricare un annuncio con premio. È stato aggiunto lo strumento di controllo degli annunci (beta). `AdSize.SMART_BANNER` ritirato a favore degli annunci banner adattivi. Sono state aggiunte annotazioni di nullità esplicite a tutte le API pubbliche.
19.8.0	15‑03‑2021	È stata aggiunta una dipendenza dall' SDK User Messaging Platform. È stato aggiunto il callback `onAdImpression()` a `FullScreenContentCallback`. Il formato `InstreamAd` è stato ritirato. Adattatori di mediazione: Deprecati `MediationBannerAdapter`, `MediationInterstitialAdapter` e `MediationNativeAdapter`. I nuovi adattatori devono implementare la classe `Adapter` per caricare questi formati. Nota: queste classi di adattatori di mediazione deprecate non verranno rimosse nella versione 20.0.0 per dare agli adattatori di mediazione il tempo di eseguire la transizione alla nuova API. Ora gli adattatori di offerta possono implementare metodi di caricamento distinti nella classe `Adapter` per i formati specifici RTB.
19.7.0	2021‑01‑20	Modifiche principali a: `InterstitialAd` `RewardedAd` `NativeAd` `AppOpenAd` `CustomRenderedAd` deprecato. Le classi e i pacchetti con il prefisso `Publisher` sono stati ritirati e sostituiti con il prefisso `AdManager`. Ultima release secondaria prima della versione 20.0.0. Tutte le API contrassegnate come obsolete in questa release e nelle release precedenti verranno rimosse nella versione 20.0.0. Per maggiori dettagli, consulta la guida alla migrazione alla versione 20.0.0.
19.6.0	04‑12‑2020	È stato ritirato il metodo `onAdLeftApplication() AdListener`. È stato corretto un bug per cui agli utenti che utilizzano dispositivi Android 11 viene chiesto di selezionare un browser quando fanno clic su un annuncio.
19.5.0	2020‑10‑20	Annunci banner: il metodo `onAdImpression() AdListener` viene ora chiamato per gli annunci banner. È stato aggiunto il metodo `setHttpTimeoutMillis()` per personalizzare il timeout per le chiamate HTTPS effettuate dall'SDK Google Mobile Ads.
19.4.0	10-09-2020	È stato aggiunto il supporto per i dispositivi Android 11 per le app che hanno come target l'API 30. Annunci apertura app: è stato modificato il formato `AppOpenAd` per funzionare più come un formato a schermo intero rispetto a una visualizzazione banner. Sono stati aggiunti metodi `getResponseInfo()` e `show()` a `AppOpenAd`. Le classi `AppOpenAdView` e `AppOpenAdPresentationCallback` sono state ritirate. Mediazione: ora sono disponibili i report sullo stato della mediazione. Utilizza `ResponseInfo.getAdapterResponses()` per ottenere informazioni sulla risposta per ogni rete pubblicitaria che ha partecipato a una richiesta di annunci. Annunci con premio legacy: ritirati `RewardedVideoAd`. È stato corretto un bug per cui `MobileAds.initialize()` richiama il gestore del completamento una sola volta. Ogni chiamata a `MobileAds.initialize()` ora invoca il callback di completamento.
19.3.0	20-07-2020	Attenzione: le versioni dell'SDK 19.3.0 e precedenti non supportano Android 11 (API 30). Ti consigliamo di utilizzare la versione SDK 19.4.0 o superiore se prevedi di impostare `targetSdkVersion` sull'API 30. Sono stati aggiunti i metodi `getDomain()` e `getCause()` a `AdError`. Sono stati aggiunti nuovi callback relativi agli errori di caricamento a tutti i formati degli annunci che restituiscono un valore `LoadAdError`. Ad es. `onAdFailedToLoad(LoadAdError)`. Callback di errore di caricamento non più supportati che restituiscono un int. Ad esempio, `onAdFailedToLoad(int)`. Annunci con premio: è stato aggiunto `onRewardedAdFailedToShow(AdError)` e ritirato `onRewardedAdFailedToShow(int)`. Mediazione con premio: è stato aggiunto il codice di errore di presentazione `MEDIATION_SHOW_ERROR`. Tutti gli errori di visualizzazione relativi agli annunci mediati ora resistono `MEDIATION_SHOW_ERROR` per `AdError.getCode()` e un `AdError.getCause()` non nullo che rappresenta l'errore di mediazione di fondo.
19.2.0	18‑06‑2020	È stato aggiunto il formato `RewardedInterstitialAd`. Questa funzionalità è attualmente in versione beta privata. Contatta il tuo account manager per richiedere l'accesso. Annunci nativi: è stata aggiunta un'interfaccia utente dello strumento di convalida nativo per le richieste di test per aiutarti a rilevare e correggere le violazioni delle norme relative agli annunci nativi. È stato aggiunto il metodo `MobileAds.disableMediationAdapterInitialization()`. Chiama questo metodo prima di inizializzare l'SDK Google Mobile Ads per disabilitare l'inizializzazione dell'adattatore di mediazione. Avviso:la chiamata di questo metodo può influire negativamente sulle prestazioni della mediazione Google. Questo metodo dovrebbe essere chiamato solo se includi gli adattatori di mediazione Google nella tua app, ma non esegui la mediazione tramite Google durante una determinata sessione dell'app (ad esempio, stai eseguendo un test di mediazione A/B).
19.1.0	16‑04‑2020	Ritirato `MobileAds.initialize(Context, String)` in favore di `MobileAds.initialize(Context, OnInitializationCompleteListener)`. `AdRequest.isTestDevice()` ora restituisce `true` per i dispositivi di test impostati tramite `MobileAds.setRequestConfiguration()`. È stato risolto l'arresto anomalo NullPointerException in `MobileAds.initialize()` che si verificava su alcuni dispositivi nelle app che utilizzano SDK Lite.
19.0.1	18-03-2020	Annunci nativi: è stato corretto un problema di perdita di memoria che si verificava durante l'utilizzo di `NativeCustomTemplateAd`.
19.0.0	02‑03‑2020	Questa release è un aggiornamento PRINCIPALE della versione con le seguenti modifiche che comportano interruzioni: È stata aggiornata la versione minima dell'SDK Android all'API 16 per allinearsi ai criteri di distribuzione di Google Play Services. Annunci nativi: `MediaContent` è stato spostato nel pacchetto `com.google.android.gms.ads`. È stato aggiunto il supporto per la lettura dei parametri di consenso dalla versione 2.0 del TCF di IAB e dalla stringa `us_privacy` di IAB. `setNeighboringContentUrls()` e `getNeighboringContentUrls()` aggiunti a `AdRequest`. È stata aggiunta la classe `ResponseInfo` che fornisce informazioni su un annuncio caricato. Per tutti i formati degli annunci, è stato ritirato `getMediationAdapterClassName()` a favore di `getResponseInfo()`. Annunci nativi: sono stati aggiunti i metodi `getDuration()` e `getCurrentTime()` a `MediaContent`. Mediazione nativa: sono stati aggiunti i metodi `getDuration()` e `getCurrentTime()` a `UnifiedNativeAdMapper` per l'implementazione degli adattatori. `AdRequest.Builder.addTestDevice()` obsoleto. Utilizza `RequestConfiguration.Builder.setTestDeviceIds()`.
18.3.0	05‑11‑2019	Sono state aggiunte API per il formato dell'annuncio `InstreamAd`. Questa funzionalità è attualmente in versione beta privata. Contatta il tuo account manager per richiedere l'accesso. Banner adattivo: sono stati modificati i metodi di creazione dei banner adattivi nel corso `AdSize`. Ad esempio, `AdSize.getCurrentOrientationBannerAdSizeWithWidth()` è stato rinominato in `AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize()`. Mediazione: l'SDK Google Mobile Ads ora intercetta le eccezioni generate dagli adattatori di mediazione. Mediazione con premio: è stato corretto un bug per cui, se più annunci con premio mediati vengono memorizzati nella cache, ne veniva visualizzato solo uno. È stato aggiunto il metodo `setTestDeviceIds()` per consentire di impostare i dispositivi di test una volta per tutte le richieste di annunci.
18.2.0	29‑08‑2019	Sono state aggiunte API per il formato `AppOpenAd`. Questa funzionalità è attualmente in versione beta privata. Contatta il tuo account manager per richiedere l'accesso.
18.1.1	23‑07‑2019	Mediazione: ora gli adattatori vengono inizializzati quando le app chiamano `MobileAds.initialize(Context, OnInitializationCompleteListener)`. Mediazione: le eccezioni dell'adattatore le cui tracce dello stack includono l'SDK Google Mobile Ads ora vengono rilevate e gestite dall'SDK Google Mobile Ads.
18.1.0	09‑07‑2019	Uscita ufficiale per il supporto di App Measurement. Per impostazione predefinita, la misurazione delle app inizializza e invia i dati all'avvio dell'app. È stata aggiunta un'opzione per ritardare la misurazione delle app fino alla chiamata esplicito dell'SDK Google Mobile Ads. È stato aggiunto un nuovo metodo di inizializzazione, `MobileAds.initialize(Context, OnInitializationCompleteListener)`, che ti invia una notifica quando l'SDK Google Mobile Ads e tutti gli adattatori di mediazione configurati hanno completato l'inizializzazione. È stato aggiunto `MobileAds.getInitializationStatus()` per fornire lo stato di inizializzazione di tutte le reti pubblicitarie configurate per la tua app. `MobileAds.getRequestConfiguration()` aggiunto. I parametri di targeting impostati su questo oggetto di configurazione vengono utilizzati per tutte le richieste di annunci. Annunci nativi: è stato aggiunto il metodo `NativeAdOptions.Builder.setMediaAspectRatio()` per richiedere un'area immagine specifica per l'asset media di un annuncio nativo. Questa opzione ha la precedenza sul metodo `setImageOrientation()` ora deprecato. Annunci nativi: per gli annunci non video, ora è possibile impostare il tipo di scala dell'immagine di MediaView utilizzando `MediaView.setImageScaleType()`. Annunci nativi: aggiunto `UnifiedNativeAd.getMediaContent()`. Ora i publisher che caricano le immagini solo tramite URL possono recuperare i contenuti media dell'annuncio, fornire un'immagine e chiamare `MediaView.setMediaContent()` per compilare i dati delle immagini tramite `MediaView` per gli annunci non video. Mediazione annunci nativi: gli adattatori ora possono fornire le proporzioni tramite `UnifiedNativeAdMapper.setMediaContentAspectRatio()`. Sono state aggiunte dipendenze da `play-services-measurement` e `play-services-measurement-sdk`. Le app non devono più aggiungere queste dipendenze in modo esplicito.
18.0.0	17‑06‑2019	Migrazione dalle librerie di assistenza Android alle librerie Jetpack (AndroidX). Per ulteriori informazioni, consulta le note di rilascio di Google Play Services. Per evitare un arresto anomalo che si verifica al primo avvio dopo l'installazione dell'app dal Play Store, questa release richiede ai publisher di dichiarare dipendenze aggiuntive nel file build.gradle: com.google.android.gms:play-services-measurement:17.0.0 com.google.android.gms:play-services-measurement-sdk:17.0.0 Nota: questa release è un aggiornamento della versione MAJOR e comporta una modifica sostanziale.
17.2.1	21‑05‑2019	Correzione per l'ANR proveniente da `android.media.AudioManager.getStreamVolume`.
17.2.0	11-03-2019	Video con premio: è stato aggiunto un nuovo insieme di API con premio (vedi il pacchetto con premio) che ti consentono di caricare più annunci con premio contemporaneamente. Mediazione: è stato aggiunto un nuovo insieme di API di adattatori di mediazione che supportano l'inizializzazione. Gli adattatori che implementano la nuova API implementano la classe `Adapter`. I publisher che utilizzano `firebase-analytics` insieme alla versione `17.2.0` di una delle librerie di annunci (ad es. `com.google.android.gms:play-services-ads:17.2.0`) deve utilizzare `com.google.firebase:firebase-analytics:16.3.0`.
17.1.3	31‑01‑2019	I publisher che utilizzano `firebase-analytics` insieme alla versione `17.1.3` di una delle librerie di annunci (ad es. `com.google.android.gms:play-services-ads:17.1.3`) deve utilizzare `com.google.firebase:firebase-analytics:16.3.0`.
17.1.2	03-12-2018	Publisher che utilizzano `firebase-analytics` insieme alla versione `17.1.2` di qualsiasi raccolta di annunci (ad es. `com.google.android.gms:play-services-ads:17.1.2`) deve utilizzare `com.google.firebase:firebase-analytics:16.0.6`.
17.1.1	12‑11‑2018	È stato corretto un bug per cui determinate combinazioni di `play-services-ads` e `firebase-analytics` (ad es. `ads:17.1.0` e `analytics:16.0.5`) ha generato un errore del compilatore `duplicate entry`. I publisher che utilizzano `firebase-analytics` insieme alla versione `17.1.1` di una delle librerie di annunci (ad es. `com.google.android.gms:play-services-ads:17.1.1`) deve utilizzare `com.google.firebase:firebase-analytics:16.0.5`.
17.1.0	02‑11‑2018	Sono stati aggiunti i metodi `setMaxAdContentRating()` e `setTagForUnderAgeOfConsent()` a `AdRequest.Builder`. Sono state aggiunte le seguenti costanti da utilizzare con `AdRequest.Builder.setMaxAdContentRating()` e `AdRequest.Builder.setTagForUnderAgeOfConsent()`: `MAX_AD_CONTENT_RATING_G` `MAX_AD_CONTENT_RATING_PG` `MAX_AD_CONTENT_RATING_T` `MAX_AD_CONTENT_RATING_MA` `TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE` `TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE` `TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED`
17.0.0	05‑10‑2018	I publisher AdMob Google devono specificare un `<meta-data>` tag con chiave `com.google.android.gms.ads.APPLICATION_ID` nel file AndroidManifest.xml. Per ulteriori dettagli, consulta la guida introduttiva. Annunci nativi: `NativeAppInstallAd`, `NativeContentAd` e le API associate sono ritirate a favore di `UnifiedNativeAd`. Per ulteriori istruzioni sull'utilizzo delle nuove API, consulta Annunci nativi Utenza avanzata. Annunci nativi: è stata aggiunta la funzionalità "Disattiva questo annuncio". Annunci nativi: è stato rimosso il log di avviso benigno "UnconfirmedClickListener non deve essere nullo quando è impostata ClickConfirmingView". Annunci con premio: è stato aggiunto il metodo `setAdMetadataListener` su `RewardedVideoAd` per rilevare le modifiche ai metadati degli annunci. Annunci con premio: la chiamata a `destroy()` azzera l'ascoltatore. I seguenti metodi sono stati ritirati il giorno `AdRequest.Builder`. `setGender()` `setBirthday()` `setIsDesignedForFamiles()` È stato corretto un bug per cui `onRewardedVideoCompleted()` non veniva attivato sugli emulatori.
16.0.0	02‑10‑2018	Nessuna modifica agli annunci. Per ulteriori informazioni, consulta le note di rilascio di Google Play Services.
15.0.0	2018‑04‑12	Versione beta di MRAID v3. Annunci nativi: è stata aggiunta l'API Unified Native Ad. In questo modo, `NativeAppInstallAds` e `NativeContentAds` vengono combinati in un nuovo tipo: `UnifiedNativeAd`. Nota: quando utilizzi gli annunci nativi, viene visualizzato un avviso innocuo nei log quando viene fatto clic sull'annuncio nativo: "UnconfirmedClickListener non deve essere nullo mentre ClickConfirmingView è impostato." Questo avviso può essere ignorato e verrà rimosso nella prossima release.
12.0.1	28‑03‑2018	Nessuna modifica agli annunci. Per ulteriori dettagli, consulta le note di rilascio di Google Play Services.
12.0.0	2018‑03‑20	Video con premio: è stato aggiunto il metodo di callback `onRewardedVideoCompleted()` a `RewardedVideoAdListener`. Per evitare un errore di compilazione durante l'aggiornamento alla versione 12.0.0, le app devono overrideare questo callback nella loro implementazione di `RewardedVideoAdListener`. Mediazione nativa: è stato aggiunto il metodo `trackViews()` a `NativeAdMapper`, per consentire agli adattatori di accedere agli oggetti `View` corrispondenti ai singoli asset degli annunci nativi. `trackView()` è stato ritirato in favore di `trackViews()`.
11.8.0	18‑12‑2017	Correzioni di bug e miglioramenti generali.
11.6.0	7-11-2017	È stata aggiunta la classe `NativeAdViewHolder` e i metodi correlati in `NativeAppInstallAd` e `NativeContentAd`. `AdLoader.getMediationAdapterClassName` deprecato (i publisher devono utilizzare i metodi dello stesso nome in `NativeAppInstallAd` e `NativeContentAd`). Ora gli annunci di prova mostrano un'etichetta nella parte superiore dell'annuncio. Per ulteriori dettagli, consulta la guida ai test.
11.4.0	19‑09‑2017	Sono stati aggiunti metodi `getMediationAdapterClassName()` alle classi `NativeAppInstallAd` e `NativeContentAd`. Il metodo con lo stesso nome in `AdLoader` verrà ritirato. È stato aggiunto un metodo `onVideoEnd()` alla classe `MediationNativeListener`, i metodi `hasVideoContent()`, `setHasVideoContent()` e `setMediaView()` alla classe `NativeAdMapper` e i metodi `getAdVolume()` e `isAdMuted()` alla classe `NativeMediationAdRequest` per supportare la mediazione video nativa. È stato rimosso il corso `SearchAdRequest`.
11.2.2	05‑09‑2017	È stato aggiunto un nuovo metodo `loadAd()` che accetta un oggetto `PublisherAdRequest` alla classe `RewardedVideoAd`.
11.2.0	14‑08‑2017	Alla classe `AdLoader` è stato aggiunto il metodo `loadAds()`, che consente alle app di caricare più annunci univoci in una singola richiesta. Quando esegui l'upgrade dell'app alla versione 11.2.0 o successiva dell'SDK Google Mobile Ads, anche il `build.gradle` dell'app deve essere aggiornato in modo da specificare un valore `compileSdkVersion` di almeno `26` (Android O). Questo non cambia il modo in cui viene eseguita l'app. Non dovrai aggiornare `targetSdkVersion`. A partire dalla versione 11.2.0, l'SDK Google Mobile Ads è disponibile tramite il Repository Maven di Google. Per ulteriori informazioni, consulta le note di rilascio di Google Play Services.
11.0.0	07-06-2017	Sono stati aggiunti i metodi `onAdClicked()` e `onAdImpression()` alla classe `AdListener`. Questi metodi vengono richiamati solo per gli annunci per l'installazione di app native e gli annunci di contenuti nativi. Sono stati rimossi i metodi `getInAppPurchaseListener()` e `setInAppPurchaseListener()` dalle classi `AdView`, `InterstitialAd` e `NativeExpressAdView`. Sono stati rimossi anche i relativi tipi di acquisti in-app. Sono stati aggiunti i metodi `OnVideoMute()`, `OnVideoPause()`, `OnVideoPlay()` e `OnVideoStart()` alla classe `VideoController.VideoLifecycleCallbacks`. È stata aggiunta la possibilità di attivare la modalità immersiva sugli annunci a schermo intero aggiungendo il metodo `setImmersiveMode()` ai corsi `PublisherInterstitialAd` e `RewardedVideoAd`. È stata aggiunta l'interfaccia `OnPublisherAdViewLoadedListener`, la classe `PublisherAdViewOptions` e la classe `PublisherAdViewOptions.Builder` da utilizzare con `AdLoader` per le richieste native più banner. È stata aggiunta l'interfaccia facoltativa `OnImmersiveModeUpdatedListener` che gli adattatori di mediazione possono implementare per ricevere informazioni sugli aggiornamenti della modalità immersiva. È stato aggiunto il metodo `getMediationAdapterClassName()` alla classe `RewardedVideoAd`. Sono state aggiunte regole `keep` per preservare automaticamente i nomi delle classi dell'adattatore di mediazione quando si utilizza ProGuard.
10.2.0	15-2-2017	Google Play Services 10.2.x è la prima release che non include più il supporto completo per la versione 2.3.x di Android (Gingerbread). Le app sviluppate utilizzando l'SDK release 10.2.x e successive richiedono un livello API Android minimo 14 e non possono essere installate su dispositivi con un livello API inferiore a 14. Per scoprire di più sulle opzioni a tua disposizione, incluso il compilare più APK per estendere il supporto della tua app per Android Gingerbread, consulta il blog Android for Developers. È stato aggiunto il supporto degli asset video per i contenuti avanzati nativi e gli annunci con modello personalizzato. Sono stati aggiunti i metodi `getVideoController()`, `setVideoOptions()` e `getVideoOptions()` alla classe `PublisherAdView`. È stato aggiunto il corso `AdChoicesView`. Sono stati aggiunti i metodi `getAdChoicesContent()` e `setAdChoicesContent()` alla classe `NativeAdMapper`. È stata aggiunta l'interfaccia `InitializableMediationRewardedVideoAdAdapter` per gli adattatori di mediazione video con premio che vogliono attivare l'inizializzazione anticipata prima che venga effettuata una richiesta di annuncio. È stato aggiunto il supporto per l'anteprima in-app e la risoluzione dei problemi in Google Ad Manager.
10.0.1	21‑11‑2016	Correzioni di bug e miglioramenti generali.
9.8.0	24‑10‑2016	`MobileAds.Initialize(Context)` non è più deprecato. I publisher di Google Ad Manager devono chiamare questo metodo durante l'inizializzazione delle loro app. I publisher AdMob devono comunque utilizzare `MobileAds.Initialize(Context, String)` e trasmettere il codice dell'applicazione.
9.6.0	22‑09‑2016	È stata aggiunta la classe `MediaView` per gli annunci video nativi avanzati. È stato aggiunto un metodo `openDebugMenu()` alla classe `MobileAds` per l'anteprima delle creatività e la risoluzione dei problemi relativi alle unità pubblicitarie di Ad Manager. È stato aggiunto il supporto per gli eventi personalizzati video con premio.
9.4.0	01‑08‑2016	Correzioni di bug e miglioramenti generali.
9.2.0	27-06-2016	È stato aggiunto il metodo `setAdChoicesPlacement()` alla `NativeAdOptions.Builder` classe, che ora i publisher di app possono utilizzare per specificare la posizione del proprio `AdChoices` negli annunci nativi. La riproduzione degli annunci video è stata migliorata con diverse correzioni di bug.
9.0.1	26‑05‑2016	Risolve un problema di ProGuard introdotto nella versione 9.0.0. Gli editori non hanno più bisogno di un'opzione `keep` per `com.google.android.gms.common.util.DynamiteApi`.
9.0.0	2016‑05‑18	È stata aggiunta la compilazione automatica dei dati sulla posizione per le app che concedono esplicitamente l'autorizzazione di accesso alla posizione. È stato aggiunto il supporto per gli eventi personalizzati della mediazione video con premio. Sono state aggiunte opzioni video per gli annunci Native Express. Aggiornamento dell'API Annunci associati alla ricerca personalizzata. Metodo `setAppMuted()` aggiunto. Il metodo `MobileAds.initialize(android.content.Context, java.lang.String)` non è più deprecato. Il metodo `MobileAds.initialize(android.content.Context)` è stato ritirato. È stato aggiunto il metodo `MediationNativeListener.onAdImpression()` per registrare le impressioni negli adattatori di mediazione. Solo per questa release, le app che utilizzano ProGuard per il post-elaborazione dell'applicazione devono aggiungere la seguente opzione `keep` al file di configurazione di ProGuard: `-keep public @com.google.android.gms.common.util.DynamiteApi class * { *; }`
8.4.0	18‑12‑2015	È stato aggiunto un metodo pubblico, `MobileAds.setAppVolume()`, per comunicare all'SDK Mobile Ads il livello di volume corrente di un'app. Sono state implementate correzioni di bug e miglioramenti.
8.3.0	06‑11‑2015	È stato aggiunto il supporto per gli annunci video con premio. È stato aggiunto un metodo `isLoading()` a `PublisherAdView` e `PublisherInterstitialAd` per verificare se una richiesta di annuncio è in lavorazione. Il metodo `setIsDesignedForFamilies()` è stato aggiunto a `AdRequest.Builder` e `PublisherAdRequest.Builder`. È stato aggiunto un metodo `destroy()` a `NativeAdView`.
8.1.0	24-09-2015	Correzione di diversi bug.
7.8.0	13-08-2015	Versione release ufficiale di MRAID v2. È stato aggiunto un metodo `isLoading()` a `AdLoader`, `AdView`, e `InterstitialAd` per verificare se è in corso una richiesta di annuncio. `PublisherAdRequest.Builder#setManualImpressionsEnabled()` obsoleto. Utilizza invece `PublisherAdView#setManualImpressionsEnabled()`.
7.5.0	28-05-2015	È stato aggiunto il supporto per i formati degli annunci nativi per l'installazione di app e di contenuti in AdMob e Ad Manager. È stato aggiunto il supporto per i formati degli annunci nativi personalizzati, disponibili per le prenotazioni di Ad Manager.
7.3.0	28-04-2015	Correzione di diversi bug.
7.0.0	2015‑03‑19	Sono stati aggiunti i metodi `addCustomTargeting()` e `addCategoryExclusion()` a `PublisherAdRequest.Builder`. Risolto un problema per cui `PublisherAdView.recordManualImpression()` registra più impressioni in Ad Manager quando viene utilizzato il conteggio manuale delle impressioni. È stato risolto un problema che causava il rendering non corretto degli annunci quando si utilizzava l'attributo `android:largestWidthLimitDp` nel tag `<supports-screens>`. Il metodo `setRequestAgent()` è stato aggiunto a `AdRequest.Builder` e `PublisherAdRequest.Builder`. Questo metodo deve essere utilizzato per indicare le origini delle richieste di annunci da parte di terze parti che mediano con l'SDK Mobile Ads.
6.5.87	08‑12‑2014	È stata introdotta l'architettura JAR suddivisa: ora gli sviluppatori di Android Studio possono includere solo la parte relativa agli annunci di Google Play Services facendo riferimento a `com.google.android.gms:play‑services‑ads:6.+`. Nota: le app che creano annunci banner in XML devono comunque fare riferimento all'intera raccolta `com.google.android.gms:play‑services:6.+`. Correzione di diversi bug.
6,1	08‑10‑2014	È stato aggiunto un metodo `getLocation()` a `com.google.android.gms.ads.MediationAdRequest`. È stata aggiunta una descrizione dei contenuti al pulsante di chiusura dell'interstitial per motivi di accessibilità. È stato rimosso il logging di "Risorse Google Play non trovate" quando il progetto della biblioteca è collegato correttamente. È stato aggiunto `getMediationAdapterClassName()` a `AdView` per ottenere il nome della classe dell'adattatore di mediazione della rete pubblicitaria che sta attualmente mostrando un annuncio.
5,0	25‑06‑2014	Sono state aggiunte nuove API per implementare gli eventi personalizzati. È stato aggiunto il flusso di acquisto predefinito per l'acquisto in-app, utilizzando l'API Fatturazione Google Play.
4.4	7-05-2014	Sono state aggiunte nuove API Mediation Adapter. È stato aggiunto un nuovo formato dell'annuncio `LARGE_BANNER` 320 x 100 sia per smartphone che per tablet. Aggiunto un nuovo formato interstitial per gli acquisti in-app. Imposta un `InAppPurchaseListener` su `InterstitialAd` per monitorare gli eventi di acquisto in-app. Correzione di bug per l'arresto anomalo di `SecurityException` dovuto alla lettura di gservices senza autorizzazione.
4.3	17‑03‑2014	`InterstitialAd` ora funziona se viene passato un contesto dell'applicazione. Metodo `setContentUrl()` aggiunto a `PublisherAdRequest.Builder`. Correzione dell'eccezione quando Servizio non registrato.
4.2	03‑02‑2014	Correzione di diversi bug.
4.1	16‑01‑2014	È stato aggiunto il supporto per Ad Manager e gli annunci della rete di ricerca per le app mobile. `AdRequest.Builder` ora ha un metodo `setLocation()`. È stato corretto un arresto anomalo che si verificava se veniva richiesto un annuncio interstitial, ma nel manifest non era specificato `AdActivity`.
4.0	31-10-2013	Le API Google Mobile Ads ora fanno parte di Google Play Services. Gli aggiornamenti futuri alle API Google Mobile Ads vengono inviati automaticamente ai dispositivi tramite Google Play Services. Ad Manager e gli annunci della rete di ricerca per le app mobile non sono ancora supportati.