با انتشار نسخه اصلی جدید Google Mobile Ads SDK، ممکن است به نسخه های اصلی قبلی تاریخ غروب داده شود. پس از غروب یک نسخه SDK، ترافیک آگهی از آن نسخه به دلیل توقف ارائه آگهی در معرض خطر عدم تکمیل خودکار است.
مزایای برنامه منسوخ شدن
معرفی یک برنامه زمانبندی قابل پیش بینی استهلاک مزایای زیر را ارائه می دهد:
امکان پیش بینی و برنامه ریزی برای به روز رسانی SDK با یک سال زمان تحویل.
کد SDK قدیمی که فقط برای پشتیبانی از نسخه‌های قدیمی وجود دارد، می‌تواند حذف شود، در نتیجه اندازه SDK کاهش می‌یابد و خطر بروز باگ‌ها کاهش می‌یابد.
منابع مهندسی می توانند بیشتر بر روی پشتیبانی از SDK های جدیدتر و نوآوری ویژگی های جدید SDK تمرکز کنند.
جدول زمانی
جدول زیر تاریخ‌های منسوخ و غروب آفتاب را برای هر نسخه فهرست می‌کند. ما شما را تشویق می کنیم که در اسرع وقت پس از انتشار به جدیدترین نسخه مهاجرت کنید.
1 تاریخ غروب آفتاب مشخص تری در وبلاگ برنامه نویس Google Ads اعلام می شود و با دو ماه اخطار در این صفحه به روز می شود.
تفاوت بین پشتیبانی شده، منسوخ شده، و غروب آفتاب
مدت
پشتیبانی می شود
منسوخ شده است
غروب آفتاب
نسخه های SDK
همه نسخه‌ها با نسخه اصلی N و N-1، که N آخرین نسخه اصلی است.
همه نسخه ها با نسخه اصلی N-2.
همه نسخه‌ها با نسخه اصلی N-3 یا پایین‌تر. نسخه‌های اصلی N-3 تقریباً دو ماه پس از انتشار نسخه اصلی N غروب می‌کنند.
ارائه آگهی
تبلیغات به این نسخه ارائه می شود.
تبلیغات به این نسخه ارائه می شود.
تبلیغات در معرض خطر عدم ارائه به این نسخه. ما مرتباً استفاده از همه نسخه‌های غروب آفتاب را بررسی می‌کنیم تا در آینده غیرفعال کردن ارائه آگهی را در نظر بگیریم. قدیمی‌ترین نسخه‌های با استفاده کمتر و هزینه‌های نگهداری بالاتر ابتدا هدف قرار خواهند گرفت. وقتی ارائه آگهی غیرفعال است، درخواست‌های آگهی یک علامت بدون پر را با خطا نشان می‌دهد که این نسخه غروب است.
سوالات فنی پشتیبانی SDK مخصوص این نسخه دیگر در انجمن برنامه‌نویس Google Mobile Ads SDK پشتیبانی نمی‌شوند. برای دریافت پشتیبانی کامل، از شما خواسته می شود که مشکل را در نسخه پشتیبانی شده تأیید کنید.
سوالات فنی پشتیبانی SDK مخصوص این نسخه دیگر در انجمن برنامه‌نویس Google Mobile Ads SDK پشتیبانی نمی‌شوند. برای دریافت پشتیبانی کامل، از شما خواسته می شود که مشکل را در نسخه پشتیبانی شده تأیید کنید.
چرخه عمر یک نسخه SDK اصلی
به طور کلی، نسخه اصلی جدید برای حدود دو سال در حالت پشتیبانی شده و یک سال دیگر در حالت منسوخ قبل از رفتن به حالت غروب آفتاب زندگی می کند.
جدول زمانی منسوخ شدن و غروب آفتاب برای Google Mobile Ads SDK حول نسخه های اصلی SDK می چرخد. ما قصد داریم در سه ماهه اول هر سال یک نسخه اصلی منتشر کنیم. انتشار نسخه اصلی جدید باعث ایجاد تغییراتی در پشتیبانی از نسخه های اصلی قبلی می شود.
هنگامی که نسخه اصلی جدید N منتشر می شود:
همه نسخه‌های SDK با نسخه اصلی N-2 فوراً منسوخ شده در نظر گرفته می‌شوند.
همه نسخه‌های SDK با نسخه اصلی N-3 پس از تقریباً دو ماه غروب می‌کنند.
استثنائات
این زمانبندی حذف چارچوبی برای طول عمر قابل پیش‌بینی نسخه SDK فراهم می‌کند. با این حال، ممکن است در آینده استثناهایی وجود داشته باشد. این برنامه ما را از غروب یک نسخه SDK در تاریخ قبلی منع نمی کند، اما ما متعهد هستیم که ارتباط فعالانه ای را با زمان کافی برای هرگونه تغییر آینده ارائه دهیم.
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eGoogle Mobile Ads SDK versions are given sunset dates after which ad traffic may stop serving.\u003c/p\u003e\n"],["\u003cp\u003eA deprecation schedule allows developers to plan updates, reduce code size, and focus on newer SDKs.\u003c/p\u003e\n"],["\u003cp\u003eThe timetable outlines the status, release, deprecation, and sunset dates for each SDK version, encouraging migration to the newest version.\u003c/p\u003e\n"],["\u003cp\u003eSDK versions undergo a lifecycle of supported, deprecated, and sunset states, with newer releases triggering changes in support for older versions.\u003c/p\u003e\n"],["\u003cp\u003eWhile the schedule aims for predictability, exceptions may occur with proactive communication and lead time provided for any changes.\u003c/p\u003e\n"]]],["Google Mobile Ads SDK versions follow a deprecation schedule: new major versions trigger the deprecation and eventual sunset of older ones. Deprecated versions (N-2) receive ad serving but no support. Sunset versions (N-3 or lower) risk ad serving being disabled and receive no support. Each new major version is released in the first quarter, and stays supported for two years, then is deprecated for one, and then sunset. Migrating to the latest version upon release is highly recommended to avoid ad serving interruptions.\n"],null,["Select platform: [Android](/ad-manager/mobile-ads-sdk/android/deprecation \"View this page for the Android platform docs.\") [iOS](/ad-manager/mobile-ads-sdk/ios/deprecation \"View this page for the iOS platform docs.\") [Unity](/ad-manager/mobile-ads-sdk/unity/deprecation \"View this page for the Unity platform docs.\") [Flutter](/ad-manager/mobile-ads-sdk/flutter/deprecation \"View this page for the Flutter platform docs.\")\n\n\u003cbr /\u003e\n\nWith the release of a new major Google Mobile Ads SDK version, earlier\nmajor versions may be given a sunset date. After an SDK version is sunset,\nad traffic from that version is at risk of receiving automatic no fill due to\nstopped ad serving.\n\nBenefits of a deprecation schedule\n\n: Introducing a predictable deprecation schedule offers the following benefits:\n\n - Ability to predict and plan for SDK updates with a year of lead time.\n - Legacy SDK code that only exists to support old versions can be deleted, thereby decreasing SDK size and lowering the risk of bugs.\n - Engineering resources can focus more on support for newer SDKs and innovation of new SDK features.\n\nTimetable\n\nThe following table lists the specific deprecation and sunset dates for each\nversion. We encourage you to migrate to the newest version as soon as possible\nafter its release.\n\n| Versions | Status | Release date | Deprecation date | Sunset date | Migration guide |\n|------------------------------------------------------------------------|------------|-------------------|--------------------|--------------------------------|-------------------------------------------------------------------------------|\n| [v24.x.x](/ad-manager/mobile-ads-sdk/android/rel-notes#24.0.0) | Supported | February 24, 2025 | Q1 2027 | Q2 2028 | |\n| [v23.x.x](/ad-manager/mobile-ads-sdk/android/rel-notes#23.0.0) | Supported | March 7, 2024 | Q1 2026 | Q2 2027 | [Migrate to v24](/ad-manager/mobile-ads-sdk/android/migration#migrate-to-v24) |\n| [v22.x.x](/ad-manager/mobile-ads-sdk/android/rel-notes#22.0.0) | Deprecated | March 29, 2023 | February 24, 2025 | Q2 2026[^1^](#sunset-footnote) | [Migrate to v23](/ad-manager/mobile-ads-sdk/android/migration#migrate-to-v23) |\n| [v21.x.x](/ad-manager/mobile-ads-sdk/android/rel-notes#21.0.0) | Deprecated | May 25, 2022 | March 7, 2024 | June 30, 2025 | [Migrate to v22](/ad-manager/mobile-ads-sdk/android/migration#migrate-to-v22) |\n| [v20.x.x](/ad-manager/mobile-ads-sdk/android/rel-notes#20.0.0) | Sunset | April 5, 2021 | March 29, 2023 | June 30, 2024 | [Migrate to v21](/ad-manager/mobile-ads-sdk/android/migration#migrate-to-v21) |\n| [v7.x.x - v19.x.x](/ad-manager/mobile-ads-sdk/android/rel-notes#7.0.0) | Sunset | March 19, 2015 | September 30, 2022 | June 30, 2023 | [Migrate to v20](/ad-manager/mobile-ads-sdk/android/migration#migrate-to-v20) |\n\n^1^ A more specific sunset date will\nbe announced on the [Google Ads Developer\nblog](//ads-developers.googleblog.com/search/label/mobile_ads_sdk), and updated\non this page with two months notice.\n| **Key Point:** SDK Versions 6.x.x and below have ad serving disabled.\n\nDifferences between supported, deprecated, and sunset\n\n| Term | Supported | Deprecated | Sunset |\n|------------------|----------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **SDK Versions** | All releases with major release N and N-1, where N is the latest major version. | All releases with major release N-2. | All releases with major release N-3 or below. Releases with major version N-3 will sunset approximately two months after major version N is released. |\n| **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. |\n| **Support** | Technical SDK support questions are welcomed on the [Google Mobile Ads SDK developer forum](//groups.google.com/group/google-admob-ads-sdk). | Technical SDK support questions specific to this version are no longer supported on the [Google Mobile Ads SDK developer forum](//groups.google.com/group/google-admob-ads-sdk). 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](//groups.google.com/group/google-admob-ads-sdk). You will be asked to validate the issue in a supported version to receive full support. |\n\nLifecycle of a major SDK version\n\nIn general, a new major version will live in the **supported** state for about\ntwo years, and in a **deprecated** state for an additional year before moving\nto a **sunset** state.\n\nThe deprecation and sunset timelines for Google Mobile Ads SDK revolve\naround major SDK releases. We plan to have one major version release in the\nfirst quarter of each year. The release of a new major version triggers changes\nin support for earlier major versions.\n\nWhen a new major version N is released:\n\n- All SDK versions with major version N-2 are considered **deprecated** immediately.\n- All SDKs versions with major version N-3 will **sunset** after approximately two months.\n\nExceptions\n\nThis deprecation schedule provides a framework for predictable lifetimes for an\nSDK version. However, there may be exceptions in the future. This schedule does\nnot preclude us from sunsetting an SDK version at an earlier date, but we are\ncommitted to providing proactive communication with ample lead time for any\nfuture changes."]]
