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

الإصدار تاريخ الإصدار ملاحظات
23.6.0 ‎2024‑12‑03
  • إيقاف جميع واجهات برمجة التطبيقات ذات الصلة بتنسيق الإعلانات أثناء الانتقال إلى أعلى أو أسفل الصفحة على سبيل المثال، AdSize.getCurrentOrientationInterscrollerAdSize().
23.5.0 ‎2024‑10‑29
  • تم تعديل رسائل logcat المتعلّقة بتعذُّر تحميل الإعلانات في الإصدار 23.4.0 من مستوى الخطأ إلى مستوى المعلومات.
  • تحسين تحقيق الربح من الإعلانات المخصّصة في علامات التبويب المخصّصة لـ WebView API للإعلانات
23.4.0 ‎2024‑09‑30
  • تؤدي حالات تعذُّر تحميل الإعلانات الآن إلى عرض رسالة 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 ‎2024‑03‑07
  • التغييرات التي قد تؤدي إلى حدوث أعطال:
    • زيادة الحد الأدنى لمستوى واجهة برمجة تطبيقات Android إلى 21
    • لمواصلة جمع مقاييس سلوك المستخدِمين في AdMob، يمكنك ربط تطبيقك على AdMob بمنصّة Firebase ودمج حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google لبرنامج Firebase" في تطبيقك.
    • تمت إزالة واجهة برمجة التطبيقات MobileAds.enableSameAppKey() المتوقّفة نهائيًا وتم تعديل الطريقة البديلة MobileAds.putPublisherFirstPartyIdEnabled() لعرض قيمة منطقية حول ما إذا كانت عملية ثبات التحكّم ناجحة أم لا.
    • Native Ads:
      • تمت إزالة AdLoader.forUnifiedNativeAd(). استخدِم AdLoader.forNativeAd() بدلاً من ذلك.
      • تمت إزالة AdLoader.forCustomTemplateAd(). استخدِم AdLoader.forCustomFormatAd() بدلاً من ذلك.
    • تمت إزالة AdFormat.UNKNOWN بدون استبدال. يجب أن تُرسل التطبيقات التي تستخدم QueryInfo.generate() شكل إعلان.
    • يمكن الآن تسلسل طُرق AdManagerAdRequest.Builder المُكتسَبة من العنصر الرئيسي لإنشاء عنصر من طلب واحد. وقد تطلّب ذلك إجراء تغيير في بنية اكتساب السمات بحيث AdManagerAdRequest.Builder لم تعُد تكتسِب السمات من AdRequest.Builder.
  • تُضيف MobileAds.registerCustomTabsSession() لتحسين تحقيق الربح من الإعلانات في علامات التبويب المخصّصة. اطّلِع على تحسين علامات التبويب المخصّصة للحصول على مزيد من المعلومات.
  • تم تعديل الاعتمادية على حزمة تطوير البرامج (SDK) لمنصة User Messaging Platform إلى الإصدار 2.2.0.
22.6.0 ‎2023‑12‑06
  • تم إيقاف الإصدار MobileAds.setSameAppKeyEnabled() نهائيًا وتمت إعادة تسمية الطريقة إلى MobileAds.putPublisherFirstPartyIdEnabled().
  • تم إيقاف AdFormat.UNKNOWN نهائيًا بدون توفير بديل. التطبيقات التي تستخدم QueryInfo.generate() يجب أن ترسل شكل إعلان.
22.5.0 ‎2023‑10‑30
22.4.0 ‎2023‑09‑13
22.3.0 ‎2023‑08‑22
  • تمت إضافة إمكانية إنشاء أحجام تكيُّفية باستخدام AdSize.FULL_WIDTH كعرض. في السابق، كانت أحجام الإعلانات التي تم إنشاؤها باستخدام AdSize.FULL_WIDTH تُعامل على أنّها AdSize.SMART_BANNER.
22.2.0 ‎2023‑07‑05
22.1.0 ‎2023‑05‑18
  • أداة فحص الإعلانات: تم تفعيل إمكانية بدء طلبات الإعلانات من واجهة مستخدم أداة فحص الإعلانات على الأجهزة التي لا تتضمّن "خدمات Google Play".
22.0.0 ‎2023‑03‑29
  • التغييرات التي قد تؤدي إلى حدوث أعطال:
    • تمت إزالة 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
  • أصبح معرّف تطبيق "مدير إعلانات Google" مطلوبًا الآن لجميع تطبيقات "مدير إعلانات Google" ويتطلب استخدام التنسيق 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 API للإعلانات للحصول على مزيد من التفاصيل.
  • تمت إضافة getResponseExtras() إلى ResponseInfo ما قد يؤدي إلى عرض معلومات إضافية عن استجابة الإعلان.
21.0.0 ‎2022‑05‑25
  • التغييرات التي قد تؤدي إلى حدوث أعطال:
    • تتطلّب "حزمة SDK لإعلانات Google على الأجهزة الجوّالة" الآن أن تكون جميع التطبيقات على الإصدار 19 من Android API كحد أدنى لتشغيلها.
    • تمت إضافة @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.
  • تم تفعيل callback onAdClicked() في فئة AdListener لشكل الإعلان المدمج مع المحتوى.
20.3.0 ‎2021‑08‑23
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 ‎2021‑03‑15
  • تمت إضافة عنصر يعتمد على حزمة تطوير البرامج (SDK) لمنصة User Messaging Platform.
  • تمت إضافة طلب معاودة الاتصال 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 على الأجهزة الجوّالة.
19.4.0 ‎2020‑09‑10
  • تمت إضافة إمكانية استخدام الأجهزة التي تعمل بنظام Android 11 للتطبيقات التي تستهدف المستوى 30 لواجهة برمجة التطبيقات.
  • الإعلانات على شاشة فتح التطبيق: تم تغيير شكل AppOpenAd ليعمل بشكلٍ مشابه لشكل الإعلانات التي تظهر على ملء الشاشة أكثر من شكل إعلانات البانر. تمت إضافة getResponseInfo() وshow() إلى AppOpenAd. صفوف AppOpenAdView وAppOpenAdPresentationCallback التي تم إيقافها نهائيًا
  • التوسّط: تتوفّر الآن تقارير حالة التوسّط. استخدِم ResponseInfo.getAdapterResponses() للحصول على معلومات الاستجابة لكل شبكة مواقع إعلانية شاركت في طلب إعلان.
  • الإعلانات القديمة التي تضم مكافأة: تم إيقافها نهائيًا RewardedVideoAd.
  • تم إصلاح خطأ يتسبب في أن يُعيد 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
  • تمت إضافة تنسيق RewardedInterstitialAd. تتوفّر هذه الميزة حاليًا في إصدار تجريبي خاص. يُرجى التواصل مع مدير حسابك لطلب الوصول.
  • الإعلانات المدمجة مع المحتوى: تمت إضافة واجهة مستخدم لأداة التحقّق من الإعلانات المدمجة مع المحتوى في طلبات الاختبار لمساعدتك في رصد مخالفات السياسة المتعلّقة بالإعلانات المدمجة مع المحتوى وإصلاحها.
  • تمت إضافة طريقة MobileAds.disableMediationAdapterInitialization(). استخدِم هذه الطريقة قبل إعداد حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" بهدف إيقاف إعداد محوِّل التوسّط.
19.1.0 ‎2020‑04‑16
19.0.1 ‎2020‑03‑18
  • الإعلانات المدمجة مع المحتوى: تم إصلاح تسرُّب الذاكرة الذي حدث عند استخدام NativeCustomTemplateAd.
19.0.0 ‎2020‑03‑02
  • تمت إضافة إمكانية قراءة مَعلمات الموافقة من الإصدار 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 ‎2019‑07‑23
  • التوسّط: يتم الآن إعداد المحوِّلات عندما تستدعي التطبيقات MobileAds.initialize(Context, OnInitializationCompleteListener).
  • التوسّط: يتم الآن رصد استثناءات المحوِّل التي تتضمّن عمليات تتبُّع تسلسل استدعاء الدوال البرمجية في "حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة" ومعالجتها من قِبل "حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة".
18.1.0 ‎2019‑07‑09
  • الإصدار الرسمي لدعم ميزة "قياس أداء التطبيقات"
  • يتمّ تلقائيًا إعداد ميزة قياس أداء التطبيق وإرسال البيانات عند بدء تشغيله. تمت إضافة خيار لتأخير قياس أداء التطبيق إلى أن يتمّ استدعاء حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" صراحةً.
  • تمت إضافة طريقة إعداد جديدة، 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().
  • تمت إضافة تبعيات على 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‑03‑11
  • إعلانات الفيديو التي تضم مكافآت: تمت إضافة مجموعة جديدة من واجهات برمجة التطبيقات لإعلانات الفيديو التي تضم مكافآت (اطّلِع على حزمة rewarded التي تتيح لك تحميل إعلانات متعددة تضم مكافآت في الوقت نفسه).
  • التوسّط: تمت إضافة مجموعة جديدة من واجهات برمجة تطبيقات محوِّل التوسّط التي تتيح عملية الإعداد. إنّ محوِّلات البيانات التي تستخدم واجهة برمجة التطبيقات الجديدة تستخدم فئة Adapter.
  • الناشرون الذين يستخدِمون firebase-analytics مع الإصدار 17.2.0 من أيّ من مكتبة الإعلانات (مثل com.google.android.gms:play-services-ads:17.2.0) يجب استخدام com.google.firebase:firebase-analytics:16.3.0.
17.1.3 ‎2019‑01‑31
  • الناشرون الذين يستخدِمون firebase-analytics مع الإصدار 17.1.3 من أيّ من مكتبة الإعلانات (مثل com.google.android.gms:play-services-ads:17.1.3) يجب استخدام com.google.firebase:firebase-analytics:16.3.0.
17.1.2 ‎2018‑12‑03
  • الناشرون الذين يستخدِمون firebase-analytics مع الإصدار 17.1.2 من أيّ من مكتبة الإعلانات (مثل com.google.android.gms:play-services-ads:17.1.2) يجب استخدام com.google.firebase:firebase-analytics:16.0.6.
17.1.1 ‎2018‑11‑12
  • تم إصلاح خطأ كان يتسبب في عدم ظهور تركيبات معيّنة من 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
  • على ناشري Google AdMob تحديد علامة <meta-data> باستخدام المفتاح com.google.android.gms.ads.APPLICATION_ID في ملف AndroidManifest.xml. يُرجى الرجوع إلى دليل البدء للاطّلاع على مزيد من التفاصيل.
  • الإعلانات المدمجة مع المحتوى: تم إيقاف واجهات برمجة التطبيقات NativeAppInstallAd وNativeContentAd والواجهات المرتبطة بها نهائيًا واستبدالها بواجهة UnifiedNativeAd. يُرجى الرجوع إلى الإعلانات المدمجة مع المحتوى الإعلانات المدمجة مع المحتوى المتقدّمة للحصول على مزيد من التعليمات حول استخدام واجهات برمجة التطبيقات الجديدة.
  • الإعلانات المدمجة مع المحتوى: تمت إضافة ميزة "تجاهل هذا الإعلان".
  • الإعلانات المدمجة: تمت إزالة سجلّ التحذيرات غير الضار: "يجب ألا يكون UnconfirmedClickListener فارغًا أثناء ضبط ClickConfirmingView".
  • الإعلانات التي تضم مكافآت: تمت إضافة طريقة setAdMetadataListener في RewardedVideoAd للاستماع إلى التغييرات في البيانات الوصفية للإعلان.
  • الإعلانات التي تضم مكافأة: سيؤدي استدعاء destroy() إلى إلغاء المستمع.
  • إيقاف الأساليب التالية نهائيًا في AdRequest.Builder
  • تم إصلاح خطأ كان يؤدي إلى عدم بدء onRewardedVideoCompleted() على المحاكيات.
16.0.0 ‎2018‑10‑02
15.0.0 ‎2018‑04‑12
  • الإصدار التجريبي من MRAID 3
  • الإعلانات المدمجة مع المحتوى: تمت إضافة Unified Native Ad API. يؤدي ذلك إلى دمج نوعَي المحتوى NativeAppInstallAds وNativeContentAds في نوع جديد واحد: UnifiedNativeAd.
  • ملاحظة: عند استخدام الإعلانات المدمجة مع المحتوى، يظهر تحذير غير ضار في السجلّات عند النقر على الإعلان المدمج مع المحتوى: "يجب ألا يكون UnconfirmedClickListener فارغًا أثناء ضبط ClickConfirmingView." يمكن تجاهل هذا التحذير، وسيتم إزالته في الإصدار التالي.
12.0.1 ‎2018‑03‑28
  • لن يتم إجراء أي تغييرات على الإعلانات. اطّلِع على ملاحظات الإصدار لخدمات Google Play للحصول على مزيد من التفاصيل.
12.0.0 ‎2018‑03‑20
  • الفيديو الذي يضم مكافأة: تمت إضافة onRewardedVideoCompleted() طريقة ردّ الاتصال إلى RewardedVideoAdListener.
  • التوسّط في الإعلانات المدمجة: تمت إضافة طريقة trackViews() إلى NativeAdMapper، ما يتيح للمحوِّلات الوصول إلى عناصر View التي تتوافق مع مواد عرض الإعلانات المدمجة الفردية. تم إيقاف trackView() نهائيًا واستبداله بـ trackViews().
11.8.0 ‎2017‑12‑18
  • إصلاح الأخطاء وإجراء تحسينات عامة
11.6.0 ‎2017‑11‑07
  • تمت إضافة فئة NativeAdViewHolder والطُرق ذات الصلة في NativeAppInstallAd وNativeContentAd.
  • تم إيقاف AdLoader.getMediationAdapterClassName نهائيًا (على الناشرين استخدام الطرق التي تحمل الاسم نفسه في NativeAppInstallAd وNativeContentAd بدلاً من ذلك).
  • تعرض الإعلانات الاختبارية الآن تصنيفًا أعلى الإعلان. اطّلِع على دليل الاختبار للحصول على مزيد من التفاصيل.
11.4.0 ‎2017‑09‑19
  • تمت إضافة طرق getMediationAdapterClassName() إلى فئتَي NativeAppInstallAd وNativeContentAd. سيتم إيقاف AdLoader باستخدام الأسلوب الذي يحمل الاسم نفسه.
  • تمت إضافة طريقة onVideoEnd() إلى فئة MediationNativeListener وفئة hasVideoContent() وsetHasVideoContent() و setMediaView() إلى فئة NativeAdMapper، وفئتَي getAdVolume() وisAdMuted() إلى فئة NativeMediationAdRequest لإتاحة التوسّط في الفيديوهات الأصلية.
  • تمّت إزالة فئة SearchAdRequest.
11.2.2 ‎2017‑09‑05
  • تمت إضافة طريقة 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. تم أيضًا إزالة فئات الشراء داخل التطبيق ذات الصلة.
  • تمت إضافة الطرق OnVideoMute() OnVideoPause() OnVideoPlay() وOnVideoStart() إلى فئة VideoController.VideoLifecycleCallbacks.
  • تمت إضافة إمكانية تفعيل الوضع الشامل في الإعلانات التي تظهر على ملء الشاشة من خلال إضافة الأسلوب setImmersiveMode() إلى الفئتَين PublisherInterstitialAd وRewardedVideoAd.
  • تمت إضافة واجهة OnPublisherAdViewLoadedListener وPublisherAdViewOptions وPublisherAdViewOptions.Builder لاستخدامها مع AdLoader لطلبات إعلانات البانر المضمّنة في المحتوى.
  • تمت إضافة واجهة OnImmersiveModeUpdatedListener اختيارية يمكن لمحوِّلات التوسّط تنفيذها للحصول على إشعارات بشأن تعديلات الوضع الم immersive.
  • تمت إضافة طريقة 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
9.6.0 ‎2016‑09‑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
  • تمت إضافة ميزة ملء معلومات الموقع الجغرافي تلقائيًا للتطبيقات التي تمنح إذن الموقع الجغرافي صراحةً.
  • تمت إضافة إمكانية استخدام الأحداث المخصّصة لتوسّط الفيديوهات التي تضم مكافآت.
  • تمت إضافة خيارات فيديو لإعلانات Native Express.
  • تم تعديل واجهة برمجة التطبيقات Custom Search Ads API.
  • تمّت إضافة طريقة 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 لإعلانات Google على الأجهزة الجوّالة بمستوى الصوت الحالي للتطبيق.
  • تم تنفيذ إصلاحات للأخطاء وإجراء تحسينات.
8.3.0 ‎2015‑11‑6
  • تمت إضافة ميزة إعلانات الفيديو التي تضم مكافآت.
  • تمت إضافة طريقة isLoading() إلى PublisherAdView وPublisherInterstitialAd للتحقّق مما إذا كان طلب الإعلان في مرحلة التقدّم.
  • تمت إضافة طريقة setIsDesignedForFamilies() إلى AdRequest.Builder وPublisherAdRequest.Builder.
  • تمت إضافة طريقة destroy() إلى NativeAdView.
8.1.0 ‎2015‑09‑24 إصلاحات أخطاء متنوّعة.
7.8.0 ‎2015‑08‑13
  • إصدار الإصدار الرسمي من MRAID v2
  • تمت إضافة طريقة isLoading() إلى AdLoader، AdView، وInterstitialAd للتحقّق مما إذا كان طلب الإعلان قيد التقدّم.
  • تم إيقاف PublisherAdRequest.Builder#setManualImpressionsEnabled() نهائيًا. استخدِم PublisherAdView#setManualImpressionsEnabled() بدلاً من ذلك.
7.5.0 ‎2015‑05‑28
  • تمّت إضافة إمكانية استخدام أشكال الإعلانات المُدمَجة مع المحتوى وإعلانات تثبيت التطبيقات في كلّ من AdMob و"مدير إعلانات Google".
  • تمت إضافة إمكانية استخدام أشكال الإعلانات المدمجة مع المحتوى المخصّصة، وهي متاحة للحجوزات في "مدير إعلانات Google".
7.3.0 ‎2015‑04‑28 إصلاحات أخطاء متنوّعة.
7.0.0 ‎2015‑03‑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 ‎2014‑06‑25
  • تمت إضافة واجهات برمجة تطبيقات جديدة لتنفيذ "الأحداث المخصّصة".
  • تمت إضافة مسار الشراء التلقائي لعملية الشراء داخل التطبيق باستخدام واجهة برمجة التطبيقات Google Play Billing API.
4.4 ‎2014‑05‑07
  • تمت إضافة واجهات برمجة تطبيقات جديدة لمحوِّل التوسّط.
  • تمت إضافة تنسيق إعلان جديد بحجم 320×100 LARGE_BANNER لكلٍّ من الهواتف والأجهزة اللوحية.
  • تمت إضافة تنسيق إعلان بيني جديد لعملية الشراء داخل التطبيق. اضبط InAppPurchaseListener على InterstitialAd للاستماع إلى أحداث الشراء داخل التطبيق.
  • إصلاح خطأ في تطبيق SecurityException بسبب قراءة gservices بدون إذن
4.3 ‎2014‑03‑17
  • تعمل دالة InterstitialAd الآن إذا تم تمريرها بسياق تطبيق.
  • تمت إضافة طريقة setContentUrl() إلى PublisherAdRequest.Builder.
  • حلّ مشكلة الاستثناء عند عدم تسجيل الخدمة
4.2 ‎2014‑02‑03 إصلاحات أخطاء متنوّعة.
4.1 ‎2014‑01‑16
  • تمت إضافة إمكانية استخدام "مدير إعلانات Google" و"الإعلانات على شبكة البحث" للتطبيقات المتوافقة مع الأجهزة الجوّالة.
  • أصبح لدى AdRequest.Builder الآن طريقة setLocation().
  • تم إصلاح عطل كان يحدث في حال طلب إعلان بيني ولكن لم يتم تحديد AdActivity في البيان.
4.0 ‎2013‑10‑31
  • أصبحت واجهات برمجة التطبيقات لخدمة "إعلانات Google على الأجهزة الجوّالة" جزءًا من خدمات Google Play.
  • يتم تلقائيًا طرح التحديثات المستقبلية لواجهات برمجة تطبيقات "إعلانات Google للأجهزة الجوّالة" على الأجهزة من خلال "خدمات Google Play".
  • لا يتوفّر "مدير إعلانات Google" و"الإعلانات على شبكة البحث" لتطبيقات الأجهزة الجوّالة بعد.