تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
الإصدار
تاريخ الإصدار
ملاحظات
24.5.0
24-07-2025
يمكن للناشرين المدرَجين في القائمة المسموح بها الآن استخدام معرّف موضع الإعلان لجميع أشكال الإعلانات.
تم إصلاح عُطل مرتبط برسالة الخطأ 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
24-02-2025
التغييرات التي قد تؤدي إلى أعطال:
تمت زيادة الحد الأدنى لمستوى واجهة برمجة تطبيقات Android إلى 23.
تمت إضافة MediationRewardedAdCallback.onUserEarnedReward()
وإيقاف
MediationRewardedAdCallback.onUserEarnedReward(RewardItem) نهائيًا.
يجب تعديل وسيطاء التوسّط لاستخدام الطريقة الجديدة.
تم إيقاف جميع واجهات برمجة التطبيقات ذات الصلة بشكل الإعلان بين الصفحات. على سبيل المثال، 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 لإعلانات الأجهزة الجوّالة.
تم تعديل الاعتمادية على حزمة تطوير البرامج (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.
تمت إزالة واجهة برمجة التطبيقات MobileAds.enableSameAppKey() المتوقّفة نهائيًا
وتم تعديل الطريقة البديلة MobileAds.putPublisherFirstPartyIdEnabled()
لعرض قيمة منطقية تحدّد ما إذا كان استمرار عنصر التحكّم ناجحًا أم لا.
Native Ads:
تمت إزالة AdLoader.forUnifiedNativeAd(). استخدِم AdLoader.forNativeAd() بدلاً من ذلك.
تمت إزالة AdLoader.forCustomTemplateAd(). استخدِم AdLoader.forCustomFormatAd() بدلاً من ذلك.
تمت إزالة AdFormat.UNKNOWN بدون استبداله. يجب أن تمرِّر التطبيقات التي تستخدم
QueryInfo.generate()
شكل إعلان.
يمكن الآن ربط طرق AdManagerAdRequest.Builder الموروثة من العنصر الرئيسي معًا لإنشاء عنصر من مكالمة واحدة.
وقد تطلّب ذلك تغييرًا في بنية الوراثة بحيث لم يعُد AdManagerAdRequest.Builder يرث من AdRequest.Builder.
التوسّط: تم تغيير قيمة العائد لكل من
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 لطلب الإعلانات وعرضها
من خلال واجهة مستخدم "أداة فحص الإعلانات".
أداة فحص الإعلانات: تمت إضافة إمكانية تصدير سجلّات طلبات الإعلانات من خلال
ميزة "المشاركة على Android" في حزمة تطوير البرامج (SDK).
21.1.0
2022-07-14
تمت إضافة إمكانية تحقيق الربح من الإعلانات في WebView. لمزيد من التفاصيل، يمكنك الاطّلاع على دمج WebView API للإعلانات.
تمت إضافة getResponseExtras() إلى
ResponseInfo
التي قد تعرض معلومات إضافية عن استجابة الإعلان.
21.0.0
25-05-2022
التغييرات التي قد تؤدي إلى أعطال:
تتطلّب حزمة تطوير البرامج "SDK لإعلانات Google على الأجهزة الجوّالة" الآن أن يكون الحد الأدنى لمستوى واجهة برمجة التطبيقات (API) في جميع التطبيقات هو 19 على نظام التشغيل Android.
تمت إضافة تعليقات توضيحية @NonNull في كل طريقة لم تحدّد سابقًا إمكانية القيم الخالية بشكل صريح.
تمت إزالة الطريقة AdRequest.Builder.addNetworkExtras().
يمكنك استخدام AdRequest.Builder.addNetworkExtrasBundle()
بدلاً من ذلك.
ستوقف حزمة تطوير البرامج (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
بدءًا من الإصدار 20.4.0، تتضمّن حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" الإذن
com.google.android.gms.permission.AD_ID في بيان
حزمة SDK الذي يتم دمجه تلقائيًا في بيان التطبيق من خلال
أدوات إصدار Android. لمزيد من المعلومات عن بيان الإذن AD_ID، بما في ذلك كيفية إيقافه، يمكنك الرجوع إلى
مقالة مركز مساعدة Play Console.
تمت إضافة
onAdClicked()
إلى FullScreenContentCallback.
تم تفعيل
onAdClicked()
في الفئة AdListener لشكل الإعلان المدمج مع المحتوى.
برامج التكيّف مع التوسّط: تم إصلاح تعليق توضيحي بشأن إمكانية قبول القيمة الخالية للمعلمة mediationExtras في جميع طلبات التحميل في برامج التكيّف مع التوسّط.
20.2.0
2021‑06‑08
تمت إضافة ميزة "فاحص الإعلانات" (إصدار تجريبي) للناشرين على "مدير إعلانات Google".
تمت إضافة دالة معاودة الاتصال 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 على الأجهزة الجوّالة.
تمت إضافة إمكانية استخدام التطبيقات التي تستهدف المستوى 30 لواجهة برمجة التطبيقات على أجهزة Android 11.
الإعلانات على شاشة فتح التطبيق: تم تغيير شكل AppOpenAd ليعمل بشكل أقرب إلى شكل ملء الشاشة بدلاً من عرض البانر. تمت إضافة الطريقتَين getResponseInfo() وshow() إلى AppOpenAd. تم إيقاف الفئتين AppOpenAdView
وAppOpenAdPresentationCallback.
التوسّط: أصبحت ميزة إعداد التقارير عن حالة التوسّط متاحة الآن. استخدِم
ResponseInfo.getAdapterResponses()
للحصول على معلومات الرد لكل شبكة إعلانات شاركت في طلب إعلان.
الإعلانات القديمة مقابل مكافأة: تم إيقافها نهائيًا RewardedVideoAd.
تمت إضافة تنسيق RewardedInterstitialAd، وهو متاح حاليًا في إصدار تجريبي خاص.
تم إصلاح الخطأ الذي كان يؤدي إلى أن يستدعي MobileAds.initialize()
معالج الإكمال مرة واحدة فقط. يؤدي كل طلب إلى
MobileAds.initialize() الآن إلى استدعاء دالة معاودة الاتصال الخاصة بالإكمال.
تمت إضافة دوال استدعاء جديدة متعلّقة بتعذُّر التحميل إلى جميع أشكال الإعلانات التي تعرض 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
الإعلانات المدمجة مع المحتوى: تمت إضافة واجهة مستخدم لأداة التحقّق من الإعلانات المدمجة مع المحتوى إلى طلبات الاختبار لمساعدتك في رصد انتهاكات سياسات الإعلانات المدمجة مع المحتوى وحلّها.
تمت إضافة طريقة الدفع MobileAds.disableMediationAdapterInitialization(). يجب استدعاء هذه الطريقة قبل إعداد حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة من أجل إيقاف عملية إعداد محوّل التوسّط.
تمت إضافة واجهات برمجة تطبيقات لشكل الإعلان InstreamAd. تتوفّر هذه الميزة حاليًا في إصدار تجريبي خاص. يُرجى التواصل مع مدير حسابك لطلب إذن الوصول.
إعلان البانر التكيُّفي: تم تغيير طرق إنشاء إعلانات البانر التكيُّفية في الفئة
AdSize. على سبيل المثال، تمت إعادة تسمية AdSize.getCurrentOrientationBannerAdSizeWithWidth()
إلى AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize().
التوسّط: ترصد حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" الآن الاستثناءات التي تطرحها برامج التوسّط.
التوسّط في الإعلانات مقابل مكافأة: تم إصلاح خطأ كان يؤدي إلى عدم عرض سوى إعلان واحد مقابل مكافأة إذا تم تخزين عدة إعلانات مقابل مكافأة في ذاكرة التخزين المؤقت.
تمت إضافة الطريقة setTestDeviceIds() لتفعيل إعداد
أجهزة الاختبار مرة واحدة لجميع طلبات الإعلانات.
18.2.0
29-08-2019
تمت إضافة واجهات برمجة تطبيقات للتنسيق
AppOpenAd. تتوفّر هذه الميزة حاليًا في إصدار تجريبي خاص. يُرجى التواصل مع مدير حسابك لطلب إذن الوصول.
التوسّط: يتم الآن رصد استثناءات المحوّل التي تتضمّن عمليات تتبُّع تسلسل استدعاء الدوال البرمجية في حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" ومعالجتها من خلال حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
18.1.0
2019‑07‑09
الإصدار الرسمي الذي يتيح استخدام ميزة "قياس التطبيق"
الإعلانات المدمجة مع المحتوى: بالنسبة إلى الإعلانات غير المرتبطة بالفيديو، يمكن الآن ضبط نوع مقياس الصورة في MediaView باستخدام MediaView.setImageScaleType().
الإعلانات المدمجة مع المحتوى: تمت إضافة UnifiedNativeAd.getMediaContent().
يمكن للناشرين الذين يحمّلون الصور فقط من خلال عناوين URL الحصول الآن على محتوى الوسائط الخاص بالإعلان، وتوفير صورة له، واستدعاء MediaView.setMediaContent() لتعبئة بيانات الصورة
من خلال MediaView للإعلانات غير الفيديو.
الإعلانات المدمجة مع المحتوى: تمت إضافة واجهات برمجة تطبيقات لإتاحة ميزة "القياس المفتوح" لأشكال الإعلانات المدمجة مع المحتوى المخصّصة غير المرتبطة بالفيديو.
تمت إزالة الفئة Correlator وواجهات برمجة التطبيقات المرتبطة بها.
لم تكن هذه الميزة تعمل في السابق.
تمت إضافة تبعيات على play-services-measurement وplay-services-measurement-sdk. لم تعُد التطبيقات بحاجة إلى إضافة هذه التبعيات بشكل صريح.
18.0.0
2019‑06‑17
نقل البيانات من "مكتبات دعم Android" إلى مكتبات Jetpack (AndroidX) راجِع
ملاحظات إصدار "خدمات Google Play" للحصول على مزيد من المعلومات.
لتجنُّب حدوث عُطل عند التشغيل الأول بعد تثبيت التطبيق من "متجر Play"، يتطلّب هذا الإصدار من الناشرين الإفصاح عن تبعيات إضافية في ملف build.gradle:
حلّ مشكلة 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.
على الناشرين في "مدير إعلانات Google" تحديد علامة
<meta-data> تتضمّن المفتاح
com.google.android.gms.ads.AD_MANAGER_APP
في ملف AndroidManifest.xml. راجِع دليل
البدء لمزيد من التفاصيل.
الإعلانات المدمجة مع المحتوى: تم إيقاف NativeAppInstallAd وNativeContentAd
وواجهات برمجة التطبيقات المرتبطة بهما نهائيًا لصالح UnifiedNativeAd.
يُرجى الرجوع إلى الإعلانات المدمجة مع المحتوى
المتقدّمة الموحّدة للحصول على مزيد من التعليمات حول استخدام واجهات برمجة التطبيقات الجديدة.
الإعلانات المدمجة مع المحتوى: أضفنا ميزة "تجاهل هذا الإعلان".
الإعلانات المدمجة مع المحتوى: تمت إزالة سجلّ التحذير غير الضار: "يجب ألا يكون UnconfirmedClickListener فارغًا أثناء ضبط ClickConfirmingView".
الإعلانات مقابل مكافآت: تمت إضافة طريقة setAdMetadataListener في
RewardedVideoAd للاستماع إلى تغييرات البيانات الوصفية للإعلان.
الإعلانات مقابل مكافآت: سيؤدي استدعاء destroy() إلى إلغاء قيمة المستمع.
تم إصلاح الخطأ الذي كان يتسبّب في عدم تشغيل onRewardedVideoCompleted() على المحاكيات.
16.0.0
2018‑10‑02
لم يتم إجراء أي تغييرات على الإعلانات. راجِع ملاحظات إصدار "خدمات Google Play" للحصول على مزيد من المعلومات.
15.0.0
2018‑04‑12
الإصدار التجريبي 3 من MRAID
الإعلانات المدمجة مع المحتوى: تمت إضافة 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 نهائيًا.
تمت إضافة طريقة 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. تمت أيضًا إزالة فئات عمليات الشراء داخل التطبيق ذات الصلة.
تمت إضافة إمكانية تفعيل الوضع الغامر في "الإعلانات بملء الشاشة" من خلال إضافة الطريقة
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، يُرجى الاطّلاع على
مدونة مطوّري تطبيقات 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
22-09-2016
تمت إضافة الفئة MediaView إلى "الإعلانات المدمجة مع المحتوى المتقدّمة" في "إعلانات الفيديو".
تمت إضافة طريقة openDebugMenu() إلى الفئة
MobileAds لمعاينة المواد الإبداعية وتحديد المشاكل وحلّها في الوحدات الإعلانية على "مدير إعلانات Google".
تمّت إضافة إمكانية استخدام أحداث مخصّصة لفيديوهات مقابل مكافآت.
تم تحسين تشغيل إعلانات الفيديو من خلال إصلاح العديد من الأخطاء.
9.0.1
26-05-2016
يحلّ هذا الإصدار مشكلة في ProGuard تم طرحها في الإصدار 9.0.0.
لم يعُد الناشرون بحاجة إلى خيار keep من أجل com.google.android.gms.common.util.DynamiteApi.
9.0.0
2016‑05‑18
تمت إضافة ميزة التعبئة التلقائية لمعلومات الموقع الجغرافي
للتطبيقات التي تمنح إذن الوصول إلى الموقع الجغرافي بشكل صريح.
تمّت إضافة إمكانية استخدام أحداث مخصّصة للتوسّط في "الفيديوهات مقابل مكافأة".
تمت إضافة خيارات فيديو لـ "الإعلانات المحلية السريعة".
تم تعديل واجهة برمجة التطبيقات Custom Search Ads API.
في هذا الإصدار فقط، على التطبيقات التي تستخدم 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.
تمت إضافة طريقة 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".
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.
يتم تلقائيًا إرسال التحديثات المستقبلية لواجهات برمجة التطبيقات الخاصة بـ "إعلانات Google على الأجهزة الجوّالة" إلى الأجهزة من خلال "خدمات Google Play".
لا تتوفّر بعد "إعلانات شبكة البحث على التطبيقات للأجهزة الجوّالة" و"مدير إعلانات Google".
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eGoogle Ad Manager Android SDK updates prioritize enhancing ad performance, developer experience, and user privacy, while adapting to Android platform changes.\u003c/p\u003e\n"],["\u003cp\u003eMajor version updates (v23.0.0, v22.0.0, v21.0.0, v20.0.0) introduce significant, potentially breaking changes, requiring developers to carefully migrate their implementations.\u003c/p\u003e\n"],["\u003cp\u003eThe SDK has evolved to deprecate older APIs and introduce new functionalities, like improved ad load failure logging, adaptive banners, and privacy-preserving API testing.\u003c/p\u003e\n"],["\u003cp\u003eUpdates reflect industry trends and regulations, including increased minimum SDK requirements, User Messaging Platform (UMP) SDK integration for privacy enhancements, and support for features like Attribution Reporting and Topics API.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers should consult the detailed release notes for specific version changes and migration instructions to ensure seamless integration and optimal ad performance.\u003c/p\u003e\n"]]],["Key actions and information: The content details changes across multiple versions of an ads SDK. These changes include deprecating older methods and classes, introducing new ad formats (like `NativeAd` and `AppOpenAd`), and updating existing APIs with new features such as `Ad Inspector` UI, `User Messaging Platform SDK` updates, `QueryInfo`, `MediaContent`, and `ResponseInfo`. Major version updates introduced breaking changes, minimum API level increases, and migration to Jetpack/AndroidX libraries. Ad loading and request configurations were also enhanced.\n"],null,[]]