弃用和停用

随着新的主要 Google 移动广告 SDK 版本的发布,我们可能会为早期主要版本设定弃用日期。弃用某个 SDK 版本后,如果广告流量来自该版本,广告流量可能会因广告投放停止而自动未填充。

弃用时间表的优势

引入可预测的弃用时间表具有以下优势:

  • 能够根据一年的准备时间预测 SDK 更新并制定计划。
  • 可以删除只是为了支持旧版本而存在的旧版 SDK 代码,从而缩减 SDK 大小并降低出现错误的风险。
  • 工程资源可以更侧重于支持较新的 SDK 和新 SDK 功能的创新。

时刻表

下表列出了每个版本的具体弃用和停用日期。我们建议您在最新版本发布后尽快进行迁移。

Versions 状态 发布日期 弃用日期 停用日期 迁移指南
v23.x.x 支持 2024 年 3 月 7 日 2026 年第 1 季度 2027 年第 2 季度
v22.x.x 支持 2023 年 3 月 29 日 2025 年第 1 季度 2026 年第 2 季度 迁移到 v23
v21.x.x 已弃用 2022 年 5 月 25 日 2024 年 3 月 7 日 2025 年第 2 季度 1 迁移到 v22
v20.x.x 已弃用 2021 年 4 月 5 日 2023 年 3 月 29 日 2024 年 6 月 30 日 迁移到 v21
v7.x.x - v19.x.x 落日余晖 2015 年 3 月 19 日 2022 年 9 月 30 日 2023 年 6 月 30 日 迁移到 v20
v11.x.x 支持 2021 年 2 月 2026 年第 1 季度 2027 年第 2 季度
v10.x.x 支持 2023 年 1 月 26 日 2025 年第 1 季度 2026 年第 2 季度 迁移到 v11
v9.x.x 已弃用 2022 年 2 月 1 日 2021 年 2 月 2025 年第 2 季度 1 迁移到 v10
v8.x.x 已弃用 2021 年 2 月 1 日 2023 年 1 月 26 日 2024 年 6 月 30 日 迁移到 v9
v7.x.x 落日余晖 2015 年 2 月 3 日 2022 年 9 月 30 日 2023 年 6 月 30 日 迁移到 v8
v8.x.x 支持 2023 年 3 月 30 日 2025 年第 1 季度 2026 年第 2 季度
v7.0.2 - 7.4.1 已弃用 2022 年 6 月 2 日 2021 年 2 月 2025 年第 2 季度 1 迁移到 v8
v6.0.0 - 7.0.1 已弃用 2021 年 5 月 17 日 2023 年 3 月 29 日 2024 年 6 月 30 日 开始使用
v3.0.0 - v5.4.0 落日余晖 2016 年 2 月 2 日 2022 年 9 月 30 日 2023 年 6 月 30 日 开始使用
v3.0.0 - 4.x.x 支持 2023 年 5 月 10 日 2025 年第 1 季度 2026 年第 2 季度
v2.0.0 - 2.4.0 已弃用 2022 年 8 月 3 日 2021 年 2 月 2025 年第 2 季度 1 开始使用
v0.13.0 - 1.3.0 已弃用 2021 年 5 月 18 日 2023 年 3 月 29 日 2024 年 6 月 30 日 开始使用
v0.0.1 - v0.12.2+1 落日余晖 2021 年 3 月 3 日 2022 年 9 月 30 日 2023 年 6 月 30 日 开始使用
v11.0.0 - 11.x.x 支持 2023 年 5 月 4 日 2025 年第 1 季度 2026 年第 2 季度
v10.4.0 - 10.7.0 已弃用 2022 年 6 月 28 日 2021 年 2 月 2025 年第 2 季度 1 开始使用
v10.0.0 - 10.3.0 落日余晖 2022 年 10 月 13 日 2022 年 10 月 13 日 2023 年 6 月 30 日 2 开始使用
v9.2.0 - 9.6.0 已弃用 2022 年 6 月 28 日 2021 年 2 月 2025 年第 2 季度 1 开始使用
v9.1.0 及更低版本 落日余晖 2022 年 6 月之前 2022 年 6 月 28 日 2023 年 6 月 30 日 开始使用

1 我们将在 Google Ads 开发者博客上公布更具体的弃用日期,届时也会相应地在此页面进行更新,并提前两个月发出通知。

受支持、已弃用和弃用的区别

术语 支持 已弃用 落日余晖
SDK 版本 主要版本为 N 和 N-1 的所有版本,其中 N 表示最新的主要版本。 主要版本为 N-2 的所有版本。 主要版本为 N-3 或更低版本的所有版本。主要版本为 N-3 的版本将在主要版本 N 发布后大约两个月内弃用。
广告投放 广告可投放到此版本。 广告可投放到此版本。 广告存在无法投放到此版本的风险。我们今后会定期审核所有弃用版本的使用情况,以考虑停止广告投放。使用率较低且维护费用较高的最旧版本将首先成为目标。广告投放停止后,广告请求会返回“未填充”,以及一个错误,指明此版本已弃用。
支持 您可以在 Google Mobile Ads SDK developer forum上咨询 SDK 技术支持问题。 仅与此版本有关的 SDK 技术支持问题已不能在 Google Mobile Ads SDK developer forum上咨询。 您将需要在受支持的版本上验证存在相应问题,才能获得全面支持。 仅与此版本有关的 SDK 技术支持问题已不能在 Google Mobile Ads SDK developer forum上咨询。 您将需要在受支持的版本上验证存在相应问题,才能获得全面支持。

主要 SDK 版本的生命周期

一般情况下,新的主要版本会在大约两年内保持受支持状态,并在一年内处于已弃用状态,之后才会进入停用状态。

Google 移动广告 SDK 的废弃和弃用时间表是围绕主要 SDK 版本制定的。我们计划在每年的第一季度发布一个主要版本。新的主要版本的发布会使对早期主要版本的支持发生变化。

当新的主要版本 N 发布后:

  • 主要版本为 N-2 的所有 SDK 版本都会立即被视为已弃用
  • 主要版本为 N-3 的所有 SDK 版本将在大约两个月后停用

异常

此弃用时间表提供了一个框架,以实现 SDK 版本的可预测生命周期。不过,未来可能会有一些例外情况。此时间表不会妨碍我们提前弃用某个 SDK 版本,但我们承诺为将来所做的任何更改提供充足的准备时间。