تم تحديث تبعية com.google.android.play:hsdp إلى
الإصدار 2.2.0 لإصلاح عطل
java.lang.IllegalStateException.
تم تعديل قواعد ProGuard للمستهلكين لمنع حدوث عطل في java.lang.RuntimeException في فئة androidx.work.WorkManagerInitializer عند تفعيل الوضع الكامل لـ R8.
تم إصلاح خطأ يتعلّق بعدم تمرير سياق Activity متاح إلى حِزم تطوير البرامج (SDK) التابعة لجهات خارجية عند عرض إعلانات بملء الشاشة تتم إدارتها من خلال التوسّط.
1.5.0
2026-09-24
تمت إضافة واجهات برمجة التطبيقات لإنشاء الإشارات وعرضها لتنسيق SwipeableInterstitialAd. تتوفّر هذه الميزة في إصدار تجريبي خاص. يمكنك التواصل مع مدير حسابك لطلب إذن الوصول.
تمت إضافة واجهة برمجة تطبيقات excludedAppIds إلى طلبات عرض الإعلانات على شكل رموز، ما يتيح للناشرين استبعاد قائمة بأرقام تعريف التطبيقات من الردود على الإعلانات على شكل رموز بشكل اختياري.
1.4.0
2026-08-20
تمت إضافة إمكانية استخدام تنسيق PictureInPictureAd. تتوفّر "إعلانات نافذة ضمن النافذة" في إصدار تجريبي مفتوح.
تم إصلاح الأخطاء وإجراء تحسينات على الأداء لميزة الوصول المحدود.
1.3.0
2026-07-21
تم تغيير AdView.loadAd() لإيقاف المحاولات التلقائية مؤقتًا لطلبات عرض الإعلانات التي تعذّر إكمالها عند إيقاف إعادة التحميل التلقائية للوحدة الإعلانية.
عندما لا يؤدي طلب عرض إعلانات مدمجة مع المحتوى أو إعلانات رموز متعددة إلى عرض أي إعلانات متاحة، تعرض حزمة تطوير البرامج (SDK) الآن الخطأ NO_FILL بدلاً من INTERNAL_ERROR.
تمت إضافة طريقة Ad.getAdUnitId() لتحديد معرّف الوحدة الإعلانية المستخدَم لطلب الإعلان.
تمت إضافة طريقة InitializationConfig.Builder.disableSdkCrashReporting() التي تتيح إيقاف معالج الأعطال التلقائي يدويًا في GMA Next-Gen SDK. بشكل تلقائي، تواصل حزمة SDK تفويض معالجة الأعطال إلى معالِجات أخرى مسجَّلة (مثل Crashlytics).
عند استخدام التوسّط مع مصادر إعلانات الأحداث المخصّصة، يعرض ResponseInfo.getAdapterClassName() الآن اسم فئة الحدث المخصّص بدلاً من com.google.ads.mediation.customevent.CustomEventAdapter.
1.2.1
2026-06-15
بالنسبة إلى التطبيقات التي تستخدم WebView API للإعلانات، تم إصلاح مشكلة كانت تمنع حزمة تطوير البرامج (SDK) من تقديم إشارات إلى علامات الإعلانات المتوافقة (رمز AdSense وعلامة "ناشر Google" وIMA لـ HTML5). حدثت هذه المشكلة بسبب استدعاء طرق Webkit بشكل غير صحيح في سلسلة مهام في الخلفية.
1.2.0
2026-06-11
تم إصلاح خلل يؤدي إلى حدوث
java.lang.NullPointerException في androidx.webkit.internal.PrefetchOperationCallbackAdapter.
تمت إضافة التنسيق
SwipeableInterstitialAd. تتوفّر هذه الميزة في إصدار تجريبي خاص. يمكنك التواصل مع مدير حسابك لطلب إذن الوصول.
تمت إضافة خيار لفرض استخدام حزمة تطوير البرامج (SDK) لـ Cronet بدلاً من OkHttp لعمليات الشبكة. لحلّ الأخطاء أثناء التشغيل في المشاريع التي تستخدم OkHttp 5، ننصح بفرض استخدام Cronet لعمليات الشبكة. لفرض استخدام Cronet، اضبط السمة الإضافية force_use_cronet على true في InitializationConfig.Builder عند استدعاء MobileAds.initialize():
تم حلّ مشكلة تحميل فئة تابعة لجهة خارجية أثّرت في إنشاء إشارات طلبات عرض الإعلانات من خادم إلى خادم.
0.24.0-beta01
2026-02-13
تمت إتاحة استخدام "إعلانات البانر التكيُّفية الثابتة" الكبيرة. تم تصميم "إعلانات البانر التكيُّفية الثابتة الكبيرة" لزيادة التفاعل والإيرادات.
يمكنك طلب "إعلانات بانر تكيُّفية ثابتة" كبيرة باستخدام الطرق التالية في فئة
AdSize:
تم خفض الحدّ الأدنى المطلوب لإصدار المكوّن الإضافي لنظام Gradle المتوافق مع Android (AGP) من 8.2.0 إلى 7.3.1.
تم إيقاف AdPreloader.getConfigurations() وAdPreloader.getConfiguration(preloadId) نهائيًا. ولا يتوفّر بديل له.
0.21.0-beta01
2025-10-08
تمت إضافة طريقة InitializationConfig.Builder.disableMediationAdapterInitialization(). يجب استدعاء هذه الطريقة قبل إعداد GMA Next-Gen SDK لإيقاف إعداد محوّل التوسّط.
تم تحسين استخدام إعدادات WebView لتقليل أخطاء ANR.
تم الرجوع إلى إصدار سابق من تبعية androidx.webkit من 1.13.0 إلى
1.12.1.
تمت إزالة الإذن android.permission.RECEIVE_BOOT_COMPLETED
الذي تستخدمه حزمة androidx.work.
تم إصلاح حقل تمت تسميته بشكل خاطئ في فئة NativeAdMapper.
0.20.0-beta01
2025-09-19
تم إصلاح خلل كان يؤدي إلى عدم تشغيل بعض إعلانات الفيديو المدمجة مع المحتوى تلقائيًا.
0.19.0-beta01
2025-08-14
تم الرجوع إلى إصدارات سابقة من تبعيتَين.
androidx.work:work-runtime من الإصدار 2.10.0 إلى الإصدار 2.7.0
تم تغيير الإصدار androidx.core:core and androidx.core:core-ktx من 1.15.0 إلى 1.12.0.
تمت إعادة تسمية السمة loadedAdSourceResponse في
ResponseInfo إلى loadedAdSourceResponseInfo.
تم إصلاح خلل كان يسمح للمستخدمين بإغلاق بعض الإعلانات بملء الشاشة قبل الأوان باستخدام زر الرجوع.
يمكن الآن للناشرين الذين لديهم إذن الوصول إلى هذه الميزة استخدام رقم تعريف موضع الإعلان في جميع أشكال الإعلانات.
تمت إضافة دالة استدعاء destroy() إلى NativeAdMapper لمحوّلات التوسّط المدمجة.
0.18.0-beta01
2025-07-17
تم إصلاح خلل في التوسّط المدمج مع المحتوى كان يؤدي إلى توقّف عرض الإعلانات للمحوّلات التي تشير إلى com.google.android.gms.ads.NativeAd.MediaView.
تمت إضافة تعليق توضيحي إلى MobileAds.registerCustomTabsSession() باستخدام @JvmStatic.
تم إصلاح خلل كان يؤدي إلى توقُّف إعادة تحميل "إعلانات البانر" التي يتم تحميلها باستخدام العرض الانحداري لطلبات الشبكة في AdMob.
0.17.0-alpha02
2025-06-23
تم إصلاح خطأ في عروض أسعار التوسّط للإعلانات المدمجة مع المحتوى، حيث يتعذّر دائمًا على المحوّلات التي تنفّذ عروض الأسعار وليس العرض الإعلاني بدون انقطاع (مثل Meta Audience Network) عرض الإعلانات المدمجة مع المحتوى.
تم إصلاح تعطّل يحدث عندما يستدعي محوّل التوسّط عدة طرق MediationAdLoadCallback لطلب عرض إعلان واحد.
0.17.0-alpha01
2025-06-18
تم طرح الإصدار 0.17.0-alpha01 عن طريق الخطأ، وهو لا يتضمّن الميزات الجديدة المقصودة. يُرجى استخدام الإصدار 0.17.0-alpha02 بدلاً من ذلك.
تم تعديل تبعية حزمة User Messaging Platform SDK إلى الإصدار 3.2.0.
تم إصلاح خلل في توسّط "الإعلانات المدمجة مع المحتوى" كان يؤدي إلى حدوث أعطال في المحوّلات التي تشير إلى الفئة com.google.android.gms.ads.formats.MediaView.
التحميل المسبَق للإعلان: تمت إضافة getNumAdsAvailable() وإيقاف numAdsAvailable() نهائيًا.
بالنسبة إلى التطبيقات التي تم تطويرها باستخدام Kotlin، تم خفض الحد الأدنى المطلوب لإصدار Kotlin من 2.1 إلى 1.9.
0.15.0-alpha01
2025-04-24
الإعلانات المدمجة مع المحتوى: تمت إضافة إمكانية تحميل إعلانات مدمجة مع المحتوى متعددة.
تمت إضافة طريقة
NativeAdLoader.load(NativeAdRequest, numberOfAds, NativeAdLoaderCallback)
تطلب إعلانات متعددة في آنٍ واحد.
تمت إضافة دالة ردّ نداء NativeAdLoaderCallback.onAdLoadingCompleted() يتم تشغيلها عند اكتمال تحميل جميع "الإعلانات المدمجة مع المحتوى".
لإتاحة التحميل غير المتزامن في Kotlin، تمت إضافة طريقة NativeAdLoader.load(NativeAdRequest, numberOfAds) التي تعرض Flow<NativeAdLoadResult>.
تم تحديث اعتمادية kotlinx-coroutines-android من
الإصدار 1.7.3 إلى 1.9.0.
0.14.0-alpha01
2025-03-20
ستتعذّر طلبات عرض الإعلانات إذا تم إعداد حزمة SDK باستخدام معرّف تطبيق غير صالح.
لم تعُد طريقة AdPreloader.start() تتطلّب ردّ اتصال PreloadCallback.
تكون السمة bufferSize اختيارية عند إنشاء
عنصر من خلال فئة بيانات PreloadConfiguration. للسماح لـ Google بتحسين حجم ذاكرة التخزين المؤقت، لا تضبط السمة bufferSize.
تمت إزالة السمة maxAdsPerSession من فئة بيانات PreloadConfiguration.
تمت إضافة السمتَين shouldRequestMultipleImages وshouldReturnUrlsForImageAssets إلى الصف NativeAdOptions.
0.13.0-alpha01
2025-02-26
تمت إضافة MediationRewardedAdCallback.onUserEarnedReward()
وإيقاف
MediationRewardedAdCallback.onUserEarnedReward(RewardItem) نهائيًا.
تمت إضافة واجهات برمجة تطبيقات التحميل المُسبَق للإعلانات.
0.12.0-alpha01
2025-01-22
تم إصلاح خطأ تسبَّب في حجب بعض الطرق داخل AdRequest وAdRequest.Builder وSignalRequest وSignalRequest.Builder.
بالنسبة إلى مستخدمي WebView API للإعلانات الذين ليس لديهم رقم تعريف تطبيق في "مدير إعلانات Google"، أضفنا InitializationConfig.WEBVIEW_APIS_FOR_ADS_APPLICATION_ID الذي يمكن تمريره أثناء إعداد حزمة تطوير البرامج (SDK).
تمت إضافة إمكانية دمج "الإعلانات المدمجة مع المحتوى" و"إعلانات البانر" في طلبات الإعلانات في "إدارة إعلانات Google".
0.11.0-alpha01
2024-12-12
تم تعديل الاعتمادية على حزمة User Messaging Platform SDK إلى الإصدار 3.1.0.
تمت إضافة إمكانية استخدام إيماءات النقر المخصّصة في "الإعلانات المدمجة مع المحتوى".
تمت إضافة إمكانية احتساب عدد مرات الظهور يدويًا لإعلانات البانر في حجوزات "مدير إعلانات Google".
0.10.0-alpha01
2024-11-08
تمت إضافة دوال DSL لـ VideoOptions وRequestConfiguration من أجل تحسين التوافق مع Kotlin.
تمت إضافة إمكانية استخدام Publisher Privacy Treatment API مع RequestConfiguration.setPublisherPrivacyPersonalizationState().
تمت إضافة إمكانية استخدام أشكال الإعلانات المدمجة مع المحتوى والمخصّصة المدمجة مع المحتوى التي لا تتضمّن مواد عرض فيديو.
تمت إضافة إمكانية استخدام الإصدار 3 من MRAID.
تمت إضافة الاعتمادية على الإصدار 2.2.0 من حزمة User Messaging Platform SDK.
تم تعديل نطاق الخطأ لأخطاء Google من
com.google.android.gms.ads
إلى com.google.android.libraries.ads.mobile.sdk.
تمت إضافة طريقة MobileAds.isInitialized() للتحقّق مما إذا كان قد تم إعداد حزمة تطوير البرامج (SDK) مسبقًا.
تمت إضافة BannerAd.isCollapsible() للتحقّق مما إذا كان "إعلان البانر" الذي تم عرضه قابلاً للتصغير.
تمت إضافة MobileAds.registerCustomTabsSession() لتحسين
تحقيق الربح من الإعلانات في "علامات التبويب المخصّصة".
تمت إعادة تسمية "OnInitializationCompleteListener" إلى
"OnAdapterInitializationCompleteListener".
تمت إعادة تسمية "AdapterResponseInfo" إلى
"AdSourceResponseInfo".
تمت إعادة تسمية "AdRequest.Builder.putAdNetworkExtrasBundle()" إلى
"AdRequest.Builder.putAdSourceExtrasBundle()".
تم إصلاح خلل تعذُّر إنشاء فئات محوِّل عروض الأسعار بشكل صحيح.
0.3.0-alpha01
2024-03-20
الإصدار الأوّلي من GMA Next-Gen SDK
تتيح هذه المنصة عرض "إعلانات البانر" و"الإعلانات البينية" و"الإعلانات مقابل مكافأة" و"الإعلانات البينية مقابل مكافأة" و"الإعلانات على شاشة فتح التطبيق".
تتيح هذه المنصة التوسّط لجميع أشكال الإعلانات. تتوافق المحوّلات المكتوبة للإصدار الحالي من "SDK لإعلانات Google على الأجهزة الجوّالة" مع الإصدار GMA Next-Gen SDK.
تمت إضافة تبعية على الإصدار 1.4.10 من حزمة SDK للقياس المفتوح.
تاريخ التعديل الأخير: 2026-10-23 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2026-10-23 (حسب التوقيت العالمي المتفَّق عليه)"],[],[]]