弃用和停用

请选择平台： Android iOS Unity Flutter

随着新的主要 Google 移动广告 SDK 版本的发布，我们可能会为早期主要版本设定弃用日期。弃用某个 SDK 版本后，来自该版本的广告流量会面临因广告投放停止而自动收到“未填充”的风险。

废弃时间表的优势

推出可预测的弃用时间安排可带来以下优势：

  • 能够用一年的时间预测 SDK 更新并相应地进行规划。
  • 可以删除仅为了支持旧版本而存在的旧版 SDK 代码，从而缩减 SDK 大小并降低出错风险。
  • 工程资源可以腾出更多精力放在对较新 SDK 的支持以及新 SDK 功能的创新上。

时刻表

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

版本 状态 发布日期 弃用日期 停用日期 迁移指南
v24.x.x 支持 2025 年 2 月 24 日 2027 年第 1 季度 2028 年第 2 季度
v23.x.x 支持 2024 年 3 月 7 日 2026 年第 1 季度 2027 年第 2 季度 迁移到 v24
v22.x.x 已弃用 2023 年 3 月 29 日 2025 年 2 月 24 日 2026 年第二季度 1 迁移到 v23
v21.x.x 已弃用 2022 年 5 月 25 日 2024 年 3 月 7 日 2025 年 6 月 30 日 迁移到 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

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

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

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

主要 SDK 版本的生命周期

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

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

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

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

异常

此弃用时间安排针对 SDK 版本提供了可预测的生命周期框架。不过，未来可能会有一些例外情况。此时间安排并不会妨碍我们提前停用某个 SDK 版本，但我们致力于在未来有任何变动时，主动进行说明并留出充足的时间。