تسببت تعذُّر تحميل الإعلانات الآن في ظهور رسالة 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
تمت إزالة واجهة برمجة تطبيقات 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
يجب إدخال رقم تعريف تطبيق "مدير الإعلانات" الآن لجميع تطبيقات "مدير الإعلانات"
يجب استخدام التنسيق ca-app-pub-################~##########. راجِع ضبط التطبيق.
لمزيد من التفاصيل.
أداة فحص الإعلانات: توسيع نطاق توافق حِزم تطوير البرامج (SDK) لعرض إعلانات البانر و
الإعلانات المدمجة مع المحتوى التي يتم طلبها من خلال واجهة مستخدم أداة فحص الإعلانات
تمت إضافة إمكانية استخدام معرّف الطرف الأول للناشر (المعروف سابقًا باسم
مفتاح التطبيق نفسه) لمساعدتك في عرض إعلانات أكثر صلةً وتخصيصًا باستخدام
البيانات التي يتم جمعها من تطبيقاتك.
إصدار الإصدار الرسمي لجيل QueryInfo
21.3.0
2022-10-10
أداة فحص الإعلانات: تمت إضافة ميزة حزمة تطوير البرامج (SDK) لطلب الإعلانات وعرضها
التي يتم طلبها من خلال واجهة مستخدم أداة فحص الإعلانات.
تمت إضافة getResponseExtras() إلى
ResponseInfo
ما قد يؤدي إلى عرض معلومات إضافية عن استجابة الإعلان.
21.0.0
2022‑05‑25
التغييرات التي قد تؤدي إلى أعطال:
تتطلب حزمة "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.
تم تفعيل
onAdClicked()
في الفئة AdListener لشكل الإعلان المدمج مع المحتوى.
تمت إضافة طلب معاودة الاتصال onAdImpression() إلى
FullScreenContentCallback.
إيقاف تنسيق InstreamAd نهائيًا
مهايئات التوسّط:
تم إيقاف العمل بها في MediationBannerAdapter،
MediationInterstitialAdapter و
MediationNativeAdapter يجب تنفيذ المحوّلات الجديدة
Adapter الصف
لتحميل هذه التنسيقات.
يمكن الآن لمحوّلات عروض الأسعار تنفيذ طرق تحميل مختلفة في
Adapter صف
التنسيقات الخاصة بعرض الأسعار في الوقت الفعلي (RTB).
19.7.0
2021-01-20
التغييرات الرئيسية في:
InterstitialAd
RewardedAd
NativeAd
AppOpenAd
تم إيقاف العمل بها في CustomRenderedAd.
تم
إيقاف الفصول والحِزم التي تحتوي على البادئة Publisher نهائيًا واستبدالها بالبادئة AdManager.
آخر إصدار ثانوي قبل الإصدار 20.0.0 جميع واجهات برمجة التطبيقات التي تم وضع علامة متوقّفة عليها
في هذا الإصدار والإصدارات السابقة لها في الإصدار 20.0.0. اطّلِع على دليل نقل البيانات في الإصدار 20.0.0
للحصول على مزيد من التفاصيل.
19.6.0
2020-12-04
تم إيقاف onAdLeftApplication() AdListener
.
تم إصلاح خطأ كان يطلب من المستخدمين على أجهزة Android 11 اختيار
متصفّح عند النقر على إعلان.
19.5.0
2020-10-20
إعلانات البانر: يتم الآن استدعاء الطريقة onAdImpression()
AdListener لإعلانات البانر.
تمت إضافة setHttpTimeoutMillis()
لتخصيص مهلة مكالمات HTTPS التي يتم إجراؤها بواسطة تطبيق Google Mobile
حزمة تطوير البرامج (SDK) لعرض الإعلانات
تمت إضافة الدعم لأجهزة 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
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/3/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.
على ناشري 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 التجريبي.
الإعلانات المدمجة مع المحتوى: تمت إضافة Unified Native Ad API. يجمع هذا بين
NativeAppInstallAds وNativeContentAds في واحدة جديدة
النوع: UnifiedNativeAd.
ملاحظة: عند استخدام الإعلانات المدمجة مع المحتوى، هناك تحذير خطير
في السجلات عند النقر على الإعلان المدمج مع المحتوى:
"يجب ألا يكون UnconfirmedClickListener فارغًا بينما يكون ClickConfirmingView
البيانات المطلوبة." يمكن تجاهل هذا التحذير، وستتم إزالته في غضون
.
12.0.1
2018‑03‑28
ما مِن تغييرات في الإعلانات. اطّلِع على ملاحظات الإصدار
لخدمات Google Play للحصول على مزيد من التفاصيل.
12.0.0
2018/3/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/9/19
تمت إضافة طرق getMediationAdapterClassName() إلى فئتَي
NativeAppInstallAd وNativeContentAd. تشير رسالة الأشكال البيانية
طريقة واحدة تحمل الاسم نفسه في AdLoader
سيتم إيقافها.
تمت إضافة طريقة loadAd() جديدة تستخدم PublisherAdRequest.
في الفئة RewardedVideoAd.
11.2.0
2017/8/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
7 حزيران (يونيو) 2017
تمت إضافة الطريقتَين 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/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 لعرض الإعلانات على الأجهزة الجوّالة بمستوى الصوت الحالي للتطبيق.
تم تنفيذ إصلاحات للأخطاء وإجراء تحسينات.
8.3.0
2015-11-6
تمت إضافة دعم لإعلانات الفيديو التي تضم مكافأة.
تمت إضافة طريقة isLoading() إلى PublisherAdView.
وPublisherInterstitialAd للتحقّق من حالة طلب الإعلان
التقدم.
تمت إضافة الطريقة setIsDesignedForFamilies() إلى
AdRequest.Builder
وPublisherAdRequest.Builder.
تم إيقاف العمل بها في PublisherAdRequest.Builder#setManualImpressionsEnabled().
استخدِم PublisherAdView#setManualImpressionsEnabled() بدلاً من ذلك.
7.5.0
2015‑05‑28
تمت إضافة دعم لأشكال الإعلانات المدمجة مع المحتوى لتثبيت التطبيقات والإعلانات المدمَجة مع المحتوى على AdMob و"مدير إعلانات Google".
تمت إضافة إمكانية استخدام أشكال الإعلانات المدمجة مع المحتوى المخصّصة، وهي متاحة للحجوزات في "مدير إعلانات Google".
7.3.0
2015‑04‑28
إصلاحات أخطاء متنوّعة.
7.0.0
2015/3/19
تمت إضافة addCustomTargeting() و
addCategoryExclusion() طريقة من أجل
PublisherAdRequest.Builder
تمّ إصلاح مشكلة كانت تؤدي إلى PublisherAdView.recordManualImpression()
تسجيل مرّات ظهور متعدّدة في "مدير إعلانات Google" عند استخدام احتساب مرّات الظهور يدويًا.
تمت إضافة الطريقة 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
25 حزيران (يونيو) 2014
تمت إضافة واجهات برمجة تطبيقات جديدة لتنفيذ "الأحداث المخصّصة".
تمت إضافة مسار الشراء التلقائي لعملية الشراء داخل التطبيق باستخدام واجهة برمجة التطبيقات 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
تمت إضافة دعم لكل من "مدير الإعلانات" و"الإعلانات على شبكة البحث" لتطبيقات الأجهزة الجوّالة.
يتضمّن AdRequest.Builder الآن طريقة setLocation().
تم إصلاح مشكلة تعطُّل حدثت عند طلب إعلان بيني بدون تحديد
AdActivity في البيان.
4.0
2013‑10‑31
أصبحت واجهات برمجة التطبيقات لإعلانات Google على الأجهزة الجوّالة جزءًا من
خدمات Google Play.
طرح التحديثات المستقبلية لواجهات برمجة تطبيقات إعلانات Google على الأجهزة الجوّالة تلقائيًا إلى
الأجهزة من خلال "خدمات Google Play".
لا يتوفّر "مدير إعلانات Google" و"الإعلانات على شبكة البحث" لتطبيقات الأجهزة الجوّالة بعد.
تاريخ التعديل الأخير: 2024-10-16 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-10-16 (حسب التوقيت العالمي المتفَّق عليه)"],[[["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."]]],[]]