تؤدي حالات تعذُّر تحميل الإعلانات الآن إلى عرض رسالة logcat تعرض ad failed
to load في تتبع تسلسل استدعاء الدوال البرمجية للتعذُّر. يسجل تتبع تسلسل استدعاء الدوال البرمجية هذا
على أنها خطأ، ولكنها لا تشير ضمنًا إلى تعطُّل. راجِع تصحيح أخطاء رسائل تسجيل الأخطاء الشائعة.
لتفسير الأعطال الشائعة في تحميل الإعلانات إذا واجهت خطأ متكرّرًا
يتعلّق بعرض الإعلانات غير المُوثَّق، شارِك تسلسل استدعاء الدوالّ مع
فريق دعم حزمة SDK لعرض الإعلانات على الأجهزة الجوّالة.
تم تعديل اعتمادية SDK لمنصة User Messaging Platform إلى الإصدار 3.0.0.
23.2.0
2024‑06‑27
تاريخ الإضافة: AdView.isCollapsible()
للإشارة إلى ما إذا كان آخر إعلان بانر تم تحميله قابلاً للتصغير.
23.1.0
2024‑05‑09
يجب أن يتضمّن compileSdkVersion 34 حرفًا على الأقل.
محوِّلات التوسّط المدمجة: تم إيقاف loadNativeAd
وloadRtbNativeAd() نهائيًا واستبدالهما بloadNativeAdMapper() وloadRtbNativeAdMapper().
بدء استخدام المهايئات في استخدام طرق التحميل الجديدة هذه
الأخرى.
23.0.0
7 آذار (مارس) 2024
التغييرات التي قد تؤدي إلى حدوث أعطال:
زيادة الحد الأدنى لمستوى واجهة برمجة تطبيقات Android إلى 21
لمواصلة جمع مقاييس سلوك المستخدِمين في AdMob، عليك اتّباع الخطوات التالية:
وربط تطبيقك على AdMob بمنصّة Firebase ودمج "إحصاءات Google"
حزمة تطوير البرامج (SDK) لمنصّة 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) لطلب الإعلانات وعرضها
تم طلبها من خلال واجهة مستخدم "أداة فحص الإعلانات".
تمت إضافة getResponseExtras() إلى
ResponseInfo
ما قد يؤدي إلى عرض معلومات إضافية عن استجابة الإعلان.
21.0.0
25 أيار (مايو) 2022
التغييرات التي قد تؤدي إلى أعطال:
تتطلب حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" الآن أن تكون جميع التطبيقات على حدّ أدنى
المستوى 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
تمت إضافة إمكانية استخدام الأجهزة التي تعمل بنظام التشغيل Android 12 للتطبيقات التي تستهدف المستوى 31 من واجهة برمجة التطبيقات.
تمت إضافة ميزة استخدام
معرّف مجموعة التطبيقات
في حالات الاستخدام، مثل إعداد التقارير ومنع الاحتيال.
20.4.0
2021-09-22
بدءًا من الإصدار 20.4.0، تتضمّن حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" الإذن
com.google.android.gms.permission.AD_ID في
بيان حزمة SDK الذي يتم دمجه تلقائيًا في بيان التطبيق من خلال
"أدوات إنشاء Android". لمزيد من المعلومات عن بيان الإذن AD_ID
، بما في ذلك كيفية إيقافه، يمكنك الرجوع إلى
مقالة مركز مساعدة Play Console هذه.
تمت إضافة onAdClicked()
معاودة الاتصال إلى FullScreenContentCallback.
تم تفعيل callback
onAdClicked()
في فئة AdListener لشكل الإعلان المدمج مع المحتوى.
تمت إضافة طلب معاودة الاتصال onAdImpression() إلى
FullScreenContentCallback.
تم إيقاف تنسيق InstreamAd نهائيًا.
محوِّلات التوسّط:
تم إيقاف MediationBannerAdapterMediationInterstitialAdapterMediationNativeAdapter نهائيًا. يجب أن تُنفِّذ المحوِّلات الجديدة فئة
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()
وAdError.getCause() غير الفارغة التي تمثّل خطأ المعالجة برمجيًا الأساسي.
19.2.0
18 حزيران (يونيو) 2020
الإعلانات المدمجة مع المحتوى: تمت إضافة واجهة مستخدم أداة التحقق من الإعلانات المدمجة مع المحتوى عند الاختبار
لمساعدتك في اكتشاف انتهاكات سياسات الإعلانات المدمجة مع المحتوى وإصلاحها.
تمت إضافة واجهات برمجة تطبيقات لشكل الإعلان InstreamAd. تتوفّر هذه الميزة حاليًا في
إصدار تجريبي خاص. يُرجى التواصل مع مدير حسابك لطلب إذن الوصول.
إعلان البانر التكيُّفي: تم تغيير طرق إنشاء إعلانات البانر التكيُّفية في فئة
AdSize
على سبيل المثال، تمت إعادة تسمية AdSize.getCurrentOrientationBannerAdSizeWithWidth()
إلى AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize().
التوسّط: ترصد الآن "حزمة SDK لإعلانات Google على الأجهزة الجوّالة" استثناءات
يتمّ طرحها من خلال محوِّلات التوسّط.
التوسّط للإعلانات التي تضم مكافآت: تمّ إصلاح خطأ كان يؤدي إلى عرض إعلان واحد فقط في حال تخزين إعلانات متعددة تضم مكافآت ومتوسطة
في ذاكرة التخزين المؤقت.
تمت إضافة طريقة setTestDeviceIds() لتفعيل إعداد
الأجهزة الاختبارية مرة واحدة لجميع طلبات الإعلانات.
18.2.0
2019‑08‑29
تمّت إضافة واجهات برمجة تطبيقات لتنسيق
AppOpenAd. هذه الميزة متوفرة حاليًا.
إصدار تجريبي خاص. يُرجى التواصل مع مدير حسابك لطلب إذن الوصول.
التوسّط: استثناءات المحوّل التي تتضمّن عمليات تتبُّع تسلسل استدعاء الدوال البرمجية
يتم الآن اكتشاف حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" ومعالجتها من خلال
SDK لإعلانات Google على الأجهزة الجوّالة.
الإعلانات المدمجة مع المحتوى: بالنسبة إلى الإعلانات غير الفيديو، نوع مقياس الصورة في MediaView
يمكن الآن ضبطها باستخدام MediaView.setImageScaleType()
الإعلانات المدمجة مع المحتوى: تمت إضافة UnifiedNativeAd.getMediaContent().
يمكن الآن للناشرين الذين يحمّلون الصور عبر عناوين URL الحصول على وسائط الإعلان
المحتوى وتقديم صورة له ثم الاتصال
MediaView.setMediaContent() لتعبئة بيانات الصور
حتى MediaView للإعلانات التي لا تتضمّن فيديو
الإعلانات المدمجة مع المحتوى: تمت إضافة واجهات برمجة تطبيقات لتفعيل ميزة "القياس المفتوح" لأشكال الإعلانات المدمجة مع المحتوى المخصّصة غير المزوّدة بفيديو.
إصلاح خطأ ANR الذي نشأ في
android.media.AudioManager.getStreamVolume
17.2.0
2019‑03‑11
إعلانات الفيديو التي تضم مكافآت: تمت إضافة مجموعة جديدة من واجهات برمجة التطبيقات لإعلانات الفيديو التي تضم مكافآت (اطّلِع على حزمة
rewarded
التي تتيح لك تحميل إعلانات متعددة تضم مكافآت في الوقت نفسه).
التوسّط: تمت إضافة مجموعة جديدة من واجهات برمجة التطبيقات لمهايئات التوسّط التي تتوافق مع
التهيئة. إنّ محوِّلات البيانات التي تستخدم واجهة برمجة التطبيقات الجديدة تستخدم فئة
Adapter.
الناشرون الذين يستخدمون firebase-analytics مع الإصدار
17.2.0 من أي من مكتبة الإعلانات
(مثال: com.google.android.gms:play-services-ads:17.2.0)
يجب أن يستخدم com.google.firebase:firebase-analytics:16.3.0.
17.1.3
31/1/2019
الناشرون الذين يستخدمون firebase-analytics مع الإصدار
17.1.3 من أي من مكتبة الإعلانات
(مثال: com.google.android.gms:play-services-ads:17.1.3)
يجب أن يستخدم com.google.firebase:firebase-analytics:16.3.0.
17.1.2
2018-12-03
الناشرون الذين يستخدِمون firebase-analytics مع الإصدار
17.1.2 من أيّ من مكتبة الإعلانات
(مثل com.google.android.gms:play-services-ads:17.1.2)
يجب استخدام com.google.firebase:firebase-analytics:16.0.6.
17.1.1
2018‑11‑12
تم إصلاح الخطأ الذي تسبَّب في حالات مجموعات معيّنة من play-services-adsfirebase-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.
على ناشري Ad Manager 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 3
الإعلانات المدمجة مع المحتوى: تمت إضافة Unified Native Ad API. يؤدي ذلك إلى دمج نوعَي المحتوى
NativeAppInstallAds وNativeContentAds في نوع
جديد واحد: UnifiedNativeAd.
ملاحظة: عند استخدام الإعلانات المدمجة مع المحتوى، يظهر تحذير غير ضار في السجلّات عند النقر على الإعلان المدمج مع المحتوى:
"يجب ألا يكون UnconfirmedClickListener فارغًا أثناء ضبط ClickConfirmingView." يمكن تجاهل هذا التحذير، وسيتم إزالته في الإصدار التالي.
12.0.1
28 آذار (مارس) 2018
ما مِن تغييرات في الإعلانات. اطّلِع على ملاحظات الإصدار
لخدمات 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
2016/9/22
تمت إضافة MediaView لإعلانات الفيديو (المتقدّمة) للإعلانات المدمجة مع المحتوى.
تمت إضافة openDebugMenu() إلى
MobileAds لمعاينة تصميم الإعلان
تحديد المشاكل وحلّها في الوحدات الإعلانية على "مدير إعلانات Google"
تمت إضافة دعم للأحداث المخصّصة للفيديو الذي يضم مكافأة.
في هذا الإصدار فقط، على التطبيقات التي تستخدم 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.
تمت إضافة setRequestAgent()
إلى AdRequest.Builder
وPublisherAdRequest.Builder.
يجب استخدام هذه الطريقة للإشارة إلى مصادر طلبات الإعلانات التي تقدّمها جهات خارجية تتوسّط في إرسالها إلى حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
6.5.87
2014-12-08
تمّت إتاحة بنية JAR المجزّأة: يمكن لمطوّري "استوديو Android" الآن
تضمين جزء الإعلانات من "خدمات Google Play" فقط من خلال الاعتماد على
com.google.android.gms:play‑services‑ads:6.+.
ملاحظة: على التطبيقات التي تنشئ إعلانات بانر بتنسيق XML أن تشير إلى
المكتبة بأكملها com.google.android.gms:play‑services:6.+.
إصلاحات أخطاء متنوّعة.
6.1
2014-10-08
تمت إضافة طريقة getLocation() إلى
com.google.android.gms.ads.MediationAdRequest.
تمت إضافة وصف المحتوى إلى زر الإغلاق البيني لـ
سهولة الوصول.
تمت إزالة تسجيل الرسالة "لم يتم العثور على موارد Google Play". عندما تصل المكتبة
مشروعك بشكل صحيح.
تمّت إضافة getMediationAdapterClassName() إلى AdView.
للحصول على اسم فئة مهايئ توسط شبكة الإعلانات الذي يعرض إعلانًا في الوقت الحالي.
5.0
2014‑06‑25
تمت إضافة واجهات برمجة تطبيقات جديدة لتنفيذ الأحداث المخصّصة.
تمت إضافة مسار الشراء التلقائي لعملية الشراء داخل التطبيق، وذلك باستخدام Google Play Billing API.
4.4
2014‑05‑07
تمت إضافة واجهات برمجة تطبيقات جديدة لمهايئ التوسّط.
تمت إضافة شكل إعلان LARGE_BANNER الجديد مقاس 320x100 لكلا الهاتفين
والأجهزة اللوحية.
تمت إضافة تنسيق بيني جديد للشراء داخل التطبيق. اضبط
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".
لا يتوفر "مدير الإعلانات" و"الإعلانات على شبكة البحث" لتطبيقات الأجهزة الجوّالة حتى الآن.
تاريخ التعديل الأخير: 2024-10-18 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-10-18 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Google Ad Manager Android SDK updates prioritize enhancing ad performance, developer experience, and user privacy, while adapting to Android platform changes."],["Major 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."],["The SDK has evolved to deprecate older APIs and introduce new functionalities, like improved ad load failure logging, adaptive banners, and privacy-preserving API testing."],["Updates 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."],["Developers should consult the detailed release notes for specific version changes and migration instructions to ensure seamless integration and optimal ad performance."]]],[]]