Google IMA Android SDK 版本紀錄

版本 發布日期 附註
3.33.0 2024-03-28
3.32.0 已淘汰 2024-01-30
  • 這個版本在搭載 Android API 25 以下級別的裝置發生問題。請改用 IMA SDK Android 3.33.0 版。
  • 為廣告連播放送新增第三方拼接工具 VOD 串流支援功能。詳情請參閱 Android Pod 放送指南。這項變更包括新增下列 API:
  • 將 IMA 支援的 minSdkVersion 增加至 19。
  • 修正使用「瞭解詳情」按鈕點閱廣告後,無法在 Android API 30 以上版本中開啟新頁面的問題。這個問題仍然存在。
  • 修正使用 AdsLoader.addAdsLoadedListener() 可能導致 ArrayIndexOutOfBoundsException 例外狀況的錯誤。
  • 新增廣告錯誤 VAST_NO_ADS_AFTER_WRAPPER
3.31.0 2023-08-31
  • 在 Android API 30 以上版本中,IMA SDK 3.31.0 至 3.29.0 版發生問題,因為按下 [瞭解詳情] 按鈕後按一下無法開啟新網頁。如要解決受影響版本的問題,建議您新增意圖宣告,以在應用程式資訊清單中開啟網頁連結,如下所示:
              <?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>
            
  • 將 IMA 的 OM SDK 依附元件更新至 1.4.8 版,其中包含新的連網電視信號。
  • 淘汰下列 AdsRequest API:
    • getExtraParameter()
    • getExtraParameters()
    • setExtraParameter()
  • SDK 3.31.0 版將於 2025 年 1 月 XX 日淘汰。詳情請參閱淘汰時間表
3.30.3 2023-08-03
  • 更新內部程式庫依附元件,以縮短啟動延遲時間。
  • SDK 3.30.3 版將於 2024 年 8 月 31 日淘汰。詳情請參閱淘汰時間表
3.30.2 2023-07-28
  • 修正 3.30.1 版中出現的非預期 NullPointerException 錯誤。
  • 修正 ProGuard ,該問題會導致部分事件無法從 SDK 發出。這項錯誤修正會影響 IMA DAI SDK 的 ExoPlayer 擴充功能。
  • 新增 Gradle v8 以上版本支援。過往的 Android IMA SDK 版本必須在 gradle.properties 檔案中設定 android.enableR8.fullMode=false。詳情請參閱 R8 完整模式文章
  • SDK 3.30.2 版將於 2024 年 8 月 3 日淘汰。詳情請參閱淘汰時間表
3.30.1 已淘汰 2023-04-18
  • 這個版本發生未預期的 NullPointerException 錯誤。在較新的有效版本推出之前,使用舊版 IMA SDK Android 3.29.0 版。
  • 修正應用程式在非 Android TV 裝置上使用 3.30.0 版當機的問題。
3.30.0 已淘汰 2023-03-29
3.29.0 2022-10-14
  • EspVersion 類別重新命名為 VersionInfo 類別。
  • 將 Encrypted Signals (ESP) API 重新命名為 Secure Signals API。
  • 新增功能旗標 API。您可以使用功能旗標 API 啟用或停用 IMA 中的特定功能。使用 ImaSdkSettings.getFeatureFlags()ImaSdkSettings.setFeatureFlags() 取得並設定功能旗標。
  • 修正部分 IMA 事件無法傳送的問題。
  • 新增 androidx.webkit:webkit 做為 IMA SDK 依附元件
  • SDK 3.29.0 版將於 2024 年 3 月 29 日淘汰。詳情請參閱淘汰時間表
3.28.2 2022-09-14
  • 更新 SDK 依附元件以使用 AndroidX。
  • SDK 3.28.2 版將於 2023 年 10 月 14 日淘汰。詳情請參閱淘汰時間表
3.28.1 已淘汰 2022-08-03
3.27.1 2022-05-27
  • 服務推出,不含新功能。
  • SDK 3.27.1 版將於 2023 年 8 月 3 日淘汰。詳情請參閱淘汰時間表
3.27.0 2022-03-01
  • 將隨播廣告寬度和高度設為 IMA 常數 FLUID_SIZE ,以新增自動調整大小隨播廣告版位的支援功能。
  • SDK 3.27.0 版將於 2023 年 5 月 27 日淘汰。詳情請參閱淘汰時間表
3.26.0 2022-01-12
  • 新增適用於發布商的加密信號 (ESP) API (在 IMA SDK v3.29.0 中更名為安全信號)。如此一來,發布商就能啟用聯播網出價方和 IdP。
  • SDK 3.26.0 版將於 2023 年 3 月 1 日淘汰。詳情請參閱淘汰時間表
3.25.1 2021-11-08
3.24.0 2021-06-03
3.23.0 2021-04-07
  • 新增 ImaSdkSettings.setSessionId() ImaSdkSettings.getSessionId() 方法,取得並設定工作階段 ID。這是專門用於展示頻率上限的臨時隨機 ID。
  • 修正與隨播廣告相關的 NullPointerException 錯誤。
  • 停用 API 級別 21 以下的隨播廣告中的 JavaScript,以修正安全漏洞。
  • SDK 3.23.0 版將於 2022 年 6 月 3 日淘汰。詳情請參閱淘汰時間表
3.22.3 2021-03-16
  • 修正與在廣告載入期間發布 AdsLoader 相關的 NullPointerException 錯誤。
  • 在廣告載入事件發生非預期的情況下,為 UNEXPECTED_ADS_LOADED_EVENT 新增 1206 錯誤。
  • SDK 3.22.3 版將於 2022 年 4 月 7 日淘汰。詳情請參閱淘汰時間表
3.22.2 2021-02-26
  • IMA SDK 現在依附於下列程式庫:
    • com.google.android.gms:play-services-base
    • com.google.android.gms:play-services-basement
    • androidx.preference:preference
  • 修正 AdsLoader 收到不含有效工作階段 ID 的錯誤時錯誤訊息
  • SDK 3.22.2 版將於 2022 年 3 月 16 日淘汰。詳情請參閱淘汰時間表
3.22.0 2021-01-11
  • 為 DAI 串流新增廣告連播放送功能。在廣告連播放送工作流程中,廣告 Manager 只負責放送廣告。發布商有責任管理內容,並建立資訊清單,然後指向 Ads Manager。使用 ImaSdkFactory.createPodStreamRequest() 建立 Pod 放送功能的串流要求。如果使用這個模式,您必須負責在 streamInit() 上載入串流。
  • 修正因應用程式生命週期監控工具未正確清理而造成的記憶體流失問題。
  • SDK 3.22.0 版將於 2022 年 2 月 26 日淘汰。詳情請參閱淘汰時間表
3.21.4 2020-12-09
  • 在 WebView 刪除後,移除與呼叫 adsLoader.release() 相關的無害警告訊息。
  • SDK 3.21.4 版將於 2022 年 1 月 8 日淘汰。詳情請參閱淘汰時間表
3.21.2 2020-11-20
  • 修正從空白佇列傳送訊息更新而導致非預期的執行緒安全問題。
  • 更新 AdsLoader.release() 的說明文件。
  • SDK 3.21.2 版將於 2021 年 12 月 9 日淘汰。詳情請參閱淘汰時間表
3.21.1 2020-11-17
  • 修正有時在事件觸發時會導致應用程式當機的問題。
  • SDK 3.21.1 版將於 2021 年 11 月 20 日淘汰。詳情請參閱淘汰時間表
3.21.0 2020-10-23
  • 在 DAI Android SDK 中新增 SIMID 廣告支援。
  • 新增 AdsLoader.release() 方法並淘汰 BaseDisplayContainer.destroy()。這項變更可解決在 VMAP 廣告時段中間棄置 BaseDisplayContainer 時發生的記憶體流失問題。建議您使用 AdsLoader.release() 這個新方法來處理 IMA SDK 物件,而非使用 BaseDisplayContainer.destroy()
  • SDK 3.21.0 版將於 2021 年 11 月 17 日淘汰。詳情請參閱淘汰時間表
3.20.1 2020-10-12
  • 修正 API 級別 29 以上版本的 Android 中的 HTMLResource 隨播廣告問題。請參閱「Android API 行為變更」一文。
  • SDK 3.20.1 版將於 2021 年 10 月 23 日淘汰。詳情請參閱淘汰時間表
3.20.0 2020-08-18
  • 3.20.0 版是第一個受到 IMA 暫停行為異動影響的版本。如果您使用這個版本或日後的 SDK 版本,建議您閱讀網誌文章,並在應用程式中進行暫停行為的變更。發布商可以使用測試廣告代碼,測試這些變更的導入方式。
  • 新增 DAI VideoStreamPlayer 類別的 onPause()onResume() 回呼。
  • adPeriodDuration() 方法新增至 AdProgressInfo 類別。
  • 支援在 Android TV 裝置上支援圖示點擊備用圖片。
  • 新增 ICON_FALLBACK_IMAGE_CLOSED 事件,以便處理 Android TV 裝置上關閉圖示備用圖片的情況。
  • AdsManager 中移除已淘汰的 focusSkipButton() 方法,改用 focus() 方法。
  • 對於連網電視裝置,系統現在會於觸發 AdEvent.AdEventType STARTED 事件時自動聚焦廣告。如要停用廣告的自動對焦功能,請使用 adsRenderingSettings.setFocusSkipButtonWhenAvailable(false) 方法,然後根據自訂需求使用 focus() 方法。
  • getCurrentTimeMs()getDurationMs 方法新增至 VideoProgressUpdate() 類別。
  • 淘汰 getCurrentTimegetDuration 方法,改用新的 getCurrentTimeMsgetDurationMs 方法。
  • 修正 DASH 直播未正確回報廣告事件的問題。
  • SDK 3.20.0 版將於 2021 年 10 月 12 日淘汰。詳情請參閱淘汰時間表
3.19.4 2020-07-08
3.19.3 2020-06-29
  • 修正 IAB 資訊公開和同意聲明架構整合 GDPR 相關問題,該問題會導致與同意聲明管理平台 SDK 整合的玩家出現當機情形。
  • SDK 3.19.3 版將於 2021 年 7 月 8 日淘汰。詳情請參閱淘汰時間表
3.19.2 2020-06-22
3.19.0 2020-05-12
3.18.1 2020-03-25
  • 新增高像素密度裝置上的隨播廣告縮放功能。
  • 新增用戶端 SIMID 廣告支援功能。
  • SDK 3.18.1 版將於 2021 年 5 月 12 日淘汰。詳情請參閱淘汰時間表
3.18.0 2020-03-04
  • 將 pause() 和 Resume() 新增至 VideoStreamPlayer 介面。這些必須在 3.18.0 以上版本中實作。
  • SDK 3.18.0 版將於 2021 年 3 月 25 日淘汰。詳情請參閱淘汰時間表
3.17.0 2020-02-07
3.16.5 2020-01-22
  • 利用 AdsRequest.setContentUrl StreamRequest.setContentUrl 重新執行 OMID 1.3 contentUrl 的支援。
  • 支援使用 FriendlyObstruction 重新執行 OMID 1.3 友善遮蔽物。
  • 淘汰 BaseDisplayContainer.registerVideoControlsOverlayBaseDisplayContainer.unregisterAllVideoControlsOverlay 方法,改用 FriendlyObstruction
  • 修正在 CompanionAdSlots 上呼叫 clear() 後發生的 NullPointerException 問題
  • 修正在廣告播放期間呼叫 destroy() 時,可能導致記憶體流失的問題。
  • SDK 3.16.5 版將於 2021 年 2 月 7 日淘汰。詳情請參閱淘汰時間表
3.16.2 2019-12-05
  • 新增支援自動加入 IAB 資訊公開和同意聲明架構第 2 版和 CCPA 同意聲明參數的支援功能。
  • 使用 Android 偏好設定現在需要 androidx 套件。
  • SDK 3.16.2 版將於 2021 年 1 月 22 日淘汰。詳情請參閱淘汰時間表
3.16.1 2019-11-08
3.16.0 2019-10-23
  • replaceAdTagParameters 方法新增至 StreamManager,以便於直播期間取代所有廣告代碼參數。
  • 停止支援下列已淘汰的方法:
    • 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()
  • SDK 3.16.0 版將於 2020-11-08 淘汰。詳情請參閱淘汰時間表
3.14.0 2019-09-11
  • 服務推出,不含新功能。
  • SDK 3.14.0 版將於 2020 年 10 月 23 日淘汰。詳情請參閱淘汰時間表
3.13.1 2019-09-03
3.11.3 2019-06-11
  • 修正 Android 開放原始碼計畫裝置上 is_lat 設定的錯誤。
  • SDK 3.11.3 版將於 2020 年 9 月 3 日淘汰。詳情請參閱淘汰時間表
3.11.2 2019-04-16
  • 修正下列當機問題:java.lang.ClassNotFoundException: Didn't find class "j$.util.concurrent.ConcurrentHashMap"
  • SDK 3.11.0 版已於 2020 年 6 月 11 日正式淘汰。詳情請參閱淘汰時間表
3.11.0 已淘汰 2019-03-22
3.10.9 2019-03-13
  • 修正競爭狀況錯誤:略過第一則廣告後,廣告 UI 有時不會在後續廣告中顯示。
  • 修正了呼叫 getCompanionAds() API 時發生的當機問題。
  • SDK 3.10.7 版將於 2020 年 3 月 22 日淘汰。詳情請參閱淘汰時間表
3.10.7 2019-02-19
3.10.6 2019-01-23
  • seek() 方法新增至串流播放器介面。
  • 新增對 AD_BUFFERING 廣告事件回呼的支援。
  • 不得在廣告請求中傳遞容器。新工作流程需要透過 AdsLoader 建構函式傳遞容器。
  • 新增 BaseDisplayContainer.destroy() 方法。
  • 修正影片播放完成時發生的記憶體流失問題。
  • 淘汰 requestNextAdBreak。日後推出的版本將移除這個 API。之後,系統會在廣告插播時間點前 4 秒自動擷取廣告。
  • SDK 3.10.2 版將於 2020 年 2 月 19 日淘汰。詳情請參閱淘汰時間表
3.10.2 2018-11-13
  • 修正導致 Pod 中的第二則廣告擲回 VAST 402 錯誤的競爭狀況。
  • 在 DAI Android SDK 中加入展示頻率上限和競爭排除功能。
  • getAdProgressInfo()StreamManager 移至 BaseManager
  • getVastMediaHeight()getVastMediaWidth()getVastMediaBitrate() 新增至 Ad
  • SDK 3.9.4 版將於 2020 年 1 月 23 日淘汰。詳情請參閱淘汰時間表
3.9.4 2018-08-01
  • getCompanionAds() 新增至 Ad。這樣只會在使用 DAI 時傳回隨播廣告。
  • 新增 CompanionAd 類別。
  • 將新的 SKIPPABLE_STATE_CHANGED 事件新增至 AdEvent
  • 修正在某些情況下未遵循 focusSkipButtonWhenAvailable 預設設定的問題。
  • SDK 3.9.0 版將於 2019 年 8 月 1 日淘汰。詳情請參閱淘汰時間表
3.9.0 2018-07-09
  • 現已支援 Android TV。
  • focusSkipButton() 新增至 AdsManager。這項功能僅適用於 Android TV。
  • getFocusSkipButtonWhenAvailable() 新增至 AdsRenderingSettings,預設值為 true。這項功能僅適用於 Android TV。
  • setFocusSkipButtonWhenAvailable() 新增至 AdsRenderingSettings。這項功能僅適用於 Android TV。
  • VideoAdPlayer 現在擴充 VolumeProvider 介面現在如要使用自訂播放功能,必須導入此介面。
  • SDK 3.8.7 版將於 2019 年 7 月 9 日淘汰。詳情請參閱淘汰時間表
3.8.7 2018-05-23
  • 允許在 HTML 隨播廣告中使用動畫。
  • SDK 3.8.5 版將於 2019 年 5 月 23 日淘汰。詳情請參閱淘汰時間表
3.8.5 2018-04-09
  • 修正忽略 ImaSdkSettings 的問題。
  • 修正建構作業與 com.android.support 版本檔案發生衝突的問題。
  • setAdWillPlayMuted 新增至 AdsRequest
  • setLoadVideoTimeout 新增至 AdsRenderingSettings
  • SDK 3.8.2 版將於 2019 年 4 月 9 日淘汰。詳情請參閱淘汰時間表
3.8.2 2018-01-24
  • setLiveStreamPrefetchSeconds 新增至 AdsRequest
  • 修正多項說明文件。
  • SDK 3.7.4 版將於 2019 年 1 月 24 日淘汰。詳情請參閱淘汰時間表
3.7.4 2017-06-29
  • setVastLoadTimeout 新增至 AdsRequest
  • getSkipTimeOffset 新增至 Ad
  • SDK 3.7.2 版將於 2018 年 6 月 29 日淘汰。詳情請參閱淘汰時間表
3.7.2 2017-05-25
  • setDebugMode 新增至 ImaSdkSettings
  • SDK 3.7.1 版將於 2018 年 5 月 25 日淘汰。詳情請參閱淘汰時間表
3.7.1 2017-03-24
  • 解決使用 Proguard 時發生的命名空間衝突。
  • Jar 大小約減少 30 KB。
  • SDK 3.7.0 版將於 2018 年 3 月 24 日淘汰。詳情請參閱淘汰時間表
3.7.0 2017-03-13
  • 修正部分 IMA 類別意外合併到 ProGuard 的 a.a.a.a 套件的問題。
  • SDK 3.6.0 版將於 2018 年 3 月 13 日淘汰。詳情請參閱淘汰時間表
3.6.0 2017-02-16
  • 將下列項目新增至 Ad
    • getAdWrapperCreativeIds()
    • getAdvertiserName()
    • getCreativeAdId()
    • getCreativeId()
    • getDealId()
    • getSurveyUrl()
    • getUniversalAdIdRegistry()
    • getUniversalAdIdValue()
  • 新增 AdsManager.requestNextAdBreak().
  • 將下列項目新增至 AdsRenderingSettings
    • setEnablePreloading()
    • getEnablePreloading()
  • 將下列項目新增至 AdsRequest
    • setContentDuration()
    • setContentKeywords()
    • setContentTitle()
  • SDK 3.5.2 版將於 2018 年 2 月 16 日淘汰。詳情請參閱淘汰時間表
3.5.2 2016-11-14
  • 新增 SDK 擁有的影片播放器,可選擇性處理廣告播放。
  • 新增 CompanionAdSlot.ClickListener 和方法,以新增和移除事件監聽器。
  • 修正 getViewability() 錯誤記錄無效的問題。
  • 修正圖示的點閱行為問題,導致無法正常顯示。
  • SDK 3.4.0 版將於 2017 年 11 月 14 日淘汰。詳情請參閱淘汰時間表
3.4.0 2016-09-12
  • 修正使用 Google Play 服務 9.0.0 以上版本時發生的檔案重複錯誤。
3.3.2 2016-07-11
3.3.0 2016-05-31
3.2.1 2016-04-07
  • 服務推出,不含新功能。
3.1.3 2015-12-16
3.b13.3 (Beta 版) 2015-09-10
  • 服務推出,不含新功能。
3.b12.1 (Beta 版) 2015-07-20
3.b11.4 (Beta 版) 2015-05-21
  • 將下列項目新增至 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.getMaxRedirectsImaSdkSettings.setMaxRedirects
  • IMA API 類別現已更名為 final
  • SDK 版本號碼現在採用 3.bX.Y 格式,b 則代表 SDK 的 Beta 版狀態。
  • 下列 AdError.AdErrorCode 值已移除:
    • API_ERROR - 請改用 UNKNOWN_AD_RESPONSE
    • PLAYLIST_MALFORMED_RESPONSE - 請改用 UNKNOWN_AD_RESPONSE
    • REQUIRED_LISTENERS_NOT_ADDED:未由 SDK 引發。
    • VAST_INVALID_URL - 請改用 VAST_LOAD_TIMEOUT
Beta 版 9 2014-10-17
  • 新增 Ad API getTitlegetDescriptiongetContentType
  • 在廣告 UI 中新增廣告連播位置的相關資訊,例如「廣告 4 之 1:(0:13)」。
  • 您不再使用影片播放器直接控制廣告的暫停/播放/繼續作業,請改用 AdsManager.pause()AdsManager.resume()
Beta 版 8 2014-06-12
  • 修正廣告 UI 無法清除可略過廣告的問題。
  • 記錄媒體檔案載入逾時的錯誤代碼。
Beta 版 7 2014-05-27
  • 修正 Google Play 服務問題。SDK 現在需要在應用程式中內建 Google Play 服務。詳情請參閱「 設定 Google Play 服務 SDK」一文。
Beta 版 6 2014-04-14
  • 新增 VAST 3 支援。
  • 新增部分 VMAP 支援 (與目前 Ad Manager 廣告規則一致)。
  • 將下列項目新增至 API:
    • AdError.AdErrorCode.ADS_REQUEST_NETWORK_ERROR
    • AdEvent.AdEventType.LOG
    • AdEvent.getAdData()
    • AdPodInfo.getMaximumDuration()
    • AdPodInfo.getPodIndex()
    • AdPodInfo.getTimeOffset()
  • 修正錯誤:片中廣告如果設有最佳化的廣告連播,會略過廣告連播中的所有其他廣告。
  • 傳遞至 WorkManager 的 AdsRenderingSettings 將不再遭到忽略。
  • 修正多項錯誤以提升穩定性。
Beta 版 5 2013-12-12
  • 修正播放清單中可略過廣告的問題。
Beta 版 4 2013-10-15
  • 新增在 AdsLoader 上呼叫 contentComplete,可重設 Correlator 值。
Beta 版 3 2013-09-05
  • 服務推出,不含新功能。
Beta 版 2 2013-07-07
  • Beta 版 SDK 的公開版本。
封測版第 2 版 2013-06-24
  • 新增了 API,用於設定 ImaSdkSettings 物件的使用者介面語言。請注意,這是設定 UI 語言,而不是廣告語言。
  • 修正應用程式同時包含 IMA SDK 和 AdMob SDK 程式庫時會發生的衝突。
  • 新增各種內部成效指標的記錄功能。
封閉 Beta 版 1 2013-04-02
  • 初始 Beta 版本。以下是 Beta 版的已知問題:

    SDK 相關

    Android v3 IMA SDK 不支援 HTML5 IMA SDK 內提供的下列 AdEventsIMPRESSIONLOGSKIPPABLE_STATE_CHANGEDSTOPPEDVOLUME_CHANGEDVOLUME_MUTED

    範例應用程式相關

    1. 在使用者按下廣告後,廣告播放器無法正確繼續運作。舉例來說,有時當您在點按廣告後返回應用程式,如果繼續播放廣告,系統會跳到廣告結束並完整播放,而不是在點閱廣告前就從上次中斷的地方繼續播放。
    2. 「串流內廣告 2」廣告代碼傳回的廣告與 v3 IMA Android SDK 不相容。
    3. 播放廣告時,範例播放器不會自動停用跳轉 (拖曳) 功能。當廣告在播放時,請務必停用影片播放器的跳轉功能。