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

الإصدار تاريخ الإصدار ملاحظات
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
  • لم يعُد من الضروري تفعيل إزالة التجميل اللغوي في Java 8+ API.
  • تم تعديل تبعية حزمة User Messaging Platform SDK إلى الإصدار 3.2.0.
  • تم إصلاح خلل في توسّط &quot;الإعلانات المدمجة مع المحتوى&quot; كان يؤدي إلى حدوث أعطال في المحوّلات التي تشير إلى الفئة com.google.android.gms.ads.formats.MediaView.
  • التحميل المسبَق للإعلان: تمت إضافة getNumAdsAvailable() وإيقاف numAdsAvailable() نهائيًا.
  • تمت إزالة علامة السمة android.adservices.AD_SERVICES_CONFIG من ملف البيان الخاص بحزمة SDK لمنع حدوث تعارضات في الدمج للتطبيقات التي تضبط خدمات الإعلانات الخاصة بواجهة برمجة التطبيقات.
0.15.1-alpha01 2025-04-28
0.15.0-alpha01 2025-04-24
  • الإعلانات المدمجة مع المحتوى: تمت إضافة إمكانية تحميل إعلانات مدمجة مع المحتوى متعددة.
    • تمت إضافة طريقة NativeAdLoader.load(NativeAdRequest, numberOfAds, NativeAdLoaderCallback) تطلب إعلانات متعددة في آنٍ واحد.
    • تمت إضافة دالة ردّ نداء NativeAdLoaderCallback.onAdLoadingCompleted() يتم تشغيلها عند اكتمال تحميل جميع &quot;الإعلانات المدمجة مع المحتوى&quot;.
    • لإتاحة التحميل غير المتزامن في 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().
  • تمّت إضافة واجهات برمجة تطبيقات 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 للقياس المفتوح.