عند إطلاق إصدار رئيسي جديد من "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 ads.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers have a year lead time to plan for SDK updates after a deprecation announcement.\u003c/p\u003e\n"],["\u003cp\u003eMigrating to newer versions helps reduce SDK size, lower bug risks, and allows Google to focus on newer features.\u003c/p\u003e\n"],["\u003cp\u003eVersions v23.x.x and v22.x.x are currently supported, while v21.x.x is deprecated and v20.x.x and earlier are sunset.\u003c/p\u003e\n"],["\u003cp\u003eSDK versions 6.x.x and below have ad serving disabled.\u003c/p\u003e\n"]]],[],null,["Select platform: [Android](/admob/android/deprecation \"View this page for the Android platform docs.\") [iOS](/admob/ios/deprecation \"View this page for the iOS platform docs.\") [Unity](/admob/unity/deprecation \"View this page for the Unity platform docs.\") [Flutter](/admob/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](/admob/android/rel-notes#24.0.0) | Supported | February 24, 2025 | Q1 2027 | Q2 2028 | |\n| [v23.x.x](/admob/android/rel-notes#23.0.0) | Supported | March 7, 2024 | Q1 2026 | Q2 2027 | [Migrate to v24](/admob/android/migration#migrate-to-v24) |\n| [v22.x.x](/admob/android/rel-notes#22.0.0) | Deprecated | March 29, 2023 | February 24, 2025 | Q2 2026[^1^](#sunset-footnote) | [Migrate to v23](/admob/android/migration#migrate-to-v23) |\n| [v21.x.x](/admob/android/rel-notes#21.0.0) | Deprecated | May 25, 2022 | March 7, 2024 | June 30, 2025 | [Migrate to v22](/admob/android/migration#migrate-to-v22) |\n| [v20.x.x](/admob/android/rel-notes#20.0.0) | Sunset | April 5, 2021 | March 29, 2023 | June 30, 2024 | [Migrate to v21](/admob/android/migration#migrate-to-v21) |\n| [v7.x.x - v19.x.x](/admob/android/rel-notes#7.0.0) | Sunset | March 19, 2015 | September 30, 2022 | June 30, 2023 | [Migrate to v20](/admob/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."]]
