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

الإصدار	تاريخ الإصدار	ملاحظات
24.7.0	‫2025-10-09	تم تصحيح تعليق توضيحي غير صالح بشأن إمكانية قبول القيمة الخالية في نوع الإرجاع الخاص بالدالة NativeCustomFormatAd.getDisplayOpenMeasurement(). لم تتغيّر الوظيفة، لأنّه كان من المتوقّع أن تعرض الطريقة القيمة null. تمت إعادة الإصدار androidx.webkit:webkit إلى الإصدار 1.12.1 من الإصدار 1.14.0 للحفاظ على التوافق مع الإصدار 7.3.1 من المكوّن الإضافي لنظام Gradle المتوافق مع Android.
24.6.0	‫2025-09-08	يمكن لمحوّلات التوسّط للإعلانات المدمجة مع المحتوى الآن تنفيذ NativeAdMapper.destroy() لتلقّي إشعار عند إيقاف عرض إعلان مدمج مع المحتوى.
24.5.0	‫2025-07-24	يمكن للناشرين الذين يمكنهم استخدام هذه الميزة الآن الاستفادة من ميزة "رقم تعريف موضع الإعلان" لجميع أشكال الإعلانات. تم إصلاح عُطل في التطبيق مع رسالة الخطأ Fatal Exception: java.util.ConcurrentModificationException.
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	أصبح الحد الأدنى لإصدار Kotlin هو 2.1.0. تم إصلاح الأخطاء وإجراء تحسينات في الأداء. سيتم طرح play-services-ads-lite بوتيرة أقل، ولن يتم توزيعه مع هذا الإصدار. لمزيد من المعلومات، يُرجى الاطّلاع على مستندات Lite SDK.
24.0.0	2025‑02‑24	هذا الإصدار هو تحديث للإصدار الرئيسي ويتضمّن العديد من التغييرات غير المتوافقة مع الإصدارات السابقة. يمكنك الاطّلاع على نقل البيانات إلى حزمة SDK الإصدار 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	‫29-10-2024	تم تعديل رسائل logcat التي تم طرحها في الإصدار 23.4.0 بشأن تعذُّر تحميل الإعلان من مستوى الخطأ إلى مستوى المعلومات. تحسين تحقيق الربح من الإعلانات المخصّصة في علامات التبويب المخصّصة من خلال واجهة برمجة التطبيقات WebView API للإعلانات
23.4.0	‫2024‑09‑30	تؤدي حالات تعذُّر تحميل الإعلانات الآن إلى استدعاء رسالة logcat تعرض ad failed to load في تتبُّع تسلسل استدعاء الدوال البرمجية لحالة التعذُّر. تسجّل عملية تتبُّع تسلسل استدعاء الدوال البرمجية هذه الرسالة كخطأ، ولكنّها لا تشير إلى حدوث عُطل. راجِع تصحيح أخطاء رسائل تسجيل الأخطاء الشائعة لتفسير حالات تعذُّر تحميل الإعلانات الشائعة. إذا ظهر لك خطأ متكرّر مرتبط بعرض الإعلانات وغير موثّق، يُرجى مشاركة تتبُّع تسلسل استدعاء الدوال البرمجية مع فريق دعم حزمة "SDK لإعلانات Google على الأجهزة الجوّالة". تمت إضافة طرق addCustomTargeting() إلى AdRequest.
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	هذا الإصدار هو تحديث للإصدار الرئيسي ويتضمّن العديد من التغييرات غير المتوافقة مع الإصدارات السابقة. يمكنك الاطّلاع على مزيد من المعلومات حول كيفية نقل البيانات في نقل البيانات إلى حزمة SDK الإصدار 23. التغييرات التي قد تؤدي إلى أعطال: تمت زيادة الحد الأدنى لمستوى واجهة برمجة تطبيقات 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	تم تعديل الاعتمادية على حزمة تطوير البرامج (SDK) لمنصة User Messaging Platform إلى الإصدار 2.1.0. تمت إضافة الطريقة setPublisherPrivacyPersonalizationState() إلى Publisher Privacy Treatment API (الإصدار التجريبي).
22.4.0	‫2023-09-13	يجب أن يكون الحد الأدنى compileSdkVersion هو 33. أداة فحص الإعلانات: تمت إضافة دعم حزمة SDK لطلب الإعلانات وعرضها التي تم طلبها من خلال واجهة مستخدم "أداة فحص الإعلانات". تمّت إضافة طريقة QueryInfo.generate() جديدة تأخذ رقم تعريف وحدة إعلانية. تتيح إجراء الاختبار الأوّلي للإصدار التجريبي من واجهة برمجة التطبيقات Attribution Reporting API والإصدار التجريبي من واجهة برمجة التطبيقات Topics API المخصّصتَين للحفاظ على الخصوصية. لمزيد من المعلومات، يمكنك الاطّلاع على دليل مبادرة حماية الخصوصية على Android في AdMob.
22.3.0	‫22-08-2023	تمت إضافة إمكانية إنشاء أحجام تكيُّفية باستخدام AdSize.FULL_WIDTH كعرض. في السابق، كان يتم التعامل مع أحجام الإعلانات التي تم إنشاؤها باستخدام AdSize.FULL_WIDTH على أنّها AdSize.SMART_BANNER.
22.2.0	‫2023‑07‑05	الأحداث المخصّصة: تم إيقافها نهائيًا AdRequest.Builder.addCustomEventExtrasBundle(). استخدِم Adapter وتفاعَل مع المَعلمات الإضافية من خلال AdRequest.Builder.addNetworkExtrasBundle() بدلاً من ذلك. تم إيقاف AdRequest.getCustomEventExtrasBundle() نهائيًا. استخدِم Adapter وتفاعَل مع المَعلمات الإضافية من خلال AdRequest.getNetworkExtrasBundle() بدلاً من ذلك.
22.1.0	‫2023-05-18	أداة فحص الإعلانات: تم تفعيل إمكانية إرسال طلبات إعلانات من واجهة مستخدم "أداة فحص الإعلانات" على الأجهزة التي لا تتضمّن "خدمات Google Play".
22.0.0	‫29-03-2023	هذا الإصدار هو تحديث للإصدار الرئيسي ويتضمّن العديد من التغييرات غير المتوافقة مع الإصدارات السابقة. يمكنك الاطّلاع على نقل البيانات إلى حزمة SDK الإصدار 22 لمعرفة المزيد من المعلومات حول كيفية نقل البيانات. التغييرات التي قد تؤدي إلى أعطال: تمّت إزالة 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 لطلب الإعلانات وعرضها من خلال واجهة المستخدم الخاصة بأداة فحص الإعلانات. الإعلانات المدمجة مع المحتوى: تمت إضافة getMediaContent() إلى MediaView. الإعلانات المدمجة مع المحتوى المخصّصة: تمت إضافة getMediaContent() إلى NativeCustomFormatAd. تم إيقاف getVideoMediaView() نهائيًا. أنشئ MediaView خاصًا بك واستخدِم NativeCustomFormatAd.getMediaContent() بدلاً من ذلك. تم إيقاف getVideoController() نهائيًا. يمكنك استخدام NativeCustomFormatAd.getMediaContent().getVideoController() كبديل.
21.2.0	‫2022-09-06	أداة فحص الإعلانات: تمت إضافة إمكانية تصدير سجلّات طلبات الإعلانات من خلال ميزة "المشاركة على Android" في حزمة تطوير البرامج (SDK).
21.1.0	‫2022-07-14	تمت إضافة إمكانية تحقيق الربح من الإعلانات في WebView. لمزيد من التفاصيل، يمكنك الاطّلاع على مقالة دمج WebView API للإعلانات. تمت إضافة getResponseExtras() إلى ResponseInfo التي قد تعرض معلومات إضافية عن استجابة الإعلان. الإصدار التجريبي: تتوفّر واجهة برمجة التطبيقات getResponseExtras() في إصدار تجريبي. قد تتغيّر القيمة المعروضة بدون طرح إصدار جديد من حزمة SDK.
21.0.0	‫25-05-2022	هذا الإصدار هو تحديث للإصدار الرئيسي ويتضمّن العديد من التغييرات غير المتوافقة مع الإصدارات السابقة. راجِع دليل نقل البيانات إلى حزمة تطوير البرامج (SDK) الإصدار 21 للحصول على مزيد من المعلومات حول كيفية نقل البيانات. التغييرات التي قد تؤدي إلى أعطال: تتطلّب حزمة تطوير البرامج "SDK لإعلانات Google على الأجهزة الجوّالة" الآن أن يكون الحد الأدنى لمستوى واجهة برمجة التطبيقات Android في جميع التطبيقات هو 19 لكي تعمل. تمت إضافة تعليقات توضيحية @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() الإصدار التجريبي: تتوفّر واجهات برمجة التطبيقات هذه في إصدار تجريبي. وقد تتغيّر قيم الإرجاع بدون طرح إصدار جديد من حزمة تطوير البرامج (SDK). تمّت إضافة إمكانية استخدام الأحداث المخصّصة في "أداة فحص الإعلانات".
20.6.0	‫22-02-2022	تم إيقاف جميع واجهات الأحداث المخصّصة. استخدِم الفئة Adapter والواجهة MediationAdLoadCallback بدلاً من ذلك. تمت إضافة دعم gad_has_consent_for_cookies SharedPreferences. ستفعّل حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" الإعلانات المحدودة (LTD) عندما يتم ضبط قيمة الإعداد المفضّل gad_has_consent_for_cookies على 0. لمزيد من التفاصيل، يُرجى الاطّلاع على مقالة ضبط الموافقة على ملفات تعريف الارتباط. ستوقف حزمة تطوير البرامج (SDK) لـ "إعلانات Google على الأجهزة الجوّالة" عملية نقل المعرّف الإعلاني على Android (AAID) عند استدعاء RequestConfiguration.Builder.setTagForChildDirectedTreatment() مع TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE (راجِع الإعداد كموجَّه إلى الأطفال)، أو عند استدعاء RequestConfiguration.Builder.setTagForUnderAgeOfConsent() مع TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE (راجِع إعداد المستخدمين الذين لم يبلغوا سن الرشد).
20.5.0	‫2021‑11‑18	تمت إضافة إمكانية استخدام التطبيقات التي تستهدف المستوى 31 من واجهة برمجة التطبيقات على أجهزة Android 12. تمت إضافة إمكانية استخدام معرّف مجموعة التطبيقات لحالات الاستخدام، مثل إعداد التقارير ومنع الاحتيال.
20.4.0	‫22-09-2021	يتطلّب هذا الإصدار وجميع الإصدارات السابقة توفُّر تبعية صريحة على androidx.work:work-runtime:2.7.0 لإصلاح خطأ يؤدي إلى تعطُّل التطبيق على نظام التشغيل Android S مع تتبُّع تسلسل استدعاء الدوال البرمجية التالي: Fatal Exception: java.lang.IllegalArgumentException: com.mycompany.myapp: Targeting S+ (version 10000 and above) requires that one of FLAG_IMMUTABLE or FLAG_MUTABLE be specified when creating a PendingIntent. Strongly consider using FLAG_IMMUTABLE, only use FLAG_MUTABLE if some functionality depends on the PendingIntent being mutable, e.g. if it needs to be used with inline replies or bubbles. at android.app.PendingIntent.checkFlags(PendingIntent.java:386) at android.app.PendingIntent.getBroadcastAsUser(PendingIntent.java:657) at android.app.PendingIntent.getBroadcast(PendingIntent.java:644) at androidx.work.impl.utils.ForceStopRunnable.getPendingIntent(ForceStopRunnable.java:174) at androidx.work.impl.utils.ForceStopRunnable.isForceStopped(ForceStopRunnable.java:108) at androidx.work.impl.utils.ForceStopRunnable.run(ForceStopRunnable.java:86) at androidx.work.impl.utils.SerialExecutor$Task.run(SerialExecutor.java:75) at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1167) at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:641) at java.lang.Thread.run(Thread.java:920) لإصلاح هذا الخطأ، أضِف التبعيات التالية الخاصة بحزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى ملف Gradle على مستوى التطبيق في وحدتك: dependencies { implementation 'com.google.android.gms:play-services-ads:20.4.0' // For apps targeting Android 12, add WorkManager dependency. constraints { implementation('androidx.work:work-runtime:2.7.0') { because '''androidx.work:work-runtime:2.1.0 pulled from play-services-ads has a bug using PendingIntent without FLAG_IMMUTABLE or FLAG_MUTABLE and will fail in Apps targeting S+.''' } } } بدءًا من الإصدار 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	إعلان البانر التكيُّفي: تمت إضافة AdSize.getInlineAdaptiveBannerAdSize() لطلب إعلانات بانر تكيُّفية مضمّنة بارتفاع أقصى. تمت إضافة AdError.toString() لتسهيل تسجيل البيانات.
20.0.0	‫2021‑04‑05	هذا الإصدار هو تحديث للإصدار الرئيسي ويتضمّن العديد من التغييرات غير المتوافقة مع الإصدارات السابقة. يمكنك الاطّلاع على دليل الاستعداد لاستخدام الإصدار 20 من حزمة تطوير البرامج (SDK) للحصول على مزيد من المعلومات حول كيفية نقل البيانات. التغييرات التي قد تؤدي إلى أعطال: تمت إزالة واجهة برمجة التطبيقات القديمة 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 لتحميل هذه التنسيقات. ملاحظة: لن تتم إزالة فئات أدوات ربط التوسّط المتوقّفة نهائيًا هذه في الإصدار 20.0.0 لمنح أدوات ربط التوسّط وقتًا للانتقال إلى واجهة برمجة التطبيقات الجديدة. يمكن الآن لمحوّلات عروض الأسعار تنفيذ طرق تحميل مميّزة في فئة Adapter لتنسيقات RTB المحدّدة.
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	تنبيه: لا تتوافق الإصدارات 19.3.0 والإصدارات الأقدم من حزمة SDK مع نظام التشغيل Android 11 (المستوى 30 لواجهة برمجة التطبيقات). ننصحك باستخدام الإصدار 19.4.0 أو إصدار أحدث من حزمة تطوير البرامج (SDK) إذا كنت تخطّط لضبط targetSdkVersion على المستوى 30 من واجهة برمجة التطبيقات. تمت إضافة الطريقتَين getDomain() وgetCause() إلى AdError. تمت إضافة دوال استدعاء جديدة متعلّقة بتعذُّر التحميل إلى جميع أشكال الإعلانات التي تعرض LoadAdError. مثال: onAdFailedToLoad(LoadAdError). تم إيقاف دوال الاستدعاء المتعلّقة بتعذُّر التحميل والتي تعرض عددًا صحيحًا. على سبيل المثال: onAdFailedToLoad(int). الإعلانات مقابل مكافأة: تمت إضافة onRewardedAdFailedToShow(AdError) وإيقاف onRewardedAdFailedToShow(int) نهائيًا. التوسّط لعرض الإعلانات مقابل مكافأة: تمت إضافة رمز الخطأ MEDIATION_SHOW_ERROR. تعرض جميع أخطاء العرض المرتبطة بالإعلانات التي يتم عرضها من خلال التوسّط الآن MEDIATION_SHOW_ERROR في AdError.getCode()، بالإضافة إلى AdError.getCause() NonNull الذي يمثّل خطأ التوسّط الأساسي.
19.2.0	2020‑06‑18	تمت إضافة تنسيق RewardedInterstitialAd. تتوفّر هذه الميزة في إصدار تجريبي خاص. يُرجى التواصل مع مدير حسابك لطلب إذن الوصول. الإعلانات المدمجة مع المحتوى: تمت إضافة واجهة مستخدم "أداة التحقّق من الإعلانات المدمجة مع المحتوى" إلى طلبات الاختبار لمساعدتك في رصد انتهاكات سياسات الإعلانات المدمجة مع المحتوى وإصلاحها. تمت إضافة طريقة MobileAds.disableMediationAdapterInitialization(). يجب استدعاء هذه الطريقة قبل إعداد حزمة تطوير البرامج (SDK) لـ "إعلانات Google على الأجهزة الجوّالة" من أجل إيقاف عملية إعداد محوّل التوسّط. تحذير: قد يؤدي استدعاء هذا الإجراء إلى التأثير سلبًا في أداء التوسّط من Google. يجب عدم استدعاء هذه الطريقة إلا إذا كنت تضمّن برامج وسيطة من Google في تطبيقك ولكنك لا تستخدمها كوسيط خلال جلسة تطبيق معيّنة (على سبيل المثال، إذا كنت تجري اختبارًا للوساطة من النوع أ/ب).
19.1.0	2020‑04‑16	تم إيقاف MobileAds.initialize(Context, String) نهائيًا واستخدام MobileAds.initialize(Context, OnInitializationCompleteListener) بدلاً منه. AdRequest.isTestDevice() تعرض الآن القيمة true للأجهزة الاختبارية التي تم ضبطها من خلال MobileAds.setRequestConfiguration(). تم إصلاح عُطل NullPointerException في MobileAds.initialize() الذي حدث على بعض الأجهزة في التطبيقات التي تستخدم Lite SDK.
19.0.1	‫2020‑03‑18	الإعلانات المدمجة مع المحتوى: تم إصلاح تسريب الذاكرة الثابت الذي حدث عند استخدام NativeCustomTemplateAd.
19.0.0	‫2020‑03‑02	هذا الإصدار هو تحديث رئيسي يتضمّن التغييرات غير المتوافقة التالية: تم تعديل الحد الأدنى لإصدار حزمة تطوير البرامج (SDK) لنظام التشغيل Android إلى المستوى 16 من واجهة برمجة التطبيقات بما يتوافق مع سياسة التوزيع الخاصة بخدمات Google Play. الإعلانات المدمجة مع المحتوى: تم نقل MediaContent إلى حزمة com.google.android.gms.ads. تمت إضافة إمكانية قراءة مَعلمات الموافقة من الإصدار 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-08-2019	تمت إضافة واجهات برمجة تطبيقات للتنسيق AppOpenAd. تتوفّر هذه الميزة في إصدار تجريبي خاص. يُرجى التواصل مع مدير حسابك لطلب إذن الوصول.
18.1.1	‫23-07-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	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	تمت إضافة الطريقتَين setMaxAdContentRating() وsetTagForUnderAgeOfConsent() إلى AdRequest.Builder. تمت إضافة الثوابت التالية لاستخدامها مع AdRequest.Builder.setMaxAdContentRating() وAdRequest.Builder.setTagForUnderAgeOfConsent(): MAX_AD_CONTENT_RATING_G MAX_AD_CONTENT_RATING_PG MAX_AD_CONTENT_RATING_T MAX_AD_CONTENT_RATING_MA TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED
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. setGender() setBirthday() setIsDesignedForFamiles() تم إصلاح الخطأ الذي تسبّب في عدم تشغيل onRewardedVideoCompleted() على المحاكيات.
16.0.0	‫2018‑10‑02	ما مِن تغييرات على الإعلانات. يُرجى الرجوع إلى ملاحظات إصدار &quot;خدمات Google Play&quot; للحصول على مزيد من المعلومات.
15.0.0	2018‑04‑12	الإصدار التجريبي من MRAID v3 الإعلانات المدمجة مع المحتوى: تمت إضافة Unified Native Ad API. يؤدي ذلك إلى دمج NativeAppInstallAds وNativeContentAds في نوع جديد واحد هو UnifiedNativeAd. ملاحظة: عند استخدام الإعلانات المدمجة مع المحتوى، يظهر تحذير غير ضار في السجلّات عند النقر على الإعلان المدمج مع المحتوى: UnconfirmedClickListener يجب ألا يكون فارغًا أثناء ضبط ClickConfirmingView. يمكن تجاهل هذا التحذير، وستتم إزالته في الإصدار التالي.
12.0.1	‫28-03-2018	ما مِن تغييرات على الإعلانات. راجِع ملاحظات الإصدار الخاصة بـ &quot;خدمات Google Play&quot; للحصول على مزيد من التفاصيل.
12.0.0	2018‑03‑20	فيديو مقابل مكافأة: تمت إضافة طريقة رد الاتصال onRewardedVideoCompleted() إلى RewardedVideoAdListener. لتجنُّب حدوث خطأ في التجميع عند التحديث إلى الإصدار 12.0.0، يجب أن تتجاهل التطبيقات عملية الاستدعاء هذه في تنفيذ 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. لمزيد من المعلومات، يُرجى الاطّلاع على ملاحظات إصدار &quot;خدمات Google Play&quot;.
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) والإصدارات الأحدث الحد الأدنى لمستوى واجهة برمجة التطبيقات (API) 14 على Android، ولا يمكن تثبيتها على الأجهزة التي تعمل بمستوى واجهة برمجة تطبيقات أقل من 14. لمزيد من المعلومات حول الخيارات المتاحة، بما في ذلك إنشاء حِزم APK متعددة لتوسيع نطاق توافق تطبيقك مع Android Gingerbread، يُرجى الاطّلاع على مدونة "مطوّرو تطبيقات Android". تمت إضافة إمكانية استخدام مواد عرض الفيديو في "الإعلانات المدمجة المتقدّمة" و"الإعلانات المستندة إلى نماذج مخصّصة". تمت إضافة الطرق getVideoController() وsetVideoOptions() وgetVideoOptions() إلى الفئة PublisherAdView. تمت إضافة الصف AdChoicesView. تمت إضافة الطريقتَين getAdChoicesContent() وsetAdChoicesContent() إلى الفئة NativeAdMapper. تمت إضافة واجهة InitializableMediationRewardedVideoAdAdapter لمحوّلات التوسّط الخاصة بـ "الفيديوهات مقابل مكافأة" التي تريد تفعيل الإعداد الأوّلي قبل إرسال طلب إعلان. تمت إضافة إمكانية معاينة الإعلانات داخل التطبيق وتحديد المشاكل وحلّها في &quot;مدير إعلانات Google&quot;.
10.0.1	2016‑11‑21	إصلاح الأخطاء وإجراء تحسينات عامة
9.8.0	‫24-10-2016	تمت إعادة تفعيل MobileAds.Initialize(Context). على الناشرين الذين يستخدمون &quot;مدير إعلانات Google&quot; استدعاء هذه الطريقة عند بدء تشغيل تطبيقاتهم. على ناشري AdMob مواصلة استخدام MobileAds.Initialize(Context, String) وتمرير رمز التطبيق.
9.6.0	‫22-09-2016	تمت إضافة الفئة 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	تمت إضافة ميزة التعبئة التلقائية لمعلومات الموقع الجغرافي للتطبيقات التي تمنح إذن الوصول إلى الموقع الجغرافي بشكل صريح. تمت إضافة إمكانية استخدام الأحداث المخصّصة في التوسّط لعرض "إعلانات الفيديو مقابل مكافأة". تمت إضافة خيارات فيديو لـ "الإعلانات المدمجة السريعة". تم تعديل واجهة برمجة التطبيقات 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	‫24-09-2015	إصلاحات أخطاء متنوّعة.
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". تمّت إضافة إمكانية استخدام أشكال &quot;الإعلانات المدمجة مع المحتوى&quot; المخصّصة، وهي متاحة للحجوزات في &quot;مدير إعلانات Google&quot;.
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 للحصول على اسم فئة وسيط شبكة الإعلانات الذي يعرض إعلانًا.
17.0.0	2018‑10‑05	تمّت إضافة واجهات برمجة تطبيقات جديدة لتنفيذ الأحداث المخصّصة. تمت إضافة مسار شراء تلقائي لعمليات الشراء داخل التطبيق باستخدام Google Play Billing API.
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	أصبحت واجهات برمجة التطبيقات الخاصة بـ &quot;إعلانات Google على الأجهزة الجوّالة&quot; الآن جزءًا من خدمات Google Play. يتم تلقائيًا إرسال التحديثات المستقبلية لواجهات برمجة التطبيقات الخاصة بـ &quot;إعلانات Google على الأجهزة الجوّالة&quot; إلى الأجهزة من خلال &quot;خدمات Google Play&quot;. لم يتمّ بعد إتاحة "مدير إعلانات Google" و"الإعلانات على شبكة البحث لتطبيقات الأجهزة الجوّالة".