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

الإصدار تاريخ الإصدار ملاحظات
23.5.0 ‎2024‑10‑29
  • تم تعديل رسائل logcat المتعلّقة بتعذُّر تحميل الإعلانات في الإصدار 23.4.0 من مستوى الخطأ إلى مستوى المعلومات.
  • تحسين تحقيق الربح من الإعلانات المخصّصة في علامات التبويب المخصّصة لـ WebView API للإعلانات
23.4.0 30 أيلول (سبتمبر) 2024
23.3.0 2024/8/12
  • تم تعديل اعتمادية حزمة تطوير البرامج (SDK) لمنصة User Messaging Platform إلى الإصدار 3.0.0.
23.2.0 ‎2024‑06‑27
  • تمت إضافة AdView.isCollapsible() للإشارة إلى ما إذا كان إعلان البانر الذي تم تحميله أخيرًا قابلاً للتصغير.
23.1.0 ‎2024‑05‑09
  • يجب أن يتضمّن compileSdkVersion 34 حرفًا على الأقل.
  • محوِّلات التوسّط المدمجة: تم إيقاف loadNativeAd وloadRtbNativeAd() نهائيًا واستبدالهما بloadNativeAdMapper() وloadRtbNativeAdMapper(). يجب نقل المحوّلات إلى استخدام طرق التحميل الجديدة هذه والعناصر ذات الصلة.
23.0.0 7 آذار (مارس) 2024
  • التغييرات التي قد تؤدي إلى حدوث أعطال:
    • تم رفع الحد الأدنى لمستوى واجهة برمجة تطبيقات 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 6 حزيران (يونيو) 2023
  • تم إيقاف الإصدار MobileAds.setSameAppKeyEnabled() نهائيًا وتمت إعادة تسمية الطريقة إلى MobileAds.putPublisherFirstPartyIdEnabled().
  • تم إيقاف AdFormat.UNKNOWN نهائيًا بدون توفير بديل. يجب أن تجتاز التطبيقات التي تستخدم QueryInfo.generate() شكل إعلان.
22.5.0 ‎2023‑10‑30
22.4.0 13 أيلول (سبتمبر) 2023
22.3.0 ‎2023‑08‑22
  • تمت إضافة إمكانية إنشاء أحجام قابلة للتكيّف باستخدام AdSize.FULL_WIDTH كعرض. في السابق، كان يتم التعامل مع أحجام الإعلانات التي تم إنشاؤها باستخدام AdSize.FULL_WIDTH على أنّها AdSize.SMART_BANNER.
22.2.0 5 تموز (يوليو) 2023
22.1.0 18 حزيران (يونيو) 2023
  • أداة فحص الإعلانات: تم تفعيل إمكانية إرسال طلبات الإعلان من واجهة مستخدم أداة فحص الإعلانات على الأجهزة التي لا تتضمّن "خدمات Google Play".
22.0.0 29 آذار (مارس) 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 31 تشرين الأول (أكتوبر) 2023
  • الإعلانات على شاشة فتح التطبيق: تم إيقاف طُرق 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
  • أداة فحص الإعلانات: تمت إضافة ميزة حزمة تطوير البرامج (SDK) لتصدير سجلّات طلبات الإعلانات من خلال "لوحة المشاركة" في Android.
21.1.0 2022/7/14
  • تمت إتاحة تحقيق الربح من الإعلانات في WebView. يمكنك الاطّلاع على دمج واجهة WebView API للإعلانات للحصول على مزيد من التفاصيل.
  • تمت إضافة getResponseExtras() إلى ResponseInfo ما قد يعرض معلومات إضافية حول استجابة الإعلان.
21.0.0 ‎2022‑05‑25
  • التغييرات التي قد تؤدي إلى أعطال:
    • تتطلّب "حزمة SDK لإعلانات Google على الأجهزة الجوّالة" الآن استخدام الإصدار 19 من واجهة برمجة التطبيقات (API) لنظام التشغيل 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
  • تمت إضافة إمكانية استخدام الأجهزة التي تعمل بنظام التشغيل Android 12 للتطبيقات التي تستهدف المستوى 31 من واجهة برمجة التطبيقات.
  • تمت إضافة إتاحة رقم تعريف مجموعة التطبيقات لحالات الاستخدام مثل إعداد التقارير ومنع الاحتيال.
20.4.0 2021-09-22
  • بدءًا من الإصدار 20.4.0، ستتضمّن حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إذن com.google.android.gms.permission.AD_ID في ملف بيان حزمة SDK الذي يتم دمجه تلقائيًا في بيان التطبيق من خلال أدوات الإصدار من Android. لمزيد من المعلومات عن بيان الإذن AD_ID ، بما في ذلك كيفية إيقافه، يمكنك الرجوع إلى مقالة مركز مساعدة Play Console هذه.
  • تمت إضافة onAdClicked() معاودة الاتصال إلى FullScreenContentCallback.
  • تم تفعيل callback onAdClicked() في فئة AdListener لشكل الإعلان المدمج مع المحتوى.
20.3.0 23 آب (أغسطس) 2021
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 15 آذار (مارس) 2021
  • تمت إضافة عنصر يعتمد على حزمة تطوير البرامج (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
  • تمت إضافة إمكانية استخدام الأجهزة التي تعمل بنظام Android 11 للتطبيقات التي تستهدف المستوى 30 لواجهة برمجة التطبيقات.
  • الإعلانات على شاشة فتح التطبيق: تم تغيير شكل 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() و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 2 آذار (مارس) 2020
  • تمت إضافة إمكانية قراءة مَعلمات الموافقة من الإصدار 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 29 آب (أغسطس) 2019
  • تمّت إضافة واجهات برمجة تطبيقات لتنسيق AppOpenAd. تتوفّر هذه الميزة حاليًا كإصدار تجريبي خاص. يُرجى التواصل مع مدير حسابك لطلب إذن الوصول.
18.1.1 23 تموز (يوليو) 2019
  • التوسّط: يتم الآن إعداد المحوّلات عند استدعاء التطبيقات 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 17 حزيران (يونيو) 2019
  • نقل البيانات من مكتبات Android Support إلى مكتبات Jetpack (AndroidX) يُرجى الرجوع إلى ملاحظات إصدار "خدمات Google Play" للحصول على مزيد من المعلومات.
  • لتجنُّب حدوث تعطُّل عند إطلاق التطبيق لأول مرّة بعد تثبيت التطبيق من "متجر Play"، يطلب هذا الإصدار من الناشرين الإفصاح عن تبعيات إضافية في create.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 2019/05/21
  • إصلاح خطأ 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 31/1/2019
  • الناشرون الذين يستخدمون 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
  • على ناشري AdMob Google تحديد علامة <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
  • لن يتم إجراء أي تغييرات على الإعلانات. للحصول على مزيد من المعلومات، يمكنك الرجوع إلى ملاحظات الإصدار في "خدمات Google Play".
15.0.0 2018/4/12
  • الإصدار 3 من MRAID التجريبي.
  • الإعلانات المدمجة مع المحتوى: تمت إضافة واجهة برمجة التطبيقات الموحدة للإعلانات المدمجة مع المحتوى. يؤدي هذا إلى الجمع بين 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) أو الإصدارات الأحدث المستوى 14 من واجهة برمجة تطبيقات Android على الأقل ولا يمكن تثبيتها على الأجهزة التي تعمل بمستوى واجهة برمجة تطبيقات أقل من 14. لمعرفة المزيد من المعلومات حول الخيارات المتاحة لك، بما في ذلك إنشاء عدة حِزم APK لتوسيع نطاق دعم تطبيقك لنظام Android Gingerbread، يُرجى الاطّلاع على مدوّنة مطوّري تطبيقات Android.
  • تم توفير مواد عرض الفيديو لمحتوى الإعلان المدمج مع المحتوى (المتقدم) وإعلانات النماذج المخصصة.
  • تمت إضافة الطرق getVideoController() setVideoOptions() وgetVideoOptions() إلى فئة PublisherAdView.
  • تمت إضافة الصف AdChoicesView.
  • تمت إضافة الطريقتَين getAdChoicesContent() وsetAdChoicesContent() إلى الفئة NativeAdMapper.
  • تمت إضافة واجهة InitializableMediationRewardedVideoAdAdapter لمحوِّلات التوسّط في إعلانات الفيديو التي تضم مكافآت والتي تريد تفعيل الإعداد المُسبَق قبل تقديم طلب إعلان.
  • تمت إضافة إمكانية المعاينة داخل التطبيق وتحديد المشاكل وحلّها في "مدير إعلانات Google".
10.0.1 2016-11-21
  • إصلاح الأخطاء وإجراء تحسينات عامة
9.8.0 ‎2016‑10‑24
  • تم إلغاء إيقاف MobileAds.Initialize(Context) نهائيًا. على الناشرين في "مدير إعلانات Google" استدعاء هذه الطريقة عند بدء تشغيل تطبيقاتهم. على الناشرين في AdMob مواصلة استخدام MobileAds.Initialize(Context, String) وإرسال رمز التطبيق.
9.6.0 ‎2016‑09‑22
  • تمت إضافة الفئة MediaView لإعلانات الفيديو المتقدمة مع المحتوى.
  • تمت إضافة طريقة openDebugMenu() إلى الفئة MobileAds لمعاينة المواد الإبداعية وتحديد مشاكل الوحدات الإعلانية في "مدير إعلانات Google" وحلّها.
  • تمت إضافة إمكانية استخدام الأحداث المخصّصة للفيديوهات التي تضم مكافآت.
9.4.0 ‎2016‑08‑01
  • تم إصلاح الأخطاء وإجراء تحسينات عامة.
9.2.0 27 حزيران (يونيو) 2016
  • تمت إضافة طريقة setAdChoicesPlacement() إلى فئة NativeAdOptions.Builder التي يمكن لصنّاع تطبيقات استخدامها الآن لتحديد الموقع الجغرافي لـ AdChoices في الإعلانات المدمجة.
  • تم تحسين تشغيل إعلانات الفيديو من خلال إصلاح العديد من الأخطاء.
9.0.1 ‎2016‑05‑26
  • حلّ مشكلة في ProGuard ظهرت في الإصدار 9.0.0 لم يعُد الناشرون بحاجة إلى الخيار keep في com.google.android.gms.common.util.DynamiteApi.
9.0.0 18-05-2016
  • تمت إضافة ميزة ملء معلومات الموقع الجغرافي تلقائيًا للتطبيقات التي تمنح إذن الموقع الجغرافي صراحةً.
  • تمت إضافة دعم للأحداث المخصّصة للتوسّط في إعلانات الفيديو التي تضم مكافأة.
  • تمت إضافة خيارات الفيديو لإعلانات Native Express.
  • تم تعديل واجهة برمجة التطبيقات Custom Search Ads API.
  • تمت إضافة الطريقة 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 لإعلانات Google على الأجهزة الجوّالة بمستوى الصوت الحالي للتطبيق.
  • تم تنفيذ إصلاحات للأخطاء وإجراء تحسينات.
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 الإصدار 2
  • تمت إضافة طريقة isLoading() إلى AdLoader وAdView وInterstitialAd للتحقق مما إذا كان طلب الإعلان قيد التقدم.
  • تم إيقاف PublisherAdRequest.Builder#setManualImpressionsEnabled() نهائيًا. يمكنك استخدام PublisherAdView#setManualImpressionsEnabled() كبديل.
7.5.0 28-05-2015
  • تمّت إضافة إمكانية استخدام أشكال الإعلانات المُدمَجة مع المحتوى وإعلانات تثبيت التطبيقات في كلّ من 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 المجزّأة: يمكن لمطوّري "استوديو Android" الآن تضمين جزء الإعلانات من "خدمات Google Play" فقط من خلال الاعتماد على 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 Billing API.
4.4 2014-05-07
  • تمت إضافة واجهات برمجة تطبيقات جديدة لمحوِّل التوسّط.
  • تمت إضافة تنسيق إعلان جديد أبعاده 320×100 LARGE_BANNER لكلٍّ من الهواتف والأجهزة اللوحية.
  • تمت إضافة تنسيق بيني جديد للشراء داخل التطبيق. يمكنك ضبط InAppPurchaseListener على InterstitialAd للاستماع إلى أحداث الشراء داخل التطبيق.
  • إصلاح خطأ في تطبيق SecurityException بسبب قراءة gservices بدون إذن
4.3 2014/3/17
  • تعمل InterstitialAd الآن إذا تم تمرير سياق التطبيق.
  • تمت إضافة طريقة setContentUrl() إلى PublisherAdRequest.Builder.
  • أصلِح المشكلة للحصول على استثناء في حال عدم تسجيل الخدمة.
4.2 2014-02-03 إصلاحات أخطاء متنوّعة.
4.1 2014-01-16
  • تمت إضافة إمكانية استخدام "مدير إعلانات Google" و"الإعلانات على شبكة البحث" للتطبيقات المتوافقة مع الأجهزة الجوّالة.
  • تمّت إضافة طريقة setLocation() إلى AdRequest.Builder.
  • تم إصلاح العُطل الذي حدث إذا تم طلب إعلان بيني ولكن لم يتم تحديد AdActivity في البيان.
4.0 ‎2013‑10‑31
  • أصبحت واجهات برمجة التطبيقات لإعلانات Google على الأجهزة الجوّالة الآن جزءًا من خدمات Google Play.
  • يتم تلقائيًا طرح التحديثات المستقبلية لواجهات برمجة تطبيقات "إعلانات Google للأجهزة الجوّالة" على الأجهزة من خلال "خدمات Google Play".
  • لا يتوفّر "مدير إعلانات Google" و"الإعلانات على شبكة البحث" لتطبيقات الأجهزة الجوّالة بعد.