سجلّ إصدار حزمة SDK لإدراج إعلان ديناميكي لإعلانات الوسائط التفاعلية من Google لإعلانات الوسائط التفاعلية

الإصدار تاريخ الإصدار Notes
3.33.0 2024-03-28
3.32.0 تم إيقاف العمل به 2024-01-30
  • يواجه هذا الإصدار مشكلة في الجهاز الذي يعمل بالمستوى 25 أو أقل من واجهة برمجة تطبيقات Android. استخدِم الإصدار 3.33.0 من أداة تطوير البرامج لإعلانات الوسائط التفاعلية بدلاً من ذلك.
  • تتيح هذه الميزة استخدام أداة تجميع الفيديوهات عند الطلب التابعة لجهات خارجية لعرض مجموعات الإعلانات المتسلسلة. يمكنك الاطّلاع على دليل عرض لوحات Android المتسلسلة للحصول على مزيد من المعلومات، بما في ذلك إضافة واجهات برمجة التطبيقات التالية:
  • عليك زيادة minSdkVersion التي تتوافق مع إعلانات الوسائط التفاعلية إلى 19.
  • حلّ المشكلة التي تؤدي إلى عدم فتح صفحة جديدة في الإصدار 30 من واجهة برمجة تطبيقات Android والإصدارات الأحدث عند النقر على زر "مزيد من المعلومات" باستخدام زر "مزيد من المعلومات" لا تزال المشكلة قائمة على الإصدارات من 3.31.0 حتى 3.29.0 من حزمة تطوير البرامج لإعلانات الوسائط التفاعلية، حيث يلزم إيجاد حل بديل حتى تنجح نسبة النقر إلى الظهور في الإعلانات.
  • إصلاح خطأ حيث قد يؤدي استخدام AdsLoader.addAdsLoadedListener() إلى حدوث استثناء ArrayIndexOutOfBoundsException.
  • تتم إضافة خطأ الإعلان VAST_NO_ADS_AFTER_WRAPPER.
3.31.0 2023-08-31
  • حدثت مشكلة في الإصدارات من 3.31.0 حتى 3.29.0 من حزمة تطوير البرامج لإعلانات الوسائط التفاعلية في الإصدار 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) لإعلانات الوسائط التفاعلية على أداة OM إلى الإصدار 1.4.8 الذي يتضمّن إشارات جديدة للتلفزيون المتّصل
  • إيقاف واجهات برمجة التطبيقات AdsRequest التالية نهائيًا:
    • getExtraParameter()
    • getExtraParameters()
    • setExtraParameter()
  • سيتم إيقاف الإصدار 3.31.0 نهائيًا من حزمة تطوير البرامج (SDK) في XX/1/2025. يمكنك الاطّلاع على الجدول الزمني للإيقاف للحصول على مزيد من التفاصيل.
3.30.3 2023-08-03
  • يحدّث تبعيات المكتبة الداخلية لتحسين وقت استجابة بدء التشغيل.
  • سيتم إيقاف الإصدار 3.30.3 نهائيًا من حزمة تطوير البرامج (SDK) في 31 آب (أغسطس) 2024. يمكنك الاطّلاع على الجدول الزمني للإيقاف للحصول على مزيد من التفاصيل.
3.30.2 2023-07-28
  • إصلاح أخطاء NullPointerException غير المتوقعة التي تظهر في الإصدار 3.30.1.
  • يعمل على إصلاح مشكلة توفير المتطلبات اللازمة تسبّبت في عدم انبعاث بعض الأحداث من حزمة تطوير البرامج (SDK). يؤثر هذا الخطأ في إضافة ExoPlayer لحزمة تطوير البرامج لإدراج إعلان ديناميكي لإعلانات الوسائط التفاعلية.
  • تتوافق هذه الميزة مع الإصدار 8 والإصدارات الأحدث من Gradle. ويجب في الإصدارات السابقة من حزمة تطوير البرامج لإعلانات الوسائط التفاعلية لنظام التشغيل Android ضبط android.enableR8.fullMode=false في ملف gradle.properties. يمكنك الاطّلاع على مقالة الوضع الكامل في R8 للحصول على مزيد من المعلومات.
  • سيتم إيقاف الإصدار 3.30.2 من حزمة تطوير البرامج (SDK) نهائيًا في 03-08-2024. يمكنك الاطّلاع على الجدول الزمني للإيقاف للحصول على مزيد من التفاصيل.
3.30.1 إيقاف نهائيًا 2023-04-18
  • يحتوي هذا الإصدار على مشكلة تتضمّن أخطاء NullPointerException غير متوقّعة. استخدِم الإصدار 3.29.0 من حزمة تطوير البرامج لإعلانات الوسائط التفاعلية (IMA) الأقدم من نظام التشغيل Android إلى أن يتم إطلاق إصدار أحدث يعمل.
  • إصلاح مشكلة تعطُّل التطبيقات التي تستخدم الإصدار 3.30.0 على أجهزة أخرى غير Android TV.
3.30.0 تم إيقاف العمل بها 2023-03-29
  • يتسبب هذا الإصدار في حدوث مشكلة في التطبيقات التي لا تعمل على نظام Android TV الأساسي. استخدِم الإصدار 3.29.0 من حزمة تطوير البرامج لإعلانات الوسائط التفاعلية بدلاً من ذلك.
  • إضافة واجهة برمجة التطبيقات 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.
  • إعادة تسمية واجهات برمجة التطبيقات الخاصة بخدمة "الإشارات المشفّرة للناشرين" (ESP) لتصبح واجهات برمجة تطبيقات الإشارات الآمنة
  • إضافة واجهات برمجة التطبيقات للعلامات المميزة. يمكنك استخدام واجهات برمجة التطبيقات المستندة إلى ميزة "علامة الميزات" لتفعيل ميزات محدّدة أو إيقافها في إعلانات الوسائط التفاعلية. استخدِم ImaSdkSettings.getFeatureFlags() وImaSdkSettings.setFeatureFlags() للحصول على علامات الميزات وإعدادها.
  • إصلاح المشكلة المتمثلة في عدم إرسال بعض أحداث إعلانات الوسائط التفاعلية.
  • إضافة androidx.webkit:webkit كإحدى أدوات تطوير البرامج لإعلانات الوسائط التفاعلية
  • سيتم إيقاف الإصدار 3.29.0 نهائيًا من حزمة تطوير البرامج (SDK) في 29-3-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 أيلول (سبتمبر) 2023. يمكنك الاطّلاع على الجدول الزمني للإيقاف للحصول على مزيد من التفاصيل.
3.27.1 2022-05-27
  • إصدار الخدمة، ما مِن ميزات جديدة.
  • سيتم إيقاف الإصدار 3.27.1 نهائيًا من حزمة تطوير البرامج (SDK) في 03-08-2023. يمكنك الاطّلاع على الجدول الزمني للإيقاف للحصول على مزيد من التفاصيل.
3.27.0 2022-03-01
  • تتم إضافة إمكانية استخدام الخانات المصاحبة ذات الحجم السائل عن طريق ضبط عرض الإعلان المصاحب وارتفاعه على قيمة ثابتة لإعلانات الوسائط التفاعلية FLUID_SIZE .
  • سيتم إيقاف الإصدار 3.27.0 نهائيًا من حزمة تطوير البرامج (SDK) في 27 تموز (يوليو) 2023. يمكنك الاطّلاع على الجدول الزمني للإيقاف للحصول على مزيد من التفاصيل.
3.26.0 2022-01-12
  • تتم إضافة واجهات برمجة تطبيقات الإشارات المشفّرة للناشرين (ESP) (التي تمت إعادة تسميتها إلى الإشارات الآمنة في الإصدار 3.29.0 من حزمة تطوير البرامج لإعلانات الوسائط التفاعلية). يتيح ذلك للناشرين تفعيل عروض الأسعار على الشبكة وموفِّري الهوية (idP).
  • سيتم إيقاف الإصدار 3.26.0 نهائيًا من حزمة تطوير البرامج (SDK) في 1 آذار (مارس) 2023. يمكنك الاطّلاع على الجدول الزمني للإيقاف للحصول على مزيد من التفاصيل.
3.25.1 2021-11-08
  • تضيف AdsRenderingSettings.setEnableCustomTabs() وAdsRenderingSettings.getEnableCustomTabs() لنسبة النقر إلى الظهور للإعلانات داخل التطبيق باستخدام علامات التبويب المخصّصة.
  • بدايةً من الإصدار 3.25.1، ستتضمّن حزمة تطوير البرامج لإعلانات الوسائط التفاعلية الإذن com.google.android.gms.permission.AD_ID في ملف بيان حزمة تطوير البرامج (SDK) الذي يتم دمجه تلقائيًا في ملف بيان التطبيق عن طريق أدوات إصدار Android. لمزيد من المعلومات حول بيان الإذن AD_ID، بما في ذلك كيفية إيقافه، يمكنك مراجعة مقالة مركز مساعدة Play Console هذه.
  • ستتم إضافة إمكانية استخدام معرّف مجموعة التطبيقات في حالات الاستخدام، مثل الإبلاغ عن المحتوى ومنع الاحتيال.
  • تتيح إضافة تحسينات في الأداء عند استخدام مثيلات AdsLoader متعدّدة من خلال إتاحة التخزين المؤقت لسلاسل المحادثات وإعادة استخدامها.
  • سيتم إيقاف الإصدار 3.25.1 نهائيًا من حزمة تطوير البرامج (SDK) في 12-01-2023. يمكنك الاطّلاع على الجدول الزمني للإيقاف للحصول على مزيد من التفاصيل.
3.24.0 2021-06-03
  • تعمل هذه السياسة على إضافة واجهات برمجة تطبيقات دقة النقطة الثابتة للفئتَين CuePoint وStreamManager المستخدَمَين في ميزة DAI. يؤدي ذلك إلى إضافة واجهات برمجة التطبيقات التالية: وسيتم إيقاف واجهات برمجة التطبيقات التالية نهائيًا:
    • CuePoint.getEndTime()
    • CuePoint.getStartTime()
    • StreamManager.getContentTimeForStreamTime()
    • StreamManager.getPreviousCuePointForStreamTime()
    • StreamManager.getStreamTimeForContentTime()
  • لمنع خطأ NullPointerException المتعلّق بالطلبات الداخلية المرسَلة إلى StreamRequest.getContentUrl().
  • سيتم إيقاف الإصدار 3.24.0 نهائيًا من حزمة تطوير البرامج (SDK) في 08-11-2022. يمكنك الاطّلاع على الجدول الزمني للإيقاف للحصول على مزيد من التفاصيل.
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) في 07-04-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 آذار (مارس) 2022. يمكنك الاطّلاع على الجدول الزمني للإيقاف للحصول على مزيد من التفاصيل.
3.22.0 2021-01-11
  • تتيح إضافة عرض لوحات الإعلانات المتسلسلة الخاصة ببث DAI. في سير عمل عرض الإعلانات المتسلسلة، يكون "مدير الإعلانات" مسؤولاً عن عرض الإعلانات فقط. ويتحمّل الناشرون مسؤولية المحتوى وإنشاء البيان الذي سيشير إلى "مدير الإعلانات". استخدِم 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
  • تتوافق هذه الميزة مع إعلانات SIMID في حزمة تطوير البرامج (SDK) الخاصة بـ DAI لنظام التشغيل Android.
  • لإضافة طريقة AdsLoader.release() وإيقاف BaseDisplayContainer.destroy() نهائيًا يحل هذا التغيير مشكلة تسرُّب الذاكرة الذي حدث عند التخلص من BaseDisplayContainer في منتصف جدول عرض إعلانات VMAP. تمثّل السمة AdsLoader.release() الطريقة الجديدة المقترَحة للتخلص من عناصر حزمة تطوير البرامج لإعلانات الوسائط التفاعلية بدلاً من استخدام BaseDisplayContainer.destroy().
  • سيتم إيقاف الإصدار 3.21.0 نهائيًا من حزمة تطوير البرامج (SDK) في 17 تشرين الثاني (نوفمبر) 2021. يمكنك الاطّلاع على الجدول الزمني للإيقاف للحصول على مزيد من التفاصيل.
3.20.1 2020-10-12
3.20.0 2020-08-18
  • سيتأثر الإصدار 3.20.0 أولاً بالتغييرات على سلوك الإيقاف المؤقت لإعلانات الوسائط التفاعلية. إذا كنت تستخدم هذا الإصدار أو أي إصدار مستقبلي من حزمة SDK، ننصحك بقراءة مشاركة المدونة وإجراء التغييرات اللازمة لإيقاف تطبيقك مؤقتًا. يمكن للناشرين اختبار تنفيذهم لهذه التغييرات باستخدام علامة الإعلان التجريبي.
  • إضافة onPause() وonResume() لفئة DAI VideoStreamPlayer.
  • يضيف هذا الإعداد الطريقة adPeriodDuration() إلى الفئة AdProgressInfo.
  • تتوافق هذه الميزة مع الصور الاحتياطية للنقر على الرموز على أجهزة Android TV.
  • تتم إضافة حدث ICON_FALLBACK_IMAGE_CLOSED لمعالجة وقت إغلاق الصورة الاحتياطية للرمز على أجهزة Android TV.
  • يؤدي هذا الإجراء إلى إزالة طريقة focusSkipButton() المتوقّفة نهائيًا من AdsManager لصالح طريقة focus().
  • بالنسبة إلى أجهزة التلفزيون المتّصل (CTV)، يتم الآن التركيز التلقائي على الإعلانات عند تنشيط حدث "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 آب (أغسطس) 2021. يمكنك الاطّلاع على الجدول الزمني للإيقاف للحصول على مزيد من التفاصيل.
3.19.3 2020-06-29
  • إصلاح مشكلة دمج إطار الشفافية والموافقة الصادر عن مكتب IAB مع اللائحة العامة لحماية البيانات، والتي تسبّبت في حدوث أعطال للّاعبين المُدمجين في حِزم تطوير البرامج لمنصّة إدارة الموافقة
  • سيتم إيقاف الإصدار 3.19.3 من حزمة تطوير البرامج (SDK) نهائيًا في 8 تموز (يوليو) 2021. يمكنك الاطّلاع على الجدول الزمني للإيقاف للحصول على مزيد من التفاصيل.
3.19.2 2020-06-22
  • يعمل على إصلاح مشكلة تسبّبت في تجاهل حزمة تطوير البرامج (SDK) لأحداث VideoAdPlayerCallback.onContentComplete() خارج نطاق تشغيل الإعلانات.
  • يتيح هذا الخيار تحديد مجموعات ترجمة DAI مختلفة للّغة نفسها، وذلك باستخدام المَعلمة 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-05-2021. يمكنك الاطّلاع على الجدول الزمني للإيقاف للحصول على مزيد من التفاصيل.
3.18.0 2020-03-04
  • تضيف دالةpause() وCV() إلى واجهة VideoStreamPlayer. ويجب تنفيذ ذلك على الإصدار 3.18.0 والإصدارات الأحدث.
  • سيتم إيقاف الإصدار 3.18.0 نهائيًا من حزمة تطوير البرامج (SDK) في 25 آذار (مارس) 2021. يمكنك الاطّلاع على الجدول الزمني للإيقاف للحصول على مزيد من التفاصيل.
3.17.0 2020-02-07
3.16.5 2020-01-22
  • إعادة صياغة رمز OMID 1.3 contentUrl مع AdsRequest.setContentUrl و StreamRequest.setContentUrl .
  • تتم إعادة صياغة العوائق المتوافقة مع OMID 1.3 من خلال استخدام FriendlyObstruction .
  • يؤدي هذا الخيار إلى إيقاف الطريقتَين BaseDisplayContainer.registerVideoControlsOverlay وBaseDisplayContainer.unregisterAllVideoControlsOverlay لصالح FriendlyObstruction .
  • لإصلاح مشكلة NullPointerException تحدث بعد طلب clear() في CompanionAdSlots.
  • يعمل هذا الإجراء على إصلاح مشكلة كانت تتسبب في تسرُّب الذاكرة عند طلب destroy() أثناء تشغيل الإعلان.
  • سيتم إيقاف الإصدار 3.16.5 نهائيًا من حزمة تطوير البرامج (SDK) في 07-02-2021. يمكنك الاطّلاع على الجدول الزمني للإيقاف للحصول على مزيد من التفاصيل.
3.16.2 2019-12-05
  • بالإضافة إلى ذلك، يمكن إضافة إمكانية إدراج مَعلمات الموافقة تلقائيًا من الإصدار الثاني من إطار الشفافية والموافقة الصادر عن مكتب IAB وقانون خصوصية المستهلك في كاليفورنيا (CCPA).
  • يتطلب استخدام إعدادات Android المفضّلة الآن استخدام حزمة androidx.
  • سيتم إيقاف الإصدار 3.16.2 من حزمة تطوير البرامج (SDK) نهائيًا في 22-01-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-10-2020. يمكنك الاطّلاع على الجدول الزمني للإيقاف للحصول على مزيد من التفاصيل.
3.13.1 2019-09-03
  • إضافة إمكانية ضبط سياق التشغيل المستمر لطلب عرض الإعلانات يمكنك الاطّلاع على setContinuousPlayback() للحصول على مزيد من التفاصيل.
  • تتم إضافة الإجراء getUniversalAdIds() إلى فئة الإعلان.
  • تتم إضافة setAuthToken وgetAuthToken وsetFormat وgetFormat والتعداد StreamFormat.
  • إصلاح خطأ في أجهزة nexus 5 الذي يحدث عند إزالة حاوية قبل تلقّي استجابة للإعلان.
  • يعمل على إصلاح مشكلة عدم عرض الإعلانات المصاحبة سوى مرة واحدة.
  • إصلاح المشكلة المتمثلة في عدم إخفاق أنواع الإعلانات غير المتوافقة (غير الخطية وVPAID) بسلاسة.
  • سيتم إيقاف الإصدار 3.13.1 نهائيًا من حزمة تطوير البرامج (SDK) في 11 أيلول (سبتمبر) 2020. يمكنك الاطّلاع على الجدول الزمني للإيقاف للحصول على مزيد من التفاصيل.
3.11.3 2019-06-11
  • إصلاح الخطأ في إعداد is_lat على أجهزة AOSP.
  • سيتم إيقاف الإصدار 3.11.3 من حزمة تطوير البرامج (SDK) نهائيًا في 3 تموز (يوليو) 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
  • يضيف حدثَي الإعلان onAdPeriodStarted() وonAdPeriodEnded(). هذه الأحداث متاحة لميزة DAI فقط.
  • سيتم إيقاف الإصدار 3.10.6 من حزمة تطوير البرامج (SDK) نهائيًا في 13 آذار (مارس) 2020. يمكنك الاطّلاع على الجدول الزمني للإيقاف للحصول على مزيد من التفاصيل.
3.10.6 2019-01-23
  • لإضافة طريقة seek() إلى واجهة مشغِّل البث
  • توفير إمكانية معاودة الاتصال بحدث إعلاني واحد (AD_BUFFERING)
  • يجب ألا يتم تمرير الحاويات بعد ذلك في طلب الإعلان. وتتطلّب طريقة سير العمل الجديدة تمرير حاوية من خلال إحدى الدوال الإنشائية AdsLoader.
  • لإضافة طريقة BaseDisplayContainer.destroy().
  • لإصلاح تسرُّب الذاكرة الذي حدث عند اكتمال تشغيل الفيديو.
  • سيتم إيقاف requestNextAdBreak نهائيًا. وستتم إزالة واجهة برمجة التطبيقات هذه في إصدار مستقبلي. بعد ذلك، سيتم استرجاع الإعلانات تلقائيًا قبل 4 ثوانٍ من وقت الفاصل الإعلاني.
  • سيتم إيقاف الإصدار 3.10.2 من حزمة تطوير البرامج (SDK) نهائيًا في 19-02-2020. يمكنك الاطّلاع على الجدول الزمني للإيقاف للحصول على مزيد من التفاصيل.
3.10.2 2018-11-13
  • إصلاح شرط سباق يؤدي إلى عرض الإعلان الثاني في مجموعة إعلانات متسلسلة لخطأ VAST 402.
  • تعمل هذه السياسة على إضافة تحديد عدد مرّات الظهور والاستبعاد التنافسي إلى حزمة تطوير البرامج (SDK) الخاصة بأدوات الذكاء الاصطناعي (AI) لنظام التشغيل Android.
  • نقل "getAdProgressInfo()" من StreamManager إلى BaseManager
  • إضافة getVastMediaHeight() وgetVastMediaWidth() وgetVastMediaBitrate() إلى Ad
  • سيتم إيقاف الإصدار 3.9.4 من حزمة تطوير البرامج (SDK) نهائيًا في 23 تشرين الأول (أكتوبر) 2020. يمكنك الاطّلاع على الجدول الزمني للإيقاف للحصول على مزيد من التفاصيل.
3.9.4 2018-08-01
  • لإضافة getCompanionAds() إلى Ad يؤدي هذا إلى عرض الإعلانات المصاحبة أثناء استخدام ميزة DAI فقط.
  • إضافة صف CompanionAd جديد
  • تتم إضافة حدث "SKIPPABLE_STATE_CHANGED" جديد إلى "AdEvent".
  • إصلاح المشكلة المتمثلة في عدم الالتزام بالإعداد التلقائي لـ focusSkipButtonWhenAvailable في بعض الحالات.
  • سيتم إيقاف الإصدار 3.9.0 من حزمة تطوير البرامج (SDK) نهائيًا في 1 آب (أغسطس) 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) في 09-07-2019. يمكنك الاطّلاع على الجدول الزمني للإيقاف للحصول على مزيد من التفاصيل.
3.8.7 2018-05-23
  • يسمح بالصور المتحركة في الإعلانات المصاحبة بتنسيق HTML.
  • سيتم إيقاف الإصدار 3.8.5 نهائيًا من حزمة تطوير البرامج (SDK) في 23-05-2019. يمكنك الاطّلاع على الجدول الزمني للإيقاف للحصول على مزيد من التفاصيل.
3.8.5 2018-04-09
  • يعمل هذا الإجراء على حل المشكلة المتعلقة بتجاهل ImaSdkSettings.
  • لإصلاح المشكلة المتمثلة في وجود تعارضات في الإصدار مع ملفات إصدار com.android.support.
  • لإضافة setAdWillPlayMuted إلى AdsRequest
  • لإضافة setLoadVideoTimeout إلى AdsRenderingSettings
  • سيتم إيقاف الإصدار 3.8.2 من حزمة تطوير البرامج (SDK) نهائيًا في 9 نيسان (أبريل) 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-05-2018. يمكنك الاطّلاع على الجدول الزمني للإيقاف للحصول على مزيد من التفاصيل.
3.7.1 2017-03-24
  • يحل تعارض مساحة الاسم عند استخدام Proguard.
  • تم تقليل حجم البرطمان بحوالي 30 كيلوبايت.
  • سيتم إيقاف الإصدار 3.7.0 من حزمة تطوير البرامج (SDK) نهائيًا في 24 آذار (مارس) 2018. يمكنك الاطّلاع على الجدول الزمني للإيقاف للحصول على مزيد من التفاصيل.
3.7.0 2017-03-13
  • إصلاح المشكلة المتمثلة في دمج بعض صفوف إعلانات الوسائط التفاعلية عن غير قصد في حزمة a.a.a.a في ProGuard.
  • سيتم إيقاف الإصدار 3.6.0 من حزمة تطوير البرامج (SDK) نهائيًا في 13-03-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
  • إضافة واجهات برمجة تطبيقات الإعلانات getTitle وgetDescription وgetContentType.
  • يضيف معلومات عن موضع مجموعة الإعلانات المتسلسلة إلى واجهة مستخدم الإعلان، مثل "الإعلان 1 من 4: (0:13)".
  • يجب عدم التحكّم مباشرةً في إيقاف الإعلانات مؤقتًا أو تشغيلها أو استئنافها باستخدام مشغّل الفيديو. بدلاً من ذلك، استخدِم AdsManager.pause() وAdsManager.resume().
إصدار تجريبي - الإصدار 8 2014-06-12
  • إصلاح مشكلة عدم محو واجهة مستخدم الإعلانات للإعلانات القابلة للتخطي
  • توثيق رمز الخطأ لمهلة تحميل ملف الوسائط
إصدار تجريبي من الإصدار 7 2014-05-27
  • حلّ مشكلة في "خدمات Google Play" تتطلب حزمة تطوير البرامج (SDK) الآن تضمين خدمات Google Play في تطبيقك. لمزيد من المعلومات، يُرجى الاطّلاع على إعداد حزمة SDK لخدمات Google Play.
إصدار تجريبي - الإصدار 6 2014-04-14
  • إضافة دعم VAST 3.
  • يضيف دعم VMAP الجزئي (التكافؤ مع قواعد إعلانات "مدير الإعلانات" الحالية).
  • إضافة ما يلي إلى واجهة برمجة التطبيقات:
    • 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. تجدر الإشارة إلى أنّه يتمّ استخدام هذا لضبط لغة واجهة المستخدِم وليس لغة الإعلان.
  • تم إصلاح التعارض الذي كان يحدث عندما تضمّن أحد التطبيقات مكتبات حزمة تطوير البرامج لإعلانات الوسائط التفاعلية ومكتبات حزمة تطوير البرامج (SDK) في AdMob.
  • تمت إضافة ميزة تسجيل مقاييس الأداء الداخلية المختلفة.
الإصدار التجريبي المغلق 1 2013-04-02

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

    المتعلقة بحزمة تطوير البرامج (SDK)

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

    نماذج ذات صلة بالتطبيقات

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