ملاحظات الإصدار
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
الإصدار
تاريخ الإصدار
ملاحظات
25.5.0
2026‑09‑17
تمت زيادة الحد الأدنى لمستوى واجهة برمجة تطبيقات Android إلى 24.
تمت إضافة onInitializationFailed() إلى InitializationCompleteCallback. تُبلِغ محوّلات التوسّط الآن حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" بأخطاء إعداد حِزم تطوير البرامج التابعة لجهات خارجية، وذلك باستخدام رمز الخطأ ونطاق الخطأ ورسالة الخطأ.
عند استخدام التوسّط مع مصادر إعلانات الأحداث المخصّصة، تعرض السمة ResponseInfo.getAdapterClassName() الآن اسم فئة الحدث المخصّص بدلاً من com.google.ads.mediation.customevent.CustomEventAdapter.
25.4.0
2026‑06‑17
إصلاح الأخطاء وتحسينات على الأداء
25.3.0
21-05-2026
تمت إضافة الطريقة setAgeRestrictedTreatment() في RequestConfiguration.Builder وإيقاف الطريقتَين setTagForChildDirectedTreatment() وsetTagForUnderAgeOfConsent() نهائيًا. استخدِم الطريقة الجديدة لضبط المعالجة حسب العمر على "طفل" و"مراهق".
25.2.0
2026-04-13
إصلاح الأخطاء وتحسينات على الأداء
25.1.0
2026‑03‑16
تم إصلاح خطأ في فاحص الإعلانات كان يمكن أن يتسبّب في حدوث خطأ عند طلب إعلان اختباري خارج السياق باستخدام عنوان URL فارغ للمحتوى.
25.0.0
2026-02-17
التغييرات التي قد تؤدي إلى أعطال:
تمت إزالة الفئة VersionInfo في الحزمة com.google.android.gms.ads.mediation.
تمت إزالة الطريقة getConfiguration() المتوقّفة نهائيًا في الفئة RtbSignalData.
تمت إزالة الطريقتَين المتوقّفتَين نهائيًا onFailure(String) وonAdFailedToShow(String) في الفئات التالية:
تمت إزالة فئة NativeAdViewHolder من حزمة com.google.android.gms.ads.nativead.
تمت إزالة MIN_WIDTH_RATIO وMIN_HEIGHT_RATIO من MediationUtils للسماح بحدود أكثر مرونة لمطابقة أحجام الإعلانات في التوسّط.
تم تعديل الاعتمادية على حزمة تطوير البرامج (SDK) لمنصة User Messaging Platform إلى الإصدار 4.0.0.
تمت إضافة إمكانية استخدام "إعلانات بانر تكيُّفية ثابتة" كبيرة الحجم. تم تصميم إعلانات البانر التكيّفية الثابتة الكبيرة لزيادة التفاعل والإيرادات.
يمكنك طلب "إعلانات بانر تكيُّفية ثابتة كبيرة" باستخدام الطرق التالية في فئة AdSize:
تم إصلاح مشكلة عدم توفّر ترجمات لموارد حزمة SDK في الإصدارَين 24.6.0 و24.7.0.
تم إيقاف NativeAdViewHolder نهائيًا. استخدِم NativeAdView
لعرض الإعلانات المدمجة مع المحتوى بدلاً من ذلك.
تم إيقاف الطريقتَين AdPreloader.getConfigurations() وAdPreloader.getConfiguration(preloadId) نهائيًا. ولا يمكن استبدال هذه الطرق.
24.7.0
2025‑10‑09
تم تصحيح علامة توضيح مفقودة لإمكانية قبول القيم الفارغة في نوع القيمة التي تم إرجاعها للدالة
NativeCustomFormatAd.getDisplayOpenMeasurement().
لم تتغيّر الوظيفة، لأنّه كان من المتوقّع أن تعرض الطريقة قيمة فارغة.
تم الرجوع إلى الإصدار androidx.webkit:webkit من الاعتمادية من 1.14.0 إلى 1.12.1 للحفاظ على التوافق مع الإصدار 7.3.1 من المكوّن الإضافي لنظام Gradle المتوافق مع Android.
24.6.0
2025-09-08
يمكن الآن لمحوّلات التوسّط للإعلانات المدمجة مع المحتوى تنفيذ NativeAdMapper.destroy()
لتلقّي إشعار عند إيقاف عرض إعلان مدمج مع المحتوى.
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
23.4.0
2024-09-30
تؤدي حالات تعذُّر تحميل الإعلانات الآن إلى ظهور رسالة logcat تقول ad failed
to load في تتبُّع تسلسل استدعاء الدوال البرمجية لحالة التعذُّر. يسجّل تتبُّع تسلسل استدعاء الدوال البرمجية هذه الرسالة كخطأ، ولكنّه لا يشير إلى حدوث تعطُّل. راجِع تصحيح أخطاء رسائل تسجيل الأخطاء الشائعة
لتفسير حالات تعذُّر تحميل الإعلانات الشائعة. إذا ظهر لك خطأ متكرّر مرتبط بعرض الإعلانات وغير موثّق، شارِك تتبُّع تسلسل استدعاء الدوال البرمجية مع Google Mobile Ads SDK (Legacy) فريق الدعم.
تم تعديل الاعتمادية على حزمة User Messaging Platform SDK إلى الإصدار 3.0.0.
23.2.0
27-06-2024
تمت إضافة AdView.isCollapsible()
للإشارة إلى ما إذا كان آخر بانر تم تحميله قابلاً للتصغير.
23.1.0
2024-05-09
يجب أن يكون الحد الأدنى compileSdkVersion هو 34.
محوّلات "التوسّط" الأصلية: تم إيقاف loadNativeAd
وloadRtbNativeAd() نهائيًا واستبدالهما بـ loadNativeAdMapper() وloadRtbNativeAdMapper().
يجب نقل بيانات أدوات الربط إلى استخدام طرق التحميل الجديدة هذه والعناصر ذات الصلة.
23.0.0
2024‑03‑07
التغييرات التي قد تؤدي إلى أعطال:
تمت زيادة الحد الأدنى لمستوى واجهة برمجة تطبيقات Android إلى 21.
لمواصلة جمع مقاييس سلوك المستخدمين في AdMob،
عليك ربط تطبيق يستخدم AdMob بمنصة Firebase ودمج حزمة تطوير البرامج (SDK) الخاصة بخدمة "إحصاءات Google لبرنامج Firebase" في تطبيقك.
تمت إزالة واجهة برمجة التطبيقات MobileAds.enableSameAppKey() المتوقّفة نهائيًا
وتم تعديل الطريقة البديلة MobileAds.putPublisherFirstPartyIdEnabled()
لعرض قيمة منطقية تحدّد ما إذا كان استمرار عنصر التحكّم ناجحًا أم لا.
Native Ads:
تمت إزالة AdLoader.forUnifiedNativeAd(). يُرجى استخدام
AdLoader.forNativeAd() بدلاً من ذلك.
تمت إزالة AdLoader.forCustomTemplateAd(). يُرجى استخدام
AdLoader.forCustomFormatAd() بدلاً من ذلك.
تمت إزالة AdFormat.UNKNOWN بدون استبدالها. يجب أن تمرِّر التطبيقات التي تستخدم
QueryInfo.generate()
شكل إعلان.
يمكن الآن ربط طرق AdManagerAdRequest.Builder الموروثة من العنصر الرئيسي معًا لإنشاء عنصر من مكالمة واحدة.
وقد تطلّب ذلك تغييرًا في بنية الوراثة بحيث لم يعُد النوع AdManagerAdRequest.Builder يرث من النوع AdRequest.Builder.
التوسّط: تم تغيير قيمة العائد لكل من
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
التي تم طلبها من خلال واجهة مستخدم "أداة فحص الإعلانات".
سيؤدي ضبط Google Mobile Ads SDK (Legacy) إلى إيقاف إرسال معرّف 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
تمت إضافة إمكانية استخدام أجهزة Android 12 للتطبيقات التي تستهدف المستوى 31 من واجهة برمجة التطبيقات.
تمت إضافة إمكانية استخدام
معرّف مجموعة التطبيقات
لحالات الاستخدام مثل إعداد التقارير ومنع الاحتيال.
20.4.0
22-09-2021
اعتبارًا من الإصدار 20.4.0، تتضمّن Google Mobile Ads SDK (Legacy) الإذن 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 على الأجهزة الجوّالة.
تمت إضافة إمكانية استخدام أجهزة Android 11 للتطبيقات التي تستهدف المستوى 30 لواجهة برمجة التطبيقات.
الإعلانات على شاشة فتح التطبيق: تم تغيير شكل الإعلان 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()، بالإضافة إلى قيمة NonNull AdError.getCause() تمثّل خطأ التوسّط الأساسي.
19.2.0
2020‑06‑18
الإعلانات المدمجة مع المحتوى: تمت إضافة واجهة مستخدم "أداة التحقّق من الإعلانات المدمجة مع المحتوى" إلى طلبات الاختبار لمساعدتك في رصد انتهاكات سياسات الإعلانات المدمجة مع المحتوى وإصلاحها.
تمّت إضافة واجهات برمجة تطبيقات لشكل الإعلان InstreamAd. تتوفّر هذه الميزة في إصدار تجريبي خاص. يُرجى التواصل مع مدير حسابك لطلب الإذن بالوصول.
إعلان البانر التكيُّفي: تم تغيير طرق إنشاء إعلانات البانر التكيُّفية في فئة
AdSize. على سبيل المثال، تم تغيير اسم AdSize.getCurrentOrientationBannerAdSizeWithWidth() إلى AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize().
التوسّط: يرصد Google Mobile Ads SDK (Legacy) الآن الاستثناءات التي تطرحها برامج التوسّط.
التوسّط لعرض الإعلانات مقابل مكافأة: تم إصلاح خطأ كان يؤدي إلى عدم عرض سوى إعلان واحد مقابل مكافأة إذا تم تخزين عدّة إعلانات من هذا النوع في ذاكرة التخزين المؤقت.
تمت إضافة الطريقة setTestDeviceIds() لتفعيل إعداد
الأجهزة الاختبارية مرة واحدة لجميع طلبات الإعلانات.
18.2.0
29-08-2019
تمت إضافة واجهات برمجة تطبيقات للتنسيق
AppOpenAd. تتوفّر هذه الميزة في إصدار تجريبي خاص.
يُرجى التواصل مع مدير حسابك لطلب الإذن بالوصول.
التوسّط: يتم الآن رصد الأخطاء الاستثنائية للمحوّل التي تتضمّن تقارير تتبُّع تسلسل استدعاء الدوال البرمجية Google Mobile Ads SDK (Legacy) ومعالجتها من خلال Google Mobile Ads SDK (Legacy).
الإعلانات المدمجة مع المحتوى: بالنسبة إلى الإعلانات غير الفيديو، يمكن الآن ضبط نوع مقياس الصورة في MediaView باستخدام MediaView.setImageScaleType().
الإعلانات المدمجة مع المحتوى: تمت إضافة UnifiedNativeAd.getMediaContent().
يمكن للناشرين الذين يحمّلون الصور باستخدام عناوين URL فقط الحصول الآن على محتوى الوسائط الخاص بالإعلان، وتوفير صورة له، واستدعاء MediaView.setMediaContent() لتعبئة بيانات الصورة
من خلال MediaView للإعلانات غير الفيديو.
الإعلانات المدمجة مع المحتوى: تمت إضافة واجهات برمجة تطبيقات لإتاحة ميزة "القياس المفتوح" لأشكال الإعلانات المدمجة مع المحتوى المخصّصة غير المرتبطة بالفيديو.
تمت إزالة الفئة Correlator وواجهات برمجة التطبيقات المرتبطة بها.
كانت هذه الميزة غير صالحة للاستخدام في السابق.
تمت إضافة تبعيات على play-services-measurement وplay-services-measurement-sdk. لم يعُد على التطبيقات إضافة هذه التبعيات بشكل صريح.
18.0.0
2019‑06‑17
الانتقال من مكتبات Android Support Libraries إلى مكتبات 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
تم إصلاح الخطأ الذي كان يؤدي إلى ظهور خطأ في برنامج التجميع duplicate entry عند استخدام بعض التركيبات من play-services-ads وfirebase-analytics (مثل ads:17.1.0 وanalytics:16.0.5).
على الناشرين الذين يستخدمون 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
الإصدار التجريبي من MRAID v3
الإعلانات المدمجة مع المحتوى: تمت إضافة 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، تتوفّر Google Mobile Ads SDK (Legacy) من خلال مستودع 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) والإصدارات الأحدث الحد الأدنى من مستوى واجهة برمجة التطبيقات 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
24-10-2016
تمت إعادة تفعيل MobileAds.Initialize(Context).
على الناشرين الذين يستخدمون "مدير إعلانات Google" استدعاء هذه الطريقة عند بدء تشغيل تطبيقاتهم. على ناشري AdMob مواصلة استخدام
MobileAds.Initialize(Context, String) وتمرير الرمز البرمجي للتطبيق.
9.6.0
22-09-2016
تمت إضافة الفئة MediaView لإعلانات الفيديو المتقدّمة من "الإعلانات المدمجة مع المحتوى".
تمت إضافة طريقة openDebugMenu() إلى الفئة
MobileAds لمعاينة المواد الإبداعية وتحديد المشاكل وحلّها في الوحدات الإعلانية على "مدير إعلانات Google".
تمّت إضافة إمكانية استخدام أحداث مخصّصة للفيديوهات مقابل مكافأة.
تم تحسين تشغيل إعلانات الفيديو من خلال إصلاح العديد من الأخطاء.
9.0.1
2016‑05‑26
يحلّ هذا الإصدار مشكلة في ProGuard تم طرحها في الإصدار 9.0.0.
لم يعُد الناشرون بحاجة إلى خيار keep من أجل com.google.android.gms.common.util.DynamiteApi.
9.0.0
2016‑05‑18
تمت إضافة ميزة التعبئة التلقائية لمعلومات الموقع الجغرافي
للتطبيقات التي تمنح إذن تحديد الموقع الجغرافي بشكل صريح.
تمّت إضافة إمكانية استخدام أحداث مخصّصة في التوسّط للإعلانات مقابل مكافأة.
تمت إضافة خيارات فيديوهات لـ "الإعلانات المدمجة السريعة".
تم تعديل واجهة برمجة التطبيقات لإعلانات البحث المخصّص.
بالنسبة إلى هذا الإصدار فقط، على التطبيقات التي تستخدم ProGuard للمعالجة اللاحقة لتطبيقها
إضافة الخيار keep التالي إلى ملف إعدادات ProGuard:
-keep public @com.google.android.gms.common.util.DynamiteApi class * { *; }
8.4.0
2015‑12‑18
تمت إضافة طريقة عامة،
MobileAds.setAppVolume()،
لإبلاغ Google Mobile Ads SDK (Legacy) بمستوى الصوت الحالي للتطبيق.
تم إصلاح الأخطاء وإجراء تحسينات.
8.3.0
2015‑11‑6
تمت إضافة دعم "إعلانات الفيديو مقابل مكافأة".
تمت إضافة طريقة isLoading() إلى PublisherAdView وPublisherInterstitialAd للتحقّق مما إذا كان طلب عرض الإعلان قيد التقدّم.
تمت إضافة الطريقة setIsDesignedForFamilies() إلى
AdRequest.Builder
وPublisherAdRequest.Builder.
تمّت إضافة طريقة destroy() إلى NativeAdView.
8.1.0
2015‑09‑24
إصلاحات أخطاء متنوّعة.
7.8.0
2015‑08‑13
إصدار MRAID v2 الرسمي
تمت إضافة طريقة isLoading() إلى
AdLoader وAdView وInterstitialAd
للتحقّق مما إذا كان طلب عرض الإعلان قيد التنفيذ.
تم إيقاف PublisherAdRequest.Builder#setManualImpressionsEnabled() نهائيًا.
يمكنك استخدام PublisherAdView#setManualImpressionsEnabled() كبديل.
7.5.0
28-05-2015
تمّت إضافة إمكانية استخدام أشكال الإعلانات المُدمَجة مع المحتوى وإعلانات تثبيت التطبيقات في كلّ من AdMob و"مدير إعلانات Google".
تمّت إضافة إمكانية استخدام أشكال "الإعلانات المدمجة مع المحتوى" المخصّصة، وهي متاحة للحجوزات في "إدارة إعلانات Google".
7.3.0
28-04-2015
إصلاحات أخطاء متنوّعة.
7.0.0
2015‑03‑19
تمت إضافة الطريقتَين addCustomTargeting() وaddCategoryExclusion() إلى PublisherAdRequest.Builder.
تم إصلاح مشكلة كانت تؤدي إلى تسجيل مرات ظهور متعدّدة في PublisherAdView.recordManualImpression()
في "مدير إعلانات Google" عند استخدام طريقة احتساب مرات الظهور يدويًا.
تمت إضافة طريقة setRequestAgent() إلى AdRequest.Builder وPublisherAdRequest.Builder.
يجب استخدام هذا الإجراء للإشارة إلى مصادر طلبات عرض الإعلانات من الجهات الخارجية التي تتوسط في Google Mobile Ads SDK (Legacy).
6.5.87
2014‑12‑08
تم تقديم بنية JAR المقسّمة، ما يتيح لمطوّري Android Studio تضمين جزء الإعلانات فقط من "خدمات 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
للحصول على اسم فئة وسيط شبكة الإعلانات الذي يعرض إعلانًا.
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
تمت إضافة إمكانية استخدام "مدير إعلانات Google" و"إعلانات شبكة البحث للتطبيقات على الأجهزة الجوّالة".
تتضمّن AdRequest.Builder الآن طريقة setLocation().
تم إصلاح عُطل حدث عند طلب إعلان بيني بدون تحديد AdActivity في ملف البيان.
4.0
2013‑10‑31
أصبحت واجهات برمجة التطبيقات الخاصة بـ "إعلانات Google على الأجهزة الجوّالة" الآن جزءًا من خدمات Google Play.
يتم تلقائيًا إرسال التحديثات المستقبلية لواجهات برمجة التطبيقات الخاصة بـ "إعلانات Google على الأجهزة الجوّالة" إلى الأجهزة من خلال "خدمات Google Play".
لا تتوفّر بعد "إدارة إعلانات Google" و"الإعلانات على شبكة البحث لتطبيقات الأجهزة الجوّالة".
تاريخ التعديل الأخير: 2026-09-26 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2026-09-26 (حسب التوقيت العالمي المتفَّق عليه)"],[],["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"]]