Cronologia delle release dell'SDK IMA per Android di Google

Versione Data di uscita Note
3.40.0 2026-08-20
  • Richiede (minSdkVersion) 24.
  • Corregge un problema per cui l'SDK IMA non riesce a richiamare in modo invisibile i metodi onLoadStream() o loadUrl() dopo una richiesta di stream DAI riuscita.
  • Aggiunge i seguenti codici di errore dell'annuncio:
    • COMPANION_DIMENSION_MISMATCH: si verifica quando le dimensioni di una creatività annuncio companion non corrispondono all'area di visualizzazione della creatività.
    • STREAM_INITIALIZATION_FAILED: si verifica quando si verifica un errore con l'inizializzazione dello stream durante l'inserimento di annunci lato server.
    • ASSET_FALLBACK_FAILED: si verifica quando esiste un problema con il fallback delle risorse.
    • UNSUPPORTED_URL: si verifica quando l'URL dell'annuncio non è valido o non è supportato dal browser corrente.
    • STREAM_INITIALIZATION_TIMEOUT: si verifica quando la richiesta di inizializzazione dello stream scade.
    • STREAM_AUTHORIZATION_FAILED: si verifica quando l'autorizzazione dello stream non va a buon fine.
  • Risolve il seguente avviso:
    • Unable to resolve Lcom/google/ads/interactivemedia/v3/impl/data/AutoValue_WebViewInitData_JavaScriptNativeBridgeInitData; annotation class 8784 .
  • Migliora le annotazioni di nullabilità per le API per migliorare la sicurezza dei tipi.
3.39.0 2026-01-22
  • In questa versione si verifica un problema noto in cui l'SDK IMA non riesce a richiamare i metodi onLoadStream() o loadUrl() in seguito a una richiesta di stream DAI riuscita. Per risolvere questo problema, utilizza la versione 3.40.0 o successive.
  • Aggiunge i metodi getAudioMimeType() e getVideoMimeType() alla classe AdMediaInfo.
  • Aggiunge l'annotazione @Nullable ai metodi dell'interfaccia SDK.
  • Aggiunge un metodo ImaSdkFactory.release() per liberare spazio dagli asset IMA se non viene creata un'istanza dell'interfaccia AdsLoader.
  • Rimuove i seguenti metodi dell'interfaccia AdsRequest ritirati:
    • setExtraParameter()
    • getExtraParameter()
    • getExtraParameters()
  • Rimuove i metodi ritirati AdDisplayContainer.setPlayer() e StreamDisplayContainer.setVideoStreamPlayer().
  • Rimuove i seguenti metodi di interfaccia BaseDisplayContainer ritirati:
    • setAdContainer()
    • registerVideoControlsOverlay()
    • unregisterAllVideoControlsOverlays()
  • Rimuove i seguenti metodi dell'interfaccia CuePoint ritirati:
    • getStartTime()
    • getEndTime()
  • Corregge un problema di perdita di memoria durante l'eliminazione di un'istanza BaseManager correlata a un messaggio Attempted to send bridge message after cleanup in logcat.
3.38.0 2025-10-07
  • In questa versione si verifica un problema noto in cui l'SDK IMA non riesce a richiamare i metodi onLoadStream() o loadUrl() in seguito a una richiesta di stream DAI riuscita. Per risolvere questo problema, utilizza la versione 3.40.0 o successive.
  • Richiede (minSdkVersion) 23.
  • Aggiunge un'interfaccia AdSlot e aggiorna l'interfaccia CompanionAdSlot per estendere l'interfaccia AdSlot.
  • Corregge un problema ANR che si verifica durante il recupero del volume del dispositivo dal thread principale.
  • La versione 3.38.0 dell'SDK IMA verrà ritirata il 22/01/2027. Per maggiori dettagli, consulta il programma di ritiro.
3.37.0 2025-07-15
  • Aggiunge la rimozione dello zucchero sintattico dell'app come requisito per le app che integrano l'SDK IMA. Le app senza desugaring abilitato non verranno create con le versioni IMA attuali o future. Per attivare la rimozione dello zucchero sintattico dell'app, vedi Aggiungere l'SDK IMA al progetto.
  • Aggiorna i requisiti di versione minima per Android compileSdk al valore 35 e il valore del plug-in Android per Gradle a 8.6.0.
  • Aggiunge l'interfaccia AdPeriodInfo, accessibile utilizzando il metodo AdEvent#getAdPeriodInfo() sull'evento AD_PERIOD_STARTED.
  • Aggiunge l'interfaccia PlaybackMeasurementCollector per valutare le prestazioni dell'SDK e la pianificazione degli annunci nelle app ExoPlayer.
  • Aggiorna IMA in modo che generi un'eccezione se effettui una richiesta di annuncio o stream con parametri non validi.
  • Aggiunge il tipo di errore AdError.WEB_VIEW_ERROR che si verifica se il renderer WebView si arresta in modo anomalo. Questo nuovo tipo di errore risolve un problema per cui gli arresti anomali del renderer WebView causano l'arresto anomalo dell'app.
  • Ottimizza la funzione ImaSdkFactory.initialize() spostando parti dell'inizializzazione di WebView in un thread in background. Questa modifica riduce la probabilità di errori ANR durante la chiamata ImaSdkFactory.initialize().
  • Corregge un errore NullPointerException causato dall'avvio di una nuova richiesta di annunci durante la chiamata a AdsLoader.release().
  • Corregge un arresto anomalo di WebViewCompat.addWebMessageListener che si verifica sui dispositivi TV connessi a internet legacy.
  • Risolve un problema per cui l'SDK IMA non contrassegnava getPreviousCuePointForStreamTimeMs() come nullable.
  • Corregge un problema che causava l'arresto anomalo dell'SDK quando non era installata alcuna WebView. Nota: WebView è un componente fondamentale dell'SDK. Se non è installata alcuna WebView, l'SDK non può funzionare correttamente.
  • Aggiorna le dipendenze di WebKit alle ultime versioni stabili.
  • L'SDK IMA per Android prevede di aggiornare il livello API minimo richiesto (minSdkVersion) alla versione 23, in modo che corrisponda alle librerie Android Jetpack (AndroidX). Per saperne di più, consulta i requisiti di versione di Jetpack.
  • Rimuove i seguenti metodi ritirati:
    • Ad.getUniversalAdIdValue()
    • Ad.getUniversalAdIdRegistry()
    • AdsManager.requestNextAdBreak()
    • BaseManager.isCustomPlaybackUsed()
    • ImaSdkFactory.createAdDisplayContainer()
    • ImaSdkFactory.createAudioAdDisplayContainer(Context)
    • ImaSdkFactory.createStreamDisplayContainer()
    • StreamManager.getStreamTimeForContentTime(double contentTime)
    • StreamManager.getContentTimeForStreamTime(double streamTime)
    • StreamManager.getPreviousCuePointForStreamTime(double streamTime)
    • VideoProgressUpdate.getCurrentTime()
    • VideoProgressUpdate.getDuration()
  • La versione 3.37.0 dell'SDK IMA verrà ritirata il 7 ottobre 2026. Per maggiori dettagli, consulta il programma di ritiro.
3.36.0 7/11/2024
  • In questa versione viene introdotto un problema noto per le app istantanee . Se integri IMA nelle app istantanee, ti consigliamo di non aggiornare l'app alla versione 3.36.0 di IMA. La prossima release dell'SDK includerà una correzione per questo problema.
  • Aggiunge nuovi metodi di richiesta di stream che includono il parametro NetworkCode. I nuovi metodi sono ImaSdkFactory.createLiveStreamRequest() e ImaSdkFactory.createVodStreamRequest(). Ritira le API simili che non includono il parametro networkCode.
  • Esegue il wrapping delle creatività companion in un layout frame corrispondente alle dimensioni dell'area annuncio dichiarate con CompanionAdSlot.setSize().
  • La versione 3.36.0 dell'SDK IMA verrà ritirata il 15/07/2026. Per maggiori dettagli, consulta il programma di ritiro.
3.35.1 2024-09-24
  • È stato risolto un problema per cui Open Measurement non riesce quando viene utilizzata l'API ImaSdkFactory.initialize().
  • Aumenta a 21 il numero di minSdkVersion supportati da IMA.
  • Aggiunge ImaSdkFactory.initialize() per recuperare e inizializzare gli asset IMA prima della prima richiesta di annuncio. La chiamata initialize() alloca la memoria necessaria per la riproduzione futura degli annunci e riduce la latenza di riproduzione del primo annuncio. Per saperne di più, consulta Migliorare il tempo di caricamento di IMA.
  • Corregge un problema relativo a un URL di clickthrough dell'annuncio non valido.
  • Corregge un arresto anomalo introdotto in IMA v3.34.0 che interessa le app che non utilizzano il desugaring Java 8 nelle versioni dell'API Android 25 e precedenti.
  • Aggiunge ottimizzazioni al tempo di avvio di IMA sui dispositivi TV connessi a internet legacy.
  • Migliora la stabilità dell'apertura dei link sui dispositivi senza browser installato.
  • La versione 3.35.1 dell'SDK IMA verrà ritirata il 7 novembre 2025. Per maggiori dettagli, consulta il programma di ritiro.
3.35.0 Deprecated 2024-08-28
  • Esiste un problema noto con questa versione in cui la misurazione OMID non riesce quando si utilizza l'API ImaSdkFactory.initialize(). Utilizza l'SDK IMA per Android v3.35.1.
  • Poiché la versione 3.35.0 è ritirata, le relative note di rilascio sono state spostate nella sezione della versione 3.35.1.
3.34.0 2024-06-13
3.33.0 2024-03-28
3.32.0 Ritirata 30/01/2024
  • Questa versione presenta un problema con i dispositivi che eseguono livelli API Android 25 e precedenti. Utilizza invece l'SDK IMA per Android v3.33.0.
  • Aggiunge il supporto dello stream VOD di stitcher di terze parti per la pubblicazione di podcast. Per ulteriori informazioni, consulta la guida alla pubblicazione dei pod Android. Questa modifica include l'aggiunta delle seguenti API:
  • Aumenta a 19 il numero di minSdkVersion supportati da IMA.
  • Risolve il problema per cui i clic sugli annunci che utilizzano il pulsante Scopri di più non aprivano una nuova pagina nella versione 30 e successive dell'API Android. Il problema esiste ancora nelle versioni dell'SDK IMA da 3.31.0 a 3.29.0, in cui è necessaria una soluzione alternativa per il funzionamento dei clic sugli annunci.
  • È stato corretto un bug per cui l'utilizzo di AdsLoader.addAdsLoadedListener() poteva causare un'eccezione ArrayIndexOutOfBoundsException.
  • Aggiunge l'errore dell'annuncio VAST_NO_ADS_AFTER_WRAPPER.
3.31.0 2023-08-31
  • Si è verificato un problema con le versioni dell'SDK IMA da 3.31.0 a 3.29.0 con la versione 30 e successive dell'API Android, in cui i clic sugli annunci che utilizzano il pulsante Scopri di più non aprono una nuova pagina. Come soluzione alternativa per le versioni interessate, devi aggiungere dichiarazioni di intent per aprire link web nel manifest dell'app nel seguente modo:
              <?xml version="1.0" encoding="utf-8"?>
              <manifest xmlns:android="http://schemas.android.com/apk/res/android"
                  package="com.example.project_name">
                  ...
                  </application>
                  <queries>
                      <intent>
                          <action android:name="android.intent.action.VIEW" />
                          <data android:scheme="https" />
                      </intent>
                      <intent>
                          <action android:name="android.intent.action.VIEW" />
                          <data android:scheme="http" />
                      </intent>
                  </queries>
              </manifest>
            
  • Aggiorna la dipendenza di IMA dall'SDK OM alla versione 1.4.8, che include nuovi segnali TV connessa a internet.
  • Ritira le seguenti API AdsRequest:
    • getExtraParameter()
    • getExtraParameters()
    • setExtraParameter()
  • La versione 3.31.0 dell'SDK IMA verrà ritirata il 28/03/2025. Per maggiori dettagli, consulta il programma di ritiro.
3.30.3 2023-08-03
  • Aggiorna le dipendenze della libreria interna per migliorare la latenza di avvio.
  • La versione 3.30.3 dell'SDK IMA verrà ritirata il 31/08/2024. Per maggiori dettagli, consulta il programma di ritiro.
3.30.2 2023-07-28
  • Corregge gli errori imprevisti NullPointerException introdotti nella versione 3.30.1.
  • Corregge un problema con Proguard che impediva l'emissione di alcuni eventi dall'SDK. Questa correzione di bug riguarda l'estensione ExoPlayer per l'SDK IMA DAI.
  • Aggiunge il supporto per Gradle v8+. Le versioni precedenti dell'SDK IMA per Android devono impostare android.enableR8.fullMode=false nel file gradle.properties. Per saperne di più, consulta l'articolo sulla modalità completa R8.
  • La versione 3.30.2 dell'SDK IMA verrà ritirata il 3 agosto 2024. Per maggiori dettagli, consulta il programma di ritiro.
3.30.1 Deprecato 2023-04-18
  • Questa versione presenta un problema con errori NullPointerException imprevisti. Utilizza la versione precedente dell'SDK IMA per Android v3.29.0 finché non viene rilasciata una versione funzionante più recente.
  • Corregge un problema per cui le app che utilizzano la versione 3.30.0 si arrestano in modo anomalo su dispositivi non Android TV.
3.30.0 Deprecato 2023-03-29
3.29.0 2022-10-14
  • Rinomina la classe EspVersion in classe VersionInfo.
  • Rinomina le API Encrypted Signals for Publishers (ESP) in API Secure Signals.
  • Aggiunge le API dei flag funzionalità. Puoi utilizzare le API dei flag di funzionalità per attivare o disattivare funzionalità specifiche in IMA. Utilizza ImaSdkSettings.getFeatureFlags() e ImaSdkSettings.setFeatureFlags() per ottenere e impostare i flag funzionalità.
  • Risolve un problema per cui alcuni eventi IMA non venivano inviati.
  • Aggiunge androidx.webkit:webkit come dipendenza dell'SDK IMA
  • La versione 3.29.0 dell'SDK IMA verrà ritirata il 29 marzo 2024. Per maggiori dettagli, consulta il programma di ritiro.
3.28.2 2022-09-14
  • Aggiorna le dipendenze dell'SDK per utilizzare AndroidX.
  • La versione 3.28.2 dell'SDK IMA verrà ritirata il 14 ottobre 2023. Per maggiori dettagli, consulta il programma di ritiro.
3.28.1 Ritirato 2022-08-03
3.27.1 2022-05-27
  • Release di servizio, nessuna nuova funzionalità.
  • La versione 3.27.1 dell'SDK IMA verrà ritirata il 3 agosto 2023. Per maggiori dettagli, consulta il programma di ritiro.
3.27.0 2022-03-01
  • Aggiunge il supporto per gli spazi companion di dimensioni flessibili impostando la larghezza e l'altezza del companion sulla costante IMA FLUID_SIZE .
  • La versione 3.27.0 dell'SDK IMA verrà ritirata il 27/05/2023. Per maggiori dettagli, consulta il programma di ritiro.
3.26.0 2022-01-12
  • Aggiunge le API Encrypted Signals for Publishers (ESP) (rinominate Indicatori sicuri nell'SDK IMA v3.29.0). In questo modo i publisher possono attivare le offerte di rete e i fornitori di identità.
  • La versione 3.26.0 dell'SDK IMA verrà ritirata il 1° marzo 2023. Per maggiori dettagli, consulta il programma di ritiro.
3.25.1 2021-11-08
  • Aggiunge AdsRenderingSettings.setEnableCustomTabs() e AdsRenderingSettings.getEnableCustomTabs() per il clickthrough in-app degli annunci che utilizzano schede personalizzate.
  • A partire dalla versione 3.25.1, l'SDK IMA include l'autorizzazione com.google.android.gms.permission.AD_ID nel manifest dell'SDK, che viene automaticamente unita al manifest dell'app dagli strumenti di compilazione di Android. Per saperne di più sulla dichiarazione dell'autorizzazione AD_ID, incluso come disattivarla, consulta questo articolo del Centro assistenza Play Console.
  • Aggiunge il supporto per l' ID set di app per casi d'uso come la generazione di report e la prevenzione di attività fraudolenta.
  • Aggiunge miglioramenti delle prestazioni quando si utilizzano più istanze di AdsLoader supportando la memorizzazione nella cache e il riutilizzo dei thread.
  • La versione 3.25.1 dell'SDK IMA verrà ritirata il 12/01/2023. Per maggiori dettagli, consulta il programma di ritiro.
3.24.0 2021-06-03
3.23.0 2021-04-07
  • Aggiunge i metodi ImaSdkSettings.setSessionId() e ImaSdkSettings.getSessionId() per ottenere e impostare l'ID sessione. Si tratta di un ID casuale temporaneo utilizzato esclusivamente per la quota limite.
  • Corregge un errore NullPointerException relativo agli annunci complementari.
  • Disabilita JavaScript negli annunci companion inferiori al livello API 21 per risolvere un problema relativo alle vulnerabilità di sicurezza.
  • La versione 3.23.0 dell'SDK IMA verrà ritirata il 3 giugno 2022. Per maggiori dettagli, consulta il programma di ritiro.
3.22.3 2021-03-16
  • Corregge un errore NullPointerException relativo al rilascio di AdsLoader durante il caricamento di un annuncio.
  • Aggiunge l'errore 1206 per un UNEXPECTED_ADS_LOADED_EVENT nei casi in cui viene inviato un evento di caricamento degli annunci imprevisto.
  • La versione 3.22.3 dell'SDK IMA verrà ritirata il 7 aprile 2022. Per maggiori dettagli, consulta il programma di ritiro.
3.22.2 2021-02-26
  • L'SDK IMA ora dipende dalle seguenti librerie:
    • com.google.android.gms:play-services-base
    • com.google.android.gms:play-services-basement
    • androidx.preference:preference
  • Corregge il messaggio di errore quando AdsLoader riceveva un errore senza un ID sessione valido.
  • La versione 3.22.2 dell'SDK IMA verrà ritirata il 16/03/2022. Per maggiori dettagli, consulta il programma di ritiro.
3.22.0 2021-01-11
  • Aggiunge la pubblicazione di pod per gli stream DAI. Nel flusso di lavoro di pubblicazione dei pod, Ads Manager è responsabile solo della pubblicazione degli annunci. I publisher sono responsabili dei contenuti e della creazione del manifest che punterà poi ad Ad Manager. Utilizza ImaSdkFactory.createPodStreamRequest() per creare una richiesta di stream per la pubblicazione di pod. Se utilizzi questa opzione, sarai responsabile del caricamento dello stream su streamInit().
  • Corregge una perdita di memoria causata dalla mancata pulizia corretta del monitor del ciclo di vita dell'app.
  • La versione 3.22.0 dell'SDK IMA verrà ritirata il 26 febbraio 2022. Per maggiori dettagli, consulta il programma di ritiro.
3.21.4 2020-12-09
  • Rimuove un messaggio di avviso innocuo relativo alla chiamata adsLoader.release() dopo che la webview è stata eliminata.
  • La versione 3.21.4 dell'SDK IMA verrà ritirata l'8 gennaio 2022. Per maggiori dettagli, consulta il programma di ritiro.
3.21.2 2020-11-20
  • Corregge problemi imprevisti di thread-safety causati dall'invio di aggiornamenti dei messaggi da una coda vuota.
  • Aggiorna la documentazione per AdsLoader.release().
  • Il ritiro della versione 3.21.2 dell'SDK IMA è previsto per il 9 dicembre 2021. Per maggiori dettagli, consulta il programma di ritiro.
3.21.1 2020-11-17
  • Corregge un problema che occasionalmente causava arresti anomali dell'app quando venivano attivati eventi.
  • La versione 3.21.1 dell'SDK IMA verrà ritirata il 20 novembre 2021. Per maggiori dettagli, consulta il programma di ritiro.
3.21.0 2020-10-23
  • Aggiunge il supporto per gli annunci SIMID nell'SDK Android DAI.
  • Aggiunge il metodo AdsLoader.release() e ritira BaseDisplayContainer.destroy(). Questa modifica risolve una perdita di memoria che si verificava durante l'eliminazione di un BaseDisplayContainer nel mezzo di una pianificazione pubblicitaria VMAP. AdsLoader.release() è il nuovo metodo consigliato per eliminare gli oggetti SDK IMA, anziché utilizzare BaseDisplayContainer.destroy().
  • La versione 3.21.0 dell'SDK IMA verrà ritirata il 17/11/2021. Per maggiori dettagli, consulta il programma di ritiro.
3.20.1 2020-10-12
3.20.0 2020-08-18
  • La versione 3.20.0 è la prima che sarà interessata dalle modifiche al comportamento di pausa di IMA. Se utilizzi questa o qualsiasi versione futura dell'SDK, ti consigliamo di leggere il post del blog e di apportare le modifiche al comportamento di pausa nella tua applicazione. Gli editori possono testare l'implementazione di queste modifiche utilizzando il tag annuncio di test.
  • Aggiunge i callback onPause() e onResume() per la classe DAI VideoStreamPlayer.
  • Aggiunge il metodo adPeriodDuration() alla classe AdProgressInfo.
  • Aggiunge il supporto per le immagini di riserva per i clic sulle icone sui dispositivi Android TV.
  • Aggiunge l'evento ICON_FALLBACK_IMAGE_CLOSED da gestire quando l'immagine di riserva dell'icona viene chiusa sui dispositivi Android TV.
  • Rimuove il metodo focusSkipButton() ritirato da AdsManager a favore del metodo focus().
  • Per i dispositivi TV connesse a internet (CTV), ora gli annunci vengono messi a fuoco automaticamente quando viene attivato l'evento AdEvent.AdEventType STARTED. Per disattivare la messa a fuoco automatica per gli annunci, utilizza il metodo adsRenderingSettings.setFocusSkipButtonWhenAvailable(false) e poi il metodo focus() in base ai requisiti personalizzati.
  • Aggiunge i metodi getCurrentTimeMs() e getDurationMs alla classe VideoProgressUpdate().
  • Ritira i metodi getCurrentTime e getDuration a favore dei nuovi metodi getCurrentTimeMs e getDurationMs.
  • Corregge un problema per i live streaming DASH in cui gli eventi pubblicitari non venivano segnalati correttamente.
  • La versione 3.20.0 dell'SDK IMA verrà ritirata il 12/10/2021. Per maggiori dettagli, consulta il programma di ritiro.
3.19.4 2020-07-08
  • Risolve un problema che impediva a setLoadVideoTimeout di aggiornare correttamente il timeout.
  • La versione 3.19.4 dell'SDK IMA verrà ritirata il 18/08/2021. Per maggiori dettagli, consulta il programma di ritiro.
3.19.3 2020-06-29
  • Corregge un problema di integrazione del TCF di IAB per il GDPR che causava arresti anomali per i player integrati con gli SDK della piattaforma di gestione del consenso.
  • La versione 3.19.3 dell'SDK IMA verrà ritirata l'8 luglio 2021. Per maggiori dettagli, consulta il programma di ritiro.
3.19.2 2020-06-22
  • Corregge un problema che causava l'ignoramento da parte dell'SDK degli eventi VideoAdPlayerCallback.onContentComplete() al di fuori della riproduzione degli annunci.
  • Aggiunge la possibilità di specificare diversi set di sottotitoli codificati DAI per la stessa lingua utilizzando il parametro subtitle_name per VideoStreamPlayer.loadUrl().
  • La versione 3.19.2 dell'SDK IMA verrà ritirata il 29/06/2021. Per maggiori dettagli, consulta il programma di ritiro.
3.19.0 2020-05-12
3.18.1 2020-03-25
  • Aggiunge il ridimensionamento per gli annunci complementari sui dispositivi ad alta densità di pixel.
  • Aggiunge il supporto per gli annunci SIMID lato client.
  • La versione 3.18.1 dell'SDK IMA verrà ritirata il 12/05/2021. Per maggiori dettagli, consulta il programma di ritiro.
3.18.0 2020-03-04
  • Aggiunge pause() e resume() all'interfaccia VideoStreamPlayer. Questi devono essere implementati per la versione 3.18.0 e successive.
  • La versione 3.18.0 dell'SDK IMA verrà ritirata il 25/03/2021. Per maggiori dettagli, consulta il programma di ritiro.
3.17.0 2020-02-07
3.16.5 2020-01-22
  • Rielabora il supporto per contentUrl OMID 1.3 con AdsRequest.setContentUrl e StreamRequest.setContentUrl .
  • Rielabora il supporto per le ostruzioni compatibili con OMID 1.3 con FriendlyObstruction .
  • Depreca i metodi BaseDisplayContainer.registerVideoControlsOverlay e BaseDisplayContainer.unregisterAllVideoControlsOverlay a favore di FriendlyObstruction .
  • È stato risolto un problema relativo a un NullPointerException che si verifica dopo aver chiamato clear() su CompanionAdSlots.
  • Corregge un problema che potenzialmente causava perdite di memoria durante la chiamata di destroy() durante la riproduzione degli annunci.
  • La versione 3.16.5 dell'SDK IMA verrà ritirata il 7 febbraio 2021. Per maggiori dettagli, consulta il programma di ritiro.
3.16.2 2019-12-05
  • Aggiunge il supporto per l'inclusione automatica dei parametri di consenso di IAB TCFv2 e CCPA.
  • L'utilizzo delle preferenze di Android ora richiede il pacchetto androidx.
  • Il ritiro della versione 3.16.2 dell'SDK IMA è previsto per il 22/01/2021. Per maggiori dettagli, consulta il programma di ritiro.
3.16.1 2019-11-08
3.16.0 2019-10-23
  • Aggiunge il metodo replaceAdTagParameters a StreamManager, che offre la possibilità di sostituire tutti i parametri dei tag annuncio durante un live streaming.
  • Rimuove il supporto dei seguenti metodi ritirati:
    • AdsRequest.getAdDisplayContainer()
    • AdsRequest.setAdDisplayContainer(AdDisplayContainer adDisplayContainer)
    • ImaSdkFactory.createAdsLoader(Context context)
    • ImaSdkFactory.createAdsLoader(Context context, ImaSdkSettings settings)
    • ImaSdkFactory.createLiveStreamRequest(String assetKey, String apiKey, StreamDisplayContainer streamDisplayContainer)
    • ImaSdkFactory.createVodStreamRequest(String contentSourceId, String videoId, String apiKey, StreamDisplayContainer streamDisplayContainer)
    • StreamRequest.getStreamDisplayContainer()
  • La versione 3.16.0 dell'SDK IMA verrà ritirata l'8 novembre 2020. Per maggiori dettagli, consulta il programma di ritiro.
3.14.0 2019-09-11
  • Release di servizio, nessuna nuova funzionalità.
  • La versione 3.14.0 dell'SDK IMA verrà ritirata il 23/10/2020. Per maggiori dettagli, consulta il programma di ritiro.
3.13.1 2019-09-03
  • Aggiunge la possibilità di impostare il contesto di riproduzione continua per una richiesta di annunci. Per maggiori dettagli, vedi setContinuousPlayback().
  • Aggiunge il metodo getUniversalAdIds() alla classe Ad.
  • Aggiunge setAuthToken, getAuthToken, setFormat, getFormat e l'enumerazione StreamFormat.
  • Corregge un errore nei dispositivi Nexus 5 che si verifica quando un contenitore viene rimosso prima di ricevere una risposta dell'annuncio.
  • Corregge un problema per cui gli annunci companion venivano visualizzati una sola volta.
  • Risolve un problema per cui i tipi di annunci non supportati (non lineari, VPAID) non avevano esito negativo.
  • La versione 3.13.1 dell'SDK IMA verrà ritirata il giorno 11/09/2020. Per maggiori dettagli, consulta il programma di ritiro.
3.11.3 2019-06-11
  • Correzione del bug relativo all'impostazione is_lat sui dispositivi AOSP.
  • La versione 3.11.3 dell'SDK IMA verrà ritirata il 3 settembre 2020. Per maggiori dettagli, consulta il programma di ritiro.
3.11.2 2019-04-16
  • Corregge il seguente arresto anomalo: java.lang.ClassNotFoundException: Didn't find class "j$.util.concurrent.ConcurrentHashMap".
  • La versione 3.11.0 dell'SDK IMA verrà ritirata l'11/06/2020. Per maggiori dettagli, consulta il programma di ritiro.
3.11.0 Ritirato 2019-03-22
3.10.9 2019-03-13
  • È stato corretto un bug di race condition per cui a volte l'interfaccia utente degli annunci non viene visualizzata negli annunci successivi dopo che il primo annuncio è stato ignorato.
  • È stato risolto un arresto anomalo che si verificava durante la chiamata all'API getCompanionAds().
  • La versione 3.10.7 dell'SDK IMA verrà ritirata il 22/03/2020. Per maggiori dettagli, consulta il programma di ritiro.
3.10.7 2019-02-19
3.10.6 2019-01-23
  • Aggiunge il metodo seek() all'interfaccia del player di streaming.
  • Aggiunge il supporto per i callback degli eventi annuncio AD_BUFFERING.
  • I contenitori non devono più essere passati nella richiesta di annuncio. Il nuovo flusso di lavoro richiede che un contenitore venga passato attraverso un costruttore AdsLoader.
  • Aggiunge il metodo BaseDisplayContainer.destroy().
  • Corregge una perdita di memoria che si verificava al termine della riproduzione video.
  • Depreca requestNextAdBreak. Questa API verrà rimossa in una release futura. Successivamente, gli annunci verranno recuperati automaticamente 4 secondi prima dell'interruzione pubblicitaria.
  • La versione 3.10.2 dell'SDK IMA verrà ritirata il 19/02/2020. Per maggiori dettagli, consulta il programma di ritiro.
3.10.2 2018-11-13
  • Corregge una condizione di competizione che causa l'errore VAST 402 nel secondo annuncio di un pod.
  • Aggiunge la quota limite e l'esclusione della concorrenza all'SDK DAI per Android.
  • Sposta getAdProgressInfo() da StreamManager a BaseManager.
  • Aggiunge getVastMediaHeight(), getVastMediaWidth() e getVastMediaBitrate() a Ad.
  • La versione 3.9.4 dell'SDK IMA verrà ritirata il 23/01/2020. Per maggiori dettagli, consulta il programma di ritiro.
3.9.4 2018-08-01
  • Aggiunge getCompanionAds() a Ad. Restituisce gli annunci companion solo quando utilizzi DAI.
  • Aggiunge una nuova classe CompanionAd.
  • Aggiunge un nuovo evento SKIPPABLE_STATE_CHANGED a AdEvent.
  • Corregge un problema per cui l'impostazione predefinita per focusSkipButtonWhenAvailable non veniva rispettata in alcuni casi.
  • La versione 3.9.0 dell'SDK IMA verrà ritirata il 1° agosto 2019. Per maggiori dettagli, consulta il programma di ritiro.
3.9.0 2018-07-09
  • Android TV è ora supportata.
  • Aggiunge focusSkipButton() a AdsManager. Questa operazione funziona solo su Android TV.
  • Aggiunge getFocusSkipButtonWhenAvailable() a AdsRenderingSettings, con valore predefinito true. Questa operazione funziona solo su Android TV.
  • Aggiunge setFocusSkipButtonWhenAvailable() a AdsRenderingSettings. Questa operazione funziona solo su Android TV.
  • VideoAdPlayer ora estende l'interfaccia VolumeProvider. L'implementazione di questa interfaccia è ora obbligatoria per la riproduzione personalizzata.
  • La versione 3.8.7 dell'SDK IMA verrà ritirata il 9 luglio 2019. Per maggiori dettagli, consulta il programma di ritiro.
3.8.7 2018-05-23
  • Consente l'animazione negli annunci companion HTML.
  • La versione 3.8.5 dell'SDK IMA verrà ritirata il 23/05/2019. Per maggiori dettagli, consulta il programma di ritiro.
3.8.5 2018-04-09
  • Corregge un problema relativo all'ignoranza di ImaSdkSettings.
  • È stato risolto un problema per cui si verificavano conflitti di build con i file della versione com.android.support.
  • Aggiunge setAdWillPlayMuted a AdsRequest.
  • Aggiunge setLoadVideoTimeout a AdsRenderingSettings.
  • La versione 3.8.2 dell'SDK IMA verrà ritirata il 9 aprile 2019. Per maggiori dettagli, consulta il programma di ritiro.
3.8.2 2018-01-24
  • Aggiunge setLiveStreamPrefetchSeconds a AdsRequest.
  • Varie correzioni alla documentazione.
  • La versione 3.7.4 dell'SDK IMA verrà ritirata il 24/01/2019. Per maggiori dettagli, consulta il programma di ritiro.
3.7.4 2017-06-29
  • Aggiunge setVastLoadTimeout a AdsRequest.
  • Aggiunge getSkipTimeOffset a Ad.
  • La versione 3.7.2 dell'SDK IMA verrà ritirata il 29/06/2018. Per maggiori dettagli, consulta il programma di ritiro.
3.7.2 2017-05-25
  • Aggiunge setDebugMode a ImaSdkSettings.
  • La versione 3.7.1 dell'SDK IMA verrà ritirata il 25/05/2018. Per maggiori dettagli, consulta il programma di ritiro.
3.7.1 2017-03-24
  • Risolve un conflitto di spazio dei nomi quando utilizzi Proguard.
  • Le dimensioni del file JAR sono state ridotte di circa 30 kB.
  • La versione 3.7.0 dell'SDK IMA verrà ritirata il 24/03/2018. Per maggiori dettagli, consulta il programma di ritiro.
3.7.0 2017-03-13
  • Corregge un problema per cui alcune classi IMA sono state unite inavvertitamente al pacchetto a.a.a.a di ProGuard.
  • La versione 3.6.0 dell'SDK IMA verrà ritirata il 13/03/2018. Per maggiori dettagli, consulta il programma di ritiro.
3.6.0 2017-02-16
  • Aggiunge quanto segue a Ad:
    • getAdWrapperCreativeIds()
    • getAdvertiserName()
    • getCreativeAdId()
    • getCreativeId()
    • getDealId()
    • getSurveyUrl()
    • getUniversalAdIdRegistry()
    • getUniversalAdIdValue()
  • Aggiunge AdsManager.requestNextAdBreak().
  • Aggiunge quanto segue a AdsRenderingSettings:
    • setEnablePreloading()
    • getEnablePreloading()
  • Aggiunge quanto segue a AdsRequest:
    • setContentDuration()
    • setContentKeywords()
    • setContentTitle()
  • La versione 3.5.2 dell'SDK IMA verrà ritirata il 16/02/2018. Per maggiori dettagli, consulta il programma di ritiro.
3.5.2 2016-11-14
  • Aggiunge un video player di proprietà dell'SDK che gestisce facoltativamente la riproduzione degli annunci.
  • Aggiunge CompanionAdSlot.ClickListener e metodi per aggiungere e rimuovere un ascoltatore.
  • Corregge un problema relativo ai log degli errori getViewability() non validi.
  • Corregge un problema relativo al comportamento clickthrough delle icone e al rendering non corretto.
  • La versione 3.4.0 dell'SDK IMA verrà ritirata il 14/11/2017. Per maggiori dettagli, consulta il programma di ritiro.
3.4.0 2016-09-12
  • Corregge un errore relativo ai file duplicati quando si utilizza Google Play Services versione 9.0.0 e successive.
3.3.2 2016-07-11
3.3.0 2016-05-31
3.2.1 2016-04-07
  • Release di servizio, nessuna nuova funzionalità.
3.1.3 2015-12-16
3.b13.3 (beta) 2015-09-10
  • Release di servizio, nessuna nuova funzionalità.
3.b12.1 (beta) 2015-07-20
3.b11.4 (beta) 2015-05-21
  • Aggiunge quanto segue all'API:
    • AdError.AdErrorCode.VAST_EMPTY_RESPONSE
    • AdError.getErrorNumber()
    • AdsRequest.setAdWillAutoPlay(Boolean)
    • CompanionAdSlot.isFilled()
    • ImaSdkSettings.setPlayerType(String)
    • ImaSdkSettings.setPlayerVersion(String)
3.b10.3 (beta) 2015-03-24
  • ImaSdkSettings.getMaxRedirects e ImaSdkSettings.setMaxRedirects aggiunti.
  • Le classi dell'API IMA ora sono final.
  • I numeri di versione dell'SDK sono ora nel formato 3.bX.Y, dove b indica lo stato beta dell'SDK.
  • Sono stati rimossi i seguenti valori di AdError.AdErrorCode:
    • API_ERROR. Utilizza invece UNKNOWN_AD_RESPONSE.
    • PLAYLIST_MALFORMED_RESPONSE. Utilizza invece UNKNOWN_AD_RESPONSE.
    • REQUIRED_LISTENERS_NOT_ADDED - non veniva generato dall'SDK.
    • VAST_INVALID_URL. Utilizza invece VAST_LOAD_TIMEOUT.
Beta v9 2014-10-17
  • Aggiunge le API Google Ads getTitle, getDescription e getContentType.
  • Aggiunge informazioni sulla posizione del pod di annunci all'interfaccia utente dell'annuncio, ad esempio, "Annuncio 1 di 4: (0:13)".
  • Non dovresti più controllare direttamente la pausa/riproduzione/ripresa degli annunci utilizzando il video player. Utilizza invece AdsManager.pause() e AdsManager.resume().
Beta v8 2014-06-12
  • Corregge un problema relativo alla mancata cancellazione dell'interfaccia utente dell'annuncio per gli annunci ignorabili.
  • Documenta il codice di errore per i timeout di caricamento dei file multimediali.
Beta v7 2014-05-27
  • Corregge un problema relativo a Google Play Services. Ora l'SDK richiede che Google Play Services sia integrato nella tua app. Per saperne di più, consulta Configurare l'SDK Google Play Services.
Beta v6 2014-04-14
  • Aggiunge il supporto di VAST 3.
  • Aggiunge il supporto VMAP parziale (parità con le attuali regole per gli annunci di Ad Manager).
  • Aggiunge quanto segue all'API:
    • AdError.AdErrorCode.ADS_REQUEST_NETWORK_ERROR
    • AdEvent.AdEventType.LOG
    • AdEvent.getAdData()
    • AdPodInfo.getMaximumDuration()
    • AdPodInfo.getPodIndex()
    • AdPodInfo.getTimeOffset()
  • Corregge un bug per cui i mid-roll con un pod ottimizzato con un wrapper causavano l'omissione di tutti gli altri annunci nel pod.
  • AdsRenderingSettings passato ad AdsManager non verrà più ignorato.
  • Sono stati corretti diversi bug per migliorare la stabilità.
Beta v5 2013-12-12
  • È stato risolto il problema relativo agli annunci ignorabili nelle playlist.
Beta v4 2013-10-15
  • È stata aggiunta la possibilità di reimpostare i valori del correlatore chiamando contentComplete su AdsLoader.
Beta v3 2013-09-05
  • Release di servizio, nessuna nuova funzionalità.
Beta v2 2013-07-07
  • Rilascio pubblico della versione beta dell'SDK.
Beta chiusa v2 2013-06-24
  • È stata aggiunta l'API per impostare la lingua dell'interfaccia utente sull'oggetto ImaSdkSettings. Tieni presente che questa impostazione viene utilizzata per impostare la lingua dell'interfaccia utente, non quella dell'annuncio.
  • Risolto il conflitto che si verificava quando un'app includeva sia le librerie dell'SDK IMA sia dell'SDK AdMob.
  • È stata aggiunta la registrazione per varie metriche di rendimento interne.
Beta chiusa v1 2013-04-02
  • Release beta iniziale. Di seguito sono riportati i problemi noti della release beta:

    SDK

    I seguenti AdEvents disponibili nell'SDK IMA per HTML5 non sono supportati nell'SDK IMA per Android v3: IMPRESSION, LOG, SKIPPABLE_STATE_CHANGED, STOPPED, VOLUME_CHANGED, VOLUME_MUTED

    Esempio relativo all'app

    1. Si verifica un problema intermittente per cui il player annuncio non riprende correttamente la riproduzione dopo che l'utente ha fatto clic su un annuncio. Ad esempio, a volte, quando torni all'app dopo aver fatto clic su un annuncio, la riproduzione dell'annuncio viene riprodotta fino alla fine, anziché riprendere da dove era stata interrotta prima del clic.
    2. Gli annunci restituiti dal tag annuncio "Instream 2" non sono compatibili con l'SDK Android IMA v3.
    3. Il lettore di esempio non disattiva automaticamente la ricerca (scrubbing) durante la riproduzione degli annunci. Assicurati di disattivare la ricerca nel video player durante la riproduzione degli annunci.