ملاحظات الإصدار

الإصدار تاريخ الإصدار ملاحظات
23.4.0 30 أيلول (سبتمبر) 2024
  • تسببت تعذُّر تحميل الإعلانات الآن في ظهور رسالة Logcat تفيد بخطأ ad failed to load في عملية تتبُّع تسلسل استدعاء الدوال البرمجية التي تعذّر تنفيذها. يسجِّل تتبع تسلسل استدعاء الدوال البرمجية هذه الرسالة كخطأ، ولكنّه لا يشير إلى حدوث تعذُّر. راجِع مقالة تصحيح أخطاء تسجيل الأخطاء الشائعة لتفسير حالات تعذُّر تحميل الإعلانات الشائعة. في حال ظهور خطأ متكرّر بالنسبة إلى عرض الإعلانات غير الموثَّق، يُرجى مشاركة تقرير تتبُّع تسلسل استدعاء الدوال البرمجية مع دعم SDK لإعلانات الأجهزة الجوّالة:
  • تمت إضافة addCustomTargeting() طريقة إلى AdRequest.
23.3.0 ‎2024‑08‑12
  • تم تعديل الاعتمادية على حزمة تطوير البرامج (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.
  • تُضيف MobileAds.registerCustomTabsSession()‎ لتحسين تحقيق الربح من الإعلانات في علامات التبويب المخصّصة. اطّلِع على تحسين علامات التبويب المخصّصة للحصول على مزيد من المعلومات.
  • تم تعديل الاعتمادية على حزمة تطوير البرامج (SDK) لمنصة User Messaging Platform إلى الإصدار 2.2.0.
22.6.0 6 حزيران (يونيو) 2023
  • تم إيقاف العمل بـ MobileAds.setSameAppKeyEnabled() وإعادة تسميته الطريقة إلى MobileAds.putPublisherFirstPartyIdEnabled().
  • تم إيقاف AdFormat.UNKNOWN بدون بديل. التطبيقات التي تستخدم QueryInfo.generate() يجب أن تُرسل شكل إعلان.
22.5.0 ‎2023‑10‑30
22.4.0 ‎2023‑09‑13
  • يجب أن يكون الحد الأدنى compileSdkVersion 33.
  • أداة فحص الإعلانات: تمت إضافة ميزة حزمة تطوير البرامج (SDK) لطلب الإعلانات وعرضها التي يتم طلبها من خلال واجهة مستخدم "أداة فحص الإعلانات".
  • تمت إضافة طريقة QueryInfo.generate() جديدة تأخذ رقم تعريف الوحدة الإعلانية.
  • يتيح هذا الخيار الاختبار الأوّلي لواجهات برمجة التطبيقات المخصّصة للحفاظ على الخصوصية في الإصدار التجريبي من Attribution Reporting API والإصدار التجريبي من Topics API. يمكنك الاطّلاع على دليل Ad Manager مبادرة حماية الخصوصية على Android للحصول على مزيد من المعلومات.
22.3.0 ‎2023‑08‑22
  • تم توفير إمكانية إنشاء أحجام تكيُّفية باستخدام AdSize.FULL_WIDTH كعرض. في السابق، كان يتم التعامل مع أحجام الإعلانات التي تم إنشاؤها باستخدام AdSize.FULL_WIDTH على أنّها AdSize.SMART_BANNER.
22.2.0 5 تموز (يوليو) 2023
22.1.0 18 حزيران (يونيو) 2023
  • أداة فحص الإعلانات: تم تفعيل إمكانية بدء طلبات الإعلانات من واجهة مستخدم أداة فحص الإعلانات على الأجهزة التي لا تتضمّن "خدمات Google Play".
22.0.0 29 آذار (مارس) 2023
  • التغييرات التي قد تؤدي إلى حدوث أعطال:
    • تمت إزالة NativeCustomFormatAd.getVideoController() و NativeCustomFormatAd.getVideoMediaView() لصالح NativeCustomFormatAd.getMediaContent()
    • تمت إزالة MobileAds.getVersionString() واستبدالها MobileAds.getVersion().
    • تمت إزالة AdRequest.Builder.setAdInfo() واستبدالها AdRequest.Builder.setAdString().
    • يعرض AdManager.Builder.setAdString() الآن نوع AdRequest.Builder.
    • تمت إزالة MediationRewardedVideoAdAdapter و واجهات برمجة التطبيقات المرتبطة لصالح Adapter.
  • تمت إضافة "AdRequest.getRequestAgent()".
  • التوسّط: تغيّرت القيمة المعروضة لسمة 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) لطلب الإعلانات وعرضها التي يتم طلبها من خلال واجهة مستخدم أداة فحص الإعلانات.
  • الإعلانات المدمجة مع المحتوى:
  • الإعلانات المدمجة مع المحتوى المخصّصة:
21.2.0 ‎2022‑09‑06
  • أداة فحص الإعلانات: تمت إضافة ميزة حزمة تطوير البرامج (SDK) لتصدير سجلّات طلبات الإعلانات من خلال "لوحة المشاركة" في Android.
21.1.0 ‎2022‑07‑14
  • تمت إتاحة تحقيق الربح من الإعلانات في WebView. عرض دمج WebView واجهة برمجة التطبيقات للإعلانات لمزيد من التفاصيل.
  • تمت إضافة getResponseExtras() إلى ResponseInfo ما قد يؤدي إلى عرض معلومات إضافية عن استجابة الإعلان.
21.0.0 ‎2022‑05‑25
  • التغييرات التي قد تؤدي إلى أعطال:
    • تتطلب حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" الآن أن تكون جميع التطبيقات على حدّ أدنى المستوى 19 من واجهة برمجة تطبيقات Android المطلوب تشغيله
    • تمت إضافة تعليقات @NonNull التوضيحية في كل طريقة في السابق لم تحدد قابلية القيم الفارغة بشكل صريح.
    • تمت إزالة الطريقة AdRequest.Builder.addNetworkExtras(). استخدِم AdRequest.Builder.addNetworkExtrasBundle() بدلاً من ذلك.
    • تمت إزالة طرق الموقع الجغرافي التالية:
      • خيار "setLocation()" مفعَّل AdRequest.Builder
      • getLocation() على AdRequest
      • getLocation() بتاريخ MediationAdConfiguration
  • تمت إضافة علامات البيان لتحسين الإعداد وتحميل الإعلانات. يمكنك الاطّلاع على تحسين دليل الإعداد وتحميل الإعلانات لمزيد من التفاصيل.
  • تم إيقاف MobileAds.getVersionString() نهائيًا. استخدام MobileAds.getVersion() بدلاً من ذلك.
  • تمت إضافة getLoadedAdapterResponseInfo() في ResponseInfo
  • تمت إضافة الطرق التالية في AdapterResponseInfo:
    • getAdSourceName()
    • getAdSourceId()
    • getAdSourceInstanceName()
    • getAdSourceInstanceId()
  • تمت إضافة إمكانية استخدام الأحداث المخصّصة في "أداة فحص الإعلانات".
20.6.0 2022-02-22
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 لشكل الإعلان المدمج مع المحتوى.
20.3.0 23 آب (أغسطس) 2021
20.2.0 ‎2021‑06‑08
  • تمت إضافة دعم "أداة فحص الإعلانات" (إصدار تجريبي) لناشري "مدير إعلانات Google".
20.1.0 ‎2021‑04‑29
20.0.0 2021-04-05
  • التغييرات التي قد تؤدي إلى حدوث أعطال:
    • تمت إزالة واجهة برمجة التطبيقات القديمة Interstitial.
    • تمت إزالة واجهة برمجة تطبيقات RewardedVideoAd القديمة.
    • تمت إزالة الصفوف التي تبدأ بـ Publisher. (مثال: PublisherAdView).
    • تمت إزالة CustomRenderedAd.
    • تمت إزالة InstreamAd.
    • تمت إزالة SearchAdRequest.
    • تمت إزالة AdListener.onAdLeftApplication().
    • تمت إزالة NativeAppInstallAd، NativeContentAd وUnifiedNativeAd يتوفّر الآن شكل واحد من أشكال الإعلانات المدمجة مع المحتوى باسم NativeAd.
    • أصبحت RewardedAd الآن فئة مجردة. يمكنك استخدام RewardedAd.load() طريقة ثابتة لتحميل إعلان يضم مكافأة.
  • تم إيقاف AdSize.SMART_BANNER لصالح تكيفي إعلانات البانر
  • تمت إضافة تعليقات توضيحية صريحة تشير إلى إمكانية القيم الفارغة في جميع واجهات برمجة التطبيقات العامة.
19.8.0 15 آذار (مارس) 2021
  • تمت إضافة عنصر يعتمد على حزمة تطوير البرامج (SDK) لمنصّة User Messaging Platform.
  • تمت إضافة طلب معاودة الاتصال 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) لعرض الإعلانات
  • تاريخ الإضافة: setNeighboringContentUrls() وgetNeighboringContentUrls() إلى PublisherAdRequest.
19.4.0 2020-09-10
  • تمت إضافة الدعم لأجهزة Android 11 للتطبيقات التي تستهدف المستوى 30 لواجهة برمجة التطبيقات.
  • الإعلانات على شاشة فتح التطبيق: تم تغيير تنسيق AppOpenAd لتحقيق المزيد من الأداء. مثل تنسيق ملء الشاشة من عرض البانر. تمت الإضافة getResponseInfo() وshow() طريقة لإجراء AppOpenAd صفوف AppOpenAdView وAppOpenAdPresentationCallback المتوقّفة نهائيًا
  • التوسّط: تتوفّر الآن تقارير حالة التوسّط. استخدِم ResponseInfo.getAdapterResponses() للحصول على معلومات الاستجابة لكل شبكة مواقع إعلانية شاركت في طلب إعلان.
  • الإعلانات التي تضم مكافأة القديمة: تم إيقاف العمل بها في RewardedVideoAd.
  • تمت إضافة تنسيق RewardedInterstitialAd، وهو متوفّر حاليًا في إصدار تجريبي خاص.
  • تم إصلاح الخطأ المتمثل في MobileAds.initialize() باستدعاء معالج إكمال معاودة الاتصال مرة واحدة فقط. تؤدي كلّ مكالمة إلى MobileAds.initialize() الآن إلى استدعاء دالة الاستدعاء عند اكتمال العملية.
19.3.0 ‎2020‑07‑20
  • تمت إضافة الطريقتَين getDomain() وgetCause() إلى AdError.
  • تمت إضافة استدعاءات جديدة لتعذُّر التحميل إلى جميع أشكال الإعلانات التي تعرض LoadAdError مثال: onAdFailedToLoad(LoadAdError)
  • وظائف الاستدعاء القديمة المتعلّقة بتعذُّر التحميل والتي تُعرِض عددًا صحيحًا، مثل onAdFailedToLoad(int).
  • الإعلانات التي تضم مكافأة: تمت إضافة onRewardedAdFailedToShow(AdError) وإيقاف onRewardedAdFailedToShow(int) نهائيًا.
  • التوسّط بمكافأة: تمت إضافة MEDIATION_SHOW_ERROR رمز خطأ العرض التقديمي. أمّا الآن، فجميع أخطاء العرض المرتبطة بالإعلانات التي تتمّ معالجتها برمجيًا، فتعرض الآنMEDIATION_SHOW_ERROR بدلاً من AdError.getCode() وAdError.getCause() غير الفارغة التي تمثّل خطأ المعالجة برمجيًا الأساسي.
19.2.0 ‎2020‑06‑18
  • الإعلانات المدمجة مع المحتوى: تمت إضافة واجهة مستخدم أداة التحقق من الإعلانات المدمجة مع المحتوى عند الاختبار لمساعدتك في اكتشاف انتهاكات سياسات الإعلانات المدمجة مع المحتوى وإصلاحها.
  • تمت إضافة MobileAds.disableMediationAdapterInitialization() . يجب استدعاء هذه الطريقة قبل إعداد حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" من أجل إيقاف إعداد محوّل التوسّط.
19.1.0 16 نيسان (أبريل) 2020
19.0.1 ‎2020‑03‑18
  • الإعلانات المدمجة مع المحتوى: تم إصلاح تسرّب الذاكرة الذي حدث عند استخدام NativeCustomTemplateAd.
19.0.0 2 آذار (مارس) 2020
  • تمت إضافة إمكانية قراءة مَعلمات الموافقة من الإصدار 2.0 من إطار الشفافية والموافقة الصادر عن مكتب IAB وسلسلة us_privacy الصادرة عن مكتب IAB.
  • تمت إضافة setNeighboringContentUrls() و من getNeighboringContentUrls() إلى AdRequest.
  • تمت إضافة فئة ResponseInfo التي تقدّم معلومات عن إعلان تم تحميله.
  • بالنسبة إلى جميع أشكال الإعلانات، تم إيقاف getMediationAdapterClassName() نهائيًا. لصالح getResponseInfo().
  • الإعلانات المدمجة مع المحتوى: تمت إضافة الطريقتَين getDuration() و getCurrentTime() إلى MediaContent.
  • التوسّط الأصلي: تمت إضافة طريقتَي getDuration() و getCurrentTime() إلى UnifiedNativeAdMapper ليتمكّن المحوِّلون من تنفيذها.
  • متوقّفة نهائيًا AdRequest.Builder.addTestDevice() استخدِم RequestConfiguration.Builder.setTestDeviceIds() بدلاً من ذلك.
18.3.0 2019-11-05
  • تمت إضافة واجهات برمجة تطبيقات لشكل الإعلان InstreamAd. تتوفّر هذه الميزة حاليًا في إصدار تجريبي خاص. يُرجى التواصل مع مدير حسابك لطلب إذن الوصول.
  • إعلان البانر التكيُّفي: تم تغيير طرق إنشاء إعلانات البانر التكيُّفية في فئة AdSize على سبيل المثال، تمت إعادة تسمية AdSize.getCurrentOrientationBannerAdSizeWithWidth(). إلى AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize().
  • التوسّط: أصبحت حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" تتلقّى الآن الاستثناءات المعروضة من خلال محوّلات التوسّط.
  • التوسّط للإعلانات التي تضم مكافآت: تمّ إصلاح خطأ كان يؤدي إلى عرض إعلان واحد فقط في حال تخزين إعلانات متعددة تضم مكافآت ومتوسطة في ذاكرة التخزين المؤقت.
  • تمت إضافة setTestDeviceIds() لتفعيل الإعداد الأجهزة الاختبارية مرة واحدة لجميع طلبات الإعلان.
18.2.0 ‎2019‑08‑29
  • تمّت إضافة واجهات برمجة تطبيقات لتنسيق AppOpenAd. تتوفّر هذه الميزة حاليًا في إصدار تجريبي خاص. يُرجى التواصل مع مدير حسابك لطلب إذن الوصول.
18.1.1 23 تموز (يوليو) 2019
  • التوسّط: يتم الآن إعداد المحوّلات عند استدعاء التطبيقات MobileAds.initialize(Context, OnInitializationCompleteListener)
  • التوسّط: يتم الآن رصد استثناءات المحوِّل التي تتضمّن عمليات تتبُّع تسلسل استدعاء الدوال البرمجية في "حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة" ومعالجتها من قِبل "حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة".
18.1.0 2019-07-09
  • الإصدار الرسمي لدعم قياس أداء التطبيقات.
  • تمت إضافة طريقة تهيئة جديدة، MobileAds.initialize(Context, OnInitializationCompleteListener), تُعلمك عندما يتم إعداد حزمة SDK لإعلانات Google على الأجهزة الجوّالة وجميع تكون محوّلات التوسّط قد اكتملت عملية الإعداد.
  • تمت إضافة MobileAds.getInitializationStatus() لتوفير حالة الإعداد لجميع شبكات المواقع الإعلانية التي تم ضبطها لتطبيقك.
  • تمت إضافة MobileAds.getRequestConfiguration(). يتم استخدام مَعلمات الاستهداف التي تم ضبطها على عنصر الضبط هذا في جميع طلبات الإعلانات.
  • الإعلانات المدمجة مع المحتوى: تمت إضافة طريقة NativeAdOptions.Builder.setMediaAspectRatio() لطلب نسبة عرض إلى ارتفاع محدَّدة لمادة عرض الوسائط الخاصة بالإعلان المدمج مع المحتوى. يكون لهذا الخيار الأولوية على خيار الإيقاف النهائي setImageOrientation().
  • الإعلانات المدمجة مع المحتوى: بالنسبة إلى الإعلانات غير الفيديو، نوع مقياس الصورة في MediaView يمكن الآن ضبطها باستخدام MediaView.setImageScaleType()
  • الإعلانات المدمجة مع المحتوى: تمت إضافة UnifiedNativeAd.getMediaContent(). يمكن الآن للناشرين الذين يحمّلون الصور عبر عناوين URL فقط الحصول على محتوى وسائط الإعلان وتقديم صورة له واستدعاء MediaView.setMediaContent() لتعبئة بيانات الصورة من خلال MediaView للإعلانات غير المزوّدة بفيديو.
  • الإعلانات المدمجة مع المحتوى: تمت إضافة واجهات برمجة تطبيقات لتفعيل ميزة "القياس المفتوح" لأشكال الإعلانات المدمجة مع المحتوى المخصّصة غير المزوّدة بفيديو.
  • توسّط الإعلانات المدمجة مع المحتوى: يمكن للمحوّلات الآن توفير نسبة العرض إلى الارتفاع من خلال UnifiedNativeAdMapper.setMediaContentAspectRatio()
  • تمت إزالة الفئة Correlator وواجهات برمجة التطبيقات المرتبطة بها. كانت هذه الميزة لا تعمل في السابق.
  • تمت إضافة التبعيات إلى play-services-measurement و play-services-measurement-sdk لم تعُد التطبيقات تحتاج إلى إضافة هذه التبعيات صراحةً.
18.0.0 ‎2019‑06‑17
  • نقل البيانات من مكتبات Android Support إلى مكتبات Jetpack (AndroidX) راجع ملاحظات إصدار "خدمات Google Play" للحصول على مزيد من المعلومات
  • لتجنُّب حدوث عطل عند التشغيل الأول بعد تثبيت التطبيق من "متجر Play"، يتطلّب هذا الإصدار من الناشرين الإفصاح عن تبعيات إضافية في build.gradle:
    com.google.android.gms:play-services-measurement:17.0.0
    com.google.android.gms:play-services-measurement-sdk:17.0.0
17.2.1 2019/05/21
  • حلّ لخطأ 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.
17.1.0 ‎2018‑11‑02
17.0.0 2018-10-05
  • على ناشري Ad Manager Google تحديد علامة <meta-data> مع مفتاح com.google.android.gms.ads.AD_MANAGER_APP في ملف AndroidManifest.xml. يُرجى الرجوع إلى دليل البدء للحصول على مزيد من التفاصيل.
  • الإعلانات المدمجة مع المحتوى: NativeAppInstallAd وNativeContentAd وواجهات برمجة التطبيقات المرتبطة بها، تم إيقافها نهائيًا لصالح UnifiedNativeAd. راجع الإعلانات المدمجة مع المحتوى موحدة متقدمة للحصول على مزيد من التعليمات عن استخدام واجهات برمجة التطبيقات الجديدة.
  • الإعلانات المدمجة مع المحتوى: تمت إضافة "تجاهل هذا الإعلان" الجديدة.
  • الإعلانات المدمجة مع المحتوى: سجلّ التحذير الأساسي: "UnconfirmedClickListener يجب ألا تكون فارغة عند تعيين ClickConfirmingView". تمت إزالة.
  • الإعلانات التي تضم مكافأة: تمت إضافة الطريقة setAdMetadataListener على RewardedVideoAd للاطّلاع على التغييرات في البيانات الوصفية للإعلان.
  • الإعلانات التي تضم مكافأة: سيؤدي استدعاء destroy() إلى إلغاء المستمع.
  • إيقاف الأساليب التالية نهائيًا في AdRequest.Builder
  • تم إصلاح خطأ كان يؤدي إلى عدم بدء 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 سيتم إيقافها.
  • تمت إضافة طريقة onVideoEnd() إلى فئة MediationNativeListener وفئة hasVideoContent() وsetHasVideoContent() و setMediaView() إلى فئة NativeAdMapper، وفئتَي getAdVolume() وisAdMuted() إلى فئة NativeMediationAdRequest لإتاحة التوسّط في الفيديوهات الأصلية.
  • تمت إزالة الصف SearchAdRequest.
11.2.2 ‎2017‑09‑05
  • تمت إضافة طريقة 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. تم أيضًا إزالة فئات الشراء داخل التطبيق ذات الصلة.
  • تمت إضافة الطرق OnVideoMute() OnVideoPause() OnVideoPlay() وOnVideoStart() إلى فئة VideoController.VideoLifecycleCallbacks .
  • تمت إضافة إمكانية تفعيل الوضع الشامل في الإعلانات التي تظهر على ملء الشاشة من خلال إضافة الأسلوب 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".
  • تمت إضافة إمكانية استخدام الأحداث المخصّصة للفيديوهات التي تضم مكافآت.
9.4.0 2016-08-01
  • تم إصلاح الأخطاء وإدخال تحسينات عامة.
9.2.0 ‎2016‑06‑27
  • تمت إضافة طريقة setAdChoicesPlacement() إلى فئة NativeAdOptions.Builder التي يمكن لصنّاع تطبيقات استخدامها الآن لتحديد الموقع لـ AdChoices في الإعلانات المدمجة.
  • تم تحسين تشغيل إعلانات الفيديو من خلال إصلاح العديد من الأخطاء.
9.0.1 ‎2016‑05‑26
  • يحل مشكلة ProGuard التي تم طرحها في الإصدار 9.0.0. لم يعُد الناشرون بحاجة إلى خيار keep لأجل com.google.android.gms.common.util.DynamiteApi.
9.0.0 ‎2016‑05‑18
  • تمت إضافة ميزة ملء معلومات الموقع الجغرافي تلقائيًا للتطبيقات التي تمنح إذن الموقع الجغرافي صراحةً.
  • تمت إضافة دعم للأحداث المخصّصة للتوسّط في إعلانات الفيديو التي تضم مكافأة.
  • تمت إضافة خيارات الفيديو للإعلانات المدمجة مع المحتوى (إكسبرس).
  • تم تحديث واجهة برمجة تطبيقات إعلانات البحث المخصّص.
  • تمّت إضافة طريقة setAppMuted().
  • لم تعد الطريقة MobileAds.initialize(android.content.Context, java.lang.String) متوقفة نهائيًا.
  • تم إيقاف الطريقة MobileAds.initialize(android.content.Context) نهائيًا.
  • تمت إضافة الطريقة MediationNativeListener.onAdImpression() لإعداد تقارير مرّات الظهور في محوِّلات التوسّط.
  • في هذا الإصدار فقط، على التطبيقات التي تستخدم 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.
  • تمت إضافة طريقة destroy() إلى NativeAdView.
8.1.0 2015/9/24 إصلاحات أخطاء متنوّعة.
7.8.0 ‎2015‑08‑13
  • إصدار الإصدار الرسمي من MRAID v2
  • تمت إضافة طريقة isLoading() إلى AdLoader, AdView, وInterstitialAd للتحقّق ممّا إذا كان طلب الإعلان قيد التقدّم
  • تم إيقاف العمل بها في 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" عند استخدام احتساب مرّات الظهور يدويًا.
  • تم إصلاح مشكلة كانت تؤدي إلى عرض الإعلانات بشكلٍ غير صحيح عند استخدام سمة android:largestWidthLimitDp في علامة <supports-screens>.
  • تمت إضافة الطريقة 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" و"الإعلانات على شبكة البحث" لتطبيقات الأجهزة الجوّالة بعد.