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

الإصدار تاريخ الإصدار ملاحظات
24.4.0 2025‑06‑09
  • تمّت إضافة العديد من واجهات برمجة التطبيقات الجديدة لتحميل الإعلانات مسبقًا وإيقاف واجهات برمجة التطبيقات الحالية نهائيًا. ستبقى ميزة التحميل المُسبَق للإعلانات ميزة أولية محدودة.
24.3.0 2025‑05‑19
  • تم تعديل الاعتمادية على حزمة تطوير البرامج (SDK) لمنصة User Messaging Platform إلى الإصدار 3.2.0.
24.2.0 2025‑04‑07
  • تم إصلاح الأخطاء وإجراء تحسينات في الأداء.
24.1.0 2025‑03‑12
  • تم إصلاح الأخطاء وإجراء تحسينات في الأداء.
  • سيتم طرح play-services-ads-lite بوتيرة أقل، ولن يتم توزيعه مع هذا الإصدار. لمزيد من المعلومات، يُرجى الاطّلاع على مستندات Lite SDK.
24.0.0 ‫2025‑02‑24
  • التغييرات التي قد تؤدي إلى أعطال:
    • تمت زيادة الحد الأدنى لمستوى واجهة برمجة تطبيقات Android إلى 23.
    • تمت إزالة جميع واجهات برمجة التطبيقات ذات الصلة بشكل الإعلان بين الصفحات.
    • تمت إزالة واجهات برمجة التطبيقات المتوقفة AppOpenAd الخاصة بالاتجاه.
    • تمت إزالة الصفين SearchAdView وDynamicHeightSearchAdRequest.
  • تم تعديل الاعتمادية على حزمة تطوير البرامج (SDK) لمنصة User Messaging Platform إلى الإصدار 3.1.0.
  • تتوفّر الآن عملية التحسين عند بدء التشغيل وتحميل الإعلانات بشكل عام، وهي مفعَّلة تلقائيًا.
  • تمت إضافة MediationRewardedAdCallback.onUserEarnedReward() وإيقاف MediationRewardedAdCallback.onUserEarnedReward(RewardItem) نهائيًا. يجب تعديل وسيطاء التوسّط لاستخدام الطريقة الجديدة.
  • تمت إزالة علامة السمة android.adservices.AD_SERVICES_CONFIG من ملف البيان الخاص بحزمة SDK لمنع حدوث تعارضات في الدمج للتطبيقات التي تضبط "خدمات إعلانية" خاصة بواجهة برمجة التطبيقات.
23.6.0 2024‑12‑03
  • تم إيقاف جميع واجهات برمجة التطبيقات ذات الصلة بشكل الإعلان بين الصفحات. على سبيل المثال، AdSize.getCurrentOrientationInterscrollerAdSize().
23.5.0 ‫2024-10-29
  • تم تعديل رسائل logcat الخاصة بتعذُّر تحميل الإعلان التي تم طرحها في الإصدار 23.4.0 من مستوى الخطأ إلى مستوى المعلومات.
  • تحسين تحقيق الربح من الإعلانات المخصّصة في علامات التبويب المخصّصة من خلال واجهة برمجة التطبيقات WebView API للإعلانات
23.4.0 2024‑09‑30
23.3.0 ‫2024-08-12
  • تم تعديل الاعتمادية على حزمة تطوير البرامج (SDK) لمنصة User Messaging Platform إلى الإصدار 3.0.0.
23.2.0 ‫27-06-2024
  • تمت إضافة AdView.isCollapsible() للإشارة إلى ما إذا كان آخر بانر تم تحميله قابلاً للتصغير.
23.1.0 ‫2024-05-09
  • يجب أن يكون الحد الأدنى compileSdkVersion هو 34.
  • محوّلات عروض التوسّط للإعلانات المدمجة مع المحتوى: تم إيقاف loadNativeAd وloadRtbNativeAd() نهائيًا واستبدالهما بـ loadNativeAdMapper() وloadRtbNativeAdMapper(). يجب نقل بيانات المحوّلات إلى استخدام طرق التحميل الجديدة هذه والعناصر ذات الصلة.
23.0.0 ‫2024‑03‑07
  • التغييرات التي قد تؤدي إلى أعطال:
    • تمت زيادة الحد الأدنى لمستوى واجهة برمجة تطبيقات Android إلى 21.
    • لمواصلة جمع مقاييس سلوك المستخدِمين في AdMob، عليك ربط تطبيقك على AdMob بمنصّة Firebase ودمج حزمة تطوير البرامج (SDK) الخاصة بخدمة "إحصاءات Google لبرنامج Firebase" في تطبيقك.
    • تمت إزالة واجهة برمجة التطبيقات MobileAds.enableSameAppKey() المتوقّفة نهائيًا وتم تعديل الطريقة البديلة MobileAds.putPublisherFirstPartyIdEnabled() لعرض قيمة منطقية تحدّد ما إذا كان استمرار عنصر التحكّم ناجحًا أم لا.
    • Native Ads:
      • تمت إزالة AdLoader.forUnifiedNativeAd(). استخدِم AdLoader.forNativeAd() بدلاً من ذلك.
      • تمت إزالة AdLoader.forCustomTemplateAd(). استخدِم AdLoader.forCustomFormatAd() بدلاً من ذلك.
    • تمت إزالة AdFormat.UNKNOWN بدون استبدالها. يجب أن تمرِّر التطبيقات التي تستخدم QueryInfo.generate() شكل إعلان.
    • يمكن الآن ربط طرق AdManagerAdRequest.Builder الموروثة من العنصر الرئيسي معًا لإنشاء عنصر من مكالمة واحدة. وقد تطلّب ذلك تغييرًا في بنية الوراثة بحيث لم يعُد AdManagerAdRequest.Builder يرث من AdRequest.Builder.
  • تضيف هذه السمة MobileAds.registerCustomTabsSession() لتحسين تحقيق الربح من الإعلانات في علامات التبويب المخصّصة. اطّلِع على تحسين علامات التبويب المخصّصة لمزيد من المعلومات.
  • تم تعديل الاعتمادية على حزمة تطوير البرامج (SDK) لمنصة User Messaging Platform إلى الإصدار 2.2.0.
22.6.0 ‫2023-12-06
  • تم إيقاف MobileAds.setSameAppKeyEnabled() نهائيًا وإعادة تسمية الطريقة إلى MobileAds.putPublisherFirstPartyIdEnabled().
  • تم إيقاف AdFormat.UNKNOWN نهائيًا بدون بديل. يجب أن تمرِّر التطبيقات التي تستخدم QueryInfo.generate() شكل إعلان.
22.5.0 ‫2023-10-30
22.4.0 ‫2023-09-13
22.3.0 ‫22-08-2023
  • تمت إضافة إمكانية إنشاء أحجام متجاوبة باستخدام AdSize.FULL_WIDTH كعرض. في السابق، كان يتم التعامل مع أحجام الإعلانات التي تم إنشاؤها باستخدام AdSize.FULL_WIDTH على أنّها AdSize.SMART_BANNER.
22.2.0 ‫2023-07-05
22.1.0 2023‑05‑18
  • أداة فحص الإعلانات: تم تفعيل إمكانية إرسال طلبات الإعلانات من واجهة مستخدم "أداة فحص الإعلانات" على الأجهزة التي لا تتضمّن "خدمات Google Play".
22.0.0 ‫29-03-2023
  • التغييرات التي قد تؤدي إلى أعطال:
    • تمت إزالة NativeCustomFormatAd.getVideoController() وNativeCustomFormatAd.getVideoMediaView() واستبدالهما بـ NativeCustomFormatAd.getMediaContent().
    • تمت إزالة MobileAds.getVersionString() واستبدالها بـ MobileAds.getVersion().
    • تمت إزالة AdRequest.Builder.setAdInfo() واستبدالها بـ AdRequest.Builder.setAdString().
    • تعرض AdManager.Builder.setAdString() الآن نوع AdRequest.Builder.
    • تمت إزالة MediationRewardedVideoAdAdapter وواجهات برمجة التطبيقات المرتبطة بها واستبدالها بـ Adapter.
  • تمت إضافة AdRequest.getRequestAgent().
  • التوسّط: تم تغيير قيمة العائد لكل من Adapter.getVersionInfo() و Adapter.getSDKVersionInfo() من النوع com.google.android.gms.ads.mediation.VersionInfo إلى com.google.android.gms.ads.VersionInfo. ننصح بأن تعرض وسيطات الربط النوع الجديد لأنّ com.google.android.gms.ads.mediation.VersionInfo تم إيقافه نهائيًا.
21.5.0 2023‑01‑31
  • إعلانات فتح التطبيق: تم إيقاف AppOpenAd.load() الطُرق التي تقبل مَعلمة إدخال خاصة بالاتجاه، وتمت إضافة طُرق جديدة لا تقبل مَعلمة إدخال خاصة بالاتجاه. تحدّد الطرق الجديدة اتجاه الشاشة في وقت الطلب، ما يطابق سلوك التنسيقات الأخرى بملء الشاشة.
  • التوسّط: أضفنا إمكانية التوسّط في "الإعلانات على شاشة فتح التطبيق".
  • تمت إزالة إذن RECEIVE_BOOT_COMPLETED من التبعية androidx.work:work-runtime. إذا كنت تستخدم إصدارات Gradle أقدم من 7.2.0 وتتطلّب الحصول على إذن لتطبيقك، قد تحتاج إلى تضمين الإذن صراحةً في ملف البيان الخاص بنظام Android.
21.4.0 2022‑12‑14
  • يجب الآن تقديم معرّف تطبيق "مدير إعلانات Google" لجميع تطبيقات "مدير إعلانات Google"، ويجب أن يكون بالتنسيق ca-app-pub-################~##########. راجِع مقالة ضبط تطبيقك للحصول على مزيد من التفاصيل.
  • أداة فحص الإعلانات: توسيع نطاق توافق حزمة SDK ليشمل عرض إعلانات البانر والإعلانات المدمجة مع المحتوى التي يتم طلبها من خلال واجهة مستخدم "أداة فحص الإعلانات"
  • أضفنا ميزة "معرّف الطرف الأول للناشر" (المعروفة سابقًا باسم مفتاح التطبيق نفسه) لمساعدتك في عرض إعلانات أكثر ملاءمةً وتخصيصًا باستخدام البيانات التي يتم جمعها من تطبيقاتك.
  • إصدار رسمي لإنشاء QueryInfo
21.3.0 2022‑10‑10
  • أداة فحص الإعلانات: تمت إضافة إمكانية استخدام حِزمة SDK لطلب الإعلانات وعرضها من خلال واجهة مستخدم "أداة فحص الإعلانات".
  • الإعلانات المدمجة مع المحتوى:
  • الإعلانات المدمجة مع المحتوى المخصّصة:
21.2.0 ‫2022-09-06
  • أداة فحص الإعلانات: تمت إضافة إمكانية تصدير سجلّات طلبات الإعلانات من خلال ميزة "المشاركة على Android".
21.1.0 2022‑07‑14
  • تمت إضافة إمكانية تحقيق الربح من الإعلانات ضمن WebView. لمزيد من التفاصيل، يمكنك الاطّلاع على دمج WebView API للإعلانات.
  • تمت إضافة getResponseExtras() إلى ResponseInfo التي قد تعرض معلومات إضافية عن استجابة الإعلان.
21.0.0 ‫2022-05-25
  • التغييرات التي قد تؤدي إلى أعطال:
    • تتطلّب حزمة تطوير البرامج "SDK لإعلانات Google على الأجهزة الجوّالة" الآن أن تعمل جميع التطبيقات على الحد الأدنى من مستوى واجهة برمجة التطبيقات 19 على Android.
    • تمت إضافة تعليقات توضيحية @NonNull إلى كل طريقة لم تحدّد سابقًا إمكانية القيم الخالية بشكل صريح.
    • تمت إزالة الطريقة AdRequest.Builder.addNetworkExtras(). استخدِم AdRequest.Builder.addNetworkExtrasBundle() بدلاً من ذلك.
    • تمت إزالة طرق تحديد الموقع الجغرافي التالية:
      • ‫setLocation() على AdRequest.Builder
      • getLocation() على AdRequest
      • ‫getLocation() على MediationAdConfiguration
  • تمت إضافة علامات بيان لتحسين عملية التهيئة وتحميل الإعلانات. راجِع دليل تحسين عملية التهيئة وتحميل الإعلانات لمزيد من التفاصيل.
  • تم إيقاف MobileAds.getVersionString() نهائيًا. استخدِم MobileAds.getVersion() بدلاً من ذلك.
  • تمت إضافة الطريقة getLoadedAdapterResponseInfo() في ResponseInfo.
  • تمت إضافة الطرق التالية في AdapterResponseInfo:
    • getAdSourceName()
    • getAdSourceId()
    • getAdSourceInstanceName()
    • getAdSourceInstanceId()
  • تمّت إضافة إمكانية استخدام الأحداث المخصّصة في "أداة فحص الإعلانات".
20.6.0 2022‑02‑22
20.5.0 2021‑11‑18
  • تمت إضافة إمكانية استخدام التطبيقات التي تستهدف المستوى 31 من واجهة برمجة التطبيقات على أجهزة Android 12.
  • تمت إضافة إمكانية استخدام معرِّف مجموعة التطبيقات لحالات الاستخدام، مثل إعداد التقارير ومنع الاحتيال.
20.4.0 ‫22-09-2021
  • بدءًا من الإصدار 20.4.0، تتضمّن حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" الإذن com.google.android.gms.permission.AD_ID في بيان حزمة SDK الذي يتم دمجه تلقائيًا في بيان التطبيق من خلال أدوات إصدار Android. لمزيد من المعلومات عن بيان الإذن AD_ID، بما في ذلك كيفية إيقافه، يمكنك الرجوع إلى مقالة مركز مساعدة Play Console.
  • تمت إضافة onAdClicked() إلى FullScreenContentCallback.
  • تم تفعيل onAdClicked() في الفئة AdListener لشكل الإعلان المدمج مع المحتوى.
20.3.0 ‫23-08-2021
  • تم إيقاف استخدام الطريقة AdRequest.Builder.addNetworkExtras() . استخدِم AdRequest.Builder.addNetworkExtrasBundle() بدلاً من ذلك.
  • الإعلانات المدمجة مع المحتوى: AdLoader.Builder.forCustomFormatAd() تقبل الآن قيمة قابلة للتصغير OnCustomClickListener.
  • برامج التكيّف مع التوسّط: تم إصلاح تعليق توضيحي بشأن إمكانية القيم الفارغة للمعلمة mediationExtras في جميع طلبات التحميل الخاصة ببرامج التكيّف مع التوسّط.
20.2.0 2021‑06‑08
  • تمّت إضافة ميزة "فاحص الإعلانات" (إصدار تجريبي) للناشرين على "مدير إعلانات Google".
20.1.0 ‫2021‑04‑29
20.0.0 2021‑04‑05
  • التغييرات التي قد تؤدي إلى أعطال:
    • تمت إزالة واجهة برمجة التطبيقات القديمة Interstitial.
    • تمت إزالة واجهة برمجة التطبيقات القديمة RewardedVideoAd.
    • تمت إزالة الفئات التي تبدأ بالبادئة Publisher (مثلاً: PublisherAdView).
    • تمت إزالة CustomRenderedAd.
    • تمت إزالة InstreamAd.
    • تمت إزالة SearchAdRequest.
    • تمت إزالة AdListener.onAdLeftApplication().
    • تمت إزالة NativeAppInstallAd وNativeContentAd وUnifiedNativeAd. يتوفّر الآن شكل إعلان مدمج مع المحتوى واحد باسم NativeAd.
    • RewardedAd أصبحت الآن فئة مجرّدة. استخدِم الطريقة الثابتة RewardedAd.load() لتحميل إعلان بمكافأة.
  • تمت إضافة أداة فحص الإعلانات (إصدار تجريبي).
  • تم إيقاف AdSize.SMART_BANNER نهائيًا واستبداله بإعلانات البانر التكيّفية.
  • تمت إضافة تعليقات توضيحية صريحة بشأن إمكانية القيم الفارغة إلى جميع واجهات برمجة التطبيقات العامة.
19.8.0 2021‑03‑15
  • تمت إضافة تبعية إلى حزمة تطوير البرامج (SDK) لمنصة User Messaging Platform.
  • تمت إضافة دالة الاستدعاء onAdImpression() إلى FullScreenContentCallback.
  • تم إيقاف تنسيق InstreamAd نهائيًا.
  • محوّلات التوسّط:
    • تم إيقاف MediationBannerAdapter وMediationInterstitialAdapter وMediationNativeAdapter نهائيًا. يجب أن تنفّذ المحوّلات الجديدة الفئة Adapter لتحميل هذه التنسيقات.
    • يمكن الآن لمحوّلات عروض الأسعار تنفيذ طرق تحميل مميّزة في فئة Adapter للتنسيقات الخاصة بنظام عروض الأسعار في الوقت الفعلي.
19.7.0 ‫2021-01-20
  • التغييرات الرئيسية على:
    • InterstitialAd
    • RewardedAd
    • NativeAd
    • AppOpenAd
  • تم إيقاف CustomRenderedAd نهائيًا.
  • تم إيقاف الفئات والحِزم التي تتضمّن البادئة Publisher واستبدالها بالبادئة AdManager.
  • آخر إصدار ثانوي قبل الإصدار 20.0.0 ستتم إزالة جميع واجهات برمجة التطبيقات التي تم وضع علامة عليها باعتبارها متوقفة في هذا الإصدار والإصدارات السابقة في الإصدار 20.0.0. اطّلِع على دليل نقل البيانات إلى الإصدار 20.0.0 لمزيد من التفاصيل.
19.6.0 ‫2020-12-04
  • تم إيقاف الطريقة onAdLeftApplication() AdListener نهائيًا.
  • تم إصلاح الخطأ الذي كان يطلب من مستخدمي أجهزة Android 11 اختيار متصفّح عند النقر على إعلان.
19.5.0 ‫2020-10-20
  • إعلانات البانر: يتم الآن استدعاء الطريقة onAdImpression() AdListener لإعلانات البانر.
  • تمت إضافة الطريقة setHttpTimeoutMillis() لتخصيص المهلة لمكالمات HTTPS التي تجريها حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
19.4.0 2020‑09‑10
  • تمت إضافة إمكانية استخدام التطبيقات التي تستهدف المستوى 30 لواجهة برمجة التطبيقات على أجهزة Android 11.
  • الإعلانات على شاشة فتح التطبيق: تم تغيير شكل AppOpenAd ليعمل بشكل أقرب إلى شكل ملء الشاشة بدلاً من عرض البانر. تمت إضافة الطريقتَين getResponseInfo() وshow() إلى AppOpenAd. تم إيقاف الفئتين AppOpenAdView وAppOpenAdPresentationCallback.
  • التوسّط: أصبحت ميزة إعداد التقارير عن حالة التوسّط متاحة الآن. استخدِم ResponseInfo.getAdapterResponses() للحصول على معلومات الرد لكل شبكة إعلانات شاركت في طلب إعلان.
  • الإعلانات القديمة مقابل مكافأة: تم إيقافها نهائيًا RewardedVideoAd.
  • تم إصلاح الخطأ الذي كان يؤدي إلى استدعاء معالج الإكمال مرة واحدة فقط في MobileAds.initialize(). يؤدي كل طلب إلى MobileAds.initialize() الآن إلى استدعاء دالة معاودة الاتصال الخاصة بالإكمال.
19.3.0 2020‑07‑20
  • تمت إضافة الطريقتَين getDomain() وgetCause() إلى AdError.
  • تمت إضافة دوال استدعاء جديدة متعلّقة بتعذُّر التحميل إلى جميع أشكال الإعلانات التي تعرض LoadAdError. مثال: onAdFailedToLoad(LoadAdError).
  • تم إيقاف دوال الاستدعاء المتعلّقة بتعذُّر التحميل والتي تعرض عددًا صحيحًا، مثل: onAdFailedToLoad(int).
  • الإعلانات مقابل مكافأة: تمت إضافة onRewardedAdFailedToShow(AdError) وإيقاف onRewardedAdFailedToShow(int) نهائيًا.
  • التوسّط في "الإعلانات مقابل مكافأة": تمت إضافة رمز خطأ العرض MEDIATION_SHOW_ERROR. تعرض جميع أخطاء العرض المرتبطة بالإعلانات التي يتم عرضها من خلال التوسّط الآن MEDIATION_SHOW_ERROR في AdError.getCode() وNonNull AdError.getCause() يمثّل خطأ التوسّط الأساسي.
19.2.0 2020‑06‑18
  • تمت إضافة التنسيق RewardedInterstitialAd. تتوفّر هذه الميزة حاليًا في إصدار تجريبي خاص. يُرجى التواصل مع مدير حسابك لطلب إذن الوصول.
  • الإعلانات المدمجة مع المحتوى: أضفنا واجهة مستخدم لأداة التحقّق من الإعلانات المدمجة مع المحتوى في طلبات الاختبار لمساعدتك في رصد انتهاكات سياسات الإعلانات المدمجة مع المحتوى وإصلاحها.
  • تمت إضافة طريقة MobileAds.disableMediationAdapterInitialization(). يجب استدعاء هذه الطريقة قبل إعداد حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة من أجل إيقاف عملية إعداد محوّل التوسّط.
19.1.0 2020‑04‑16
19.0.1 2020‑03‑18
  • الإعلانات المدمجة مع المحتوى: تم إصلاح مشكلة تسريب الذاكرة الثابتة التي كانت تحدث عند استخدام NativeCustomTemplateAd.
19.0.0 2020‑03‑02
  • تمت إضافة إمكانية قراءة مَعلمات الموافقة من الإصدار 2.0 من إطار الشفافية والموافقة الصادر عن مكتب IAB وسلسلة us_privacy الصادرة عن مكتب IAB.
  • تمت إضافة setNeighboringContentUrls() وgetNeighboringContentUrls() إلى AdRequest.
  • تمت إضافة الفئة ResponseInfo التي توفّر معلومات عن إعلان تم تحميله.
  • بالنسبة إلى جميع أشكال الإعلانات، تم إيقاف getMediationAdapterClassName() نهائيًا واستبداله بـ getResponseInfo().
  • الإعلانات المدمجة مع المحتوى: تمت إضافة الطريقتَين getDuration() وgetCurrentTime() إلى MediaContent.
  • التوسّط الأصلي: تمت إضافة الطريقتَين getDuration() وgetCurrentTime() إلى UnifiedNativeAdMapper لكي تنفّذها المحوّلات.
  • تم إيقاف AdRequest.Builder.addTestDevice() نهائيًا. استخدِم RequestConfiguration.Builder.setTestDeviceIds() بدلاً من ذلك.
18.3.0 2019‑11‑05
  • تمت إضافة واجهات برمجة تطبيقات لشكل الإعلان InstreamAd. تتوفّر هذه الميزة حاليًا في إصدار تجريبي خاص. يُرجى التواصل مع مدير حسابك لطلب إذن الوصول.
  • إعلان البانر التكيُّفي: تم تغيير طرق إنشاء إعلانات البانر التكيُّفية في الفئة AdSize. على سبيل المثال، تم تغيير اسم AdSize.getCurrentOrientationBannerAdSizeWithWidth() إلى AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize().
  • التوسّط: ترصد حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" الآن الاستثناءات التي تطرحها برامج التوسّط.
  • التوسّط في الإعلانات مقابل مكافأة: تم إصلاح خطأ كان يؤدي إلى عدم عرض سوى إعلان واحد مقابل مكافأة إذا تم تخزين عدة إعلانات مقابل مكافأة في ذاكرة التخزين المؤقت.
  • تمت إضافة الطريقة setTestDeviceIds() لتفعيل إعداد أجهزة الاختبار مرة واحدة لجميع طلبات الإعلانات.
18.2.0 2019‑08‑29
  • تمت إضافة واجهات برمجة تطبيقات للتنسيق AppOpenAd. تتوفّر هذه الميزة حاليًا في إصدار تجريبي خاص. يُرجى التواصل مع مدير حسابك لطلب إذن الوصول.
18.1.1 2019‑07‑23
  • التوسّط: يتم الآن بدء تشغيل المحوّلات عندما تطلب التطبيقات MobileAds.initialize(Context, OnInitializationCompleteListener).
  • التوسّط: يتم الآن رصد استثناءات المحوّل التي تتضمّن عمليات تتبُّع تسلسل استدعاء الدوال البرمجية في حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" ومعالجتها من خلال حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
18.1.0 2019‑07‑09
  • الإصدار الرسمي الذي يتيح استخدام ميزة "قياس التطبيق"
  • يتم تلقائيًا إعداد قياس التطبيق وإرسال البيانات عند بدء تشغيل التطبيق. تمت إضافة خيار تأخير قياس التطبيق إلى أن يتم استدعاء حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" بشكلٍ صريح.
  • تمّت إضافة طريقة تهيئة جديدة، MobileAds.initialize(Context, OnInitializationCompleteListener)، تُعلمك عند اكتمال عملية تهيئة "حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة" وجميع محوّلات التوسّط التي تمّت تهيئتها.
  • تمت إضافة MobileAds.getInitializationStatus() لتوفير حالة الإعداد لجميع شبكات الإعلانات التي تم ضبطها لتطبيقك.
  • تمت إضافة MobileAds.getRequestConfiguration(). يتم استخدام مَعلمات الاستهداف التي تم ضبطها في عنصر الإعداد هذا مع جميع طلبات الإعلانات.
  • الإعلانات المدمجة مع المحتوى: تمت إضافة الطريقة NativeAdOptions.Builder.setMediaAspectRatio() لطلب نسبة عرض إلى ارتفاع محدّدة لمادة عرض الوسائط الخاصة بالإعلان المدمج مع المحتوى. ويحظى هذا الخيار بالأولوية على طريقة setImageOrientation() التي تم إيقافها نهائيًا.
  • الإعلانات المدمجة مع المحتوى: بالنسبة إلى الإعلانات غير المرتبطة بالفيديو، يمكن الآن ضبط نوع مقياس الصورة في MediaView باستخدام MediaView.setImageScaleType().
  • الإعلانات المدمجة مع المحتوى: تمت إضافة UnifiedNativeAd.getMediaContent(). يمكن للناشرين الذين يحمّلون الصور فقط من خلال عناوين URL الحصول الآن على محتوى الوسائط الخاص بالإعلان، وتوفير صورة له، واستدعاء MediaView.setMediaContent() لتعبئة بيانات الصورة من خلال MediaView للإعلانات غير الفيديو.
  • التوسّط في الإعلانات المدمجة مع المحتوى: يمكن للمحوّلات الآن توفير نسبة العرض إلى الارتفاع من خلال UnifiedNativeAdMapper.setMediaContentAspectRatio().
  • تمت إضافة تبعيات على play-services-measurement وplay-services-measurement-sdk. لم تعُد التطبيقات بحاجة إلى إضافة هذه التبعيات بشكل صريح.
18.0.0 ‫2019-06-17
  • نقل البيانات من "مكتبات دعم Android" إلى مكتبات Jetpack (AndroidX) راجِع ملاحظات إصدار "خدمات Google Play" للحصول على مزيد من المعلومات.
  • لتجنُّب حدوث عُطل عند التشغيل الأول بعد تثبيت التطبيق من "متجر Play"، يتطلّب هذا الإصدار من الناشرين الإفصاح عن تبعيات إضافية في ملف build.gradle: 
    com.google.android.gms:play-services-measurement:17.0.0
com.google.android.gms:play-services-measurement-sdk:17.0.0
17.2.1 ‫21-05-2019
  • حلّ مشكلة ANR التي مصدرها android.media.AudioManager.getStreamVolume.
17.2.0 ‫2019-03-11
  • إعلانات الفيديو مقابل مكافأة: تمت إضافة مجموعة جديدة من واجهات برمجة التطبيقات الخاصة بالإعلانات مقابل مكافأة (راجِع حزمة rewarded البرمجية) التي تتيح لك تحميل إعلانات متعدّدة مقابل مكافأة في الوقت نفسه.
  • التوسّط: تمت إضافة مجموعة جديدة من واجهات برمجة التطبيقات الخاصة بمحوّل التوسّط والتي تتيح عملية الإعداد. تستخدم المحوّلات التي تنفّذ واجهة برمجة التطبيقات الجديدة الفئة Adapter.
  • الناشرون الذين يستخدمون firebase-analytics مع الإصدار 17.2.0 من أي مكتبة إعلانات (مثل com.google.android.gms:play-services-ads:17.2.0) يجب استخدام com.google.firebase:firebase-analytics:16.3.0.
17.1.3 2019‑01‑31
  • الناشرون الذين يستخدمون firebase-analytics مع الإصدار 17.1.3 من أي مكتبة إعلانات (مثل com.google.android.gms:play-services-ads:17.1.3) يجب استخدام com.google.firebase:firebase-analytics:16.3.0.
17.1.2 2018‑12‑03
  • الناشرون الذين يستخدمون firebase-analytics مع الإصدار 17.1.2 من أي مكتبة إعلانات (مثل com.google.android.gms:play-services-ads:17.1.2) يجب استخدام com.google.firebase:firebase-analytics:16.0.6.
17.1.1 ‫2018-11-12
  • تم إصلاح الخطأ الذي تسبَّب في عدم عمل بعض التركيبات من play-services-ads وfirebase-analytics (مثل أدّى التعبير (ads:17.1.0 & analytics:16.0.5) إلى حدوث خطأ duplicate entry في المحوّل البرمجي. الناشرون الذين يستخدمون firebase-analytics مع الإصدار 17.1.1 من أي مكتبة إعلانات (مثل com.google.android.gms:play-services-ads:17.1.1) يجب استخدام com.google.firebase:firebase-analytics:16.0.5.
17.1.0 ‫2018-11-02
17.0.0 2018‑10‑05
  • على الناشرين في Google AdMob تحديد علامة <meta-data> تتضمّن المفتاح com.google.android.gms.ads.APPLICATION_ID في ملف AndroidManifest.xml. راجِع دليل البدء لمزيد من التفاصيل.
  • الإعلانات المدمجة مع المحتوى: تم إيقاف NativeAppInstallAd وNativeContentAd وواجهات برمجة التطبيقات المرتبطة بهما نهائيًا، وسيتم استبدالها بـ UnifiedNativeAd. يُرجى الرجوع إلى الإعلانات المدمجة مع المحتوى المتقدّمة الموحّدة للحصول على مزيد من التعليمات حول استخدام واجهات برمجة التطبيقات الجديدة.
  • الإعلانات المدمجة مع المحتوى: أضفنا ميزة "تجاهل هذا الإعلان".
  • الإعلانات المدمجة مع المحتوى: تمت إزالة سجلّ التحذير غير الضار: "يجب ألا يكون UnconfirmedClickListener فارغًا أثناء ضبط ClickConfirmingView".
  • الإعلانات مقابل مكافآت: تمت إضافة طريقة setAdMetadataListener على RewardedVideoAd للاستماع إلى تغييرات البيانات الوصفية للإعلان.
  • الإعلانات مقابل مكافآت: سيؤدي استدعاء destroy() إلى إلغاء المستمع.
  • تم إيقاف الطريقتَين التاليتَين نهائيًا في AdRequest.Builder.
  • تم إصلاح الخطأ الذي كان يتسبّب في عدم تشغيل onRewardedVideoCompleted() على المحاكيات.
16.0.0 ‫2018-10-02
  • لم يتم إجراء أي تغييرات على الإعلانات. راجِع ملاحظات إصدار &quot;خدمات Google Play&quot; للحصول على مزيد من المعلومات.
15.0.0 2018‑04‑12
  • الإصدار التجريبي من MRAID 3
  • الإعلانات المدمجة مع المحتوى: تمت إضافة Unified Native Ad API. يؤدي ذلك إلى دمج NativeAppInstallAds وNativeContentAds في نوع جديد واحد هو UnifiedNativeAd.
  • ملاحظة: عند استخدام الإعلانات المدمجة مع المحتوى، يظهر تحذير غير ضار في السجلّات عند النقر على الإعلان المدمج مع المحتوى: UnconfirmedClickListener يجب ألا تكون قيمة فارغة أثناء ضبط ClickConfirmingView. يمكن تجاهل هذا التحذير، وستتم إزالته في الإصدار التالي.
12.0.1 2018‑03‑28
  • لم يتم إجراء أي تغييرات على الإعلانات. راجِع ملاحظات الإصدار الخاصة بخدمات Google Play لمعرفة المزيد من التفاصيل.
12.0.0 2018‑03‑20
  • فيديو مقابل مكافأة: تمت إضافة طريقة رد الاتصال onRewardedVideoCompleted() إلى RewardedVideoAdListener.
  • التوسّط باستخدام الإعلانات المدمجة: تمت إضافة الطريقة trackViews() إلى NativeAdMapper، ما يمنح برامج التكيّف إذن الوصول إلى عناصر View التي تتوافق مع مواد عرض الإعلانات المدمجة الفردية. تم إيقاف trackView() نهائيًا واستبداله بـ trackViews().
11.8.0 2017‑12‑18
  • إصلاح الأخطاء وإجراء تحسينات عامة
11.6.0 2017‑11‑07
  • تمت إضافة الفئة NativeAdViewHolder والطرق ذات الصلة في NativeAppInstallAd وNativeContentAd.
  • تم إيقاف AdLoader.getMediationAdapterClassName نهائيًا (على الناشرين استخدام الطرق التي تحمل الاسم نفسه في NativeAppInstallAd وNativeContentAd بدلاً من ذلك).
  • تعرض الإعلانات الاختبارية الآن تصنيفًا في أعلى الإعلان. اطّلِع على دليل الاختبار لمزيد من التفاصيل.
11.4.0 2017‑09‑19
  • تمت إضافة طرق getMediationAdapterClassName() إلى الفئتين NativeAppInstallAd وNativeContentAd. سيتم إيقاف الطريقة التي تحمل الاسم نفسه في AdLoader نهائيًا.
  • تمت إضافة طريقة onVideoEnd() إلى الفئة MediationNativeListener، وطرق hasVideoContent() وsetHasVideoContent() وsetMediaView() إلى الفئة NativeAdMapper، وطريقتَي getAdVolume() وisAdMuted() إلى الفئة NativeMediationAdRequest لتفعيل التوسّط في عرض الإعلانات على الفيديوهات الأصلية.
  • تمت إزالة الصف SearchAdRequest.
11.2.2 2017‑09‑05
  • تمت إضافة طريقة loadAd() جديدة تقبل كائن PublisherAdRequest إلى الفئة RewardedVideoAd.
11.2.0 2017‑08‑14
  • تمت إضافة طريقة loadAds() إلى الفئة AdLoader، ما يتيح للتطبيقات تحميل إعلانات فريدة متعددة في طلب واحد.
  • عند ترقية تطبيقك إلى الإصدار 11.2.0 أو إصدار أحدث من حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة، يجب أيضًا تعديل build.gradle في تطبيقك لتحديد compileSdkVersion بقيمة 26 (Android O) على الأقل. لن يؤدي ذلك إلى تغيير طريقة تشغيل تطبيقك. لن يُطلب منك تحديث targetSdkVersion.
  • بدءًا من الإصدار 11.2.0، أصبحت حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" متاحة من خلال مستودع Maven من Google. لمزيد من المعلومات، يُرجى الاطّلاع على ملاحظات إصدار "خدمات Google Play".
11.0.0 2017‑06‑07
  • تمت إضافة الطريقتَين onAdClicked() وonAdImpression() إلى الفئة AdListener. لا يتم استدعاء هذه الطرق إلا لعمليات تثبيت التطبيقات الأصلية والإعلانات الأصلية على المحتوى.
  • تمت إزالة الطريقتَين getInAppPurchaseListener() وsetInAppPurchaseListener() من الفئات AdView وInterstitialAd وNativeExpressAdView. تمت أيضًا إزالة فئات عمليات الشراء داخل التطبيق ذات الصلة.
  • تمت إضافة الطرق OnVideoMute() وOnVideoPause() وOnVideoPlay() وOnVideoStart() إلى الفئة VideoController.VideoLifecycleCallbacks.
  • تمت إضافة إمكانية تفعيل الوضع الغامر في الإعلانات بملء الشاشة من خلال إضافة الطريقة setImmersiveMode() إلى الفئتين PublisherInterstitialAd وRewardedVideoAd.
  • تمت إضافة الواجهة OnPublisherAdViewLoadedListener والفئة PublisherAdViewOptions والفئة PublisherAdViewOptions.Builder لاستخدامها مع AdLoader لطلبات الإعلانات المدمجة مع الإعلانات الصورية.
  • تمت إضافة واجهة OnImmersiveModeUpdatedListener الاختيارية التي يمكن أن تنفّذها محوّلات التوسّط ليتم إعلامها بآخر الأخبار حول الوضع الغامر.
  • تمت إضافة الطريقة getMediationAdapterClassName() إلى الفئة RewardedVideoAd.
  • تمت إضافة قواعد keep للحفاظ تلقائيًا على أسماء فئات وسيط التوسّط عند استخدام ProGuard.
10.2.0 2017‑2‑15
  • الإصدار 10.2.x من "خدمات Google Play" هو الإصدار الأول الذي لم يعُد يتضمّن توافقًا كاملاً مع الإصدار 2.3.x من Android (Gingerbread). تتطلّب التطبيقات التي تم تطويرها باستخدام الإصدار 10.2.x والإصدارات الأحدث من حزمة تطوير البرامج (SDK) مستوى واجهة برمجة تطبيقات Android لا يقل عن 14، ولا يمكن تثبيتها على الأجهزة التي تعمل بمستوى واجهة برمجة تطبيقات أقل من 14. لمزيد من المعلومات حول الخيارات المتاحة، بما في ذلك إنشاء حِزم APK متعددة لتوسيع نطاق توافق تطبيقك مع نظام التشغيل Android Gingerbread، يُرجى الاطّلاع على مدونة &quot;مطوّرو تطبيقات Android&quot;.
  • تمت إضافة إمكانية استخدام مواد عرض الفيديو في "الإعلانات المدمجة المتقدّمة" و"الإعلانات المستندة إلى نماذج مخصّصة".
  • تمت إضافة الطرق getVideoController() وsetVideoOptions() وgetVideoOptions() إلى الفئة PublisherAdView.
  • تمت إضافة الصف AdChoicesView.
  • تمت إضافة الطريقتَين getAdChoicesContent() وsetAdChoicesContent() إلى الفئة NativeAdMapper.
  • تمت إضافة واجهة InitializableMediationRewardedVideoAdAdapter لمحوّلات التوسّط الخاصة بـ "الفيديوهات مقابل مكافأة" التي تريد تفعيل الإعداد الأوّلي قبل إرسال طلب إعلان.
  • تمت إضافة إمكانية معاينة الإعلانات داخل التطبيق وتحديد المشاكل وحلّها في &quot;مدير إعلانات Google&quot;.
10.0.1 2016‑11‑21
  • إصلاح الأخطاء وإجراء تحسينات عامة
9.8.0 2016‑10‑24
  • تمت إعادة تفعيل MobileAds.Initialize(Context). على الناشرين في &quot;مدير إعلانات Google&quot; استدعاء هذه الطريقة عند بدء تشغيل تطبيقاتهم. على ناشري AdMob مواصلة استخدام MobileAds.Initialize(Context, String) وتمرير رمز التطبيق.
9.6.0 2016‑09‑22
  • تمت إضافة الفئة MediaView إلى "إعلانات الفيديو المتقدّمة" في "الإعلانات المدمجة مع المحتوى".
  • تمت إضافة طريقة openDebugMenu() إلى الفئة MobileAds لمعاينة تصميم الإعلان وتحديد المشاكل وحلّها في الوحدات الإعلانية على "مدير إعلانات Google".
  • تمّت إضافة إمكانية استخدام أحداث مخصّصة لفيديوهات مقابل مكافأة.
9.4.0 2016‑08‑01
  • إصلاح الأخطاء وإجراء تحسينات عامة
9.2.0 2016‑06‑27
  • تمت إضافة طريقة setAdChoicesPlacement() إلى فئة NativeAdOptions.Builder التي يمكن لناشري التطبيقات استخدامها الآن لتحديد موقع AdChoices في الإعلانات الم native.
  • تم تحسين تشغيل إعلانات الفيديو من خلال إصلاح العديد من الأخطاء.
9.0.1 2016‑05‑26
  • يحلّ هذا الإصدار مشكلة في ProGuard تم طرحها في الإصدار 9.0.0. لم يعُد الناشرون بحاجة إلى خيار keep من أجل com.google.android.gms.common.util.DynamiteApi.
9.0.0 2016‑05‑18
  • تمت إضافة ميزة التعبئة التلقائية لمعلومات الموقع الجغرافي للتطبيقات التي تمنح إذن الوصول إلى الموقع الجغرافي بشكل صريح.
  • تمّت إضافة إمكانية استخدام أحداث مخصّصة للتوسّط في "الفيديوهات مقابل مكافأة".
  • تمت إضافة خيارات الفيديو إلى "الإعلانات المدمجة السريعة".
  • تم تعديل واجهة برمجة التطبيقات لـ "إعلانات البحث المخصّص".
  • تمّت إضافة طريقة setAppMuted().
  • لم يعُد استخدام الطريقة MobileAds.initialize(android.content.Context, java.lang.String) متوقفًا نهائيًا.
  • تم إيقاف استخدام الطريقة MobileAds.initialize(android.content.Context) نهائيًا.
  • تمت إضافة الطريقة MediationNativeListener.onAdImpression() لإعداد تقارير عن مرّات الظهور في محوّلات التوسّط.
  • في هذا الإصدار فقط، على التطبيقات التي تستخدم ProGuard لمعالجة تطبيقاتها بعد اكتمالها إضافة الخيار keep التالي إلى ملف إعداد ProGuard:

    -keep public @com.google.android.gms.common.util.DynamiteApi class * { *; }
8.4.0 2015‑12‑18
  • تمت إضافة طريقة عامة، MobileAds.setAppVolume()، لإبلاغ حزمة تطوير البرامج (SDK) لإعلانات الأجهزة الجوّالة بمستوى الصوت الحالي في التطبيق.
  • تم إصلاح الأخطاء وإجراء تحسينات.
8.3.0 2015‑11‑6
  • تمت إضافة إمكانية عرض إعلانات الفيديو مقابل مكافأة.
  • تمت إضافة طريقة isLoading() إلى PublisherAdView وPublisherInterstitialAd للتحقّق مما إذا كان طلب الإعلان قيد التنفيذ.
  • تمت إضافة طريقة الدفع setIsDesignedForFamilies() إلى AdRequest.Builder وPublisherAdRequest.Builder.
  • تمت إضافة طريقة destroy() إلى NativeAdView.
8.1.0 2015‑09‑24 إصلاحات أخطاء متنوّعة.
7.8.0 2015‑08‑13
  • إصدار MRAID v2 الرسمي
  • تمت إضافة طريقة isLoading() إلى AdLoader وAdView وInterstitialAd للتحقّق مما إذا كان طلب الإعلان قيد التنفيذ.
  • تم إيقاف PublisherAdRequest.Builder#setManualImpressionsEnabled() نهائيًا. يمكنك استخدام PublisherAdView#setManualImpressionsEnabled() كبديل.
7.5.0 2015‑05‑28
  • تمّت إضافة إمكانية استخدام أشكال الإعلانات المُدمَجة مع المحتوى وإعلانات تثبيت التطبيقات على كلّ من AdMob و"مدير إعلانات Google".
  • تمّت إضافة إمكانية استخدام أشكال "الإعلانات المدمجة مع المحتوى" المخصّصة، وهي متاحة للحجوزات في "مدير إعلانات Google".
7.3.0 2015‑04‑28 إصلاحات أخطاء متنوّعة.
7.0.0 2015‑03‑19
  • تمت إضافة الطريقتَين addCustomTargeting() وaddCategoryExclusion() إلى PublisherAdRequest.Builder.
  • تم إصلاح مشكلة كانت تؤدي إلى تسجيل مرات ظهور متعدّدة في PublisherAdView.recordManualImpression() عند استخدام ميزة احتساب مرات الظهور يدويًا.
  • تم إصلاح مشكلة كانت تتسبب في عرض الإعلانات بشكلٍ غير صحيح عند استخدام السمة android:largestWidthLimitDp على العلامة <supports-screens>.
  • تمت إضافة طريقة setRequestAgent() إلى AdRequest.Builder وPublisherAdRequest.Builder. يجب استخدام هذه الطريقة للإشارة إلى مصادر طلبات الإعلانات من الجهات الخارجية التي تتوسط حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
6.5.87 2014‑12‑08
  • تم تقديم بنية JAR المقسّمة، ما يتيح لمطوّري &quot;استوديو Android&quot; تضمين جزء الإعلانات فقط من &quot;خدمات Google Play&quot; من خلال الاعتماد على com.google.android.gms:play‑services‑ads:6.+.
    ملاحظة: يجب أن تستمر التطبيقات التي تنشئ إعلانات بانر بتنسيق XML في الإشارة إلى المكتبة بأكملها com.google.android.gms:play‑services:6.+.
  • إصلاحات أخطاء متنوّعة.
6.1 2014‑10‑08
  • تمت إضافة طريقة getLocation() إلى com.google.android.gms.ads.MediationAdRequest.
  • تمت إضافة وصف للمحتوى إلى زر إغلاق الإعلان البيني لتسهيل الاستخدام.
  • تمت إزالة تسجيل الخطأ "لم يتم العثور على موارد Google Play" عند ربط مشروع المكتبة بشكل صحيح.
  • تمت إضافة getMediationAdapterClassName() إلى AdView للحصول على اسم فئة وسيط شبكة الإعلانات الذي يعرض إعلانًا حاليًا.
5.0 2014‑06‑25
  • تمّت إضافة واجهات برمجة تطبيقات جديدة لتنفيذ الأحداث المخصّصة.
  • تمت إضافة مسار شراء تلقائي لعمليات الشراء داخل التطبيق باستخدام واجهة برمجة التطبيقات الخاصة بخدمة "الفوترة في Google Play".
4.4 2014‑05‑07
  • تمّت إضافة واجهات برمجة تطبيقات جديدة خاصة ببرنامج التوسّط.
  • تمت إضافة تنسيق إعلان جديد بحجم 320x100 LARGE_BANNER لكل من الهواتف والأجهزة اللوحية.
  • تمت إضافة تنسيق إعلان بيني جديد لعمليات الشراء داخل التطبيق. اضبط InAppPurchaseListener على InterstitialAd للاستماع إلى أحداث الشراء داخل التطبيق.
  • إصلاح الخطأ الذي يؤدي إلى تعطُّل SecurityException بسبب قراءة gservices بدون إذن
4.3 2014‑03‑17
  • تعمل الدالة InterstitialAd الآن إذا تم تمرير سياق تطبيق إليها.
  • تمت إضافة طريقة الدفع setContentUrl() إلى PublisherAdRequest.Builder.
  • تم إصلاح الخطأ الذي يحدث عند ظهور الرسالة الخدمة غير مسجّلة.
4.2 2014‑02‑03 إصلاحات أخطاء متنوّعة.
4.1 2014‑01‑16
  • تمّت إضافة إمكانية استخدام "مدير الإعلانات" و"الإعلانات على شبكة البحث للتطبيقات على الأجهزة الجوّالة".
  • تتضمّن AdRequest.Builder الآن طريقة setLocation().
  • تم إصلاح عُطل حدث عند طلب إعلان بيني بدون تحديد AdActivity في ملف البيان.
4.0 2013‑10‑31
  • أصبحت واجهات برمجة التطبيقات الخاصة بـ "إعلانات Google على الأجهزة الجوّالة" الآن جزءًا من خدمات Google Play.
  • يتم تلقائيًا إرسال التحديثات المستقبلية لواجهات برمجة التطبيقات الخاصة بـ &quot;إعلانات Google على الأجهزة الجوّالة&quot; إلى الأجهزة من خلال &quot;خدمات Google Play&quot;.
  • لا تتوفّر بعد "إعلانات شبكة البحث على التطبيقات للأجهزة الجوّالة" و"مدير إعلانات Google".