تم تعديل رسائل logcat المتعلّقة بتعذُّر تحميل الإعلانات في الإصدار 23.4.0
من مستوى الخطأ إلى مستوى المعلومات.
تحسين تحقيق الربح من الإعلانات المخصّصة في علامات التبويب المخصّصة لـ WebView
API للإعلانات
23.4.0
30 أيلول (سبتمبر) 2024
تؤدي حالات تعذُّر تحميل الإعلانات الآن إلى عرض رسالة 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 ودمج حِزمة تطوير البرامج (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
31 تشرين الأول (أكتوبر) 2023
الإعلانات على شاشة فتح التطبيق: تم إيقاف طُرق AppOpenAd.load() نهائيًا التي تقبل مَعلمة إدخال الاتجاه، كما أضافت طرقًا جديدة لا تستخدم إدخال الاتجاه. تحدِّد الطرق الجديدة اتجاه
الفيديو في وقت الطلب، ما يتطابق مع سلوك التنسيقات الأخرى
التي تعمل بالعرض الكامل.
التوسّط: تمت إضافة دعم التوسّط للإعلانات على شاشة فتح التطبيق.
إزالة إذن RECEIVE_BOOT_COMPLETED من تبعية
androidx.work:work-runtime إذا كنت تستخدم
إصدارات Gradle أقدم من 7.2.0 وتتطلّب إذنًا لتطبيقك،
قد تحتاج إلى الإفصاح عن الإذن صراحةً في بيان Android.
21.4.0
2022‑12‑14
أصبح معرّف تطبيق "مدير إعلانات Google" مطلوبًا الآن لجميع تطبيقات "مدير إعلانات Google" ويتطلب
استخدام التنسيق ca-app-pub-################~##########. راجِع ضبط تطبيقك
لمعرفة مزيد من التفاصيل.
أداة فحص الإعلانات: توسيع نطاق دعم حزمة تطوير البرامج (SDK) لعرض إعلانات البانر
والإعلانات المدمجة مع المحتوى المطلوبة من خلال واجهة مستخدم أداة فحص الإعلانات
تمت إضافة إمكانية استخدام معرّف الطرف الأول للناشر (المعروف سابقًا باسم
مفتاح التطبيق نفسه) لمساعدتك في عرض إعلانات أكثر صلةً وتخصيصًا باستخدام
البيانات التي يتم جمعها من تطبيقاتك.
إصدار الإصدار الرسمي لجيل QueryInfo
21.3.0
2022‑10‑10
أداة فحص الإعلانات: تمت إضافة ميزة حزمة تطوير البرامج (SDK) لطلب الإعلانات وعرضها
التي يتم طلبها من خلال واجهة مستخدم أداة فحص الإعلانات.
أداة فحص الإعلانات: تمت إضافة ميزة حزمة تطوير البرامج (SDK) لتصدير سجلّات طلبات الإعلانات من خلال
"لوحة المشاركة" في Android.
21.1.0
2022/7/14
تمت إتاحة تحقيق الربح من الإعلانات في WebView. يمكنك الاطّلاع على
دمج واجهة WebView
API للإعلانات للحصول على مزيد من التفاصيل.
تمت إضافة getResponseExtras() إلى
ResponseInfo
ما قد يعرض معلومات إضافية حول استجابة الإعلان.
21.0.0
2022‑05‑25
التغييرات التي قد تؤدي إلى أعطال:
تتطلّب "حزمة SDK لإعلانات Google على الأجهزة الجوّالة" الآن استخدام الإصدار 19 من واجهة برمجة التطبيقات (API) لنظام التشغيل Android كحد أدنى لتشغيل جميع التطبيقات.
تمت إضافة @NonNull تعليقات توضيحية في كل طريقة
لم تحدّد في السابق قيمة عدم السماح بالقيمة الخالية صراحةً.
تمت إزالة طريقة AdRequest.Builder.addNetworkExtras().
استخدِم AdRequest.Builder.addNetworkExtrasBundle()
بدلاً منها.
ستوقِف حزمة "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، ستتضمّن حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إذن
com.google.android.gms.permission.AD_ID في
ملف بيان حزمة SDK الذي يتم دمجه تلقائيًا في بيان التطبيق من خلال
أدوات الإصدار من Android. لمزيد من المعلومات عن بيان الإذن AD_ID
، بما في ذلك كيفية إيقافه، يمكنك الرجوع إلى
مقالة مركز مساعدة Play Console هذه.
تمت إضافة onAdClicked()
معاودة الاتصال إلى FullScreenContentCallback.
تم تفعيل callback
onAdClicked()
في فئة AdListener لشكل الإعلان المدمج مع المحتوى.
تمت إضافة معاودة الاتصال 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()
وAdError.getCause() غير الفارغة التي تمثّل خطأ المعالجة برمجيًا الأساسي.
19.2.0
2020‑06‑18
الإعلانات المدمجة مع المحتوى: تمت إضافة واجهة مستخدم لأداة التحقّق من الإعلانات المدمجة مع المحتوى في طلبات الاختبار
لمساعدتك في رصد مخالفات السياسة المتعلّقة بالإعلانات المدمجة مع المحتوى وإصلاحها.
تمت إضافة واجهات برمجة تطبيقات لشكل الإعلان InstreamAd. تتوفّر هذه الميزة حاليًا في
إصدار تجريبي خاص. يُرجى التواصل مع مدير حسابك لطلب إذن الوصول.
إعلان البانر التكيُّفي: تم تغيير طرق إنشاء إعلانات البانر التكيُّفية في
الفئة AdSize. على سبيل المثال، تمت إعادة تسمية AdSize.getCurrentOrientationBannerAdSizeWithWidth()
إلى AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize().
التوسّط: أصبحت حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" ترصد الاستثناءات
الناتجة عن محوّلات التوسّط.
التوسّط للإعلانات التي تضم مكافآت: تمّ إصلاح خطأ كان يؤدي إلى عرض إعلان واحد فقط في حال تخزين إعلانات متعددة تضم مكافآت ومتوسطة
في ذاكرة التخزين المؤقت.
تمت إضافة الطريقة setTestDeviceIds() لتفعيل إعداد
الأجهزة الاختبارية مرة واحدة لجميع طلبات الإعلان.
18.2.0
29 آب (أغسطس) 2019
تمّت إضافة واجهات برمجة تطبيقات لتنسيق
AppOpenAd. تتوفّر هذه الميزة حاليًا
كإصدار تجريبي خاص. يُرجى التواصل مع مدير حسابك لطلب إذن الوصول.
التوسّط: يتم الآن اكتشاف استثناءات المحوّلات التي تتضمّن عمليات تتبُّع تسلسُل استدعاء الدوال البرمجية
حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" والتعامل معها
من خلال حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
الإعلانات المدمجة مع المحتوى: تمت إضافة طريقة NativeAdOptions.Builder.setMediaAspectRatio() لطلب نسبة عرض إلى ارتفاع محدَّدة لمادة عرض الوسائط الخاصة بالإعلانات المدمجة مع المحتوى.
ويكون لهذا الخيار الأولوية على طريقة setImageOrientation() التي تم إيقافها نهائيًا الآن.
الإعلانات المدمجة مع المحتوى: بالنسبة إلى الإعلانات غير الفيديوهات، يمكن الآن ضبط نوع مقياس الصورة في MediaView
باستخدام MediaView.setImageScaleType().
الإعلانات المدمجة مع المحتوى: تمت إضافة UnifiedNativeAd.getMediaContent().
يمكن الآن للناشرين الذين يحمّلون الصور عبر عناوين URL فقط الحصول على محتوى الوسائط للإعلان وتوفير صورة له وطلب
MediaView.setMediaContent() لتعبئة بيانات الصور
من خلال MediaView للإعلانات التي لا تتضمّن فيديو.
الإعلانات المدمجة مع المحتوى: تمت إضافة واجهات برمجة التطبيقات لإتاحة استخدام القياس المفتوح
لأشكال الإعلانات المدمجة مع المحتوى المخصّصة لغير الفيديوهات.
تمت إزالة الفئة Correlator وواجهات برمجة التطبيقات المرتبطة بها.
كانت هذه الميزة غير فعّالة في السابق.
تمت إضافة التبعيات إلى play-services-measurement وplay-services-measurement-sdk. ولم تعُد التطبيقات
تحتاج إلى إضافة هذه التبعيات بشكل صريح.
18.0.0
17 حزيران (يونيو) 2019
نقل البيانات من مكتبات Android Support إلى مكتبات
Jetpack (AndroidX) يُرجى الرجوع إلى
ملاحظات إصدار "خدمات Google Play" للحصول على مزيد من المعلومات.
لتجنُّب حدوث تعطُّل عند إطلاق التطبيق لأول مرّة بعد تثبيت التطبيق من "متجر Play"، يطلب هذا الإصدار من الناشرين الإفصاح عن تبعيات إضافية في
create.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
31/1/2019
الناشرون الذين يستخدمون firebase-analytics مع الإصدار 17.1.3 من أي من مكتبة الإعلانات (مثل com.google.android.gms:play-services-ads:17.1.3)
يجب استخدام com.google.firebase:firebase-analytics:16.3.0.
17.1.2
2018‑12‑03
الناشرون الذين يستخدمون firebase-analytics مع الإصدار 17.1.2 من أي من مكتبة الإعلانات (مثل com.google.android.gms:play-services-ads:17.1.2)
يجب استخدام com.google.firebase:firebase-analytics:16.0.6.
17.1.1
2018‑11‑12
تم إصلاح خطأ كان يتسبب في عدم ظهور تركيبات معيّنة من play-services-ads &
firebase-analytics (مثل ads:17.1.0 وanalytics:16.0.5) أدت إلى خطأ في التجميع duplicate entry.
الناشرون الذين يستخدمون firebase-analytics مع الإصدار 17.1.1 من أي من مكتبة الإعلانات (مثل com.google.android.gms:play-services-ads:17.1.1)
يجب استخدام com.google.firebase:firebase-analytics:16.0.5.
على ناشري 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/4/12
الإصدار 3 من MRAID التجريبي.
الإعلانات المدمجة مع المحتوى: تمت إضافة واجهة برمجة التطبيقات الموحدة للإعلانات المدمجة مع المحتوى. يؤدي هذا إلى الجمع بين
NativeAppInstallAds وNativeContentAds في نوع
جديد واحد: UnifiedNativeAd.
ملاحظة: عند استخدام الإعلانات المدمجة مع المحتوى، هناك تحذير خطير يظهر في السجلات عند النقر على الإعلان المدمج مع المحتوى:
"يجب ألا تكون قيمة UnconfirmedClickListener فارغة عند تعيين ClickConfirmingView." يمكن تجاهل هذا التحذير، وستتم إزالته في الإصدار
التالي.
12.0.1
2018‑03‑28
ما مِن تغييرات في الإعلانات. للحصول على مزيد من التفاصيل، يمكنك الاطّلاع على ملاحظات الإصدار لخدمات Google Play.
12.0.0
2018‑03‑20
إعلان فيديو يضم مكافأة: تمت إضافة طريقة معاودة الاتصال
onRewardedVideoCompleted() إلى RewardedVideoAdListener.
توسط الإعلانات المدمجة مع المحتوى: تمت إضافة الطريقة trackViews() إلى NativeAdMapper، ما يمنح المحوّلات إمكانية الوصول إلى View عناصر تتوافق مع مواد العرض الفردية للإعلانات المدمجة مع المحتوى.
تم إيقاف trackView() لصالح trackViews().
11.8.0
2017-12-18
تم إصلاح الأخطاء وإدخال تحسينات عامة.
11.6.0
2017‑11‑07
تمت إضافة الفئة NativeAdViewHolder والطرق ذات الصلة في
NativeAppInstallAd وNativeContentAd.
تم إيقاف AdLoader.getMediationAdapterClassName نهائيًا (على الناشرين
استخدام الطرق التي تحمل الاسم نفسه في
NativeAppInstallAd وNativeContentAd بدلاً من ذلك).
تعرض الإعلانات الاختبارية الآن تصنيفًا أعلى الإعلان. اطّلِع على دليل الاختبار للحصول على مزيد من التفاصيل.
11.4.0
2017‑09‑19
تمت إضافة getMediationAdapterClassName() طريقة إلى
الصفَّين NativeAppInstallAd وNativeContentAd. سيتم إيقاف AdLoader
باستخدام الأسلوب الذي يحمل الاسم نفسه.
تمت إضافة طريقة 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) أو الإصدارات الأحدث
المستوى 14 من واجهة برمجة تطبيقات Android على الأقل ولا يمكن تثبيتها على الأجهزة
التي تعمل بمستوى واجهة برمجة تطبيقات أقل من 14. لمعرفة المزيد من المعلومات حول الخيارات المتاحة لك،
بما في ذلك إنشاء عدة حِزم APK لتوسيع نطاق دعم تطبيقك لنظام Android Gingerbread، يُرجى الاطّلاع على
مدوّنة مطوّري تطبيقات Android.
تم توفير مواد عرض الفيديو لمحتوى الإعلان المدمج مع المحتوى (المتقدم) وإعلانات النماذج المخصصة.
تمت إضافة الطرق getVideoController()setVideoOptions() وgetVideoOptions()
إلى فئة PublisherAdView.
تمت إضافة الصف AdChoicesView.
تمت إضافة الطريقتَين getAdChoicesContent()
وsetAdChoicesContent() إلى
الفئة NativeAdMapper.
تمت إضافة واجهة InitializableMediationRewardedVideoAdAdapter
لمحوِّلات التوسّط في إعلانات الفيديو التي تضم مكافآت والتي تريد
تفعيل الإعداد المُسبَق قبل تقديم طلب إعلان.
تمت إضافة إمكانية المعاينة داخل التطبيق وتحديد المشاكل وحلّها في "مدير إعلانات Google".
10.0.1
2016-11-21
إصلاح الأخطاء وإجراء تحسينات عامة
9.8.0
2016‑10‑24
تم إلغاء إيقاف MobileAds.Initialize(Context) نهائيًا.
على الناشرين في "مدير إعلانات Google" استدعاء هذه الطريقة عند بدء
تشغيل تطبيقاتهم. على الناشرين في AdMob مواصلة استخدام
MobileAds.Initialize(Context, String) وإرسال
رمز التطبيق.
9.6.0
2016‑09‑22
تمت إضافة الفئة MediaView لإعلانات الفيديو المتقدمة مع المحتوى.
تمت إضافة طريقة openDebugMenu() إلى الفئة
MobileAds لمعاينة المواد الإبداعية
وتحديد مشاكل الوحدات الإعلانية في "مدير إعلانات Google" وحلّها.
تمت إضافة إمكانية استخدام الأحداث المخصّصة للفيديوهات التي تضم مكافآت.
بالنسبة إلى هذا الإصدار فقط، على التطبيقات التي تستخدم 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
تمت إضافة واجهات برمجة تطبيقات جديدة لمحوِّل التوسّط.
تمت إضافة تنسيق إعلان جديد أبعاده 320×100 LARGE_BANNER لكلٍّ من الهواتف
والأجهزة اللوحية.
تمت إضافة تنسيق بيني جديد للشراء داخل التطبيق. يمكنك ضبط
InAppPurchaseListener على InterstitialAd للاستماع
إلى أحداث الشراء داخل التطبيق.
إصلاح خطأ في تطبيق SecurityException بسبب قراءة
gservices بدون إذن
4.3
2014/3/17
تعمل InterstitialAd الآن إذا تم تمرير سياق التطبيق.
تمت إضافة طريقة setContentUrl() إلى PublisherAdRequest.Builder.
أصلِح المشكلة للحصول على استثناء في حال عدم تسجيل الخدمة.
4.2
2014-02-03
إصلاحات أخطاء متنوّعة.
4.1
2014-01-16
تمت إضافة إمكانية استخدام "مدير إعلانات Google" و"الإعلانات على شبكة البحث" للتطبيقات المتوافقة مع الأجهزة الجوّالة.
تمّت إضافة طريقة setLocation() إلى AdRequest.Builder.
تم إصلاح العُطل الذي حدث إذا تم طلب إعلان بيني ولكن
لم يتم تحديد AdActivity في البيان.
4.0
2013‑10‑31
أصبحت واجهات برمجة التطبيقات لإعلانات Google على الأجهزة الجوّالة الآن جزءًا من
خدمات Google Play.
يتم تلقائيًا طرح التحديثات المستقبلية لواجهات برمجة تطبيقات "إعلانات Google للأجهزة الجوّالة" على
الأجهزة من خلال "خدمات Google Play".
لا يتوفّر "مدير إعلانات Google" و"الإعلانات على شبكة البحث" لتطبيقات الأجهزة الجوّالة بعد.
تاريخ التعديل الأخير: 2024-11-12 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-11-12 (حسب التوقيت العالمي المتفَّق عليه)"],[[["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."]]],[]]