Google IMA tvOS SDK 版本記錄

版本 發布日期 附註
4.15.1 2025-05-07
  • 將廣告期間資訊新增至 AD_PERIOD_STARTED 事件，您可以從 IMAAdEvent.adData 屬性存取該事件。
  • 新增支援功能，可使用 IMA SDK 處理 HLS 插頁式廣告中繼資料。
4.14.1 2024-12-03
  • 為所有串流類型，將聯播網代碼 新增至串流要求參數清單。
  • 點選無效的到達網址時，會觸發 LOG 事件，而不是無聲失敗。
  • 修正 OMID 工作階段遭到不當終止時的記憶體流失問題。
  • 新增支援 VOD Pod Serving 串流中的可略過廣告。
  • 修正影片嵌入可捲動容器時，捲動支援功能發生的錯誤。
  • 新增對非線性廣告的 minSuggestedDuration 支援
  • 修正錯誤：部分 Campaign Manager 追蹤網址會遭到錯誤編碼。
  • 修正導致系統無法在部分廣告工作階段中，傳送 STARTED 事件的問題。
4.13.0 2024-06-13
  • 將 VODConfigID 新增至 IMAVideoStitcherVODStreamRequest。
  • 修正 adTagURL 位於 null IMAAdsRequest 時發生的空指標例外狀況。
  • 變更 素材資源層級的回退 邏輯，可逐一檢查原始 VAST 中的所有廣告，直到 SDK 找出可播放的廣告素材為止。如果找不到可播放的廣告素材，廣告就不會播放。
  • 修正追蹤 Ping 傳送至 ad.doubleclick.net 時未觸發的問題。
  • 根據檢視區塊影格 (而非 playerView 的安全區域版面配置輔助線)，設定 SDK 的廣告大小算繪限制。
4.12.0 2024-04-03
4.11.1 2024-02-22
  • 修正廣告播放期間可能聽到內容音訊的問題。
4.10.0 2024-01-24
  • 啟用 Pod Serving VOD 串流要求。
  • 更新 AdUI 的限制，以遵守安全區域輔助線。
  • 在 iOS/tvOS 串流管理工具中新增提示點的 getter
4.9.2 2023-08-15
  • 修正錯誤：部分動態廣告插播串流的 CPU 使用率過高。
4.9.1 2023-04-20
4.8.2 2022-11-03
  • 已將 userContext 新增至 IMA 串流請求。
  • 修正錯誤：這個錯誤會導致系統發出不必要的「無效的內部訊息」警告。
4.7.0 2022-07-20
  • 修正發布商覆寫 IMA SDK 版本資訊的問題。
  • 已新增 AD_CAN_PLAY 個事件。廣告準備就緒，可播放且無緩衝時觸發。
  • 非行動裝置的預設最高位元率已提高至無限制。
4.6.1 2022-02-23
  • 服務版本，沒有公開變更。
4.5.0 2021-12-06
  • 將最低 tvOS 版本提升至 tvOS 12。
  • 修正可能導致出現多個「為什麼會顯示這則廣告？」圖示的錯誤。
  • 移除 MPNowPlayingSession 的需求。
4.4.2 2021-05-03
  • 修正 tvOS 12 以下版本會顯示警告訊息的問題。
  • 支援 tvOS 10 的最後一個 iOS 專用 IMA SDK 版本。
4.4.1 2021-03-09
  • 新增 IMASettings.sessionID 屬性，讓發布商手動設定 sessionID。
  • 新增子母畫面支援。
  • 修正廣告暫停和繼續事件有時會在內容期間觸發的問題。
  • 新增 IMAVideoDisplay.nowPlayingSession，以便在 tvOS 14 以上版本中正確支援播放/暫停事件。
  • 修正錯誤：系統會向發布商回報 AdSense 線性廣告為非線性廣告。
  • 修正 IMAStreamManager.replaceAdTagParameters 無法發布更新的問題。
  • 新增 Pod 服務 API。
  • 強制將 adContainer 附加至視窗。
4.3.2 2020-08-11
4.3.1 2020-08-05
  • 新增對 Google 額外同意聲明模式的支援。詳情請參閱 Google 的額外同意聲明模式技術規格。
  • 新增串流字幕的「language_name」鍵支援。
  • 修正導致純音訊廣告逾時的問題。
  • 修正問題：略過前置廣告中的第一則廣告時，第二則廣告會忽略自己的略過偏移。
  • 新增 IMAAdDisplayContainer.focusEnvironment，讓發布者在廣告插播期間將焦點轉移至 SDK。只要使用者需要與廣告 UI 互動 (例如可略過的廣告、VAST 圖示)，就必須使用這個方法。
  • 新增 viewController，做為 IMAAdDisplayContainer 的必要初始化引數或屬性。
  • 修正非英文本地化支援問題。
  • 減少錯誤的 RESUME 事件。
  • 新增預設啟用的 IMAAdsRenderingSettings.enablePreloading，提升廣告顯示效能。
  • 新增可略過廣告 (用戶端和隨選影片) 和 VAST 圖示 (用戶端和 DAI) 的支援功能
  • 新增 ICON_FALLBACK_IMAGE_CLOSED 和 ICON_TAPPED 事件。建議您在 ICON_FALLBACK_IMAGE_CLOSED 自動繼續，因為 SDK 會在開啟備用圖片時暫停。
  • 修正只有在 IABTCF_gdprApplies 為字串時，系統才會確認的問題。
4.2.3 2020-05-06
  • 修正特定應用程式套件 ID 可能導致流量分類錯誤的問題。
4.2.2 2020-03-26
  • 將最低執行階段版本提高至 tvOS 10
  • 修正部分 UI 更新可能在背景執行緒上觸發的錯誤
  • 修正問題：嚴格標記會導致 IMACompanionAd 的 init 與 NSObject 的
  • 已淘汰 IMAVideoDisplay 協定中的 loadURL 方法
4.2.1 2020-02-12
  • 4.2.1 版是最後一個支援 tvOS 9.x 的 IMA SDK 版本
  • 修正 tvOS 9.x 上的點擊後瀏覽功能會異常終止的問題
4.2.0 2019-10-30
  • 修正 tvOS 13 間歇性異常終止的問題。
4.1.0 2019-09-23
  • 新增 tvOS 13 支援。
  • 已為 DAI 新增 playerVideoDisplay:didLoadPlayerItem:。
  • 為動態廣告插播廣告新增 IMAAd.companionAds 和 IMACompanionAd。
  • 更新 IMAAVPlayerVideoDisplayDelegate 名稱，以更符合 Objective-C 樣式。
4.0.5 2019-08-16
  • 修正 Apple TV 遙控器的播放按鈕無法繼續播放內容的問題。
4.0.2 2019-07-18
  • 修正問題：系統會錯誤傳送使用者的「限制廣告追蹤」設定。
  • 「IMAAdEventType.adData」現在會顯示輸入的內容。
  • 已在 IMAStreamRequest 新增 authToken API。
4.0.1 已淘汰 2019-07-02
  • 結合用戶端和 DAI tvOS SDK
  • 修正問題：tvOS 無法剖析 AdsLists，並擲回 AdsLoader 錯誤。

顯示舊版本

版本 發布日期 附註
3.9.1 2019-03-28
  • 將預設的串流初始化逾時時間從 5 秒改為 8 秒。
  • 在 IMAStreamRequest 中新增 initializationTimeout 屬性，以便設定串流初始化逾時。
3.9.0 2019-03-06
  • 在 IMAStreamManagerDelegate 中新增 adPeriodDidStart 和 adPeriodDidEnd 回呼。
3.8.1 2018-12-06
  • 為避免重複記錄指標，重新觀看/搜尋廣告時，系統不會再觸發 AD_BREAK_STARTED/AD_BREAK_ENDED 等廣告事件。
3.8.0 2018-05-21
  • 新增支援 npa 廣告代碼參數。
3.7.1 2018-02-26
  • 修正錯誤：在 tvOS 11.2.6 上，系統不會對含有大括號 (「{」或「}」) 的追蹤網址執行 Ping 作業。
3.7.0 2018-01-24
  • 將下列項目新增為 IMAStreamRequest.adTagParameters 鍵的可接受值：
    • 音訊範圍 (dai-aor)
    • 排除 (dai-excl)
    • 訂單開始 (dai-os)
    • 影片範圍 (dai-sr)
  • 將下列項目新增至 IMAAd：advertiserName、creativeID、creativeAdID、dealID、universalAdIDRegistry、universalAdIDValue、wrapperAdIDs、wrapperAdSystems、wrapperCreativeIDs 和 wrapperDealIDs。
  • 現在，SDK 會在廣告插播期間加入串流時觸發 AD_BREAK_STARTED，讓接聽程式可以算繪廣告 UI。
  • 新增 IMAAVPlayerVideoDisplayDelegate，讓 IMAAVPlayerVideoDisplay 的使用者可以接收要載入的串流 AVAssetURL。使用者可以透過 AVAssetURL 物件註冊 FairPlay 內容保護播放功能。
3.6.0 2017-09-19
  • 移除無法運作的 IMAStreamRequest.attemptPreroll。
  • 新增下列可接受的 IMAStreamRequest.adTagParameters：
    • dai-ah (廣告休播)
    • dai-dlid (交貨地點)
  • 加入 IMAStreamRequest.streamActivityMonitorID。
  • 修正問題：對於未播放或載入的串流，系統不會呼叫 [IMAStreamManagerDelegate streamManager:didReceiveError:]。
3.5.0 2017-04-24
  • 加入 IMAAd.companions。
  • 新增 IMACompanion 類別。
3.4.1 2017-03-31
  • 服務版本，沒有新功能。
3.4.0 2017-03-13
  • 修正位元碼支援問題。
  • 在 AdBreakInfo 中加入以下屬性：
    • adBreakIndex
    • timeOffset
3.3.0 2016-12-05
  • 公開 [IMAAVPlayerVideoDisplay reset]，在需要以備份 AVPlayerItem 取代內容播放器上的 AVPlayerItem 時呼叫。
3.2.0 2016-08-22
  • 修正提交使用測試架構的應用程式時發生的問題。
3.1.0 2016-05-09
  • 第 1 版。