سجلّ إصدار حزمة تطوير البرامج لإدراج إعلان ديناميكي لإعلانات الوسائط التفاعلية لنظام التشغيل Android

الإصدار تاريخ الإصدار ملاحظات
3.36.0 2024-11-07
  • تُضيف طرقًا جديدة لطلبات البث تتضمّن المَعلمة NetworkCode. وهما الأسلوبان الجديدان: ImaSdkFactory.createLiveStreamRequest() و ImaSdkFactory.createVodStreamRequest(). إيقاف واجهات برمجة التطبيقات المشابهة التي لا تتضمّن المَعلمة networkCode نهائيًا
  • لتغليف تصميمات الإعلانات المصاحبة في تنسيق إطار يتطابق مع حجم الخانة الذي تمّ تحديده باستخدام CompanionAdSlot.setSize().
3.35.1 2024-09-24
  • يعمل على إصلاح مشكلة تعذُّر إجراء القياس المفتوح عند استخدام ImaSdkFactory.initialize() API.
  • زيادة عدد minSdkVersion التي تتوافق معها أداة IMA إلى 21
  • تُضيف ImaSdkFactory.initialize() لتحميل مواد عرض IMA وإعدادها قبل طلب الإعلان الأول. يؤدي استدعاء initialize() إلى تخصيص الذاكرة المطلوبة لتشغيل الإعلانات في المستقبل ويقلل من وقت الاستجابة لتشغيل الإعلان الأول.
  • حلّ مشكلة عنوان URL غير الصالح للنقر على الإعلان
  • إصلاح عطل ظهر في الإصدار 3.34.0 من IMA ويؤثر في التطبيقات التي لا تستخدم عملية إزالة الترميز البرمجي في Java8 على الإصدارات 25 من واجهة برمجة تطبيقات Android والإصدارات الأقدم
  • إضافة تحسينات إلى وقت بدء تشغيل IMA على أجهزة التلفزيون المتّصل القديمة
  • تحسين ثبات فتح الروابط على الأجهزة التي لم يتم تثبيت متصفّح عليها
  • سيتم إيقاف الإصدار 3.35.1 من حزمة SDK نهائيًا في 7 تشرين الثاني (نوفمبر) 2025. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.35.0 متوقفة نهائيًا 2024-08-28
  • هناك مشكلة معروفة في هذا الإصدار تؤدي إلى تعذُّر قياس OMID عند استخدام واجهة برمجة التطبيقات ImaSdkFactory.initialize(). استخدِم الإصدار 3.35.1 من حزمة تطوير البرامج لإعلانات الوسائط التفاعلية لنظام التشغيل Android بدلاً من ذلك.
  • بما أنّ الإصدار 3.35.0 متوقف نهائيًا، تم نقل ملاحظات الإصدار إلى قسم الإصدار 3.35.1.
3.34.0 2024-06-13
3.33.0 2024-03-28
3.32.0 متوقّف نهائيًا 2024-01-30
  • يواجه هذا الإصدار مشكلة في الأجهزة التي تعمل بمستويات واجهة برمجة تطبيقات Android الإصدار 25 والإصدارات الأقدم. استخدِم الإصدار 3.33.0 من حزمة تطوير البرامج (SDK) لإعلانات الوسائط التفاعلية لنظام التشغيل Android بدلاً من ذلك.
  • إتاحة بث الفيديوهات المسجّلة من خلال أداة ربط تابعة لجهة خارجية لعرض مجموعات المحتوى اطّلِع على دليل عرض مجموعات التطبيقات على Android للحصول على مزيد من المعلومات. يتضمّن هذا التغيير إضافة واجهات برمجة التطبيقات التالية:
  • تعمل هذه السياسة على زيادة قيمة minSdkVersion التي تتيحها إعلانات الوسائط التفاعلية إلى 19.
  • يعمل على إصلاح المشكلة التي لا تؤدي فيها النقرات إلى ظهور الإعلانات باستخدام الزر "مزيد من المعلومات" إلى فتح صفحة جديدة في الإصدار 30 من واجهة برمجة تطبيقات Android والإصدارات الأحدث. لا تزال المشكلة قائمة في الإصدارات 3.31.0 إلى 3.29.0 من حزمة تطوير البرامج (SDK) لإعلانات الوسائط التفاعلية، حيث يلزم استخدام حلّ بديل ليعمل النقر على الإعلانات.
  • إصلاح خلل يؤدي إلى ظهور استثناء ArrayIndexOutOfBoundsException عند استخدام AdsLoader.addAdsLoadedListener()
  • تُضيف خطأ الإعلان VAST_NO_ADS_AFTER_WRAPPER.
3.31.0 2023-08-31
  • هناك مشكلة في الإصدارات 3.31.0 إلى 3.29.0 من حزمة تطوير البرامج (SDK) لإعلانات الوسائط التفاعلية (IMA) مع الإصدار 30 من واجهة برمجة التطبيقات لنظام التشغيل Android والإصدارات الأحدث، حيث لا تؤدي النقرات على الإعلان باستخدام زر مزيد من المعلومات إلى فتح صفحة جديدة. كحل بديل ل الإصدارات المتأثرة، عليك إضافة بيانات عن الأهداف لفتح روابط الويب في بيان التطبيق على النحو التالي: 
              <?xml version="1.0" encoding="utf-8"?>
          <manifest xmlns:android="http://schemas.android.com/apk/res/android"
              package="com.example.project_name">
              ...
              </application>
              <queries>
                  <intent>
                      <action android:name="android.intent.action.VIEW" />
                      <data android:scheme="https" />
                  </intent>
                  <intent>
                      <action android:name="android.intent.action.VIEW" />
                      <data android:scheme="http" />
                  </intent>
              </queries>
          </manifest>
  • يعمل هذا التحديث على تعديل اعتمادية أداة تطوير البرامج (SDK) لإعلانات الوسائط التفاعلية (IMA) إلى الإصدار 1.4.8، والذي يتضمّن إشارات جديدة للتلفزيون المتّصل.
  • سيتم إيقاف واجهات برمجة تطبيقات AdsRequest التالية نهائيًا:
    • getExtraParameter()
    • getExtraParameters()
    • setExtraParameter()
  • سيتم إيقاف الإصدار 3.31.0 من حزمة تطوير البرامج (SDK) نهائيًا في 28 آذار (مارس) 2025. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.30.3 2023-08-03
  • تعمل على تحديث تبعيات المكتبة الداخلية لتحسين وقت استجابة بدء التشغيل.
  • سنوقف نهائيًا إصدار حزمة SDK 3.30.3 في 31 آب (أغسطس) 2024. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.30.2 2023-07-28
  • إصلاح الأخطاء غير المتوقّعة في NullPointerException التي ظهرت في الإصدار 3.30.1
  • إصلاح مشكلة في أداة Proguard التي أدّت إلى عدم إرسال بعض الأحداث من حزمة تطوير البرامج (SDK) يؤثر تصحيح هذا الخطأ في إضافة ExoPlayer ل حزمة تطوير البرامج (SDK) لعرض الإعلانات الديناميكية أثناء التشغيل في IMA.
  • توفّر التوافق مع الإصدار 8 من Gradle والإصدارات الأحدث. يجب ضبط الإصدارات السابقة من حزمة تطوير البرامج (SDK) لإعلانات الوسائط التفاعلية على Android علىandroid.enableR8.fullMode=false فيملف gradle.properties. اطّلِع على مقالة الوضع الكامل في R8 للحصول على مزيد من المعلومات.
  • سنوقف الإصدار 3.30.2 من حزمة تطوير البرامج (SDK) نهائيًا في 03/08/2024. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.30.1 متوقفة نهائيًا 2023-04-18
  • يتضمّن هذا الإصدار مشكلة تتعلّق بأخطاء NullPointerException غير متوقّعة. استخدِم الإصدار الأقدم من حزمة IMA SDK لنظام التشغيل Android‏ 3.29.0 إلى أن يتم طرح إصدار أحدث يعمل بشكلٍ جيد.
  • إصلاح مشكلة تتعلّق بتعطُّل التطبيقات التي تستخدم الإصدار 3.30.0 على الأجهزة التي لا تعمل بنظام التشغيل Android TV
الإصدار 3.30.0 متوقف نهائيًا 2023-03-29
  • يتضمن هذا الإصدار مشكلة تؤدي إلى تعطُّل التطبيقات التي لا تعمل على نظام Android TV الأساسي. استخدِم الإصدار 3.29.0 من حزمة تطوير البرامج لإعلانات الوسائط التفاعلية لنظام التشغيل Android بدلاً من ذلك.
  • إضافة واجهة برمجة التطبيقات ImaSdkFactory.createVideoStitcherVodStreamRequest()
  • إضافة التوافق مع المستودع الإعلاني المختلط على Google TV
  • يزيل الدعم لواجهة برمجة تطبيقات ImaSdkFactory.createSdkOwnedPlayer() المتوقّفة.
  • تُضيف رمز الخطأ ADS_PLAYER_NOT_PROVIDED
  • تُنشئ فئة BaseRequest التي تنفِّذها الآن كلّ من AdsRequest وStreamRequest .
  • تُضيف فئة SecureSignals .
  • تُضيف طريقة BaseRequest.setSecureSignals().
  • سنوقف نهائيًا استخدام الإصدار 3.30.0 من حزمة SDK في 18 نيسان (أبريل) 2024. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.29.0 2022-10-14
  • تُعيد تسمية فئة EspVersion إلى فئة VersionInfo.
  • إعادة تسمية واجهات برمجة التطبيقات Encrypted Signals for Publishers (ESP) إلى واجهات برمجة التطبيقات Secure Signals
  • تضيف واجهات برمجة التطبيقات الخاصة بمفاتيح تبديل أوضاع الميزات. يمكنك استخدام واجهات برمجة التطبيقات لميزة "الإشارة إلى الميزة" لتفعيل ميزات معيّنة أو إيقافها في IMA. استخدِم ImaSdkSettings.getFeatureFlags() و ImaSdkSettings.setFeatureFlags() للحصول على علامات الميزات وضبطها.
  • إصلاح مشكلة عدم إرسال بعض أحداث IMA
  • إضافة androidx.webkit:webkit كاعتماد على حزمة تطوير البرامج لإعلانات الوسائط التفاعلية
  • سنوقف نهائيًا استخدام الإصدار 3.29.0 من حزمة SDK في 29 آذار (مارس) 2024. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.28.2 2022-09-14
  • يحدّث اعتماديات حزمة تطوير البرامج (SDK) لاستخدام AndroidX.
  • سنوقف نهائيًا استخدام الإصدار 3.28.2 من حزمة SDK في 14 تشرين الأول (أكتوبر) 2023. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.28.1 متوقّف نهائيًا 2022-08-03
  • يواجه هذا الإصدار مشاكل في الأعطال على الإصدار 27 من Android والإصدارات الأقدم. استخدِم الإصدار 3.28.2 من حزمة تطوير البرامج لإعلانات الوسائط التفاعلية لنظام التشغيل Android بدلاً من ذلك.
  • إضافة واجهة برمجة التطبيقات ImaSdkFactory.createVideoStitcherLiveStreamRequest()
  • سنوقف الإصدار 3.28.1 من حزمة تطوير البرامج (SDK) نهائيًا في 14/09/2023. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.27.1 2022-05-27
  • إصدار الخدمة، ما مِن ميزات جديدة.
  • سنوقف الإصدار 3.27.1 من حزمة تطوير البرامج (SDK) نهائيًا في 03/08/2023. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.27.0 2022-03-01
  • إتاحة استخدام مساحات إعلانات الشركاء المتغيرة الحجم من خلال ضبط عرض وارتفاع مساحات إعلانات الشركاء على القيمة الثابتة لـ IMA FLUID_SIZE
  • سنوقف نهائيًا استخدام الإصدار 3.27.0 من حزمة SDK في 27 أيار (مايو) 2023. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.26.0 2022-01-12
  • إضافة واجهات برمجة التطبيقات الخاصة بـ "الإشارات المشفّرة للناشرين" (ESP) (تمت إعادة تسميتها إلى الإشارات الآمنة في الإصدار 3.29.0 من حزمة تطوير البرامج (SDK) لإعلانات الوسائط التفاعلية) يتيح ذلك للناشرين تفعيل عروض أسعار الشبكة وخدمات إدارة الهوية والوصول.
  • سنوقف نهائيًا استخدام الإصدار 3.26.0 من حزمة SDK في 1 آذار (مارس) 2023. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.25.1 2021-11-08
  • تضيف السمة AdsRenderingSettings.setEnableCustomTabs() وAdsRenderingSettings.getEnableCustomTabs() لنسبة النقر إلى الظهور داخل التطبيق باستخدام علامات التبويب المخصّصة.
  • اعتبارًا من الإصدار 3.25.1، تتضمّن حزمة تطوير البرامج (SDK) لإعلانات الوسائط التفاعلية الإذن com.google.android.gms.permission.AD_ID في بيان حزمة SDK الذي يتم دمجه تلقائيًا في بيان التطبيق من خلال أدوات إصدار Android. لمزيد من المعلومات حول بيان أذونات AD_ID، بما في ذلك كيفية إيقافه، يمكنك الرجوع إلى مقالة مركز مساعدة Play Console هذه.
  • تتم إتاحة رقم تعريف مجموعة التطبيقات لحالات الاستخدام مثل إعداد التقارير ومنع الاحتيال.
  • تحسينات على الأداء عند استخدام عدّة مثيلات AdsLoader من خلال إتاحة ميزة التخزين المؤقت للخيوط وإعادة استخدامها
  • سنوقف نهائيًا استخدام الإصدار 3.25.1 من حزمة تطوير البرامج (SDK) في 12‏ كانون الثاني (يناير) 2023. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.24.0 2021-06-03
3.23.0 2021-04-07
  • يضيف الطريقتان ImaSdkSettings.setSessionId() و ImaSdkSettings.getSessionId() للحصول على معرّف الجلسة وضبطه. هذا معرّف مؤقت وعشوائي يتم استخدامه حصريًا لتحديد عدد مرّات الظهور.
  • يعمل هذا الإجراء على إصلاح خطأ NullPointerException المرتبط بالإعلانات المصاحبة.
  • إيقاف JavaScript في الإعلانات المصاحبة التي تستخدم مستوى واجهة برمجة تطبيقات أقل من 21 لمعالجة مشكلة في الثغرات الأمنية
  • سيتم إيقاف الإصدار 3.23.0 من حزمة تطوير البرامج (SDK) نهائيًا في 3 حزيران (يونيو) 2022. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.22.3 2021-03-16
  • إصلاح خطأ NullPointerException متعلّق بإصدار الAdsLoader أثناء تحميل إعلان
  • تُضيف خطأ 1206 لحالة UNEXPECTED_ADS_LOADED_EVENT في الحالات التي يتم فيها إرسال حدث "تم تحميل الإعلانات" بشكل غير متوقّع.
  • سنوقف نهائيًا استخدام الإصدار 3.22.3 من حزمة SDK في 7 نيسان (أبريل) 2022. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.22.2 2021-02-26
  • تعتمد حزمة تطوير البرامج لإعلانات الوسائط التفاعلية الآن على المكتبات التالية:
    • com.google.android.gms:play-services-base
    • com.google.android.gms:play-services-basement
    • androidx.preference:preference
  • إصلاح رسالة الخطأ التي تظهر عندما يتلقّى AdsLoader خطأ بدون معرّف جلسة صالح
  • سنوقف الإصدار 3.22.2 من حزمة تطوير البرامج (SDK) نهائيًا في 16-03-2022. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.22.0 2021-01-11
  • إضافة عرض مجموعات للفيديوهات في أحداث البث المباشر المستند إلى الإعلانات في سير عمل عرض المجموعات الإعلانية، يكون "مدير إعلانات Google" مسؤولاً فقط عن عرض الإعلانات. يتحمّل الناشرون مسؤولية المحتوى وإنشاء البيان الذي سيشير بعد ذلك إلى "مدير إعلانات Google". استخدِم ImaSdkFactory.createPodStreamRequest() لإنشاء طلب بث لعرض مجموعة قنوات. وفي حال استخدام هذه الطريقة، ستكون مسؤولاً عن تحميل البث على streamInit().
  • تم إصلاح تسرُّب الذاكرة الناتج عن عدم تنظيف أداة مراقبة مراحل نشاط التطبيق بشكل صحيح.
  • سنوقف نهائيًا استخدام الإصدار 3.22.0 من حزمة تطوير البرامج (SDK) في 26 شباط (فبراير) 2022. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.21.4 2020-12-09
  • إزالة رسالة تحذير غير ضارة متعلقة بالاتصال adsLoader.release() بعد إغلاق webview
  • سنوقف الإصدار 3.21.4 من حزمة تطوير البرامج (SDK) نهائيًا في 08-01-2022. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.21.2 2020-11-20
  • تم إصلاح المشاكل غير المتوقعة الآمنة في سلاسل المحادثات والتي تنتج عن إرسال تعديلات الرسائل من قائمة انتظار فارغة.
  • تعديل المستندات المتعلّقة بتطبيق AdsLoader.release()
  • سيتم إيقاف الإصدار 3.21.2 من حزمة SDK نهائيًا في 9 كانون الأول (ديسمبر) 2021. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.21.1 2020-11-17
  • إصلاح مشكلة كانت تؤدي أحيانًا إلى تعطُّل التطبيق عند بدء الأحداث
  • سيتم إيقاف الإصدار 3.21.1 من حزمة تطوير البرامج (SDK) نهائيًا في 20 تشرين الثاني (نوفمبر) 2021. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.21.0 2020-10-23
  • إتاحة عرض الإعلانات المستندة إلى معرّف شريحة SIM في حزمة تطوير البرامج (SDK) لعرض الإعلانات الديناميكية أثناء التشغيل على Android
  • لإضافة طريقة AdsLoader.release() وإيقاف BaseDisplayContainer.destroy() نهائيًا. يحلّ هذا التغيير مشكلة تسرُّب الذاكرة التي حدثت عند التخلص من BaseDisplayContainer في منتصف جدول عرض إعلانات VMAP. AdsLoader.release() هي الطريقة الجديدة المقترَحة للتخلص من عناصر حزمة تطوير البرامج (SDK) لإعلانات الوسائط التفاعلية، بدلاً من استخدام BaseDisplayContainer.destroy().
  • سنوقف الإصدار 3.21.0 من حزمة تطوير البرامج (SDK) نهائيًا في 17-11-2021. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.20.1 2020-10-12
3.20.0 2020-08-18
  • الإصدار 3.20.0 هو أول إصدار سيتأثّر ب التغييرات في سلوك الإيقاف المؤقت في IMA. إذا كنت تستخدم هذا الإصدار أو أي إصدار مستقبلي من حزمة SDK، ننصحك بقراءة مقالة المدونة وإجراء التغييرات على سلوك الإيقاف المؤقت في تطبيقك. يمكن للناشرين اختبار تنفيذ هذه التغييرات باستخدام علامة الإعلان التجريبي.
  • تتم إضافة استدعاءَي onPause() وonResume() لفئة DAI VideoStreamPlayer.
  • تضيف الطريقة adPeriodDuration() إلى فئة AdProgressInfo.
  • إتاحة استخدام صور احتياطية عند النقر على الرموز على أجهزة Android TV
  • تُضيف القيمة ICON_FALLBACK_IMAGE_CLOSED الحدث الذي يتم التعامل معه عند إغلاق الصورة الاحتياطية للرمز على أجهزة Android TV .
  • إزالة طريقة focusSkipButton() التي تم إيقافها نهائيًا من AdsManager واستبدالها بطريقة focus()
  • بالنسبة إلى أجهزة التلفزيون المتّصلة، يتم الآن التركيز على الإعلانات تلقائيًا عند بدء حدث AdEvent.AdEventType STARTED. لإيقاف ميزة التركيز التلقائي على الإعلانات، استخدِم أسلوب adsRenderingSettings.setFocusSkipButtonWhenAvailable(false) ثم استخدِم أسلوب focus() استنادًا إلى المتطلبات المخصّصة.
  • تضيف الطريقة getCurrentTimeMs() و getDurationMs إلى فئة VideoProgressUpdate().
  • إيقاف الطريقتَين getCurrentTime و getDuration نهائيًا واستبدالهما بالطريقتَين الجديدتَين getCurrentTimeMs وgetDurationMs
  • تم إصلاح مشكلة في أحداث البث المباشر المستندة إلى DASH والتي لم يكن يتم فيها الإبلاغ عن أحداث الإعلانات بشكل صحيح.
  • سنوقف نهائيًا استخدام الإصدار 3.20.0 من حزمة تطوير البرامج (SDK) في 12 تشرين الأول (أكتوبر) 2021. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.19.4 2020-07-08
  • تم إصلاح مشكلة كانت تمنع setLoadVideoTimeout من تعديل مهلة الانتظار بشكل صحيح.
  • سنوقف الإصدار 3.19.4 من حزمة تطوير البرامج (SDK) نهائيًا في 18-08-2021. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.19.3 2020-06-29
  • تم إصلاح مشكلة دمج إطار الشفافية والموافقة الصادر عن مكتب IAB بموجب اللائحة العامة لحماية البيانات، والتي تسببت في حدوث أعطال للّاعبين المدمجين في حِزم تطوير البرامج (SDK) في "منصّة إدارة الموافقة".
  • سنوقف نهائيًا استخدام الإصدار 3.19.3 من حزمة تطوير البرامج (SDK) في 8 تموز (يوليو) 2021. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.19.2 2020-06-22
  • إصلاح مشكلة كانت تؤدي إلى تجاهل حزمة تطوير البرامج (SDK) لأحداث VideoAdPlayerCallback.onContentComplete() خارج نطاق تشغيل الإعلان
  • تضيف هذه السمة إمكانية تحديد مجموعات مختلفة من الترجمة والشرح المستندة إلى الذكاء الاصطناعي للغة نفسها باستخدام المَعلمة subtitle_name لملف VideoStreamPlayer.loadUrl().
  • سيتم إيقاف الإصدار 3.19.2 من حزمة SDK نهائيًا في 29 حزيران (يونيو) 2021. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.19.0 2020-05-12
3.18.1 2020-03-25
  • تضيف هذه الميزة ميزة تغيير حجم "الإعلانات المصاحبة" على الأجهزة ذات كثافة وحدات البكسل العالية.
  • تتيح استخدام إعلانات SIMID من جهة العميل.
  • سنوقف نهائيًا استخدام الإصدار 3.18.1 من حزمة تطوير البرامج (SDK) في 12 أيار (مايو) 2021. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.18.0 2020-03-04
  • تُضيف هذه الوظيفة دالةَي pause() وresume() إلى واجهة VideoStreamPlayer يجب تنفيذ هذه التغييرات في الإصدار 3.18.0 والإصدارات الأحدث.
  • سنوقف نهائيًا استخدام الإصدار 3.18.0 من حزمة تطوير البرامج (SDK) في 25 آذار (مارس) 2021. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.17.0 2020-02-07
3.16.5 2020-01-22
  • تتيح ميزة "إعادة العمل" استخدام ‎contentUrl في OMID 1.3 مع AdsRequest.setContentUrl و StreamRequest.setContentUrl .
  • تتيح عمليات إعادة العمل استخدام العوائق المتوافقة مع OMID 1.3 باستخدام FriendlyObstruction .
  • إيقاف الطريقتَين BaseDisplayContainer.registerVideoControlsOverlay وBaseDisplayContainer.unregisterAllVideoControlsOverlay نهائيًا واستبدالهما بالطريقة FriendlyObstruction
  • حلّ مشكلة تتعلّق بخطأ NullPointerException الذي يحدث بعد الاتصال بخطأ clear() في CompanionAdSlots
  • إصلاح مشكلة كانت تؤدي على الأرجح إلى تسرُّب الذاكرة عند استدعاء destroy() أثناء تشغيل الإعلان
  • سيتم إيقاف الإصدار 3.16.5 من حزمة تطوير البرامج (SDK) نهائيًا في 7 شباط (فبراير) 2021. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.16.2 2019-12-05
  • إتاحة تضمين مَعلمات الموافقة تلقائيًا من الإصدار 2 من إطار الشفافية والموافقة الصادر عن مكتب IAB وقانون خصوصية المستهلك في كاليفورنيا (CCPA)
  • يتطلب استخدام الإعدادات المفضّلة في Android الآن حزمة androidx.
  • سيتم إيقاف الإصدار 3.16.2 من حزمة تطوير البرامج (SDK) نهائيًا في 22 كانون الثاني (يناير) 2021. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.16.1 2019-11-08
3.16.0 2019-10-23
  • تُضيف هذه الطريقة الأسلوب replaceAdTagParameters إلى StreamManager، ما يتيح إمكانية استبدال جميع مَعلمات علامة الإعلان أثناء البث المباشر.
  • إزالة إمكانية استخدام الطرق التالية المتوقّفة نهائيًا:
    • AdsRequest.getAdDisplayContainer()
    • AdsRequest.setAdDisplayContainer(AdDisplayContainer adDisplayContainer)
    • ImaSdkFactory.createAdsLoader(Context context)
    • ImaSdkFactory.createAdsLoader(Context context, ImaSdkSettings settings)
    • ImaSdkFactory.createLiveStreamRequest(String assetKey, String apiKey, StreamDisplayContainer streamDisplayContainer)
    • ImaSdkFactory.createVodStreamRequest(String contentSourceId, String videoId, String apiKey, StreamDisplayContainer streamDisplayContainer)
    • StreamRequest.getStreamDisplayContainer()
  • سنوقف الإصدار 3.16.0 من حزمة تطوير البرامج (SDK) نهائيًا في 08-11-2020. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.14.0 2019-09-11
  • إصدار الخدمة، ما مِن ميزات جديدة.
  • سيتم إيقاف الإصدار 3.14.0 من حزمة SDK نهائيًا في 23 تشرين الأول (أكتوبر) 2020. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.13.1 2019-09-03
  • تضيف هذه الميزة إمكانية ضبط سياق التشغيل المتواصل لطلب إعلان. لمعرفة مزيد من التفاصيل، يُرجى الاطّلاع على setContinuousPlayback().
  • تُضيف هذه الطريقة الأسلوب getUniversalAdIds() إلى فئة Ad.
  • إضافة الأنواع التالية: setAuthToken، getAuthToken، setFormat، getFormat وStreamFormat enum
  • إصلاح خطأ في أجهزة Nexus 5 يحدث عند إزالة حاوية قبل تلقّي استجابة إعلان
  • إصلاح مشكلة عرض الإعلانات المصاحبة مرة واحدة فقط.
  • إصلاح مشكلة عدم تعذُّر عرض أنواع الإعلانات غير المتوافقة (الإعلانات غير الخطية وVPAID) بشكلٍ سلس
  • سنوقف نهائيًا استخدام الإصدار 3.13.1 من حزمة SDK في 11 أيلول (سبتمبر) 2020. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.11.3 2019-06-11
  • إصلاح خلل في إعداد is_lat على أجهزة AOSP
  • سنوقف الإصدار 3.11.3 من حزمة تطوير البرامج (SDK) نهائيًا في 03/09/2020. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.11.2 2019-04-16
  • إصلاح العُطل التالي: java.lang.ClassNotFoundException: Didn't find class "j$.util.concurrent.ConcurrentHashMap"
  • سيتم إيقاف الإصدار 3.11.0 من حزمة SDK نهائيًا في 11 حزيران (يونيو) 2020. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
الإصدار 3.11.0 متوقّف نهائيًا 2019-03-22
3.10.9 2019-03-13
  • تم إصلاح خلل في حالة السباق حيث لا يتم عرض واجهة مستخدم الإعلان أحيانًا في الإعلانات اللاحقة بعد تخطّي الإعلان الأول.
  • تم إصلاح مشكلة تعطُّل حدثت عند استدعاء واجهة برمجة التطبيقات getCompanionAds().
  • سنوقف الإصدار 3.10.7 من حزمة تطوير البرامج (SDK) نهائيًا في 22-03-2020. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.10.7 2019-02-19
3.10.6 2019-01-23
  • إضافة طريقة seek() إلى واجهة مشغّل البث
  • إضافة إمكانية استخدام AD_BUFFERING لعمليات استدعاء أحداث الإعلانات
  • يجب عدم تمرير الحاويات في طلب الإعلان بعد الآن. يتطلّب سير العمل الجديد تمرير حاوية من خلال AdsLoader منشئ.
  • تُضيف طريقة BaseDisplayContainer.destroy().
  • إصلاح تسرُّب الذاكرة الذي حدث عند اكتمال تشغيل الفيديو
  • إيقاف requestNextAdBreak ستتم إزالة واجهة برمجة التطبيقات هذه في إصدار مستقبلي. وبعد ذلك، سيتم جلب الإعلانات تلقائيًا قبل 4 ثوانٍ من وقت بدء الفاصل الإعلاني.
  • سيتم إيقاف الإصدار 3.10.2 من حزمة تطوير البرامج (SDK) نهائيًا في 19 شباط (فبراير) 2020. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.10.2 2018-11-13
  • إصلاح حالة تنافٍ تؤدي إلى ظهور خطأ VAST 402 في الإعلان الثاني ضمن مجموعة إعلانية
  • تضيف هذه الميزة ميزة تحديد عدد مرّات الظهور والاستبعاد التنافسي إلى حزمة تطوير البرامج (SDK) لعرض الإعلانات الديناميكية أثناء التشغيل على Android.
  • نقل getAdProgressInfo() من StreamManager إلى BaseManager
  • إضافة getVastMediaHeight() وgetVastMediaWidth() وgetVastMediaBitrate() إلى Ad
  • سنوقف الإصدار 3.9.4 من حزمة تطوير البرامج (SDK) نهائيًا في 23-01-2020. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.9.4 2018-08-01
  • لإضافة getCompanionAds() إلى Ad يؤدي ذلك إلى عرض إعلانات مصاحبة أثناء استخدام DAI فقط.
  • تُضيف فئة CompanionAd جديدة.
  • إضافة حدث SKIPPABLE_STATE_CHANGED جديد إلى AdEvent
  • إصلاح مشكلة عدم الالتزام بالإعداد التلقائي لـ focusSkipButtonWhenAvailable في بعض الحالات
  • سنوقف الإصدار 3.9.0 من حزمة تطوير البرامج (SDK) نهائيًا في 01-08-2019. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.9.0 2018-07-09
  • يمكنك الآن استخدام Android TV.
  • لإضافة focusSkipButton() إلى AdsManager لن تعمل هذه الميزة إلا على Android TV.
  • تضيف getFocusSkipButtonWhenAvailable() إلى AdsRenderingSettings، ويكون الإعداد التلقائي هو true. لن تعمل هذه الميزة إلا على Android TV.
  • لإضافة setFocusSkipButtonWhenAvailable() إلى AdsRenderingSettings يمكن استخدام هذه الميزة على Android TV فقط.
  • VideoAdPlayer يوفّر الآن واجهة VolumeProvider. أصبح تنفيذ هذه الواجهة مطلوبًا الآن للتشغيل المخصّص.
  • سنوقف نهائيًا استخدام الإصدار 3.8.7 من حزمة SDK في 9 تموز (يوليو) 2019. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.8.7 2018-05-23
  • السماح بعرض الصور المتحركة في الإعلانات المصاحبة التي تستخدم HTML
  • سنوقف نهائيًا استخدام الإصدار 3.8.5 من حزمة تطوير البرامج (SDK) في 23 أيار (مايو) 2019. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.8.5 2018-04-09
  • حلّ مشكلة تجاهل ImaSdkSettings
  • يعمل على إصلاح مشكلة حدوث تعارضات مع ملفات إصدار com.android.support.
  • لإضافة setAdWillPlayMuted إلى AdsRequest
  • لإضافة setLoadVideoTimeout إلى AdsRenderingSettings
  • سنوقف الإصدار 3.8.2 من حزمة تطوير البرامج (SDK) نهائيًا في 09/04/2019. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.8.2 2018-01-24
  • لإضافة setLiveStreamPrefetchSeconds إلى AdsRequest
  • إصلاحات متنوّعة في المستندات
  • سنوقف نهائيًا استخدام الإصدار 3.7.4 من حزمة تطوير البرامج (SDK) في 24‏ كانون الثاني (يناير) 2019. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.7.4 2017-06-29
  • لإضافة setVastLoadTimeout إلى AdsRequest
  • لإضافة getSkipTimeOffset إلى Ad
  • سنوقف الإصدار 3.7.2 من حزمة تطوير البرامج (SDK) نهائيًا في 29-06-2018. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.7.2 2017-05-25
  • لإضافة setDebugMode إلى ImaSdkSettings
  • سيتم إيقاف الإصدار 3.7.1 من حزمة تطوير البرامج (SDK) نهائيًا في 25 أيار (مايو) 2018. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.7.1 2017-03-24
  • حلّ تعارض مساحة الاسم عند استخدام Proguard
  • تم تقليل حجم الجرة بمقدار 30 كيلوبايت تقريبًا.
  • سيتم إيقاف الإصدار 3.7.0 من حزمة SDK نهائيًا في 24 آذار (مارس) 2018. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.7.0 2017-03-13
  • إصلاح مشكلة دمج بعض فئات IMA عن طريق الخطأ في حزمة a.a.a.a في ProGuard
  • سنوقف نهائيًا استخدام الإصدار 3.6.0 من حزمة SDK في 13 آذار (مارس) 2018. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.6.0 2017-02-16
  • تُضيف ما يلي إلى Ad:
    • getAdWrapperCreativeIds()
    • getAdvertiserName()
    • getCreativeAdId()
    • getCreativeId()
    • getDealId()
    • getSurveyUrl()
    • getUniversalAdIdRegistry()
    • getUniversalAdIdValue()
  • إضافة AdsManager.requestNextAdBreak().
  • تُضيف ما يلي إلى AdsRenderingSettings:
    • setEnablePreloading()
    • getEnablePreloading()
  • تُضيف ما يلي إلى AdsRequest:
    • setContentDuration()
    • setContentKeywords()
    • setContentTitle()
  • سنوقف الإصدار 3.5.2 من حزمة تطوير البرامج (SDK) نهائيًا في 16-02-2018. لمزيد من التفاصيل، يُرجى الاطّلاع على جدول الإيقاف النهائي.
3.5.2 2016-11-14
  • تضيف هذه الطريقة مشغل فيديو تابعًا لحزمة تطوير البرامج (SDK) يتولى تشغيل الإعلانات اختياريًا.
  • لإضافة CompanionAdSlot.ClickListener وطرق لإضافة مستمع وإزالته
  • يتم إصلاح مشكلة في سجلّات أخطاء getViewability() غير الصالحة.
  • حل مشكلة تتعلق بسلوك النقر للرموز وعدم عرضها بشكل صحيح.
  • سيتم إيقاف الإصدار 3.4.0 من حزمة SDK نهائيًا في 14‏ تشرين الثاني (نوفمبر) 2017. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.4.0 2016-09-12
  • إصلاح خطأ الملفات المكرّرة عند استخدام الإصدار 9.0.0 من "خدمات Google Play" والإصدارات الأحدث
3.3.2 2016-07-11
3.3.0 2016-05-31
3.2.1 2016-04-07
  • إصدار الخدمة، ما مِن ميزات جديدة.
3.1.3 2015-12-16
  • الإصدار النهائي
  • تُضيف هذه الإضافة AdsManager.discardAdBreak إلى واجهة برمجة التطبيقات.
3.b13.3 (إصدار تجريبي) 2015-09-10
  • إصدار الخدمة، ما مِن ميزات جديدة.
3.b12.1 (إصدار تجريبي) 2015-07-20
3.b11.4 (إصدار تجريبي) 2015-05-21
  • تضيف الميزة ما يلي إلى واجهة برمجة التطبيقات:
    • AdError.AdErrorCode.VAST_EMPTY_RESPONSE
    • AdError.getErrorNumber()
    • AdsRequest.setAdWillAutoPlay(Boolean)
    • CompanionAdSlot.isFilled()
    • ImaSdkSettings.setPlayerType(String)
    • ImaSdkSettings.setPlayerVersion(String)
3.b10.3 (إصدار تجريبي) 2015-03-24
  • تمت إضافة "ImaSdkSettings.getMaxRedirects" و"ImaSdkSettings.setMaxRedirects".
  • أصبحت فئات IMA API الآن final.
  • تظهر أرقام إصدارات حزمة تطوير البرامج (SDK) الآن بالتنسيق 3.bX.Y مع b للإشارة إلى حالة الإصدار التجريبي من حزمة SDK.
  • تمت إزالة قيم AdError.AdErrorCode التالية:
    • ‫API_ERROR - استخدِم UNKNOWN_AD_RESPONSE بدلاً منه.
    • PLAYLIST_MALFORMED_RESPONSE - استخدِم UNKNOWN_AD_RESPONSE بدلاً من ذلك.
    • "REQUIRED_LISTENERS_NOT_ADDED" لم يتم جمعه من خلال حزمة تطوير البرامج (SDK).
    • ‫VAST_INVALID_URL - استخدِم VAST_LOAD_TIMEOUT بدلاً منه.
الإصدار التجريبي 9 2014-10-17
  • تضيف واجهات برمجة التطبيقات لإعلانات Google‏ getTitle وgetDescription وgetContentType.
  • تُضيف هذه السمة معلومات عن موضع مجموعة الإعلانات إلى واجهة مستخدِم الإعلان، على سبيل المثال: "الإعلان 1 من 4: (0:13)".
  • لن يعود بإمكانك التحكّم مباشرةً في إيقاف الإعلانات مؤقتًا أو تشغيلها أو استئنافها باستخدام مشغّل الفيديو. بدلاً من ذلك، استخدِم AdsManager.pause() وAdsManager.resume().
الإصدار التجريبي 8 2014-06-12
  • إصلاح مشكلة عدم محو واجهة مستخدِم الإعلان للإعلانات القابلة للتخطّي
  • توثيق رمز الخطأ لوقت انتهاء مهلة تحميل ملف الوسائط
الإصدار التجريبي 7 2014-05-27
الإصدار التجريبي 6 2014-04-14
  • إتاحة استخدام نموذج عرض إعلانات الفيديو 3
  • إضافة دعم جزئي لـ VMAP (مساواة مع قواعد الإعلانات الحالية في "مدير إعلانات Google")
  • إضافة ما يلي إلى واجهة برمجة التطبيقات:
    • AdError.AdErrorCode.ADS_REQUEST_NETWORK_ERROR
    • AdEvent.AdEventType.LOG
    • AdEvent.getAdData()
    • AdPodInfo.getMaximumDuration()
    • AdPodInfo.getPodIndex()
    • AdPodInfo.getTimeOffset()
  • إصلاح خلل كان يؤدي إلى تخطّي جميع الإعلانات الأخرى في مجموعة الإعلانات المتسلسلة عند عرض إعلانات أثناء التشغيل في مجموعة إعلانات متسلسلة محسّنة ومزوّدة بغلاف
  • لن يتم بعد ذلك تجاهل إعدادات AdsRenderingSettings التي تم تمريرها إلى AdsManager.
  • تم إصلاح عدة أخطاء لتعزيز ثبات النظام.
الإصدار التجريبي 5 2013-12-12
  • حلّ مشكلة الإعلانات القابلة للتخطّي في قوائم التشغيل
الإصدار التجريبي 4 2013-10-15
  • تمت إضافة إمكانية إعادة ضبط قيم المرتبط من خلال استدعاء contentComplete في AdsLoader.
الإصدار التجريبي 3 2013-09-05
  • إصدار الخدمة، ما مِن ميزات جديدة.
الإصدار التجريبي 2 2013-07-07
  • الإصدار العلني للإصدار التجريبي من حزمة SDK
الإصدار التجريبي المغلق 2 2013-06-24
  • تمت إضافة واجهة برمجة التطبيقات لضبط لغة واجهة المستخدم على العنصر ImaSdkSettings. يُرجى العِلم أنّ هذا الإعداد يُستخدَم لضبط لغة واجهة المستخدم، وليس لغة الإعلان.
  • تم إصلاح تعارض كان يحدث عندما يتضمّن التطبيق كلّ من مكتبتَي IMA SDK وAdMob SDK.
  • تمت إضافة تسجيل لمقاييس أداء داخلية مختلفة.
الإصدار 1 من الإصدار التجريبي المغلق 2013-04-02

  • الإصدار التجريبي الأولي في ما يلي المشاكل المعروفة في الإصدار التجريبي:

    المراجع ذات الصلة بحِزم SDK

    إنّ AdEvents التالية المتوفّرة في حزمة تطوير البرامج لإعلانات الوسائط التفاعلية بتنسيق HTML5 غير متوافقة مع الإصدار 3 من حزمة تطوير البرامج لإعلانات الوسائط التفاعلية على Android: IMPRESSION، LOG، SKIPPABLE_STATE_CHANGED، STOPPED، VOLUME_CHANGED، VOLUME_MUTED

    أمثلة على المحتوى ذي الصلة بالتطبيق

    1. هناك مشكلة متقطّعة تؤدي إلى عدم إعادة تشغيل مشغّل الإعلان بشكلٍ سليم بعد أن ينقر المستخدِم على إعلان. على سبيل المثال، في بعض الأحيان، عند العودة إلى التطبيق بعد النقر على إعلان، يؤدي استئناف تشغيل هذا الإعلان إلى التخطّي إلى النهاية وإكماله، بدلاً من استئناف تشغيله من حيث توقف قبل النقر عليه.
    2. الإعلانات التي تعرضها علامة الإعلان "الإعلانات أثناء عرض الفيديو 2" غير متوافقة مع الإصدار 3 من أداة تطوير البرامج لإعلانات الوسائط التفاعلية على Android.
    3. لا يوقف مشغّل العيّنات تلقائيًا ميزة التقديم/الترجيع أثناء عرض الإعلانات. تأكد من إيقاف التقديم/الترجيع في مشغّل الفيديو أثناء عرض الإعلانات.