Deprecation and sunset

  • Newer Google Mobile Ads SDK versions may lead to earlier versions being sunset, where ad traffic is at risk of receiving no fill due to stopped ad serving.

  • A predictable deprecation schedule allows for planning SDK updates, reduces SDK size and bugs, and focuses engineering resources on newer SDKs and features.

  • The sunset of a Google Mobile Ads SDK Unity plugin version follows the Android and iOS deprecation schedules, and the entire Unity plugin version can be considered sunset if either dependency is sunset.

  • Supported SDK versions serve ads and receive technical support, deprecated versions still serve ads but have limited technical support, and sunset versions are at risk of not serving ads and do not receive technical support.

Select platform: Android iOS Unity Flutter

With the release of a new major Google Mobile Ads SDK version, earlier major versions may be given a sunset date. After an SDK version is sunset, ad traffic from that version is at risk of receiving automatic no fill due to stopped ad serving.

Benefits of a deprecation schedule

Introducing a predictable deprecation schedule offers the following benefits:

  • Ability to predict and plan for SDK updates with a year of lead time.
  • Legacy SDK code that only exists to support old versions can be deleted, thereby decreasing SDK size and lowering the risk of bugs.
  • Engineering resources can focus more on support for newer SDKs and innovation of new SDK features.

Timetable

The following table lists the specific deprecation and sunset dates for each Google Mobile Ads SDK Unity plugin version.

Versions Status Release date Deprecation date Sunset date Migration guide
v10.x.x Supported March 24, 2025 Q1 2027 Q2 2028
v9.0.0 - 9.6.0 Supported March 22, 2024 Q1 2026 Q2 2027 Get started
v8.0.0 - 8.7.0 Deprecated March 30, 2023 February 24, 2025 Q2 2026 1 Get started
v7.0.2 - 7.4.1 Sunset June 2, 2022 February 6, 2024 June 30, 2025 Migrate to v8
v6.0.0 - 7.0.1 Sunset May 17, 2021 March 29, 2023 June 30, 2024 Get started
v3.0.0 - v5.4.0 Sunset February 2, 2016 September 30, 2022 June, 30 2023 Get started

1 A more specific sunset date will be announced on the Google Ads Developer blog, and updated on this page with two months notice.

Differences between supported, deprecated, and sunset

Term Supported Deprecated Sunset
SDK Versions All releases that depend on an Android and iOS Google Mobile Ads SDK version with major release N or N-1, where N is the latest respective Android or iOS major version. All releases that depend on an Android or iOS Google Mobile Ads SDK version with major release N-2. All releases that depend on an Android or iOS Google Mobile Ads SDK version with major release N-3 or below. Releases with a dependency on an N-3 major version will sunset approximately two months after the major version N dependency is released.
Ad serving Ads serve to this version. Ads serve to this version. Ads at risk of not serving to this version. We will regularly review usage of all sunset versions going forward to consider disabling ad serving. The oldest versions with lower usage and higher maintenance costs will be targeted first. When ad serving is disabled, ad requests return a no fill with an error indicating that this version is sunset.
Support Technical SDK support questions are welcomed on the Google Mobile Ads SDK developer forum. Technical SDK support questions specific to this version are no longer supported on the Google Mobile Ads SDK developer forum. You will be asked to validate the issue in a supported version to receive full support. Technical SDK support questions specific to this version are no longer supported on the Google Mobile Ads SDK developer forum. You will be asked to validate the issue in a supported version to receive full support.

Exceptions

This deprecation schedule provides a framework for predictable lifetimes for an SDK version. However, there may be exceptions in the future. This schedule does not preclude us from sunsetting an SDK version at an earlier date, but we are committed to providing proactive communication with ample lead time for any future changes.