ملاحظات الإصدار

الإصدار تاريخ الإصدار ملاحظات
1.6.0 2026-10-22
  • تم تعديل صفحة المشاركة في أداة فحص الإعلانات عند تصدير طلب عرض الإعلان والاستجابة له لتقديم معاينات نصية وزر نسخ واقتراحات المشاركة المباشرة.
  • تم إصلاح خطأ في "الإعلانات مقابل مكافأة" و"الإعلانات البينية مقابل مكافأة" حيث كان من الممكن استدعاء الطريقة OnUserEarnedRewardListener.onUserEarnedReward() بعد الطريقة AdEventCallback.onAdDismissedFullScreenContent().
  • تم تحديث تبعية 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. تتوفّر "الإعلانات في نافذة ضمن النافذة" في إصدار تجريبي مفتوح.
  • تمت إضافة onInitializationFailed(AdError) وإيقاف onInitializationFailed(String) نهائيًا في InitializationCompleteCallback. يمكن الآن لمحوّلات التوسّط إبلاغ حزمة تطوير البرامج (SDK) بأخطاء إعداد حِزم تطوير البرامج (SDK) التابعة لجهات خارجية، وذلك من خلال رمز الخطأ ونطاق الخطأ ورسالة الخطأ.
1.3.1 2026-07-29
  • تم إصلاح الأخطاء وإجراء تحسينات على الأداء لميزة الوصول المحدود.
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 . تتوفّر هذه الميزة في إصدار تجريبي خاص. يمكنك التواصل مع مدير حسابك لطلب إذن الوصول.
  • بالنسبة إلى التطبيقات التي تطلب "إعلانات رموز" متعددة، تمت إضافة IconAd.load(IconAdRequest, int, IconAdLoadCallback)، وتم إيقاف IconAd.load(IconAdRequest, int, AdLoadCallback<IconAd>) نهائيًا. تتضمّن IconAdLoadCallback طريقة onAdLoadingCompleted() للإشارة إلى وقت انتهاء تحميل جميع الإعلانات.
  • محوّلات التوسّط:
    • تمت إضافة طريقة RequestConfiguration.getAgeRestrictedTreatment() للسماح للمحوّلات بقراءة إعدادات المعالجة الموجّهة للفئة العمرية.
    • تم تغيير untrackView() لقبول View بدلاً من View? للحفاظ على التوافق مع المحوّلات التي تم إنشاؤها وفقًا لـ Google Mobile Ads SDK (Legacy).
1.1.1 2026-05-27
  • تم إصلاح مشكلة كانت تؤدي إلى تجمّد مجموعات "الإعلانات مقابل مكافأة" المتسلسلة أثناء الانتقالات، ما يمنع المستخدمين من إغلاق الإعلان.
1.1.0 2026-05-18
1.0.1 2026-04-30
  • تم إصلاح مشكلة تعذُّر فتح الصفحات المقصودة في الإعلانات التي تستخدم window.open() أو الروابط التي تحتوي على target="_blank".
1.0.0 2026-04-14
0.25.0-beta01 2026-03-24
  • تم إصلاح مشكلة عدم عرض Ad.getResponseInfo() لبيانات وصفية معدَّلة من ResponseInfo عند إعادة تحميل إعلان بانر.
0.24.0-beta03 2026-03-07
  • تم إصلاح مشكلة تعذُّر إيقاف AdView.destroy() لمحاولات إعادة تحميل الإعلان بعد تعذُّر تحميله.
  • تمّت إضافة دوالّ إنشائية بدون وسيطات إلى NativeAdMapper وUnifiedNativeAdMapper لتحسين التوافق مع Kotlin.
  • تمت إضافة السمة packageName إلى واجهة IconAd.
  • تمت إضافة خيار لفرض استخدام حزمة تطوير البرامج (SDK) لـ Cronet بدلاً من OkHttp لعمليات الشبكة. لحلّ الأخطاء أثناء التشغيل في المشاريع التي تستخدم OkHttp 5، ننصح بفرض استخدام Cronet لعمليات الشبكة. لفرض استخدام Cronet، اضبط السمة الإضافية force_use_cronet على true في InitializationConfig.Builder عند استدعاء MobileAds.initialize(): 
    val config = InitializationConfig.Builder()
  .setExtras(bundleOf("force_use_cronet" to true))
  .build()
MobileAds.initialize(this, config)
  • تمت إضافة دعم Java 11. لاستخدام Java 11، أضِف الرمز التالي إلى مجموعة android في ملف build.gradle: 
    android {
  compileOptions {
    sourceCompatibility JavaVersion.VERSION_11
    targetCompatibility JavaVersion.VERSION_11
  }
  kotlinOptions {
    jvmTarget = '11'
  }
}
0.24.0-beta02 2026-03-03
  • تم حلّ مشكلة تحميل فئة تابعة لجهة خارجية أثّرت في إنشاء إشارات طلبات عرض الإعلانات من خادم إلى خادم.
0.24.0-beta01 2026-02-13
0.23.0-beta01 2026-01-26
  • تم تعديل الحدّ الأدنى المطلوب لإصدار "المكوّن الإضافي لنظام Gradle المتوافق مع Android" ‏ (AGP) إلى 8.3.0.
  • تم إصلاح خلل كان يؤدي إلى ظهور الخطأ java.lang.NoSuchMethodError عند استدعاء الدالة الإنشائية AdView من Kotlin.
  • تم إصلاح خلل يتعلّق بعدم استدعاء محوّلات الأحداث المخصّصة أثناء تنفيذ العرض الإعلاني بدون انقطاع.
  • تم تعديل RtbSignalData لتوفير سياق النشاط إلى RtbAdapter.collectSignals() عند توفّره.
  • تم تحديث اعتمادية androidx.webkit إلى الإصدار 1.15.0.
  • تم تعديل تبعية حزمة User Messaging Platform SDK إلى الإصدار 4.0.0.
  • تم التراجع عن إيقاف AdPreloader.getConfiguration() وAdPreloader.getConfigurations() نهائيًا.
0.22.0-beta04 2025-12-04
  • تم إصلاح مشكلة في الإصدار 0.22.0-beta02 من حزمة SDK حيث تم تضمين البيانات الوصفية للنسخة الحصرية من Java 17 بشكل غير صحيح في ملفات الفئات.
0.22.0-beta03 2025-11-25
  • تم إصلاح خلل كان يؤدي إلى عدم ضبط حجم الإعلان المطلوب بشكل صحيح عند إرسال طلبات عرض الإعلانات من خادم إلى آخر باستخدام NativeSignalRequest.Builder.setAdSize().
0.22.0-beta02 2025-11-24
  • تم حلّ خلل في تحميل "إدارة الإعلانات"، حيث تعذّر عرض طلبات عرض الإعلانات من خادم إلى خادم التي تستخدم NativeSignalRequest إذا كان ردّ الإعلان من النوع NativeAd.NativeAdType.BANNER.
0.22.0-beta01 2025-11-20
  • عدِّل واجهة برمجة التطبيقات الخاصة بـ "إعلانات البانر":
    • تمت إضافة الفئة AdView.
    • تم إيقاف BannerAd.load() وBannerAd.loadFromAdResponse() نهائيًا. لتحميل "إعلان بانر" واحد، استخدِم AdView.loadAd() وAdView.loadFromAdResponse() بدلاً من ذلك.
    • تم إيقاف BannerAd.getView() نهائيًا. لعرض BannerAd محمَّل باستخدام BannerAdPreloader، أنشئ مثيلاً من AdView واستخدِم AdView.registerBannerAd().
  • تم إصلاح خلل في الإعلانات التي تتم إدارتها من خلال التوسّط، حيث لم يتم الالتزام بـ NativeAdRequest.Builder.setAdChoicesPlacement()، ما أدى إلى وضع رمز "خيارات الإعلان" في مكان غير صحيح.
  • تم خفض الحدّ الأدنى المطلوب لإصدار المكوّن الإضافي لنظام 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 بدلاً من ذلك.
0.16.0-alpha01 2025-05-23
0.15.1-alpha01 2025-04-28
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 للإعلانات الذين ليس لديهم معرّف تطبيق في "إدارة الإعلانات"، تمت إضافة 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().
  • تمّت إضافة واجهات برمجة تطبيقات Kotlin suspend لتحميل الإعلانات وإنشاء الإشارات.
  • تمت إزالة "IconAd.LoadAdResult" واستبدالها بـ "AdLoadResult".
  • تم إصلاح مشكلة عدم بدء جلسات OMID لإعلانات الفيديو المدمجة مع المحتوى.
0.9.0-alpha01 2024-10-02
0.8.0-alpha01 2024-08-22
  • تم تعديل الاعتمادية على حزمة User Messaging Platform SDK إلى الإصدار 3.0.0.
  • الإعلانات المدمجة مع المحتوى:
    • نسخة الإصدار الرسمية لشكل الإعلان المدمج مع المحتوى
    • تمت إضافة إمكانية عرض الفيديو في مادة العرض MediaContent.
    • تمت إضافة عمليات الاستدعاء في إحدى مراحل النشاط للفيديو.
    • تمت إضافة عناصر تحكّم مخصّصة لتشغيل الفيديو.
    • تم تفعيل "القياس المفتوح" لكلّ من "الإعلانات المدمجة مع المحتوى" و"الإعلانات المدمجة مع المحتوى المخصّصة".
  • أصبح حقل signalType مطلوبًا الآن عند إنشاء SignalRequest.
0.6.0-alpha01 2024-06-20
  • تمت إضافة رمز يستخدم واجهات برمجة تطبيقات Java 8+‎ المتاحة من خلال عملية إزالة التجميل اللغوي. يجب أن تفعّل التطبيقات التي تستخدم الإصدار minSdkVersion الأقدم من الإصدار 26 ميزة إزالة التجميل اللغوي في واجهة برمجة التطبيقات Java 8+‎.
  • تمت إضافة إمكانية استخدام أشكال الإعلانات المدمجة مع المحتوى والمخصّصة المدمجة مع المحتوى التي لا تتضمّن مواد عرض فيديو.
  • تمت إضافة إمكانية استخدام الإصدار 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 للقياس المفتوح.