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

الإصدار تاريخ الإصدار Notes
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
22.4.0 2023-09-13
  • تتطلب هذه الميزة compileSdkVersion على الأقل من 33.
  • أداة فحص الإعلانات: تمت إضافة إمكانية استخدام حِزم تطوير البرامج (SDK) لطلب الإعلانات المطلوبة من خلال واجهة مستخدم "أداة فحص الإعلانات" وعرضها.
  • تمت إضافة طريقة QueryInfo.generate() جديدة تتطلّب رقم تعريف الوحدة الإعلانية.
  • يفعِّل هذا الخيار الاختبار الأولي للإصدار التجريبي من Attribution Reporting API وواجهات برمجة تطبيقات الحفاظ على الخصوصية في الإصدار التجريبي من Topics. يمكنك الاطّلاع على دليل AdMob "مبادرة حماية الخصوصية" على Android لمزيد من المعلومات.
22.3.0 2023-08-2022
  • تمت إضافة دعم لإنشاء أحجام تكيُّفي باستخدام AdSize.FULL_WIDTH كعرض. في السابق، كان يتم التعامل مع أحجام الإعلانات التي تم إنشاؤها باستخدام AdSize.FULL_WIDTH على أنّها AdSize.SMART_BANNER.
22.2.0 05-07-2023
22.1.0 من 2023 إلى 18
  • أداة فحص الإعلانات: تم تفعيل القدرة على تشغيل طلبات الإعلان من واجهة مستخدم "أداة فحص الإعلانات" على الأجهزة التي لا تتضمّن "خدمات Google Play".
22.0.0 من 2023 إلى 2029
  • التغييرات التي قد تؤدي إلى :
    • تمت إزالة 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 إلى 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
  • أداة فحص الإعلانات: تمت إضافة إمكانية استخدام حِزم تطوير البرامج (SDK) لطلب الإعلانات المطلوبة من خلال واجهة مستخدم "أداة فحص الإعلانات" وعرضها.
  • إعلانات مدمجة مع المحتوى:
  • الإعلانات المدمجة مع المحتوى المخصّصة:
21.2.0 609-2022
  • أداة فحص الإعلانات: تمت إضافة إمكانية استخدام حزمة تطوير البرامج (SDK) لتصدير سجلّات طلبات الإعلانات من خلال Android Sharesheet.
21.1.0 14-07-2022
  • تمت توفير إمكانية تحقيق الربح من الإعلانات في WebView. لمزيد من التفاصيل، يمكنك الاطّلاع على دمج WebView API للإعلانات.
  • تمت إضافة getResponseExtras() إلى ResponseInfo، ما قد يؤدي إلى عرض معلومات إضافية حول استجابة الإعلان.
21.0.0 من 2022 إلى 2025
  • التغييرات التي قد تؤدي إلى :
    • تتطلّب الآن حزمة "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-2022
20.5.0 من 18 إلى 2021
  • تمت إضافة دعم إلى أجهزة Android 12 للتطبيقات التي تستهدف المستوى 31 من واجهة برمجة التطبيقات.
  • تمت إضافة إتاحة معرّف مجموعة التطبيقات لحالات الاستخدام مثل الإبلاغ ومنع الاحتيال.
20.4.0 من 2021 إلى 2022
  • بدايةً من الإصدار 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 من 2021 إلى 2023
20.2.0 2021-06-08
  • تمت إضافة إمكانية استخدام "أداة فحص الإعلانات" (إصدار تجريبي) للناشرين على "مدير إعلانات Google".
20.1.0 من 2021 إلى 2029
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-03-2021
  • تمت إضافة عنصر يعتمد على حزمة تطوير البرامج (SDK) لمنصة User Messaging Platform.
  • تمت إضافة رقم معاودة الاتصال بالرقم onAdImpression() إلى FullScreenContentCallback.
  • تم إيقاف تنسيق InstreamAd نهائيًا.
  • محوّلات التوسّط:
    • تم إيقاف ميزات MediationBannerAdapter وMediationInterstitialAdapter وMediationNativeAdapter نهائيًا. ويجب أن تنفّذ المحوّلات الجديدة الفئة Adapter لتحميل هذه التنسيقات.
    • يمكن لمحوّلات عروض الأسعار الآن تنفيذ طرق تحميل مختلفة في فئة Adapter لأشكال "عرض الأسعار في الوقت الفعلي" (RTB).
19.7.0 من 2021 إلى 2020
  • التغييرات الرئيسية على:
    • 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 إلى 2020
  • إعلانات البانر: يُطلق على طريقة onAdImpression() AdListener الآن اسم لإعلانات البانر.
  • تمت إضافة طريقة setHttpTimeoutMillis() لتخصيص مهلة مكالمات HTTPS التي تجريها عبر حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
19.4.0 من 2020 إلى 109
  • تمت إضافة دعم إلى أجهزة Android 11 للتطبيقات التي تستهدف المستوى 30 من واجهة برمجة التطبيقات.
  • الإعلانات على شاشة فتح التطبيق: تم تغيير تنسيق AppOpenAd بحيث يكون تشغيله بتنسيق ملء الشاشة أكثر من شكل عرض البانر. تمت إضافة طريقتَي getResponseInfo() وshow() إلى AppOpenAd. تم إيقاف AppOpenAdView وAppOpenAdPresentationCallback صف.
  • التوسّط: أصبحت تقارير حالة التوسّط متاحة الآن. استخدِم ResponseInfo.getAdapterResponses() للحصول على معلومات الردّ لكل شبكة مواقع إعلانية شاركت في طلب إعلان.
  • الإعلانات القديمة التي تضم مكافأة: RewardedVideoAd متوقفة نهائيًا.
  • تم إصلاح خطأ يستدعي MobileAds.initialize() معالِج الإكمال مرة واحدة فقط. إنّ كل مكالمة إلى MobileAds.initialize() تؤدي الآن إلى معاودة الاتصال لإكمال العملية.
19.3.0 من 2020 إلى 2020
  • تمت إضافة طريقتَي getDomain() وgetCause() إلى AdError.
  • تمت إضافة استدعاءات جديدة لمعاودة الاتصال بسبب تعذُّر التحميل إلى جميع أشكال الإعلانات التي تعرض خطأ LoadAdError. على سبيل المثال: onAdFailedToLoad(LoadAdError).
  • استدعاءات استدعاء فشل التحميل التي تم إيقافها نهائيًا والتي تعرض عددًا صحيحًا. على سبيل المثال، onAdFailedToLoad(int).
  • الإعلانات التي تضم مكافأة: تمت إضافة onRewardedAdFailedToShow(AdError) وإيقاف onRewardedAdFailedToShow(int) نهائيًا.
  • التوسّط بمكافأة: تمت إضافة رمز خطأ العرض التقديمي MEDIATION_SHOW_ERROR. تعرض الآن جميع أخطاء العروض التقديمية المرتبطة بالإعلانات المعتمدة على التوسّط MEDIATION_SHOW_ERROR للسمة AdError.getCode() وAdError.getCause() غيرNull يمثّل خطأ التوسّط الأساسي.
19.2.0 من 2020 إلى 18
  • تمت إضافة تنسيق RewardedInterstitialAd. تتوفّر هذه الميزة حاليًا في إصدار تجريبي خاص. يمكنك التواصل مع مدير حسابك لطلب إذن الوصول.
  • إعلانات مدمجة مع المحتوى: تمت إضافة واجهة مستخدم لأداة التحقق من الإعلانات المدمجة مع المحتوى في طلبات الاختبار لمساعدتك في اكتشاف انتهاكات سياسات الإعلانات المدمجة مع المحتوى وإصلاحها.
  • تمت إضافة طريقة MobileAds.disableMediationAdapterInitialization(). وعليك استدعاء هذه الطريقة قبل إعداد حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة لإيقاف إعداد محوّل التوسّط.
19.1.0 من 2020 إلى 16
19.0.1 من 2020 إلى 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 مايو
  • تمت إضافة واجهات برمجة التطبيقات لشكل الإعلان InstreamAd. تتوفّر هذه الميزة حاليًا في إصدار تجريبي خاص. يمكنك التواصل مع مدير حسابك لطلب إذن الوصول.
  • إعلان البانر التكيُّفي: تم تغيير طرق إنشاء إعلانات البانر التكيُّفية في فئة AdSize. على سبيل المثال، تمت إعادة التسمية AdSize.getCurrentOrientationBannerAdSizeWithWidth() إلى AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize().
  • التوسّط: حصلت الآن حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" على الاستثناءات الناتجة عن محوّلات التوسّط.
  • التوسّط بمكافأة: تم إصلاح خطأ كان يؤدي إلى تخزين مؤقت عدة إعلانات تضم مكافأة قائمة على التوسّط، لعرض إعلان واحد فقط.
  • تمت إضافة طريقة setTestDeviceIds() لتفعيل ضبط أجهزة الاختبار مرة واحدة لجميع طلبات الإعلانات.
18.2.0 من 2019 إلى 2029
  • تمت إضافة واجهات برمجة تطبيقات لتنسيق AppOpenAd. تتوفّر هذه الميزة حاليًا في إصدار تجريبي خاص. يمكنك التواصل مع مدير حسابك لطلب إذن الوصول.
18.1.1 من 2019 إلى 2023
  • التوسّط: يتم الآن إعداد المحوّلات عند طلب التطبيقات MobileAds.initialize(Context, OnInitializationCompleteListener).
  • التوسّط: يتم الآن حجز استثناءات المحوّل التي تتضمّن عمليات تتبُّع تسلسل استدعاء الدوال البرمجية لحزمة "SDK لإعلانات Google على الأجهزة الجوّالة" وتتم معالجتها من خلال "حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة".
18.1.0 9-07-2019
  • الإصدار الرسمي لدعم قياس التطبيقات
  • تبدأ ميزة قياس أداء التطبيقات في إعداد وإرسال البيانات عند بدء تشغيل التطبيق تلقائيًا. تمت إضافة خيار لتأخير قياس أداء التطبيقات إلى أن يتم طلب "حزمة تطوير البرامج (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 إلى 17
  • نقل البيانات من مكتبات دعم Android إلى Jetpack (AndroidX) يُرجى الرجوع إلى ملاحظات إصدار "خدمات Google Play" للحصول على مزيد من المعلومات.
  • لتجنُّب تعطُّل التطبيق الذي يحدث عند تشغيله لأول مرة بعد تثبيت التطبيق من "متجر Play"، يتطلّب هذا الإصدار من الناشرين الإفصاح عن تبعيات إضافية في version.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 إلى 2021
  • عليك حلّ المشاكل المتعلّقة بأخطاء ANR التي تنشأ في android.media.AudioManager.getStreamVolume.
17.2.0 11-03-2019
  • الفيديو الذي يضم مكافأة: تمت إضافة مجموعة جديدة من واجهات برمجة التطبيقات التي تضم مكافأة (راجِع حزمة الإعلانات بمكافأة) التي تمكّنك من تحميل عدة إعلانات تضم مكافأة في الوقت نفسه.
  • التوسّط: تمت إضافة مجموعة جديدة من واجهات برمجة التطبيقات لمحوّلات التوسّط التي تتيح الإعداد. تنفّذ المحوّلات التي تنفّذ واجهة برمجة التطبيقات الجديدة الفئة 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-01-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
  • تم إصلاح خطأ كان يحدث فيه تركيبات معيّنة من 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 2018
17.0.0 من 2018 إلى 105
  • على ناشري AdMob Google تحديد علامة <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
  • ما مِن تغييرات في الإعلانات يمكنك الرجوع إلى ملاحظات الإصدار الخاصة بخدمات Google Play للحصول على مزيد من المعلومات.
15.0.0 من 2018 إلى 12
  • الإصدار 3 من MRAID التجريبي.
  • الإعلانات المدمجة مع المحتوى: تمت إضافة واجهة برمجة التطبيقات الموحدة للإعلانات المدمجة مع المحتوى. يجمع ذلك بين NativeAppInstallAds وNativeContentAds في نوع واحد جديد: UnifiedNativeAd.
  • ملاحظة: عند استخدام الإعلانات المدمجة مع المحتوى، هناك تحذير خطير يظهر في السجلات عند النقر على الإعلان المدمج مع المحتوى: "UnconfirmedClickListener should not be null in a ClickConfirmingView" يمكن تجاهل هذا التحذير، وستتم إزالته في الإصدار التالي.
12.0.1 من 2018 إلى 2028
  • ما مِن تغييرات في الإعلانات يمكنك الاطّلاع على ملاحظات الإصدار في "خدمات Google Play" للحصول على مزيد من التفاصيل.
12.0.0 من 2018 إلى 2020
  • فيديو بمكافأة: تمت إضافة طريقة معاودة الاتصال بـ "onRewardedVideoCompleted()" إلى "RewardedVideoAdListener".
  • التوسط المدمج مع المحتوى: تمت إضافة الطريقة trackViews() إلى NativeAdMapper، ما يمنح المحوّلات إمكانية الوصول إلى عناصر View المقابلة لمواد عرض الإعلانات المدمجة مع المحتوى الفردية. تم إيقاف "trackView()" لصالح "trackViews()".
11.8.0 من 2017 إلى 12 18
  • إصلاح الأخطاء وتحسينات عامة
11.6.0 7 -11-2017
  • تمت إضافة الفئة NativeAdViewHolder والطرق ذات الصلة في NativeAppInstallAd وNativeContentAd.
  • AdLoader.getMediationAdapterClassName متوقف نهائيًا (على الناشرين استخدام الطرق التي تحمل الاسم نفسه في السمتَين NativeAppInstallAd وNativeContentAd بدلاً من ذلك).
  • تعرِض الإعلانات الاختبارية الآن تصنيفًا في أعلى الإعلان. يمكنك الاطّلاع على دليل الاختبار للحصول على مزيد من التفاصيل.
11.4.0 من 2017 إلى 19
  • تمت إضافة طرق getMediationAdapterClassName() إلى الصفَّين NativeAppInstallAd وNativeContentAd. سيتم نهائيًا إيقاف الطريقة التي تحمل الاسم نفسه في AdLoader.
  • تمت إضافة طريقة onVideoEnd() إلى طريقة الفئة MediationNativeListener وhasVideoContent() وsetHasVideoContent() و setMediaView() إلى فئة NativeAdMapper وgetAdVolume() وisAdMuted() الفئة NativeMediationAdRequest لدعم التوسط المدمج مع الفيديو في الفيديو.
  • تمت إزالة الصف "SearchAdRequest".
11.2.2 من 2017 إلى 09
  • تمت إضافة طريقة loadAd() جديدة تأخذ كائن PublisherAdRequest إلى الفئة RewardedVideoAd.
11.2.0 من 2017 إلى 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-06-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 إلى 2015
  • خدمات Google Play 10.2.x هي الإصدار الأول الذي لم يعُد يتضمن التوافق الكامل للإصدار 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 2021
  • إصلاح الأخطاء وتحسينات عامة
9.8.0 من 2016 إلى 1024
  • تم إلغاء إيقاف MobileAds.Initialize(Context). وعلى الناشرين في "مدير إعلانات Google" استدعاء هذه الطريقة عند إعداد تطبيقاتهم. على الناشرين في AdMob الاستمرار في استخدام MobileAds.Initialize(Context, String) وتمرير رمز التطبيق.
9.6.0 من 2016 إلى 2022
  • تمت إضافة الفئة MediaView لإعلانات الفيديو المتقدمة للإعلانات المدمجة مع المحتوى.
  • تمت إضافة طريقة openDebugMenu() إلى فئة MobileAds لمعاينة تصميمات الإعلانات وتحديد المشاكل وحلّها في الوحدات الإعلانية في "مدير الإعلانات".
  • تم توفير دعم للأحداث المخصّصة للفيديوهات التي تضم مكافأة.
9.4.0 1-08-2016
  • إصلاح الأخطاء وتحسينات عامة
9.2.0 من 2016 إلى 2027
  • تمت إضافة طريقة setAdChoicesPlacement() إلى الفئة NativeAdOptions.Builder التي يمكن لناشري التطبيقات استخدامها الآن لتحديد موقع AdChoices في الإعلانات المدمجة مع المحتوى.
  • تم تحسين تشغيل إعلانات الفيديو مع إصلاح العديد من الأخطاء.
9.0.1 26-05-2016
  • يحل مشكلة ProGuard التي ظهرت في الإصدار 9.0.0. لم يعُد الناشرون بحاجة إلى خيار keep لنطاق com.google.android.gms.common.util.DynamiteApi.
9.0.0 من 2016 إلى 18
  • تمت إضافة التعبئة التلقائية لمعلومات الموقع الجغرافي للتطبيقات التي تمنح الإذن بتحديد الموقع الجغرافي صراحةً.
  • تم توفير دعم للأحداث المخصّصة لتوسّط الفيديو الذي يضم مكافأة.
  • تمت إضافة خيارات الفيديو لإعلانات مدمجة مع المحتوى (إكسبرس).
  • تم تعديل واجهة برمجة التطبيقات 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
  • تمت إضافة طريقة علنية، MobileAds.setAppVolume()، لإبلاغ حزمة تطوير البرامج (SDK) لعرض إعلانات الأجهزة الجوّالة بمستوى الصوت الحالي للتطبيق.
  • تنفيذ إصلاحات للأخطاء وتحسينات
8.3.0 من 2015 إلى 11
  • تم توفير دعم لإعلانات الفيديو التي تضم مكافأة.
  • تمت إضافة طريقة isLoading() إلى PublisherAdView وPublisherInterstitialAd للتحقق مما إذا كان طلب الإعلان قيد التنفيذ.
  • تمت إضافة طريقة setIsDesignedForFamilies() إلى AdRequest.Builder وPublisherAdRequest.Builder.
  • تمت إضافة طريقة destroy() إلى NativeAdView.
8.1.0 من 2015 إلى 2024 إصلاحات أخطاء متعددة
7.8.0 من 2015 إلى 13
  • نسخة الإصدار الرسمي 2 من MRAID
  • تمت إضافة طريقة isLoading() إلى AdLoader وAdView وInterstitialAd للتحقّق مما إذا كان طلب الإعلان قيد التنفيذ.
  • PublisherAdRequest.Builder#setManualImpressionsEnabled() متوقّف نهائيًا. يمكنك استخدام PublisherAdView#setManualImpressionsEnabled() كبديل.
7.5.0 من 2015 إلى 2028
  • تمت إضافة دعم لأشكال الإعلانات المدمجة مع المحتوى وعمليات تثبيت التطبيقات في AdMob و"مدير الإعلانات".
  • تمت إضافة دعم لأشكال الإعلانات المدمجة مع المحتوى المخصصة، والمتاحة للحجوزات في "مدير الإعلانات".
7.3.0 من 2015 إلى 2028 إصلاحات أخطاء متعددة
7.0.0 من 2015 إلى 2019
  • تمت إضافة addCustomTargeting() وaddCategoryExclusion() طريقة إلى PublisherAdRequest.Builder.
  • تم إصلاح مشكلة كانت تتسبب في تسجيل PublisherAdView.recordManualImpression() لعدة مرات ظهور في "مدير الإعلانات" عند استخدام احتساب عدد مرات الظهور يدويًا.
  • تم إصلاح مشكلة تتسبب في عرض الإعلانات بشكل غير صحيح عند استخدام السمة android:largestWidthLimitDp في العلامة <supports-screens>.
  • تمت إضافة الطريقة setRequestAgent() إلى AdRequest.Builder وPublisherAdRequest.Builder. يجب استخدام هذه الطريقة للدلالة على مصادر طلبات الإعلانات من قِبل الجهات الخارجية التي تتوسط في استخدام "حزمة تطوير البرامج (SDK) لإعلانات الأجهزة الجوّالة".
6.5.87 من 2014 إلى 1208
  • إطلاق بنية JAR المقسّمة: يمكن لمطوّري البرامج في "استوديو Android" الآن تضمين جزء الإعلانات من "خدمات Google Play" فقط من خلال الاعتماد على com.google.android.gms:play‑services‑ads:6.+.
    ملاحظة: يجب أن تشير التطبيقات التي تنشئ إعلانات بانر بتنسيق XML إلى المكتبة com.google.android.gms:play‑services:6.+ بأكملها.
  • إصلاحات أخطاء متعددة
6.1 من 2014 إلى 108
  • تمت إضافة طريقة getLocation() إلى com.google.android.gms.ads.MediationAdRequest.
  • تمت إضافة وصف للمحتوى إلى زر الإغلاق البيني لإمكانية الوصول.
  • تمت إزالة تسجيل الرسالة "لم يتم العثور على موارد Google Play" عندما يكون مشروع المكتبة مرتبطًا بشكل صحيح.
  • تمت إضافة getMediationAdapterClassName() إلى AdView للحصول على اسم فئة محوّل توسط شبكة الإعلانات الذي يعرض إعلانًا حاليًا.
5 من 2014 إلى 256
  • تمت إضافة واجهات برمجة تطبيقات جديدة لتنفيذ الأحداث المخصّصة.
  • تمت إضافة مسار الشراء التلقائي للشراء داخل التطبيق باستخدام واجهة برمجة التطبيقات Google Play Billing API.
4.4 7 -05-2014
  • تمت إضافة واجهات برمجة تطبيقات جديدة لمهايئ التوسط.
  • تمت إضافة شكل إعلان جديد LARGE_BANNER مقاس 320x100 لكل من الهواتف والأجهزة اللوحية.
  • تمت إضافة تنسيق بيني جديد للشراء داخل التطبيق. يمكنك ضبط InAppPurchaseListener على InterstitialAd للاستماع إلى أحداث الشراء داخل التطبيق.
  • إصلاح خطأ في عطل "SecurityException" بسبب قراءة خدمات Google بدون إذن
4.3 من 2014 إلى 17
  • تعمل InterstitialAd الآن إذا اجتازت سياق التطبيق.
  • تمت إضافة طريقة setContentUrl() إلى PublisherAdRequest.Builder.
  • حلّ مشكلة الاستثناء عند عدم تسجيل الخدمة.
4.2 2014-02-03 إصلاحات أخطاء متعددة
4.1 من 2014 إلى 16 16
  • تم توفير دعم إضافي لكلّ من "مدير الإعلانات" و"الإعلانات على شبكة البحث" لتطبيقات الأجهزة الجوّالة.
  • أصبحت ميزة setLocation() متوفّرة في "AdRequest.Builder".
  • تم إصلاح عطل كان يحدث إذا تم طلب إعلان بيني ولكن لم يتم تحديد AdActivity في البيان.
4 من 2013 إلى 10-31
  • أصبحت واجهات برمجة التطبيقات لإعلانات Google على الأجهزة الجوّالة الآن جزءًا من خدمات Google Play.
  • يتم تلقائيًا إرسال التحديثات المستقبلية لواجهات برمجة التطبيقات لإعلانات Google على الأجهزة الجوّالة إلى الأجهزة من خلال "خدمات Google Play".
  • لا تتوفر بعد إعلانات "مدير الإعلانات" و"شبكة البحث" لتطبيقات الأجهزة الجوّالة.