عند إطلاق إصدار رئيسي جديد من "SDK لإعلانات Google على الأجهزة الجوّالة"، قد يتم تحديد تاريخ لإيقاف الإصدارات الرئيسية السابقة نهائيًا. بعد إيقاف إصدار حزمة SDK نهائيًا، قد لا تتم الاستجابة تلقائيًا لطلبات عرض الإعلانات الناتجة من هذا الإصدار بسبب توقّف عرض الإعلانات.
مزايا جدول الإيقاف نهائيًا
يوفّر تقديم جدول زمني متوقّع لإيقاف الميزات نهائيًا المزايا التالية:
القدرة على توقّع تحديثات حزمة SDK والتخطيط لها قبل عام من الموعد النهائي
يمكن حذف رمز حزمة تطوير البرامج (SDK) القديم الذي لا يتوفّر إلا لدعم الإصدارات القديمة، ما يؤدي إلى تقليل حجم حزمة تطوير البرامج وتقليل خطر حدوث أخطاء.
يمكن أن تركّز موارد الهندسة بشكل أكبر على توفير الدعم لحِزم SDK الأحدث وابتكار ميزات جديدة في حِزم SDK.
جدول المواعيد
يسرد الجدول التالي تواريخ الإيقاف النهائي لكل إصدار. ننصحك بنقل البيانات إلى أحدث إصدار في أقرب وقت ممكن بعد طرحه.
الاختلافات بين المنتجات المتوافقة والقديمة والتي تم إيقافها
المصطلح
معلومات معتمَدة
منهي العمل به
الغروب
إصدارات حزمة تطوير البرامج (SDK)
جميع الإصدارات التي تتضمّن الإصدار الرئيسي N والإصدار N-1، حيث يشير الحرف N إلى أحدث إصدار رئيسي.
جميع الإصدارات التي تتضمّن الإصدار الرئيسي N-2.
جميع الإصدارات التي تتضمّن الإصدار الرئيسي N-3 أو إصدارًا أقدم سيتم إيقاف الإصدارات التي يكون فيها رقم الإصدار الرئيسي أقل من 10 (N-3) بعد شهرَين تقريبًا من طرح الإصدار الرئيسي N.
عرض الإعلانات
يتم عرض الإعلانات على هذه النسخة.
يتم عرض الإعلانات على هذه النسخة.
الإعلانات التي قد لا يتم عرضها في هذا الإصدار سنراجع بانتظام استخدام جميع الإصدارات التي سيتم إيقافها نهائيًا في المستقبل للنظر في إيقاف عرض الإعلانات. سيتم استهداف الإصدارات الأقدم التي يكون استخدامها أقل وتكاليف صيانتها أعلى أولاً. عند إيقاف عرض الإعلانات، ستؤدّي طلبات الإعلانات إلى عرض رسالة خطأ تفيد بأنه لم تتم التعبئة، ما يشير إلى أنّ هذا الإصدار تم إنهاء العمل به.
مراحل نشاط إصدار رئيسي من حزمة تطوير البرامج (SDK)
بشكل عام، سيبقى الإصدار الرئيسي الجديد في حالة متوافق لمدة عامَين تقريبًا، ثم ينتقل إلى حالة متوقّف نهائيًا لمدة عام إضافي قبل أن يصبح في حالة متوقف.
تعتمد المخطّطات الزمنية للإيقاف النهائي وإنهاء العمل بحزمة "SDK لإعلانات Google على الأجهزة الجوّالة" على الإصدارات الرئيسية من حزمة SDK. نخطّط لإطلاق إصدار رئيسي واحد في الربع الأول من كل عام. يؤدي إطلاق إصدار رئيسي جديد إلى حدوث تغييرات في إمكانية استخدام الإصدارات الرئيسية السابقة.
عند إصدار إصدار رئيسي جديد N:
تُعدّ جميع إصدارات حزمة تطوير البرامج (SDK) التي تحمل الرقم N-2 متوقّفة نهائيًا
على الفور.
سيتم إيقاف جميع إصدارات حِزم SDK التي تحمل الرقم N-3 بعد شهرَين تقريبًا.
الاستثناءات
يوفر جدول الإيقاف النهائي هذا إطارًا زمنيًا لفترات الاستخدام المتوقّعة لإصدار حزمة SDK. ومع ذلك، قد تكون هناك استثناءات في المستقبل. لا يمنعنا هذا الجدول الزمني من إيقاف إصدار حزمة SDK في تاريخ سابق، ولكنّنا ملتزمون بإرسال إشعارات استباقية قبل فترة كافية من أي تغييرات مستقبلية.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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."]]
