Google IMA DAI HTML5 SDK 版本说明

如需接收有关新版本的通知，请订阅 IMA 支持论坛上的版本说明对话。

版本 3.550.0 至 3.725.0

最新的 IMA DAI HTML5 SDK 版本为 v3.728.0。如需了解详情，请参阅 Google IMA DAI HTML5 SDK 版本发布历史记录。

版本 发布日期 备注
3.725.0 2025-10-13
  • 修复了在智能电视和游戏机平台（例如 Xbox、PlayStation、Tizen 和使用 WebOS 的平台）上加载广告时出现的 ReferenceError: Can't find variable: URLSearchParams 错误。
3.724.0 2025-10-09
  • 移除了已废弃的方法 ImaSdkSettings.setCookiesEnabled() 和 ImaSdkSettings.isCookiesEnabled() 的功能。
3.719.1 2025-09-08
  • 修复了全屏广告的 VPAID 图标定位问题。
  • 修复了音频海报图片的居中问题。
3.711.0 2025-08-07
  • 提高了 XHTML 兼容性。
3.710.0 2025-08-06
  • 添加了对通过连播投放的视频串流进行广告点击跟踪的支持。
  • 修复了 TypeError: a.brands.some is not a function 错误。
  • 修复了 IMA 过于频繁地报告广告完成事件的问题。
  • 修复了无效的 sz= 参数值导致的崩溃问题。
3.704.0 2025-06-19
  • 修复了与 DOMRect 对象使用相关的问题，即在 Chromium 版本低于 61 的环境中使用 IMA SDK 时，该 SDK 会显示 DOMRect is not defined 错误消息。
  • 修复了 Firefox 版本 139 的 OMID 可见度衡量。
3.700.0 2025-06-05
  • 弃用了 ImaSdkSettings.setCookiesEnabled() 方法。
3.697.0 2025-05-28
  • 将 AdsManager 类 init() 和 resize() 方法中的 viewMode 参数标记为可选参数。viewMode 参数没有任何影响，您可以忽略它。
  • 修复了在广告插播时间点中途加入直播时广告界面无法显示的问题。
  • 移除了已弃用的 ViewMode 枚举。
3.695.1 2025-04-30
  • 更新了 AdsManager、expand() 和 collapse() 方法的文档，以说明它们在处理非线性广告和 VPAID 广告时的行为。
3.693.0 2025-04-14
  • 弃用了 DOMAIN OMID 访问模式。
3.691.0 2025-03-31
  • 修复了 IMA 无法呈现“广告选项”图标的问题。
  • 修复了 getCompanionAds() 方法针对具有相同广告 ID 的广告返回过时的随播广告数据的 bug。
3.690.0 2025-03-26
  • 修复了视频无法在代理视频元素上播放的 bug。
3.689.6 2025-03-24
  • 添加了 AD_PERIOD_STARTED 事件中提供的 AdPeriodData 类，该类可通过 StreamEvent.getStreamData() 进行访问。
  • 改进了输入，以匹配事件类型和监听器回调类。
  • 针对已弃用和不受支持的事件监听 API 添加了控制台警告。
  • 修复了服务器引导的广告插播 (SGAI) 的一个问题，即 AD_BREAK_STARTED 和 AD_PERIOD_STARTED 事件延迟。
  • 针对失败的网络请求提升了稳定性。
  • 明确了事件监听 API。
3.681.0 2025-01-22
  • 添加了对 Ad.getCompanionAds() 的支持，以便在 STARTED 广告事件之后的所有事件中返回随播广告数组。
3.673.0 2024-10-16
  • 为 DAI Pod Serving VOD 视频流添加了对可跳过式广告的支持。
  • 修复了在广告播放期间销毁 AdManager 时发生的内存泄漏问题。
3.668.1 2024-09-23
  • 修复了在 localhost 环境中使用 IMA 示例代码时导致 1005 错误的问题。
3.667.0 2024-09-18
  • 将 LiveStreamRequest 和 VODStreamRequest 的 networkCode 参数更新为可选参数。我们建议您添加 networkCode，以与 Ad Manager 中使用的标识符设置保持一致。
3.661.1 2024-08-26
  • 将马来语 (ms) 添加到支持的语言区域列表中。
3.660.0 2024-08-20
  • 为非线性广告添加了对 minSuggestedDuration 值的支持。之前，IMA 会将所有非线性广告展示 45 秒。
3.653.0 2024-07-24
  • 修复了更新后的 Chrome 版本中非安全环境（http:// 或 localhost）存在的问题。
3.650.0 2024-07-03
3.647.0 2024-06-20
  • 为直播和 VOD 流请求添加了发布商的 Ad Manager 广告资源网代码的必需字段 StreamRequest.networkCode。
  • 针对无效或不受支持的点击后到达网址添加了 AdError 1022。
  • 修复了以下 bug：在联网电视环境中，可跳过的广告会导致出现无限循环的错误。
3.642.0 2024-05-23
  • 修复了 VAST 跟踪 ping 中的 Cookie 问题。
3.637.1 2024-04-25
3.631.0 2024-04-01
3.627.0 2024-03-06
  • 修复了导致控制台发出有关转义 iframe 沙盒的警告的 iframe 问题。
3.624.0 2024-02-29
3.621.0 2024-02-15
  • 向随播广告添加了关于此广告图标。
  • 改进了在广告播放期间使用相同 AdsLoader 制作新广告请求的处理方式。
3.617.1 2024-02-05
  • 为 iframe 添加了 title 属性，以改进无障碍功能
3.616.1 2024-01-31
  • 为 Pod 投放添加了随播广告支持。
  • 修复了包含自适应随播广告的 AdSense 广告存在的问题。
3.614.1 2024-01-22
  • 添加了对冰岛语 ('is') 本地化的支持。
3.612.0 2024-01-11
  • IMA 现在优先渲染 SIMID 广告素材，而不是 VPAID 广告素材。
3.609.0 2023-12-12
  • 添加了对使用 PodVodStreamRequest 类提供 DAI VOD Pod 的支持。
  • 修复了 DAI 直播存在的问题，即如果用户在广告插播时间点中加入直播，则无法点击广告。
3.607.0 2023-12-04
  • 修复了以下问题：当未返回任何广告时，VAST 错误信标不会触发。
  • 更新 AdsManager.skip() 仅当 IMA 未渲染跳过广告按钮且广告可跳过时，才跳过广告。
  • 更新语言翻译。
3.601.0
已回滚		 2023-11-06
  • 由于 DAI 点击后行为失败，回滚到 v3.600.0。
  • 服务发布。没有新功能。
3.600.0 2023-11-02
  • 添加了在 IMA 收到空 VAST 时触发错误 ping 的行为。
3.598.0 2023-10-26
  • 添加了行为以避免触发 about:blank VAST 展示网址。
3.597.0 2023-10-23
  • 添加了以下功能：如果主要广告返回空的 VAST 代码，IMA 会选择其他候补广告进行播放。
3.595.0 2023-10-10
  • 修复了以下问题：performance.now() 在某些联网电视上未定义。
  • 修复了广告界面元素无法在特定自定义实现上呈现的问题。
3.594.0 2023-10-04
  • 如果广告目前可以跳过，则向返回的 true 添加 StreamManager.getAdSkippableState()。
  • 针对 IMA DAI 修复了以下问题：如果 VAST 响应包含自定义跟踪跳过事件跟踪器，则 skipoffset= 值会被忽略。
3.592.0 2023-09-27
  • 修复了客户端 IMA 的一个问题，即如果 VAST 响应包含自定义跟踪跳过事件跟踪器，则 skipoffset= 值会被忽略。
3.582.5 2023-07-25
  • 添加了 AD_BREAK_FETCH_ERROR 广告事件，当广告插播时间点无法播放任何广告时，系统会触发该事件。
  • 更新了 AdPodInfo.getPodIndex() 的行为，以支持 DAI 直播前贴片广告。
  • 修复了 Ad.getContentType() 针对具有 HTML 或 iframe 资源的非线性广告返回的值。
3.580.0 2023-07-10
  • 向 DAI StreamManager 和客户端 AdDisplayContainer 提供非 HTMLVideoElement 时，添加了控制台错误，因为这会导致可视性和可听性测量失败。
3.579.0 2023-07-05
  • 在使用已弃用的外部 googletag.encryptedSignalProviders 时，向控制台添加日志警告。
3.573.0 2023-05-15
  • 修复了以下问题：当没有可用的随播广告位时，IMA 未能报告未显示所需的随播广告。
3.568.1 2023-04-13
  • IMA 现在会针对 SIMID 广告中的广告点击后到达网址触发 CLICK 广告事件。
  • 弃用了广告错误 1300： CONSENT_MANAGEMENT_PROVIDER_NOT_READY。
3.566.2 2023-03-28
  • 仅限文档更新。指定 DAI adTagParameters 仅接受 string 值。
3.565.0 2023-03-21
3.564.1 2023-03-20
  • 重命名了以下 VideoStitcherVodStreamRequest API：
3.557.0 2023-02-21

显示更早的版本（2023 年之前的版本）

3.548.0 2022-12-06
  • 为 STREAM_INITIALIZED 中的 StreamData 添加了 StreamData.dashPeriodUrl。 此网址用于 DASH 线性 Pod 视频流。
3.544.0 2022-11-10
3.541.0 2022-10-27
  • 修复了 IMA 无意中添加到窗口对象的问题。
3.532.0 2022-09-21
  • 针对 DAI 修复了以下问题：当 OMID 广告会话开始时，控制台中会发生错误。
  • 修复了以下问题：在非线性广告之后，用户无法点击线性广告的点击后到达网址。
3.531.0 2022-09-19
  • 添加了在直播期间使 SIMID 广告素材能够进行 requestPause 和 requestPlay 的功能。此功能已适用于 VOD 直播。
  • 修复了以下问题：视频广告结束时，有时会发出设置为“null”的不必要的失败网络请求。
3.529.2 2022-09-08
  • 修复了广告对象中未填充包装链内某些广告素材 ID 的问题。
3.526.0 2022-08-22
  • 修复了已连接电视设备上 is_lat 参数存在的问题。
  • 修复了桌面环境中错误显示了解详情按钮的问题。
3.523.0 2022-08-04
3.522.0 2022-07-18
3.521.0 2022-07-12
  • 添加了 AD_CAN_PLAY 事件，当广告准备好播放时，IMA 会触发该事件。使用此事件可了解在 AD_BUFFERING 事件发生后何时更新播放器界面。
  • 修复了广告连播中 TrueView 广告之后出现的非 TrueView 广告的广告界面问题。
3.520.0 2022-06-29
3.517.2 2022-05-23
3.513.0 2022-05-03
3.512.0 2022-04-21
  • 修复了以下问题：使用 GPT 代理跨 iframe 边界转发来自 IMA 的事件时出现的问题。
3.508.0 2022-03-28
  • 修复了以下问题：在 VMAP 广告期间，在 adsManager.destroy() 之后调用 adsLoader.onContentComplete() 会错误地导致播放后贴片广告。
  • 修复了以下问题：在播放 VMAP 广告期间，调用 AdsManager.discardAdBreak() 有时无法舍弃广告插播时间。
3.501.0 2022-02-17
3.498.1 2022-02-10
  • 如果指定了 TFUA 或 TFCD，系统将不再在广告请求中发送 RDID。
  • 修复了网址参数被 SDK 覆盖的 bug。
3.495.1 2022-01-10
  • 修复了 google.ima.OmidVerificationVendor 未定义的问题。
3.494.0 2022-01-04
  • 修复了以下问题：带有片尾广告的 TrueView 行动号召广告强制将焦点放在“跳过”按钮上，导致出现意外滚动。
3.493.0 2021 年 12 月 16 日
  • 在 IMA HTML5 客户端和 DAI 中启动 OMID 支持。注意：发布商可能会发现，OMID 中的展示次数与 Ad Manager 中的展示次数之间仍存在小幅 (<7%) 差异。
  • 添加了新的 OMID Access Mode API。
3.488.0 2021-11-08
  • 移除了记录到控制台的“Unrecognized Feature”警告。
  • 修复了与广告请求大小相关的 JavaScript 广告的后备行为。
3.485.1 2021-10-11
  • 修复了 OMID 的一个问题，即如果在单个 AdsDisplayContainer 的生命周期内加载了多个 AdsManager，可能会出现问题。
  • 修复了以下 bug：对于某些广告，为什么会展示此广告？可能会显示两次。
3.483.2 2021-10-04
  • 修复了 IMA 与 OMID 集成（用于 Web）时在 Shadow DOM 内使用时出现的一个 bug。
3.480.1 2021-09-13
  • 修复了以下 bug：当视频播放器处于静音状态时，DAI 会向 OM SDK 报告错误的音量。
3.479.1 2021-09-08
3.474.0 2021-08-09
  • 根据 IAB CCPA 标准，在跟踪网址和请求网址中添加了 US_PRIVACY 宏的扩展。
3.470.1 2021-07-01
  • 修复了移动版 Safari 上在 adBreakEnded 时播放器控件未正确释放的错误。
3.469.0 2021 年 6 月 24 日
  • 修复了在 STARTED 事件之前检索到随播广告时发生的错误。
3.467.0 2021-06-17
  • 修复了 Chrome 浏览器更新导致 INSECURE 模式下 VPAID 广告出现的问题。
3.458.0 2021-05-13
  • 添加了 DaiSdkSettings 类，其中包含以下 API：
    • DaiSdkSettings.getFeatureFlags()
    • DaiSdkSettings.setFeatureFlags()
3.452.0 2021-04-15
  • 更改了广告暂停行为，以便在广告点击导致导航离开网页时随时暂停广告。此变更要求发布商在广告暂停后显示用于恢复广告的界面。如需详细了解此变更，请参阅 暂停行为变更博文。 发布商可以使用此广告代码测试这些更改的实现情况。
3.448.1 2021-03-31
  • 添加 AdsRequest.pageUrl 属性，以帮助进行广告定位。 该属性值会替换广告请求的 &url= 参数。
  • 更新了 AdEvent.Type.DURATION_CHANGE 事件，以便在 SIMID 广告素材更改其时长时进行调度。
  • 修复了预加载的 SIMID 广告可能导致后续广告无法在移动环境中注册点按事件的问题。
3.447.1 2021-03-15
  • 更新了通过 AdsRenderingSettings.mimeTypes 指定的 MIME 类型的行为，以便忽略浏览器不支持的类型。
  • 在广告插播时段视频流中添加了对 ActiveView 跟踪和自定义跟踪等扩展功能的支持。
3.446.1 2021-03-08
  • 修复了以下问题：在 SIMID 广告之后显示的广告不会分派 TAPPED 事件。
3.445.1 2021-03-02
  • 修复了以下问题：预加载后贴片广告时，非线性中贴片广告的显示时间过短。
3.444.1 2021-02-25
  • 将广告代码仅返回 <Playlist/> 而不返回 UNKNOWN_AD_RESPONSE: 1010 时显示的错误消息更改为 VAST_EMPTY_RESPONSE: 1009。
  • 修复了以下 bug：AdSense 线性广告被报告为非线性广告。
  • 修复了 simid 广告中 requestChangeDuration 只能调用一次的 bug。
  • 修复了 pod 服务会导致发送无关的 ping 和 404 错误的 bug。
3.442.0 2021-02-17
  • 添加了功能标志 API，该 API 可用于启用或停用 IMA 中未永久启用的特定功能。使用 ImaSdkSettings.getFeatureFlags() 和 ImaSdkSettings.setFeatureFlags() 获取和设置功能标志。在未来的 SDK 版本中，功能标志将用于其他选择启用功能。
  • 为希望选择加入 OMID for Web 公开 Beta 版的开发者添加了 enableOmidBeta 功能标志。
  • 添加了特殊的未知时长值 (-3)，以停用 VMAP 后贴片预加载。使用 AdsRequest.contentDuration() 进行设置。
3.439.0 2021-02-08
3.438.0 2021-02-03
  • 修复了启用预加载时 IMA 事件偶尔会重复的问题。
3.436.0 2021-01-26
  • 修复了 pod 服务中的一个 bug，该 bug 可能会导致早期元数据验证被多次发送
  • 修复了以下 bug：如果 AdServingId 下方的 AdSystem 在 VAST 中设置得较低，AdServingId 会覆盖 AdSystem
3.433.2 2021-01-14
  • 允许在以下情况下投放受限广告：用户不同意使用 Cookie、用户拒绝同意使用 Cookie，或者在 IAB TCFv2 集成宽限期结束后，IMA 在 GDPR 和 ePrivacy 地区未收到有效的 TC 字符串。
回滚到 3.429.0 2020-12-10
  • 回滚到 3.429.0，因为 3.430.0 版存在一个问题，即 DAI VOD 流的 cuepoint 返回的开始时间和结束时间为 0。此问题主要发生在原生 SDK（Android 和 iOS）上。
3.427.1 2020-12-02
  • 更新了 contentDuration 的参考信息，以明确 VMAP 后贴片预加载使用情形。
  • 修复了 VPAID 广告尺寸不正确的 bug。
  • 修复了 getAdSkippableState 方法返回错误值的 bug。
回滚到 3.423.0 2020-11-11
  • 由于版本 3.424.1 中存在一个问题，导致广告暂停行为的更改对许多发布商产生了负面影响，因此回滚到 3.423.0。
3.424.1 2020-11-09
  • 修复了预加载广告管理器时音量变化无法持久存在的问题。
  • 更改了广告暂停行为，以便在广告点击导致用户离开网页时随时暂停广告。此变更要求发布商在广告暂停后显示用于恢复广告的界面。如需详细了解此变更，请参阅 暂停行为变更博文。 发布商可以使用此广告代码测试这些更改的实现情况。
3.420.1 2020-11-02
  • 修复了以下问题：在某些情况下，跳过前贴片广告后，中贴片广告不会播放，而是显示黑屏并播放前贴片广告的音频。
3.418.3 2020-10-22
  • 修复了以下 bug：在 AdSense 广告中，同意情况参数从广告请求中被剥离。
3.418.1 2020-10-21
  • HLS 媒体文件不再是桌面版 Chrome 或移动版 Chrome 网页上可选择的容器格式。
  • 修复了对 AdsManager.destroy() 的调用存在的问题，即在某些情况下使用 VmapAdManager 不会触发 ALL_ADS_COMPLETED 事件。
3.417.2 2020-10-19
  • 修复了透明度和用户意见征求字符串 (TC 字符串) 存在的问题，即当广告代码网址与用户意见征求管理提供商提供的网址具有不同的值时，字符串无法解析。
  • 修复了以下 bug：即使非线性 AdSense 广告因大小限制而无法展示，IMPRESSION 事件也会发送给发布商。
  • 修复了 iOS 上的 fullscreen 事件被统计两次的问题。
3.415.1 2020-10-05
  • 修复了导致 AdProgressData 属性被混淆的 bug。
  • 使用代理视频元素的安全 VPAID 广告现在可以正确转发全屏更改事件。
  • ima3_dai_debug.js 现在会向控制台输出更多日志。
  • IMA 现在会记录 VPAID 定义指南第 3 部分中列出的 VPAID 协议。
  • 修复了以下 bug：使用素材资源回退的广告有时会两次请求同一广告代码。
3.411.1 2020-09-23
  • 修改了 Android 6.0 及更低版本上深层链接的行为，以便在有广告客户的应用可用时，将用户重定向到该应用，而不是着陆页。
3.410.0 2020-09-17
  • 为 DAI SDK 添加了对 iframe 和 HTML 随播广告的支持。
3.407.0 2020-09-02
3.405.0 2020-08-27
  • 向 DAI SDK 添加了 StreamManager.focus() 方法，该方法允许以程序化方式更改“跳过”按钮和其他互动式界面元素的焦点。
3.404.1 2020-08-25
  • 向客户端 SDK 添加了 AdsManager.focus() 方法，该方法允许以编程方式更改跳过按钮和其他互动式界面元素的焦点。
  • 将 FullSlot 广告的淡入时间从 2 秒更改为 0.3 秒。
  • 如果 VPAID 广告位在初始化时的尺寸为 0x0，则当广告位的尺寸正确设置后，SDK 现在会调用 VPAID 广告的 resizeAd() 方法，以便广告调整大小以匹配广告位的新尺寸。
3.403.1 2020-08-24
  • 修复了 DAI VOD 流的 adPodInfo.podIndex 问题，以确保中贴片广告的索引从 1 开始正确编制。
  • 修复了 DAI VOD 流的 adPodInfo.timeOffset 问题，该问题导致后贴片广告无法正确返回 -1 的值。
  • 确保不再屏蔽 shadow DOM 内的 AdsDisplayContainer 元素。
3.402.0 2020-08-13
  • 重新发布了 IAB TCFv2 集成，解决了 gdpr=1 和 gdpr=true 之间的差异，以便对这两个值进行同等评估。我们建议使用 gdpr=1。
3.399.2 2020-07-28
  • 向 DAI SDK 添加了 StreamEvent.Type.PAUSED 和 StreamEvent.Type.RESUMED 广告事件。
  • 添加了 ICON_FALLBACK_IMAGE_CLOSED 事件，该事件会在已连接的电视设备上关闭图标回退图片对话框时触发。
  • 修复了以下问题：当广告与上一个广告具有相同的 ID 时，随播广告无法展示。
  • 为客户端 SDK 添加了对 SIMID 广告时长更改请求的支持。
3.398.1 2020-07-21
  • 向 DAI 调试 SDK 添加了额外的日志数据。
3.397.1 2020-07-21
  • 将 GFP Cookie 与 GDPR TCFv2 标准集成。现在，如果发布商与 CMP 集成，那么当欧洲经济区和英国境内的最终用户满足以下任一条件时，将不会使用 Cookie：
    • 发布商已选择停用。
    • 用户已明确选择停用。
    • CMP 正在等待用户互动。
3.396.0 2020-07-16
  • 添加了以下功能：通过为 streamRequest.adTagParameters 的 dai-apto 参数指定一个值（以毫秒为单位），自定义 DAI 视频流的广告连播决策超时时限。此设置还会影响视频流初始化超时时限，该时限的设定值比 dai-apto 值多 4 秒。
3.395.0 2020-07-14
  • 修复了移动版 Safari 上 DAI 点击后到达网址方面的问题。
  • 暂时回滚了 IAB TCFv2 集成，原因是使用 gdpr=1 和 gdpr=true 之间存在差异。
3.394.0 2020-07-13
  • 改进了在初始化时没有可用网络连接的情况下的异常处理。
  • 修改了 AD_PERIOD_ENDED 事件，以销毁当前正在播放的广告并重置与该广告关联的所有数据。
  • 为 VPAID 广告添加了音量变化报告。
  • 为 DAI 字幕添加了 subtitle_name 参数，以指定同一语言的字幕集。
3.391.0 2020-06-15
  • 修复了允许为直播投放可跳过广告的 bug。
3.388.1 2020-06-02
  • 添加了一项功能，用于在 VPAID JavaScript 尝试在 SDK 启动广告事件触发之前播放广告时返回错误。
  • 修复了导致在某些情况下忽略 CompanionAdSelectionSettings 的 bug。
3.384.0 2020-05-04
  • 改进了“跳过”按钮的无障碍功能：
    • 使预跳过文本可使用 Tab 键选择，以便屏幕阅读器可以读取该文本。
    • 为预跳过倒计时和跳过按钮添加了 aria-label 值。
3.383.0 2020-04-28
  • 新增了对客户端 SIMID 广告的支持。
3.381.1 2020-04-16
  • 修复了以下问题：如果广告规则播放列表中的广告未能加载，内容播放可能会冻结。
3.379.2 2020-04-09
  • 更新了 VPAID 广告的处理方式，不再生成新的视频元素。以前，当发布商提供的元素无法按预期运行时，IMA 会为 VPAID 广告创建一个新的视频元素。
3.373.2 2020-03-10
  • 修复了导致 VOLUME_CHANGED 和 VOLUME_MUTED 事件无法正确触发的 bug。
3.367.1 2020-02-12
  • 在 AdsLoader 上添加了 getVersion 方法，以支持检索当前 SDK 版本。
3.366.0 2020-02-06
  • 弃用了 ViewMode API 的使用。
3.365.1 2020-02-03
3.364.0 2020-01-28
  • 修复了与设置 DAI SDK 本地化相关的问题。
  • 更新了提示点数据，现在使用浮点精度。
3.361.1 2020-01-21
  • 在窄宽度的移动设备上，为什么会看到此广告？和广告时长的可见性得到提升。
3.360.0 2020-01-15
  • 将提示点时间更新为浮点数，以提高准确性。
  • 添加了对显示来自封装广告的图标（除了来自内嵌广告的图标）的支持。
  • 更新了叠加层检测逻辑，以更准确地确定可见性。
3.358.2 2020-01-15
  • 修复了 Internet Explorer 11 上 EventTarget 未定义的问题。
3.358.1 2020-01-08
  • 从可跳过广告的“跳过广告”倒计时中移除了跳过前文字。
3.355.4 2020-01-03
3.355.3 2019-12-10
  • 修复了在某些情况下无法引发日志事件的问题。
3.355.0 2019-12-05
  • 修复了包含重定向到 iOS 上 App Store 的点击后到达网址的问题。
3.354.0 2019-12-04
  • 在没有视频元素传递给 AdDisplayContainer 的情况下，添加了对 iOS 10+ 移动网站上可跳过式广告的支持。
  • 对于所有非线性广告和全插槽广告，在广告展示和可点击之间添加了 2 秒的延迟。
  • 修复了以下问题：如果 enablePreloading 设置为 true，则 setAdWillPlayMuted 无法将广告静音。
3.351.1 2019-11-14
  • 修复了导致 LOG 和 INTERACTION 广告事件在某些情况下无法包含广告对象的问题。
  • 针对符合 IAB TCFv2 标准的用户意见征求管理提供商（例如 Google 的“资助选项”）的实现，添加了 Google 广告请求的自动集成。
3.349.0 2019-11-11
  • 修复了 VMAP breakstart 和 breakend 跟踪事件存在的问题。
3.346.0 2019-10-25
  • 为 DAI SDK 添加了对 TrueView 广告的支持。TrueView 广告可以通过将 AdUiElement 传递给 StreamManager 的构造函数来实现。
3.343.1 2019-10-17
  • 修复了 tvOS 上内嵌 VMAP 解析方面的 bug。
3.339.0 2019-10-09
  • 为 DAI SDK 添加了对 VAST 图标的支持。可以通过将 AdUiElement 传递给 StreamManager 的构造函数来实现图标。
3.338.1 2019-10-07
  • 添加了 VIDEO_CLICKED 事件，该事件会在所有视频点击时触发，即使点击未触发点击后到达网址也是如此。
  • 新增了对在 DAI 广告上显示为什么显示该广告？图标的支持。可以通过将 AdUiElement 传递给 StreamManager 的构造函数来实现此目的。
3.337.0 2019-10-01
  • 向 DAI SDK 添加了对可跳过广告的支持。可通过将 AdUiElement 传递给 StreamManager 的构造函数来实现可跳过式广告。
3.336.1 2019-09-30
  • 为 DAI SDK 添加了支持，以将 AdUiElement 传递给 StreamManager 的构造函数，该构造函数应取代 setClickElement 用于处理点击后到达的网页。
3.334.0 2019-09-23
  • 修复了 VPAID 预加载方面的 bug。
3.325.3 2019-08-19
  • Microsoft Edge 中的弹出式窗口现在会显示为新标签页。
  • Internet Explorer 11 中的弹出式窗口现在会显示为新窗口。
3.323.2 2019-08-12
  • Internet Explorer 11 中的弹出式窗口现在可滚动。
3.320.0 2019-07-23
  • 添加了对 intent:// 网址的支持，以便链接到 Android 应用中的网页。
  • 新增了对 market:// 网址的支持，以便在 Android 上链接到 Google Play 商店中的网页。
3.319.1 2019-07-22
  • 新增了对多个通用广告 ID 的支持。getUniversalAdIdValue 和 getUniversalAdIdRegistry 方法现已弃用。
3.316.0 2019-07-10
  • 向 DAI 流请求对象添加了 authToken 和 streamFormat。
3.312.1 2019-06-17
  • 为 DAI 的广告对象添加了 getUniversalAdIdValue 和 getUniversalAdIdRegistry 函数。
3.311.0 2019-06-11
  • 修复了不公开列出视频的 YouTube 元数据 bug。
回滚到 3.296.0 2019-04-24
  • 回滚到 3.296.0，因为版本 3.297.3 存在错误，导致视频播放无法继续播放前贴片广告的最后一帧。
3.290.0 2019-04-01
  • 修复了不支持的广告类型（非线性广告、VPAID 广告）未正确报错的问题。
3.284.0 2019-03-04
  • 修复了以下问题：在处置广告时，订阅的事件未被清除。
  • 为 DAI 添加了 AD_PERIOD_STARTED 和 AD_PERIOD_ENDED 事件。这些事件可用于检测 DAI 视频流何时处于内容播放状态，以及何时播放广告或插播广告。
3.279.0 2019-02-13
  • 向 StreamData 添加了 manifestFormat 属性，以指明流的格式。此属性是在 LOADED 事件中填充的。
回滚到 3.274.0 2019-02-12
  • 回滚到 3.274.0。
3.275.4 2019-02-06
  • 向 StreamData 添加了 manifestFormat 属性，以指明流的格式。此属性是在 LOADED 事件中填充的。
3.273.0 2019-01-24
  • 修复了 VAST 图标未随 VPAID 广告一起显示的问题。
3.271.0 2019-01-10
  • 添加了对 VAST 4.1 宏的支持。如需了解详情，请参阅 VAST 4.1 规范。
  • 修复了以下问题：屏幕外启动的 VPAID 广告以错误的 slot 大小进行初始化。
  • 修复了未针对直播或 VOD 流触发视频错误的问题。
  • 修复了内容无法在 iOS Safari 上恢复播放的问题。
3.259.0 2018-11-27
  • 修复了以下问题：当广告插播包含 VPAID 广告或使用素材资源级回退时，随播广告的呈现出现问题。
3.255.0 2018-11-12
  • 修复了 INSECURE 模式 VPAID 广告中 VAST 图标的点击后到达网址支持方面存在的问题。
3.254.0 2018-11-08
  • 添加 AdEvent.Type.AD_BUFFERING 事件。此事件会在广告因缓冲而暂停播放时触发。
3.246.0 2018-10-18
  • 修复了将 Google 发布商代码代理与 IMA SDK 搭配使用时出现的过时播放问题。
3.244.2 2018-10-16
  • 添加 AD_PROGRESS 事件。此事件在整个广告播放过程中触发，并包含通过 getAdData() 获取的 AdProgressData 对象。
  • 向 ImaSdkSettings 添加了 isCookiesEnabled() 和 setCookiesEnabled()。
  • 修复了与背对背可跳过的视频广告相关的问题。
  • 修复了在 iOS 中使用自定义播放时出现的广告错误问题。
3.234.1 2018-09-04
  • 如果广告连播中的 VAST 封装广告未能返回广告，现在可以使用广告自助餐（没有序列号的广告）中时长小于或等于该广告的广告来替换。
3.228.0 2018-08-14
  • 修复了连续播放的可跳过广告的问题。
  • 修复了以下问题：在创建 AdsLoader 后设置 AdsManager.isCustomPlaybackUsed() 时，该方法会返回错误的值。
3.227.0 2018-08-13
  • 仅尝试播放传递给 AdsRenderingSettings.mimeTypes 的受支持 MIME 类型。
3.226.2 2018-08-07
  • 现在，没有设置播放时长的叠加广告会一直播放到下一个广告，而不是播放 15 秒。
  • 修复了 AdsRequest.vastLoadTimeout 未正确导出的问题。
  • 修复了 Ad.getVastMediaBitrate 未正确导出的问题。
3.225.0 2018-07-30
  • 强制为 Google Ad Manager 请求输出 VAST 4。
3.223.0 2018-07-25
  • 添加了 Ad.getVastMediaBitrate()。
3.216.1 2018-06-26
  • 修复了 DAI SDK 中 Ad.getDuration() 错误返回毫秒而非秒的问题。
3.216.0 2018-06-20
  • 修复了错误地将 303 错误报告为 1005 错误的 bug。这些错误被记录到服务器中时显示为 900 错误，而不是 303 错误。
3.214.1 2018-06-12
回滚到 3.211.3 2018-06-07
  • 由于存在影响特定 iPhone 实现的问题，已回滚到 3.211.3。
3.213.1 2018-06-07
3.210.1 2018-05-16
  • 修复了在调用 AdDisplayContainer.destroy() 后广告会继续显示的问题。
  • 向用于加载 VPAID 广告的 iframe 添加 allow="autoplay"。
3.198.2 2018-03-27
  • 修复了桌面版 Chrome 和 Safari 的最新版本中预加载方面的问题。
3.193.1 2018-02-26
  • 移除了 AdError 上错误记录的序列化和反序列化方法。
3.192.0 2018-02-14
  • 移除了不必要的 INVALID_ADX_EXTENSION 错误代码。如果扩展程序解析失败，广告仍会播放。
  • 在 iframe 中加载的 IMA 现在将继承 Chrome 65 及更高版本中父级网页的自动播放政策。
  • 修复了当实现未在 AdError 上销毁 AdsManager 时发生的内存泄漏。
3.190.0 2018-01-30
  • VPAID 广告现在会在停止播放但未报告展示时报告错误。这与其他所有广告的行为一致。
3.189.0 2018-01-24
  • 修复了从各种自动播放策略回退到点击播放时出现的问题。
  • 修复了 IE 11 上的播放问题。
  • 修复了 iOS 11 上中贴片广告的问题。
  • 空的 VPAID 随播广告不再触发控制台错误。
  • 将一些警告降级为使用信息日志。
3.186.1 2017-12-07
  • AdErrorEvent.getInnerError() 现在可能会返回内部 AdError 对象。这样可以检查自动播放是否失败。
3.184.1 2017-11-02
  • 修复了以下问题：如果未及时调用 adsManager.init，预加载的广告将无法播放。
  • 添加了 AdError.AUTOPLAY_DISALLOWED，当 SDK 尝试自动播放广告但被浏览器阻止时，系统会触发此错误。
回滚到 3.182.1 2017-10-26
  • 由于存在影响部分 videojs-ima 插件实现的问题，已回滚到 3.182.1。
3.183.1 2017-10-26
  • 修复了以下问题：如果未及时调用 adsManager.init，预加载的广告将无法播放。
3.182.0 2017-10-17
  • 修复了桌面版 Safari 11 上点击播放的线性视频广告的播放问题。
回滚到 3.180.3 2017-10-06
  • 由于某些广告无法正常展示，回滚到 3.180.3。
3.181.3 2017-10-05
  • 修复了无效点击后视频暂停的问题。
  • 修复了在使用 discardAdBreak() 时，中贴片广告插播时间点抛出错误的问题。
回滚到 3.179.0 2017-09-22
  • 由于某些特定 VPAID 广告存在问题，回滚到 3.179.0。
3.179.0 2017-09-18
  • 修复了在预加载广告并重复使用广告容器时呈现多个广告界面这一 bug。
3.178.0 2017-08-31
  • 修复了以下问题：如果向无法显示可跳过广告的移动版 Safari 网页投放可跳过广告，则会抛出异常。SDK 现在可以正确处理此异常。
  • 修复了在极少数情况下，移动版 Safari 上 HLS 流的 CONTENT_RESUME_REQUESTED 未触发的问题。
3.176.0 2017-08-10
  • 添加了 AdsRequest.liveStreamPrefetchSeconds。
  • 移除了 AdsRenderingSettings.useShareButton。
3.175.0 2017-07-31
  • 现在，展示 VPAID 非线性广告会导致 SDK 向播放器发送 STARTED 事件。
  • VPAID 线性广告现在会在展示时（而非开始时）触发 STARTED 事件。
3.174.0 2017-07-24
  • 修复了在启用预加载时导致某些前贴片广告 pod 冻结的问题。
  • 修复了以下问题：在某些 iOS 实现中，中贴片广告会导致内容从头开始播放。
  • 修复了以下问题：在 iOS 设备上，某些直播内容在广告播放完毕后无法继续播放。
3.173.1 2017-07-06
  • 移除了对 Flash VPAID 广告的支持。这是 IMA SDK 弃用 Flash 的更大项目的一部分。如需了解详情，请参阅 在 IMA SDK 中弃用 Flash。
3.173.0 2017-06-28
  • 修复了以下问题：在 iOS 移动版网站上，当切换内容并在不久后请求广告时，无法通过自定义播放正确恢复内容。
3.172.0 2017-06-14
  • 修复了导致全广告位 AdSense 广告在移动设备上投放失败的问题。
  • 添加了 Ad.getSkipTimeOffset()。
3.171.0 2017-06-08
  • 为以下现有 AdsManager 方法添加了对全插槽 AdSense 广告的支持：
    • getCurrentTime()
    • getRemainingTime()
    • getDuration()
    • getAdSkippableState()
    • skip()
3.170.0 2017-06-01
  • 添加了 AdsRequest.vastLoadTimeout。
  • 在使用 ImaSdkSettings.setDisableCustomPlaybackForIOS10Plus(true) 时，增加了对 iPhone 和 iPod touch 上可跳过式广告的支持。
3.169.1 2017-05-19
  • 添加了对 VPAID AdInteraction 事件的支持。触发后，视频播放器会收到新的 AdEvent.INTERACTION 事件。
3.168.0 2017-05-08
  • 将默认媒体加载超时时间从 15 秒更改为 8 秒。
  • 修复了设置 ImaSdkSettings.setDisableCustomPlaybackForIOS10Plus() 无效的问题。
3.166.0 2017-04-12
  • 添加了 ImaSdkSettings.setDisableCustomPlaybackForIOS10Plus()。现在，iOS Safari 上的自定义播放功能已默认重新启用（该功能在 3.164.0 中被停用）。广告在 Safari 中的呈现方式将与 3.164.0 之前的版本相同。
3.164.0 2017-03-29
  • 修复了 iOS 和 Android 设备上移动网站的自动播放支持。如需启用此功能，请在拨打 AdsManager.start() 之前将视频播放器或通话静音 AdsManager.setVolume(0)。
3.161.4 2017-03-24
  • 添加了 AdsManager.updateAdsRenderingSettings()，用于在调用 getAdsManager() 后更新广告呈现设置。
回滚到 3.161.1 2017-03-24
  • 回滚到 3.161.1。
3.163.0 2017-03-23
  • 添加了 AdsManager.updateAdsRenderingSettings()，用于在调用 getAdsManager() 后更新广告呈现设置。
3.160.3 2017-03-07
  • 修复了混合 pod 报告的广告位置不正确的问题。
3.159.0 2017-02-21
  • 添加了对素材资源级后备广告的支持。
3.156.0 2017-01-26
  • 修复了混合 VPAID 广告连播中广告位置报告不正确的问题。
  • 添加了 ImaSdkSettings.(set|get)DisableFlashAds()。
  • 添加“application/dash+xml”作为有效的 MIME 类型。
  • 向 Ad 添加了以下方法：
    • getUniversalAdIdValue()
    • getUniversalAdIdRegistry()
  • 向 AdsRequest 添加以下属性：
    • contentDuration
    • contentKeywords
    • contentTitle
3.154.1 2017-01-10
  • Ad.getWrapperCreativeIds() 现在可以通过封装容器更可靠地匹配广告素材。
3.153.1 2016-12-07
  • 添加了 Ad.getDealId()。
  • 添加了 Ad.getSurveyUrl()。
  • 添加了 Ad.getWrapperCreativeIds()。
  • 在 ENABLED 模式下，为 Flash 和 HTML5 VPAID 广告添加了图标支持。图标在不安全模式下无法正常使用。
3.151.1 2016 年 11 月 10 日
  • 添加了 Ad.getAdvertiserName()。
  • 修复了 HTML5 中 Flash VPAID 的问题。
3.147.1 2016-10-14
  • 添加了 Ad.getCreativeId()。
3.146.2 2016-10-10
  • 修复了特定 Flash VPAID 广告过早终止的 bug。
  • 修复了 Flash VPAID 广告在全屏模式下被裁剪的问题。
3.145.0 2016-09-22
  • 添加了 Ad.getApiFramework()。
3.144.0 2016-09-13
  • 添加了 AdError.ErrorCode.VAST_PROBLEM_DISPLAYING_MEDIA_FILE。
3.140.1 2016-08-18
  • 修复了不安全的 Flash VPAID 广告的点击后到达网址问题。
3.139.0 2016-08-10
  • 移除了 AdsRenderingSettings.AUTO_SCALE。
3.137.0 2016-07-26
  • 添加 Ad.getVastMediaWidth() 和 Ad.getVastMediaHeight()。
  • 修复了内置广告界面中的光标样式。
3.135.1 2016-06-29
  • 添加了对通过 AdsRenderingSettings.enablePreloading 预加载媒体资源的支持。
3.134.0 2016-06-16
  • 修复了以下问题：如果点击了倒计时器，跳过广告按钮有时会消失。
3.133.0 2016-06-07
  • 修复了 Android 4.4.4 上跳过按钮的视觉故障。其他平台上的跳过按钮不受此故障的影响，也不会受此更改的影响。
3.128.2 2016-05-03
  • 添加了 AdsRenderingSettings.playAdsAfterTime。
3.123.0 2016-02-24
  • 向 VMAP/广告规则添加了 VPAID Flash 广告素材支持。
3.120.0 2016-01-27
  • 向 AdsManager.init 添加了 videoElement 参数。如果 AdDisplayContainer 构造函数被调用时自定义视频元素尚未准备就绪，则可以使用此属性指定要使用的自定义视频元素。AdDisplayContainer 构造函数仍然是提供自定义视频元素的首选方式。
  • 添加了 AdsRenderingSettings.useStyledLinearAds。
3.118.0 2016-01-13
  • IMA HTML5 现在支持 VPAID Flash 广告素材。
3.116.4 2015-12-10
  • 不使用自定义点击跟踪的移动广告现在将采用包含“了解详情”按钮的新界面。现在，点击广告将暂停或恢复广告，而不是将用户引导至广告的着陆页。
3.115.0 2015-12-03
  • 现在，高度超过 90 像素的任何非线性 AdSense 或 Ad Exchange 广告都将呈现为全尺寸广告。
  • 新的全插槽广告会占据整个内容，并包含一个倒计时器和一个跳过按钮。广告关闭后，内容会继续播放，无论是计时器结束时还是用户跳过广告时，都是如此。
  • 高度小于 90 像素的非线性 AdSense 或 Ad Exchange 广告也可以通过设置 adsRequest.forceNonLinearFullSlot=true 强制呈现为全尺寸广告。
3.113.1 2015-11-12
3.111.0 2015-10-28
  • 添加了 AdEvent.LINEAR_CHANGED.
  • 添加了 AdEvent.DURATION_CHANGE.
  • 在 1% 的符合条件的广告请求中使用新界面。
3.110.0 2015-10-21
  • 添加 Ad.getTraffickingParameters 和 Ad.getTraffickingParametersString。
3.108.1 2015-09-23
  • 为 VPAID 广告添加了随播广告支持。
3.107.1 2015-09-18
  • 已停用 Android 4.0 及更高版本上的自定义播放功能。广告仍可正常投放，但会使用 SDK 拥有的播放器，而不是用户提供的播放器。
3.101.22 2015-09-10
  • VPAID 模式现在默认为 ENABLED，而不是 DISABLED。
3.101.17 2015-08-27
  • 使 Ad.getContentType() 在 LOADED 事件（而非 STARTED 事件）之后可用。这样可以更早地访问广告数据。
3.101.10 2015-08-06
3.101.8 2015-07-25
  • 修复了以下问题：对于格式为 pubads.g.doubleclick.net/gampad/live/ads 的 Ad Manager 代码，相关性标识符值不会更新。
3.101.6 2015-07-23
3.101.4 2015-07-13
  • 在 5% 的 Android 4.0 及更高版本的设备上，自定义播放处于停用状态。在未来的版本中，此百分比将逐步增加到 100%。
3.101.2 2015-06-17
  • TrueView 广告现在会在右上角显示“了解详情”按钮。点击此“了解详情”按钮以外的广告部分将不再会将用户引导至广告客户的网站。
  • 现在，即使使用自定义点击跟踪，系统也会显示可跳过的广告的“跳过”按钮。
回滚到 3.101.1 2015-06-04
  • 由于 Android 播放存在问题，已回滚到 3.101.1。
3.102.1 2015-06-04
  • TrueView 广告现在会在右上角显示“了解详情”按钮。点击此“了解详情”按钮以外的广告部分将不再会将用户引导至广告客户的网站。
  • 现在，即使使用自定义点击跟踪，系统也会显示可跳过的广告的“跳过”按钮。
  • Android 4.0 及更高版本上的自定义播放功能将被停用。广告仍可正常投放，但会使用 SDK 拥有的播放器，而不是用户提供的播放器。
3.99.4 2015-05-12
  • 修复了 VPAID 适配器 bug，该 bug 会导致跳过按钮和广告点击后到达网页元素偶尔无法点击。
  • TrueView 广告现在将通过 AdsManager.getAdSkippableState() 正确返回可跳过状态。
3.98.0 2015 年 4 月 30 日
  • 现在允许在与视频容器不同的 DOM 或 iframe 中加载 ima3.js，只要它们同源即可。
3.97.0 2015 年 4 月 22 日
  • 修复了因协议使用不当而导致 client.js 无法加载的 bug。
  • 修复了 VPAID 适配器 bug，即如果将适配器加载到 <head> 部分，则适配器无法加载。
3.93.1 2015 年 3 月 23 日
  • 在 AdsRequest 上添加了 setAdWillAutoPlay 方法。这样一来，发布商就可以指定广告是响应用户操作而播放，还是自动播放。
3.91.0 2015 年 2 月 25 日
  • 修复了与 VPAID 相关的 bug，该 bug 会导致视频播放器向 VPAID 广告触发“play”事件，而不是预期的“playing”事件。
3.87.0 2015-02-04
  • 修复了以下 bug：未使用 IMA 界面时，客户端从 getAdSkippableState 获取的值不正确。
  • 发布版本控制将从 3.1.X 更改为 3.X.Y。
3.1.85 2015-01-28
  • 添加了 AdEvent.Type.AD_METADATA。
3.1.81 2014-11-19
  • 修复了与某些第三方广告请求相关的 Freewheel 代码问题。
3.1.80 2014-11-13
  • 向 ImaSdkSettings 添加了 getPlayerType、setPlayerType、getPlayerVersion 和 setPlayerVersion，以便合作伙伴播放器在与 SDK 集成时指定播放器类型和播放器版本。
3.1.79 2014-11-06
  • IMA HTML5 SDK 现在支持 Internet Explorer 11。如需了解详情，请参阅 公告。
回滚到 3.1.75 2014-10-17
  • 由于移动网站上的广告播放存在问题，已回滚到 3.1.75。
3.1.73 2014-10-03
  • 为所有移动设备启用自定义点击跟踪。 此版本会还原之前版本 (3.1.72) 中引入的一项变更，该变更仅针对 iPhone 和 4.0 之前的 Android 版本启用了自定义点击跟踪。 这种更有限的自定义点击跟踪功能将在日后重新添加到 SDK 中。
3.1.72 2014-10-02
  • 我们现在建议您始终将内容视频播放器作为自定义播放元素传入，因为自定义播放仅在某些环境中使用。
  • 自定义点击跟踪元素现在仅在某些环境中使用。注意：如果您在视频播放器上呈现自定义点击跟踪元素，则会破坏所呈现广告的点击后到达网页功能和跳过功能。
3.1.70 2014-09-18
  • 已将 AdsRequest 上的 reportAdAutoPlayed 更改为 setAdWillAutoPlay。
3.1.69 2014-09-18
  • 无论移动广告的时长如何，都会显示了解详情按钮。
3.1.68 2014-09-17
  • 向 AdsRequest 添加了 reportAdAutoPlayed 设置。请注意，reportAdAutoPlayed 已重命名为 setAdWillAutoPlay。请参阅 3.1.70 版版本说明。
3.1.66 2014-09-11
  • 添加了以下内容：(1) AdsRenderingSettings 中的 uiElements 设置；(2) Ad 中的 getUiElements API。
3.1.65 2014-09-04
  • 通过将跳过按钮变成真正的按钮，使屏幕阅读器用户更容易发现该按钮。
3.1.63 2014-08-22
  • 添加了对 VPAID 2 JavaScript 广告素材的支持。
  • 添加了对 VAST 3 图标的支持。
  • 为随播广告添加了以下新功能：
    • 支持 VAST CompanionAds 元素中的“required”属性。
    • 支持 VAST Companion 元素中的“adSlotID”属性。
    • 如果 VAST 中返回了多个随播广告，SDK 将选择最适合给定环境的随播广告。
  • 修复了 ImaSdkSettings.setNumRedirects 和 ImaSdkSettings.getNumRedirects 无法访问的 bug。
  • 添加了 isCustomPlaybackUsed 和 isCustomClickTrackingUsed API 方法。
3.1.62 2014-08-14
  • 更新（2014 年 9 月 11 日）：我们目前不建议发布商传入其自定义播放器。我们将在 9 月底发布一项功能，用于在自定义播放器和 SDK 拥有的播放器之间自动切换，届时我们将开始推荐此实现。
    我们现在建议发布商在创建 AdDisplayContainer 时始终传递自定义视频播放器。 敬请期待即将发布的有关修改代码的指南。
  • 发布商不再需要在 CONTENT_PAUSE_REQUESTED 和 CONTENT_RESUME_REQUESTED 事件中保存和恢复内容播放器状态。
3.1.57 2014-06-26
  • 在 AdsManager 上添加一个 IMPRESSION 事件，该事件将在记录展示时触发。
  • 向 AdsManager 添加了 VOLUME_CHANGED 和 VOLUME_MUTED 事件。
3.1.55 2014-06-11
  • 如果 GPT 控制台已启用所有官方认可的标志（'google_console'、'google_force_console 和 'googfc'，用于移动设备），则现在可以正常运行。无需设置参数值（例如 'google_console=1'）。
3.1.54 2014-06-09
  • 如果用户未指定首选最大比特率，则手机的默认值为 500 kbit，其他设备（包括桌面设备）的默认值为 1,000 kbit。
  • 移除了 ImaSdkSettings.getCompetitiveExclusion()。
  • 在 Ad 类上公开了 minSuggestedDuration API。
3.1.53 2014-05-29
  • 现在，SDK 核心将始终从 imasdk.googleapis.com 加载。
3.1.51 2014-05-12
  • 修复了以下 bug：当用户锁定设备时，已暂停的广告会自动恢复。
  • 更新了有关 VAST 超时错误的文档，并指定了超时时长。
3.1.50 2014-04-30
  • 修复了导致修改了 Array 原型（例如 motools 用户）的发布商出现错误的 bug。
  • 更改了 Ad.getContentType 功能，使其在 contentType 未知时返回空字符串，而不是 null。
  • 引入了一项 25% 的实验，用于从新网域 imasdk.googleapis.com 加载核心二进制文件。此实验只会影响专门为 CORS 启用 s0.2mdn.net 的发布商。根据我们的测试，应该没有人。
  • 在 2014 年 5 月 1 日将新网域的流量比例提高到 1%，在 2014 年 5 月 2 日提高到 25%，在 2014 年 5 月 7 日提高到 100%。
3.1.47 2014-04-11
  • 添加了新 API Ad.getTitle()、Ad.getDescription() 和 Ad.getContentType()。
  • 支持 VAST 3 CACHEBUSTER 和 ERRORCODE 宏。
3.1.46 2014-04-03
  • getCompanionAds API 现在接受 google.ima.CompanionAdSelectionSettings 作为其第三个可选参数
  • 修复了 iPad 中 Safari 的 iOS 错误，该错误会导致视频广告在网络缓慢时冻结。
3.1.45 2014-03-06
  • 添加了 AdsLoader.setAutoPlayAdBreaks API，允许发布商选择是否自动播放 VMAP 和 AdRules 广告插播时间点。
  • 添加了 adBreakReady 事件，当 autoPlayAdBreaks 设置为 false 时，如果本应播放广告插播，AdsManager 将会调度该事件。
3.1.44 2014-01-28
  • 向 google.ima.AdError.ErrorCode 添加了 VAST_MEDIA_LOAD_TIMEOUT 错误代码，用于表示媒体超时。
3.1.41 2013-12-16
  • 修复了 adsManager.skip() API，使其可与广告规则搭配使用。
3.1.38 2013-12-04
  • 向 ima3.js 公开了 google.ima.settings 及其 setLocale 方法。
3.1.35 2013-11-14
  • 如果未为自定义播放指定任何自定义点击跟踪，则点击由 SDK iframe 跟踪，而不是由自定义视频元素跟踪。
  • 启用视频广告界面作为默认界面，包括呈现“跳过”按钮。
  • 将可见字符串“Advertisment”更改为“Advertisement”。
3.1.34 2013-10-22
  • 已将 loadVideoTimeout 添加到 AdsRenderingSettings。
  • 将广告超时默认时间更改为 15 秒。如果广告在 15 秒后仍未开始播放，则会放弃该广告并触发 CONTENT_RESUME_REQUESTED。
  • 更好地支持了与 VAST 兼容的错误代码。弃用了几个未使用的错误代码，并合并了其他错误代码。错误代码 200 现在由 VAST_TRAFFICKING_ERROR 常量表示。UNKNOWN_AD_RESPONSE 现在是特定于 SDK 的，代码为 1010。
  • 在 iPhone 实现中停用了广告清理功能。
3.1.33 2013-10-10
  • 修复了在移动设备上检测某些广告点击时出现的一个 bug。
3.1.23 2013-08-22
  • AdPodInfo 的新 API：公开了广告连播时长上限、广告连播指数和广告连播时间偏移量。 如需详细了解这些新 API，请参阅 AdPodInfo 页面。
3.1.20 2013-08-07
  • Bug 修复：修复了以下问题：解析不包含广告素材的 VAST 封装容器时出现问题。
  • Bug 修复：修复了 Safari 桌面版全屏模式存在的问题。
3.1.12 2013-05-21
  • 修复了伴侣 API 实现（非 GPT）中的 bug。
3.1.10 2013-05-14
  • 如果使用 GPT（Google 发布商代码）来显示随播广告，SDK 现在将从 GPT 中检索随播广告位的尺寸，并将其附加到发送给 Google Ad Manager 的广告请求中，从而覆盖发布商提供的任何尺寸。
3.1 2012-12-18
  • 此版本带来了影响 SDK 加载方式的重大内部变更。需要进行一些小的集成更改。
3.0.15 2012-10-22
  • 现在，必须在创建 AdsLoader 时指定 AdDisplayContainer。在下一个版本中，我们将移除通过 getAdsManager 方法传递 AdDisplayContainer 的已弃用方式。如需详细了解相关变更，请参阅 AdDisplayContainer 迁移指南。
  • 对自定义播放支持进行了多项更改：
    • 将自定义播放设置移至 AdDisplayContainer 的构造函数中。在下一个版本中，我们将移除使用 AdsRenderingSettings 设置这些属性的已弃用方式。
    • 使用自定义播放视频和点击跟踪元素时，SDK 不会自动显示或隐藏这些元素。发布商必须控制自定义播放元素的显示。
    • 对于 iPhone/iPod 上的自定义播放视频，当线性广告播放完毕时，SDK 不会退出全屏模式。对于由 SDK 控制的视频广告播放，行为没有变化。
    • 在下一个版本中，当调用 init 和 resize 时，SDK 将不再调整自定义播放视频和点击跟踪元素的大小。
    实施这些更改是为了尽可能保留自定义播放元素的许多渲染属性，并允许发布商代码控制这些属性。
3.0.14 2012-09-26
  • 为非线性广告添加了自动对齐功能。
  • 现在，内容恢复会在后贴片广告结束后发送。