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

ملاحظة: قد تظهر فجوات رقمية في أرقام التسلسل للإصدارات المعروضة في هذه الصفحة، مثل الإصدار 3.582.5 قبل الإصدار 3.583.1، وذلك بسبب تخطّي أرقام الإصدارات بشكل دوري.

الإصدار	تاريخ الإصدار	ملاحظات
3.40.0	2026-08-20	يتطلّب الإصدار (minSdkVersion) 24. تم إصلاح مشكلة كانت تؤدي إلى تعذّر استدعاء الطريقتَين onLoadStream() أو loadUrl() في حزمة تطوير البرامج للإعلانات التفاعلية (IMA SDK) بدون ظهور أي رسالة خطأ، وذلك بعد إرسال طلب ناجح لبث "إدراج الإعلان الديناميكي". تضيف هذه السمة رموز أخطاء الإعلانات التالية: ‫COMPANION_DIMENSION_MISMATCH: يحدث هذا الخطأ عندما لا تتطابق أبعاد تصميم الإعلان المصاحب مع مساحة عرض التصميم. ‫STREAM_INITIALIZATION_FAILED: يحدث هذا الخطأ عند حدوث مشكلة في بدء تشغيل البث أثناء إدراج الإعلانات من جهة الخادم. ‫ASSET_FALLBACK_FAILED: يحدث هذا الخطأ عندما تكون هناك مشكلة في ميزة "الرجوع إلى مادة العرض". ‫UNSUPPORTED_URL: يحدث هذا الخطأ عندما يكون عنوان URL للإعلان غير صالح أو عندما لا يتيح المتصفّح الحالي عرض الإعلان. ‫STREAM_INITIALIZATION_TIMEOUT: يحدث هذا الخطأ عندما تنتهي مهلة طلب بدء البث. ‫STREAM_AUTHORIZATION_FAILED: يحدث هذا الخطأ عندما يتعذّر منح الإذن بالبث. يحلّ هذا التحديث التحذير التالي: Unable to resolve Lcom/google/ads/interactivemedia/v3/impl/data/AutoValue_WebViewInitData_JavaScriptNativeBridgeInitData; annotation class 8784 . تحسين تعليقات توضيحية بشأن إمكانية قبول القيم الفارغة في واجهات برمجة التطبيقات لمنع أخطاء الكتابة
3.39.0	2026-01-22	تحدث مشكلة معروفة في هذا الإصدار حيث تتعذّر حزمة IMA SDK بدون إظهار أي رسالة خطأ في استدعاء الطريقتَين onLoadStream() أو loadUrl() بعد طلب ناجح لبث "إدراج الإعلان الديناميكي". لحلّ هذه المشكلة، استخدِم الإصدار 3.40.0 أو إصدارًا أحدث. تضيف هذه السمة الطريقتَين getAudioMimeType() وgetVideoMimeType() إلى الفئة AdMediaInfo. تضيف هذه السمة التوضيحية @Nullable إلى طرق واجهة حزمة SDK. تضيف هذه السمة طريقة ImaSdkFactory.release() لتنظيف مواد عرض IMA إذا لم يتم إنشاء أي واجهة AdsLoader. تزيل هذه السمة طرق AdsRequest القديمة التالية الخاصة بالواجهة: setExtraParameter() getExtraParameter() getExtraParameters() تزيل هذه السمة الطريقتَين المتوقّفتَين نهائيًا AdDisplayContainer.setPlayer() و StreamDisplayContainer.setVideoStreamPlayer(). يزيل هذا التعديل طرق واجهة BaseDisplayContainer المتوقّفة نهائيًا التالية: setAdContainer() registerVideoControlsOverlay() unregisterAllVideoControlsOverlays() تزيل هذه السمة طرق CuePoint القديمة التالية الخاصة بالواجهة: getStartTime() getEndTime() تم إصلاح مشكلة تسريب الذاكرة عند إيقاف مثيل BaseManager مرتبط برسالة Attempted to send bridge message after cleanup في logcat.
3.38.0	2025-10-07	تحدث مشكلة معروفة في هذا الإصدار حيث تتعذّر حزمة IMA SDK بدون إظهار أي رسالة خطأ في استدعاء الطريقتَين onLoadStream() أو loadUrl() بعد طلب ناجح لبث "إدراج الإعلان الديناميكي". لحلّ هذه المشكلة، استخدِم الإصدار 3.40.0 أو إصدارًا أحدث. يتطلّب الإصدار (minSdkVersion) 23. تضيف هذه السمة واجهة AdSlot وتعدّل واجهة CompanionAdSlot لتوسيع واجهة AdSlot. إصلاح مشكلة ANR تحدث عند استرداد مستوى صوت الجهاز من سلسلة التعليمات الرئيسية سيتم إيقاف الإصدار 3.38.0 من "حزمة تطوير البرامج للإعلانات التفاعلية" نهائيًا في 22 يناير 2027. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.37.0	2025-07-15	تضيف هذه السمة إزالة التشويش عن التطبيق كشرط للتطبيقات التي تدمج حزمة IMA SDK. لن يتم إنشاء التطبيقات التي لم يتم تفعيل ميزة إزالة التشفير فيها باستخدام إصدارات IMA الحالية أو المستقبلية. لتفعيل عملية إزالة التشفير في التطبيق، يُرجى الاطّلاع على إضافة حزمة تطوير البرامج لإعلانات الوسائط التفاعلية إلى مشروعك. تعدّل هذه السمة الحد الأدنى من متطلبات الإصدار لقيمة compileSdk في Android إلى 35، وقيمة المكوّن الإضافي لنظام Gradle المتوافق مع Android إلى 8.6.0. تضيف هذه السمة الواجهة AdPeriodInfo، التي يمكن الوصول إليها باستخدام الطريقة AdEvent#getAdPeriodInfo() في الحدث AD_PERIOD_STARTED. تضيف هذه الحزمة واجهة PlaybackMeasurementCollector لتقييم أداء حزمة SDK وجدولة الإعلانات في تطبيقات ExoPlayer. تعديل IMA لعرض استثناء في حال تقديم طلب إعلان أو بث يتضمّن مَعلمات غير صالحة. تضيف هذه السمة نوع الخطأ AdError.WEB_VIEW_ERROR الذي يحدث في حال تعطُّل عارض WebView. يحلّ نوع الخطأ الجديد هذا مشكلة تتسبّب فيها الأعطال في أداة العرض WebView في تعطُّل التطبيق. تحسين الدالة ImaSdkFactory.initialize() من خلال نقل أجزاء من عملية تهيئة WebView إلى سلسلة محادثات في الخلفية يقلّل هذا التغيير من احتمالية حدوث أخطاء ANR أثناء عملية ImaSdkFactory.initialize(). إصلاح الخطأ NullPointerException الذي يحدث عند بدء طلب إعلانات جديد أثناء استدعاء AdsLoader.release() أيضًا. إصلاح عُطل WebViewCompat.addWebMessageListener يحدث على أجهزة التلفزيون المتّصل القديمة تم إصلاح مشكلة كانت تؤدي إلى عدم تصنيف حزمة تطوير البرامج (SDK) الخاصة بـ IMA getPreviousCuePointForStreamTimeMs() على أنّها nullable. تم إصلاح مشكلة كانت تؤدي إلى تعطُّل حزمة تطوير البرامج (SDK) عند عدم تثبيت أي WebView. ملاحظة: WebView هو مكوّن أساسي في حزمة تطوير البرامج (SDK). إذا لم يتم تثبيت أي WebView، لن تعمل حزمة تطوير البرامج (SDK) بشكلٍ سليم. تعديل الاعتماديات على WebKit إلى أحدث الإصدارات الثابتة تخطّط "حزمة تطوير البرامج للإعلانات التفاعلية" على Android لتعديل الحد الأدنى لمستوى واجهة برمجة التطبيقات المطلوب (minSdkVersion) إلى الإصدار 23، وذلك ليتوافق مع مكتبات Android Jetpack (AndroidX). لمزيد من المعلومات، يُرجى الاطّلاع على متطلبات إصدار Jetpack. تزيل هذه السمة الطرق المتوقّفة نهائيًا التالية: Ad.getUniversalAdIdValue() Ad.getUniversalAdIdRegistry() AdsManager.requestNextAdBreak() BaseManager.isCustomPlaybackUsed() ImaSdkFactory.createAdDisplayContainer() ImaSdkFactory.createAudioAdDisplayContainer(Context) ImaSdkFactory.createStreamDisplayContainer() StreamManager.getStreamTimeForContentTime(double contentTime) StreamManager.getContentTimeForStreamTime(double streamTime) StreamManager.getPreviousCuePointForStreamTime(double streamTime) VideoProgressUpdate.getCurrentTime() VideoProgressUpdate.getDuration() سيتم إيقاف الإصدار 3.37.0 من حزمة تطوير البرامج (SDK) للإعلانات التفاعلية نهائيًا في 7 أكتوبر 2026. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.36.0	2024-11-07	تم طرح مشكلة معروفة في هذا الإصدار للتطبيقات الفورية . إذا كنت تدمج IMA في التطبيقات الفورية، ننصحك بعدم تحديث تطبيقك إلى الإصدار 3.36.0 من IMA. سيتم تضمين إصلاح لهذه المشكلة في إصدار حزمة SDK التالي. تضيف هذه السمة طرقًا جديدة لطلبات البث تتضمّن المَعلمة NetworkCode. الطريقتان الجديدتان هما ImaSdkFactory.createLiveStreamRequest() و ImaSdkFactory.createVodStreamRequest(). يؤدي إلى إيقاف واجهات برمجة التطبيقات المشابهة التي لا تتضمّن المَعلمة networkCode. تلتفّ المواد الإبداعية المصاحبة في تنسيق إطار مطابق لحجم الخانة المحدّد باستخدام CompanionAdSlot.setSize(). سيتم إيقاف الإصدار 3.36.0 من "حزمة تطوير البرامج لإعلانات الوسائط التفاعلية" نهائيًا في 15 يوليو 2026. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.35.1	2024-09-24	تم إصلاح مشكلة عدم عمل Open Measurement عند استخدام واجهة برمجة التطبيقات ImaSdkFactory.initialize(). زيادة عدد minSdkVersion التي تتوافق مع IMA إلى 21 تضيف ImaSdkFactory.initialize() لجلب مواد عرض IMA وتهيئتها قبل طلب عرض الإعلان الأول. يؤدي استدعاء initialize() إلى تخصيص الذاكرة المطلوبة لتشغيل الإعلانات في المستقبل وتقليل وقت الاستجابة عند تشغيل الإعلان الأول. لمزيد من المعلومات، يُرجى الاطّلاع على تحسين مدّة تحميل IMA. إصلاح مشكلة عدم صلاحية عنوان URL للنقرة على الإعلان. إصلاح عُطل تم تقديمه في الإصدار 3.34.0 من "إعلانات الوسائط التفاعلية" (IMA) ويؤثّر في التطبيقات التي لا تستخدم ميزة desugaring في الإصدار 8 من Java على الإصدارات 25 والإصدارات الأقدم من واجهة برمجة التطبيقات Android. أضفنا تحسينات على وقت بدء تشغيل IMA على أجهزة التلفزيون المتّصل القديمة. تحسين ثبات فتح الروابط على الأجهزة التي لا يتوفّر عليها متصفّح سيتم إيقاف الإصدار 3.35.1 من "حزمة تطوير البرامج للإعلانات التفاعلية" نهائيًا في 2025-11-07. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
الإصدار 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	تتضمّن هذه النسخة مشكلة معروفة تؤثر في التطبيقات التي لم تفعّل إزالة التجميل اللغوي لواجهات برمجة التطبيقات Java 8 والإصدارات الأحدث. تقتصر هذه المشكلة على الأجهزة التي تعمل بالإصدار 25 من واجهة برمجة التطبيقات Android أو إصدار أقدم، وقد تؤدي إلى تعطُّل التطبيقات. تضيف هذه السمة getVideoStitcherSessionOptions() وsetVideoStitcherSessionOptions() إلى StreamRequest لإدارة جلسات دمج الفيديوهات في ImaSdkFactory.createVideoStitcherLiveStreamRequest() أو ImaSdkFactory.createVideoStitcherVodStreamRequest(). تم إصلاح مشكلة نادرة في تعطُّل التطبيق بسبب قيم غير صالحة لمستوى الصوت. إزالة ضبط القيمة taskAffinity على null في بيان Android يحلّ هذا التغيير المشاكل التي يتغير فيها سلوك التطبيق بشكل غير متوقّع. سيتم إيقاف الإصدار 3.34.0 من "حزمة تطوير البرامج للإعلانات التفاعلية" نهائيًا في 24 أيلول (سبتمبر) 2025. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.33.0	2024-03-28	تضيف هذه السمة ImaSdkFactory.createVideoStitcherVodStreamRequest(String networkCode, String region, String projectNumber, String oAuthToken, String vodConfigId). تتضمّن واجهة برمجة التطبيقات الجديدة هذه المَعلمة vodConfigId التي تحلّ محل استخدام contentSourceUrl وadTagUrl في واجهة برمجة التطبيقات السابقة. تضيف هذه السمة StreamRequest.getVodConfigId(). إصلاح الخطأ الذي يؤدي إلى تعطُّل التطبيق بشكل غير متوقّع على مستويات واجهة برمجة التطبيقات 25 والإصدارات الأقدم من نظام التشغيل Android، والذي تم تقديمه في الإصدار 3.32.0 سيتم إيقاف الإصدار 3.33.0 من "حزمة تطوير البرامج للإعلانات التفاعلية" نهائيًا في 13 يونيو 2025. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
‫3.32.0 متوقّف نهائيًا	2024-01-30	يحدث خطأ في هذا الإصدار عند تشغيله على أجهزة تعمل بمستويات واجهة برمجة التطبيقات 25 والإصدارات الأقدم من نظام التشغيل Android. يمكنك بدلاً من ذلك استخدام الإصدار 3.33.0 من حزمة تطوير البرامج لإعلانات الوسائط التفاعلية (IMA) لنظام التشغيل Android. تضيف هذه السمة إمكانية عرض محتوى الفيديو عند الطلب من خلال أداة تجميع المحتوى التابعة لجهة خارجية، وذلك لعرض الإعلانات ضمن حزمة إعلانية. راجِع دليل عرض الإعلانات الصوتية على Android للحصول على مزيد من المعلومات. يشمل هذا التغيير إضافة واجهات برمجة التطبيقات التالية: ImaSdkFactory.createPodVodStreamRequest() StreamManager.loadThirdPartyStream() زيادة عدد minSdkVersion التي تتوافق مع "إعلانات الوسائط التفاعلية" إلى 19 تم إصلاح المشكلة التي كانت تمنع فتح صفحة جديدة عند النقر على الإعلانات باستخدام الزر "مزيد من المعلومات" في الإصدار 30 من واجهة برمجة التطبيقات Android API والإصدارات الأحدث. لا تزال المشكلة قائمة في الإصدارات من 3.31.0 إلى 3.29.0 من حزمة تطوير البرامج لإعلانات الوسائط التفاعلية (IMA SDK)، ويجب اتّخاذ إجراء مؤقت لكي تعمل عمليات النقر على الإعلانات. تم إصلاح خطأ كان يؤدي إلى حدوث استثناء ArrayIndexOutOfBoundsException عند استخدام AdsLoader.addAdsLoadedListener(). تضيف هذه السمة خطأ الإعلان VAST_NO_ADS_AFTER_WRAPPER.
3.31.0	2023-08-31	هناك مشكلة في الإصدارات 3.31.0 إلى 3.29.0 من حزمة تطوير البرامج لإعلانات الوسائط التفاعلية (IMA SDK) مع الإصدار 30 من واجهة برمجة التطبيقات Android API والإصدارات الأحدث، حيث لا تفتح النقرات على الإعلانات باستخدام الزر مزيد من المعلومات صفحة جديدة. كحلّ بديل للإصدارات المتأثرة، عليك إضافة بيانات الأهداف لفتح روابط الويب في بيان التطبيق على النحو التالي: <?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> تعدّل هذه النسخة اعتمادية حزمة IMA لحزمة OM SDK إلى الإصدار 1.4.8، الذي يتضمّن إشارات جديدة لأجهزة التلفزيون المتصلة. تم إيقاف واجهات برمجة التطبيقات التالية AdsRequest نهائيًا: getExtraParameter() getExtraParameters() setExtraParameter() سيتم إيقاف الإصدار 3.31.0 من "حزمة تطوير البرامج لإعلانات الوسائط التفاعلية" نهائيًا في 28 مارس 2025. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.30.3	2023-08-03	تعديل المكتبات الداخلية التي يعتمد عليها التطبيق لتحسين وقت الاستجابة عند بدء التشغيل سيتم إيقاف الإصدار 3.30.3 من "حزمة تطوير البرامج للإعلانات التفاعلية" نهائيًا في 31 أغسطس 2024. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.30.2	2023-07-28	إصلاح أخطاء NullPointerException غير المتوقّعة التي تم طرحها في الإصدار 3.30.1 تم إصلاح مشكلة في Proguarding تسبّبت في عدم إرسال بعض الأحداث من حزمة SDK. يؤثّر إصلاح الخطأ هذا في إضافة ExoPlayer الخاصة بحزمة IMA DAI SDK. تضيف هذه الحزمة إمكانية استخدام الإصدار 8 أو إصدار أحدث من Gradle. يجب أن تحدّد الإصدارات السابقة من حزمة IMA SDK لنظام التشغيل Android قيمة android.enableR8.fullMode=false في ملف gradle.properties. يمكنك الاطّلاع على مقالة وضع R8 الكامل لمزيد من المعلومات. سيتم إيقاف الإصدار 3.30.2 من "حزمة تطوير البرامج للإعلانات التفاعلية" نهائيًا في 3 آب (أغسطس) 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 من حزمة تطوير البرامج لإعلانات الوسائط التفاعلية (IMA) لنظام التشغيل Android بدلاً من ذلك. تضيف هذه السمة واجهة برمجة التطبيقات ImaSdkFactory.createVideoStitcherVodStreamRequest(). تضيف هذه السمة إمكانية التوافق مع المستودع الإعلاني المختلط على أجهزة Google TV. يزيل هذا الإصدار إمكانية استخدام واجهة برمجة التطبيقات ImaSdkFactory.createSdkOwnedPlayer() التي تم إيقافها نهائيًا. تضيف هذه السمة رمز الخطأ ADS_PLAYER_NOT_PROVIDED. ينشئ هذا الرمز الفئة BaseRequest التي تنفّذها الآن كل من AdsRequest وStreamRequest. تضيف هذه السمة الفئة SecureSignals. تضيف هذه السمة طريقة BaseRequest.setSecureSignals(). سيتم إيقاف الإصدار 3.30.0 من "حزمة تطوير البرامج للإعلانات التفاعلية" نهائيًا في 18 أبريل 2024. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.29.0	2022-10-14	تعيد تسمية الفئة EspVersion إلى الفئة VersionInfo. تغيير اسم واجهات برمجة التطبيقات "الإشارات المشفرة للناشرين" (ESP) إلى واجهات برمجة التطبيقات الإشارات الآمنة تضيف هذه الحزمة واجهات برمجة التطبيقات الخاصة بمفاتيح إيقاف أو تفعيل الميزات. يمكنك استخدام واجهات برمجة التطبيقات الخاصة بمفاتيح التبديل لتفعيل ميزات معيّنة أو إيقافها في IMA. استخدِم ImaSdkSettings.getFeatureFlags() و ImaSdkSettings.setFeatureFlags() للحصول على علامات الميزات وضبطها. تم إصلاح مشكلة عدم إرسال بعض أحداث IMA. إضافة androidx.webkit:webkit كعنصر تابع في حزمة تطوير البرامج للإعلانات التفاعلية (IMA SDK) سيتم إيقاف الإصدار 3.29.0 من "حزمة تطوير البرامج للإعلانات التفاعلية" نهائيًا في 29-03-2024. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.28.2	2022-09-14	تعديل ملحقات حزمة تطوير البرامج (SDK) لاستخدام AndroidX سيتم إيقاف الإصدار 3.28.2 من حزمة IMA SDK نهائيًا في 14-10-2023. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
‫3.28.1 متوقّف نهائيًا	2022-08-03	يتضمّن هذا الإصدار مشاكل تتسبّب في حدوث أعطال على نظام التشغيل Android الإصدار 27 والإصدارات الأقدم. يمكنك بدلاً من ذلك استخدام الإصدار 3.28.2 من حزمة تطوير البرامج لإعلانات الوسائط التفاعلية (IMA) لنظام التشغيل Android. تضيف هذه السمة واجهة برمجة التطبيقات ImaSdkFactory.createVideoStitcherLiveStreamRequest(). سيتم إيقاف الإصدار 3.28.1 من "حزمة تطوير البرامج للإعلانات التفاعلية" نهائيًا في 14 أيلول (سبتمبر) 2023. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.27.1	2022-05-27	إصدار الخدمة بدون ميزات جديدة سيتم إيقاف الإصدار 3.27.1 من حزمة IMA SDK نهائيًا في 3 أغسطس 2023. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.27.0	2022-03-01	تضيف هذه السمة إمكانية استخدام مساحات إعلانية مصاحبة ذات حجم متغير من خلال ضبط عرض وارتفاع المساحة الإعلانية المصاحبة على القيمة الثابتة FLUID_SIZE في IMA. سيتم إيقاف الإصدار 3.27.0 من "حزمة تطوير البرامج لإعلانات الوسائط التفاعلية" نهائيًا في 27 مايو 2023. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.26.0	2022-01-12	تضيف هذه الحزمة واجهات برمجة التطبيقات الخاصة بـ &quot;الإشارات المشفرة للناشرين&quot; (ESP) (تمت إعادة تسميتها إلى الإشارات الآمنة في الإصدار 3.29.0 من &quot;حزمة تطوير البرامج لإعلانات الوسائط التفاعلية&quot;). يتيح ذلك للناشرين تفعيل &quot;عروض الأسعار من الشبكة&quot; و&quot;موفّري تعريف الجمهور&quot;. سيتم إيقاف الإصدار 3.26.0 من حزمة IMA SDK نهائيًا في 2023-03-01. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.25.1	2021-11-08	تضيف هذه السمة AdsRenderingSettings.setEnableCustomTabs() وAdsRenderingSettings.getEnableCustomTabs() للنقر على الإعلانات داخل التطبيق باستخدام علامات التبويب المخصّصة. اعتبارًا من الإصدار 3.25.1، تتضمّن حزمة تطوير البرامج لإعلانات الوسائط التفاعلية الإذن com.google.android.gms.permission.AD_ID في بيان حزمة تطوير البرامج الذي يتم دمجه تلقائيًا في بيان التطبيق عن طريق أدوات إصدار Android. لمزيد من المعلومات عن بيان إذن AD_ID، بما في ذلك كيفية إيقافه، يمكنك الرجوع إلى مقالة مركز مساعدة Play Console هذه. تضيف هذه الحزمة إمكانية استخدام معرّف مجموعة التطبيقات في حالات الاستخدام مثل إعداد التقارير ومنع الاحتيال. تضيف هذه السمة تحسينات على الأداء عند استخدام مثيلات متعددةAdsLoader من خلال إتاحة التخزين المؤقت وإعادة الاستخدام. سيتم إيقاف الإصدار 3.25.1 من حزمة تطوير البرامج للإعلانات التفاعلية (IMA SDK) نهائيًا في 12-01-2023. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.24.0	2021-06-03	تضيف هذه الإضافة واجهات برمجة تطبيقات دقيقة ذات نقطة ثابتة لفئتَي CuePoint وStreamManager المستخدَمتَين في "الإعلانات الديناميكية أثناء البث". يؤدي ذلك إلى إضافة واجهات برمجة التطبيقات التالية: CuePoint.getEndTimeMs() CuePoint.getStartTimeMs() StreamManager.getContentTimeMsForStreamTimeMs() StreamManager.getPreviousCuePointForStreamTimeMs() StreamManager.getStreamTimeMsForContentTimeMs() ويتم إيقاف واجهات برمجة التطبيقات التالية نهائيًا: CuePoint.getEndTime() CuePoint.getStartTime() StreamManager.getContentTimeForStreamTime() StreamManager.getPreviousCuePointForStreamTime() StreamManager.getStreamTimeForContentTime() يمنع حدوث الخطأ NullPointerException المرتبط بالطلبات الداخلية إلى StreamRequest.getContentUrl(). سيتم إيقاف الإصدار 3.24.0 من "حزمة تطوير البرامج للإعلانات التفاعلية" نهائيًا في 8 تشرين الثاني (نوفمبر) 2022. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.23.0	2021-04-07	تضيف الطريقتَين ImaSdkSettings.setSessionId() و ImaSdkSettings.getSessionId() للحصول على معرّف الجلسة وضبطه. هذا المعرّف هو معرّف عشوائي مؤقت يُستخدم حصريًا لتحديد عدد مرات الظهور. يحلّ هذا التعديل الخطأ NullPointerException المتعلّق بالإعلانات المصاحبة. يؤدي هذا الخيار إلى إيقاف JavaScript في الإعلانات المصاحبة التي يقل مستوى واجهة برمجة التطبيقات فيها عن 21، وذلك لحلّ مشكلة تتعلّق بالثغرات الأمنية. سيتم إيقاف الإصدار 3.23.0 من حزمة تطوير البرامج للإعلانات التفاعلية (IMA) نهائيًا في 2022-06-03. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.22.3	2021-03-16	إصلاح الخطأ NullPointerException المرتبط بإصدار AdsLoader أثناء تحميل إعلان تضيف هذه السمة الخطأ 1206 إلى UNEXPECTED_ADS_LOADED_EVENT في الحالات التي يتم فيها إرسال حدث تحميل الإعلانات بشكل غير متوقّع. سيتم إيقاف الإصدار 3.22.3 من "حزمة تطوير البرامج للإعلانات التفاعلية" نهائيًا في 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 من "حزمة تطوير البرامج للإعلانات التفاعلية" نهائيًا في 16-03-2022. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.22.0	2021-01-11	تضيف هذه الميزة إمكانية عرض الإعلانات ضمن حزمة في أحداث البث المباشر التي تستخدم ميزة "إدخال الإعلانات الديناميكي". في سير عمل عرض الإعلانات ضمن حزمة، يكون "مدير إعلانات Google" مسؤولاً فقط عن عرض الإعلانات. يتحمّل الناشرون مسؤولية المحتوى وإنشاء ملف البيان الذي سيشير بعد ذلك إلى "مدير الإعلانات". استخدِم ImaSdkFactory.createPodStreamRequest() لإنشاء طلب بث لعرض الإعلانات المتسلسلة. في حال استخدام هذه الميزة، ستكون مسؤولاً عن تحميل البث على streamInit(). إصلاح تسرُّب الذاكرة الناتج عن عدم تنظيف أداة مراقبة مراحل نشاط التطبيق بشكل صحيح سيتم إيقاف الإصدار 3.22.0 من "حزمة تطوير البرامج للإعلانات التفاعلية" نهائيًا في 26-02-2022. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.21.4	2020-12-09	يزيل هذا الإجراء رسالة تحذير غير ضارة متعلقة بإجراء مكالمة adsLoader.release() بعد إيقاف عرض الويب. سيتم إيقاف الإصدار 3.21.4 من "حزمة تطوير البرامج للإعلانات التفاعلية" نهائيًا في 8 كانون الثاني (يناير) 2022. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.21.2	2020-11-20	إصلاح المشاكل غير المتوقّعة في أمان سلاسل التعليمات الناتجة عن إرسال تحديثات الرسائل من قائمة انتظار فارغة تعدّل هذه السمة مستندات AdsLoader.release(). سيتم إيقاف الإصدار 3.21.2 من "حزمة تطوير البرامج للإعلانات التفاعلية" نهائيًا في 9 كانون الأول (ديسمبر) 2021. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.21.1	2020-11-17	تم إصلاح مشكلة كانت تؤدي أحيانًا إلى تعطُّل التطبيق عند تشغيل الأحداث. سيتم إيقاف الإصدار 3.21.1 من "حزمة تطوير البرامج للإعلانات التفاعلية" نهائيًا في 20 تشرين الثاني (نوفمبر) 2021. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.21.0	2020-10-23	تضيف هذه الحزمة إمكانية عرض إعلانات SIMID في حزمة تطوير البرامج (SDK) لنظام التشغيل Android في ميزة "الإعلانات الديناميكية أثناء البث". تضيف هذه السمة الطريقة AdsLoader.release() وتوقف نهائيًا استخدام BaseDisplayContainer.destroy(). يحلّ هذا التغيير مشكلة تسرُّب الذاكرة التي كانت تحدث عند التخلّص من BaseDisplayContainer في منتصف جدول عرض إعلانات VMAP. ‫AdsLoader.release() هي الطريقة الجديدة المقترَحة للتخلّص من عناصر حزمة تطوير البرامج لإعلانات الوسائط التفاعلية (IMA SDK)، بدلاً من استخدام BaseDisplayContainer.destroy(). سيتم إيقاف الإصدار 3.21.0 من "حزمة تطوير البرامج لإعلانات الوسائط التفاعلية" نهائيًا في 17-11-2021. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.20.1	2020-10-12	إصلاح مشكلة في عناصر HTMLResource المصاحبة على المستوى 29 أو أعلى من واجهة برمجة التطبيقات في نظام التشغيل Android لمزيد من التفاصيل، يُرجى الاطّلاع على التغيير الموثّق في سلوك Android API. سيتم إيقاف الإصدار 3.20.1 من "حزمة تطوير البرامج لإعلانات الوسائط التفاعلية" نهائيًا في 23-10-2021. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.20.0	2020-08-18	الإصدار 3.20.0 هو الإصدار الأول الذي سيتأثر بالتغييرات في سلوك الإيقاف المؤقت في "إعلانات الوسائط التفاعلية". إذا كنت تستخدم هذا الإصدار أو أي إصدار مستقبلي من حزمة SDK، ننصحك بقراءة مشاركة المدونة وإجراء التغييرات اللازمة لإيقاف السلوك مؤقتًا في تطبيقك. يمكن للناشرين اختبار تنفيذ هذه التغييرات باستخدام علامة الإعلان التجريبي. تضيف هذه السمة معاودة الاتصال onPause() وonResume() لفئة 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 من "حزمة تطوير البرامج للإعلانات التفاعلية" نهائيًا في 12 تشرين الأول (أكتوبر) 2021. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.19.4	2020-07-08	تم إصلاح مشكلة كانت تمنع setLoadVideoTimeout من تعديل المهلة بشكل صحيح. سيتم إيقاف الإصدار 3.19.4 من "حزمة تطوير البرامج لإعلانات الوسائط التفاعلية" نهائيًا في 18 آب (أغسطس) 2021. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.19.3	2020-06-29	تم إصلاح مشكلة في عملية دمج "إطار الشفافية والموافقة" الصادر عن مكتب IAB مع "اللائحة العامة لحماية البيانات" (GDPR) تسبّبت في حدوث أعطال للاعبين الذين تم دمجهم مع حِزم تطوير البرامج (SDK) الخاصة بمنصّة إدارة الموافقة. سيتم إيقاف الإصدار 3.19.3 من "حزمة تطوير البرامج لإعلانات الوسائط التفاعلية" نهائيًا في 8 تموز (يوليو) 2021. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.19.2	2020-06-22	تم إصلاح مشكلة كانت تتسبّب في تجاهل حزمة SDK VideoAdPlayerCallback.onContentComplete() للأحداث التي تقع خارج نطاق تشغيل الإعلان. تضيف هذه السمة إمكانية تحديد مجموعات مختلفة من الترجمة والشرح في "الإعلانات الديناميكية أثناء البث" للغة نفسها باستخدام المَعلمة subtitle_name الخاصة بـ VideoStreamPlayer.loadUrl(). سيتم إيقاف الإصدار 3.19.2 من "حزمة تطوير البرامج لإعلانات الوسائط التفاعلية" نهائيًا في 29 يونيو 2021. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.19.0	2020-05-12	تضيف هذه السمة وظيفة الاستدعاء VideoAdPlayerCallback.onLoaded() إلى VideoAdPlayer. تم إيقاف AdsLoader.contentComplete() نهائيًا واستبداله بـ VideoAdPlayerCallback.onContentComplete() وVideoStreamPlayerCallback.onContentComplete(). سيتم إيقاف الإصدار 3.19.0 من "حزمة تطوير البرامج لإعلانات الوسائط التفاعلية" نهائيًا في 22 يونيو 2021. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.18.1	2020-03-25	تضيف هذه السمة إمكانية تغيير حجم "الإعلانات المصاحبة" على الأجهزة ذات الكثافة العالية لوحدات البكسل. تضيف هذه السمة إمكانية عرض إعلانات SIMID من جهة العميل. سيتم إيقاف الإصدار 3.18.1 من "حزمة تطوير البرامج لإعلانات الوسائط التفاعلية" نهائيًا في 12 أيار (مايو) 2021. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.18.0	2020-03-04	تضيف هذه السمة الدالتَين pause() وresume() إلى واجهة VideoStreamPlayer. يجب تنفيذ هذه التغييرات في الإصدار 3.18.0 والإصدارات الأحدث. سيتم إيقاف الإصدار 3.18.0 من "حزمة تطوير البرامج لإعلانات الوسائط التفاعلية" نهائيًا في 25 آذار (مارس) 2021. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.17.0	2020-02-07	تضيف هذه الطريقة واجهات برمجة التطبيقات التالية لنقل عملية التحقّق من صحة حاويات العرض إلى وقت إنشائها: createAdDisplayContainer(ViewGroup container, VideoAdPlayer player) createStreamDisplayContainer(ViewGroup container, VideoStreamPlayer player) createAudioAdDisplayContainer(Context context, VideoAdPlayer player) تضيف هذه السمة ImaSdkFactory.createSdkOwnedPlayer التي يجب أن يستخدمها الأشخاص الذين يستعملون مشغّل IMA المضمّن (SdkOwnedPlayer). يجب إنشاء هذا العنصر يدويًا وتمريره إلى الدالة الإنشائية الخاصة بـ AdDisplayContainer. تضيف هذه السمة عمليات التحقّق من القيم غير الفارغة إلى setAdContainer و setPlayer. تعدّل هذه الطريقة بيانات نقاط الإشارات لتستخدم الآن دقة النقطة العائمة. تم إيقاف الطُرق التالية نهائيًا: AdDisplayContainer.setPlayer(VideoAdPlayer player) BaseDisplayContainer.setAdContainer(ViewGroup container) BaseManager.isCustomPlaybackUsed() ImaSdkFactory.createAdDisplayContainer() ImaSdkFactory.createAudioAdDisplayContainer(Context context) ImaSdkFactory.createStreamDisplayContainer() StreamDisplayContainer.setVideoStreamPlayer(VideoStreamPlayer player) سيتم إيقاف الإصدار 3.17.0 من "حزمة تطوير البرامج للإعلانات التفاعلية" نهائيًا في 4 آذار (مارس) 2021. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.16.5	2020-01-22	إعادة تصميم إمكانية استخدام contentUrl في الإصدار 1.3 من OMID مع AdsRequest.setContentUrl و StreamRequest.setContentUrl إعادة تصميم ميزة التعامل مع العوائق المتوافقة مع OMID 1.3 باستخدام FriendlyObstruction . تم إيقاف الطريقتَين BaseDisplayContainer.registerVideoControlsOverlay وBaseDisplayContainer.unregisterAllVideoControlsOverlay واستخدام FriendlyObstruction بدلاً منهما. تم إصلاح مشكلة ظهور NullPointerException بعد طلب clear() على CompanionAdSlots. تم إصلاح مشكلة كانت قد تؤدي إلى حدوث تسرّب للذاكرة عند طلب destroy() أثناء تشغيل الإعلان. سيتم إيقاف الإصدار 3.16.5 من "حزمة تطوير البرامج للإعلانات التفاعلية" نهائيًا في 07-02-2021. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.16.2	2019-12-05	تضيف هذه الميزة إمكانية تضمين مَعلمات الموافقة تلقائيًا من الإصدار 2 من "إطار الشفافية والموافقة" الصادر عن مكتب IAB وقانون خصوصية المستهلك في كاليفورنيا. يتطلّب استخدام الإعدادات المفضَّلة في Android الآن حزمة androidx. سيتم إيقاف الإصدار 3.16.2 من "حزمة تطوير البرامج للإعلانات التفاعلية" نهائيًا في 22-01-2021. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.16.1	2019-11-08	تضيف هذه السمة طريقة جديدة إلى ImaSdkFactory من أجل createAudioAdDisplayContainer سيتم إيقاف الإصدار 3.16.1 من "حزمة تطوير البرامج للإعلانات التفاعلية" نهائيًا في 2020-12-05. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
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 من "حزمة تطوير البرامج للإعلانات التفاعلية" نهائيًا في 8 تشرين الثاني (نوفمبر) 2020. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.14.0	2019-09-11	إصدار الخدمة بدون ميزات جديدة سيتم إيقاف الإصدار 3.14.0 من "حزمة تطوير البرامج للإعلانات التفاعلية" نهائيًا في 23-10-2020. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.13.1	2019-09-03	تضيف هذه السمة إمكانية ضبط سياق التشغيل المتواصل لطلب عرض إعلانات. لمزيد من التفاصيل، يُرجى الاطّلاع على setContinuousPlayback(). تضيف هذه الطريقة getUniversalAdIds() إلى فئة "الإعلان". تضيف هذه السمة التعداد setAuthToken وgetAuthToken وsetFormat وgetFormat وStreamFormat. تم إصلاح خطأ في أجهزة Nexus 5 يحدث عند إزالة حاوية قبل تلقّي استجابة الإعلان. تم إصلاح مشكلة عدم عرض الإعلانات المصاحبة إلا مرة واحدة. تم إصلاح المشكلة المتمثّلة في عدم تعذُّر أنواع الإعلانات غير المتوافقة (الإعلانات غير الخطية، وVPAID) بشكلٍ سليم. سيتم إيقاف الإصدار 3.13.1 من حزمة IMA SDK نهائيًا في 11 أيلول (سبتمبر) 2020. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.11.3	2019-06-11	تم إصلاح الخطأ المتعلّق بإعداد is_lat على أجهزة AOSP. سيتم إيقاف الإصدار 3.11.3 من "حزمة تطوير البرامج للإعلانات التفاعلية" نهائيًا في 3 أيلول (سبتمبر) 2020. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.11.2	2019-04-16	تم إصلاح الخطأ التالي الذي يؤدي إلى تعطُّل التطبيق: java.lang.ClassNotFoundException: Didn't find class "j$.util.concurrent.ConcurrentHashMap". سيتم إيقاف الإصدار 3.11.0 من "حزمة تطوير البرامج للإعلانات التفاعلية" نهائيًا في 11 يونيو 2020. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
الإصدار 3.11.0 متوقّف نهائيًا	2019-03-22	تتيح هذه الحزمة استخدام حزمة SDK للقياس المفتوح لقياس إمكانية العرض من جهة خارجية. تضيف هذه السمة الطريقتَين registerVideoControlsOverlay() وunregisterAllVideoControlsOverlays() إلى BaseDisplayContainer. سيتم إيقاف الإصدار 3.10.9 من "حزمة تطوير البرامج للإعلانات التفاعلية" نهائيًا في 22 آذار (مارس) 2020. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.10.9	2019-03-13	تم إصلاح خطأ في حالة التزامن حيث لا يتم عرض واجهة مستخدم الإعلان أحيانًا في الإعلانات اللاحقة بعد تخطّي الإعلان الأول. تم إصلاح عُطل كان يحدث عند استدعاء واجهة برمجة التطبيقات getCompanionAds(). سيتم إيقاف الإصدار 3.10.7 من "حزمة تطوير البرامج للإعلانات التفاعلية" نهائيًا في 22-03-2020. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.10.7	2019-02-19	تضيف هذه السمة أحداث الإعلانات onAdPeriodStarted() وonAdPeriodEnded(). تتوفّر هذه الأحداث لإعلانات DAI فقط. سيتم إيقاف الإصدار 3.10.6 من "حزمة تطوير البرامج للإعلانات التفاعلية" نهائيًا في 13-03-2020. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.10.6	2019-01-23	تضيف هذه السمة طريقة seek() إلى واجهة مشغّل البث. تضيف هذه السمة إمكانية استخدام عمليات رد الاتصال الخاصة بأحداث الإعلانات AD_BUFFERING. يجب عدم تمرير الحاويات في طلب عرض الإعلان. يتطلّب سير العمل الجديد تمرير حاوية من خلال أداة إنشاء AdsLoader. تضيف هذه السمة طريقة BaseDisplayContainer.destroy(). إصلاح تسريب الذاكرة الذي حدث عند اكتمال تشغيل الفيديو تم إيقاف requestNextAdBreak نهائيًا. ستتم إزالة واجهة برمجة التطبيقات هذه في إصدار مستقبلي. بعد ذلك، سيتم تلقائيًا جلب الإعلانات قبل 4 ثوانٍ من وقت الفاصل الإعلاني. سيتم إيقاف الإصدار 3.10.2 من "حزمة تطوير البرامج للإعلانات التفاعلية" نهائيًا في 19-02-2020. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.10.2	2018-11-13	إصلاح مشكلة تداخل تؤدي إلى ظهور الخطأ VAST 402 في الإعلان الثاني ضمن حزمة الإعلانات تضيف هذه الحزمة ميزة تحديد عدد مرات الظهور واستبعاد المنافسين إلى حزمة تطوير البرامج (SDK) لنظام التشغيل Android الخاصة بميزة "الإعلانات الديناميكية أثناء البث". تنقل هذه الطريقة getAdProgressInfo() من StreamManager إلى BaseManager. يضيف getVastMediaHeight() وgetVastMediaWidth() وgetVastMediaBitrate() إلى Ad. سيتم إيقاف الإصدار 3.9.4 من "حزمة تطوير البرامج للإعلانات التفاعلية" نهائيًا في 23-01-2020. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.9.4	2018-08-01	يضيف getCompanionAds() إلى Ad. تعرض هذه السمة الإعلانات المصاحبة أثناء استخدام "الإعلانات الديناميكية أثناء البث" فقط. تضيف هذه السمة الفئة الجديدة CompanionAd. يضيف حدث SKIPPABLE_STATE_CHANGED جديدًا إلى AdEvent. تم إصلاح مشكلة عدم مراعاة الإعداد التلقائي لـ focusSkipButtonWhenAvailable في بعض الحالات. سيتم إيقاف الإصدار 3.9.0 من "حزمة تطوير البرامج للإعلانات التفاعلية" نهائيًا في 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 من "حزمة تطوير البرامج للإعلانات التفاعلية" نهائيًا في 9 يوليو 2019. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.8.7	2018-05-23	تسمح هذه السمة بعرض صور متحركة في الإعلانات المصاحبة بتنسيق HTML. سيتم إيقاف الإصدار 3.8.5 من "حزمة تطوير البرامج للإعلانات التفاعلية" نهائيًا في 23-05-2019. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.8.5	2018-04-09	تم إصلاح مشكلة تجاهل ImaSdkSettings. تم إصلاح مشكلة حدوث تعارضات في الإصدار مع ملفات الإصدار com.android.support. يضيف setAdWillPlayMuted إلى AdsRequest. يضيف setLoadVideoTimeout إلى AdsRenderingSettings. سيتم إيقاف الإصدار 3.8.2 من "حزمة تطوير البرامج للإعلانات التفاعلية" نهائيًا في 2019-04-09. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.8.2	2018-01-24	يضيف setLiveStreamPrefetchSeconds إلى AdsRequest. إصلاحات متنوّعة في المستندات سيتم إيقاف الإصدار 3.7.4 من "حزمة تطوير البرامج للإعلانات التفاعلية" نهائيًا في 24-01-2019. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.7.4	2017-06-29	يضيف setVastLoadTimeout إلى AdsRequest. يضيف getSkipTimeOffset إلى Ad. سيتم إيقاف الإصدار 3.7.2 من "حزمة تطوير البرامج للإعلانات التفاعلية" نهائيًا في 29-06-2018. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.7.2	2017-05-25	يضيف setDebugMode إلى ImaSdkSettings. سيتم إيقاف الإصدار 3.7.1 من "حزمة تطوير البرامج للإعلانات التفاعلية" نهائيًا في 25 مايو 2018. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.7.1	2017-03-24	يحلّ تعارضًا في مساحة الاسم عند استخدام Proguard. تم تقليل حجم ملف JAR بمقدار 30 كيلوبايت تقريبًا. سيتم إيقاف الإصدار 3.7.0 من "حزمة تطوير البرامج للإعلانات التفاعلية" نهائيًا في 24-03-2018. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.7.0	2017-03-13	تم إصلاح مشكلة دمج بعض فئات IMA عن غير قصد في حزمة a.a.a.a في ProGuard. سيتم إيقاف الإصدار 3.6.0 من "حزمة تطوير البرامج للإعلانات التفاعلية" نهائيًا في 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 من "حزمة تطوير البرامج للإعلانات التفاعلية" نهائيًا في 16-02-2018. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.5.2	2016-11-14	تضيف هذه السمة مشغّل فيديو مملوكًا لحزمة تطوير البرامج (SDK) ويتولّى بشكل اختياري عملية تشغيل الإعلانات. تضيف هذه السمة CompanionAdSlot.ClickListener وطُرقًا لإضافة مستمع وإزالته. تم إصلاح مشكلة في سجلّات الأخطاء غير الصالحة getViewability(). تم إصلاح مشكلة في سلوك النقر على الرموز وعدم عرضها بشكلٍ صحيح. سيتم إيقاف الإصدار 3.4.0 من "حزمة تطوير البرامج للإعلانات التفاعلية" نهائيًا في 14 تشرين الثاني (نوفمبر) 2017. لمزيد من التفاصيل، يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي.
3.4.0	2016-09-12	إصلاح خطأ الملفات المكرّرة عند استخدام الإصدار 9.0.0 من "خدمات Google Play" والإصدارات الأحدث
3.3.2	2016-07-11	تضيف هذه الطريقة الحدثَين AD_BREAK_STARTED وAD_BREAK_ENDED إلى دالة معاودة الاتصال AdEventListener.onAdEvent.
3.3.0	2016-05-31	إضافة AdsRenderingSetting.setPlayAdsAfterTime
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	تسمح للمستخدم بتخصيص عناصر واجهة مستخدم الإعلان باستخدام AdsRenderingSettings.setUiElements. تتيح هذه السمة تشغيل الفواصل الإعلانية يدويًا بدلاً من تشغيلها تلقائيًا. اطّلِع على تشغيل الفواصل الإعلانية يدويًا. تضيف هذه السمة القيد الذي ينص على أنّه يجب ألا تعرض الدالة ContentProgressProvider.getContentProgress القيمة null أبدًا. تضيف هذه السمة AdEvent.TAPPED التي يتم تشغيلها عندما ينقر المستخدم على أي منطقة غير قابلة للنقر في إعلان فيديو.
‫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) الآن أن تكون &quot;خدمات Google Play&quot; مضمّنة في تطبيقك. لمزيد من المعلومات، يُرجى الاطّلاع على إعداد حزمة تطوير البرامج (SDK) الخاصة &quot;بخدمات Google Play&quot;.
الإصدار التجريبي 6	2014-04-14	إضافة توافق مع الإصدار 3 من معيار VAST تتم إضافة إمكانية استخدام قائمة تشغيل إعلانات الفيديو المتعددة (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) وحزمة تطوير البرامج لإعلانات Google على الأجهزة الجوّالة (AdMob SDK). تمت إضافة تسجيل للعديد من مقاييس الأداء الداخلية.
الإصدار التجريبي المغلق 1	2013-04-02	الإصدار التجريبي الأوّلي في ما يلي المشاكل المعروفة في الإصدار التجريبي: ذات الصلة بحِزم تطوير البرامج (SDK) لا تتوافق عناصر AdEvents التالية المتاحة ضمن حزمة تطوير البرامج للإعلانات التفاعلية بتنسيق HTML5 مع حزمة تطوير البرامج للإعلانات التفاعلية على Android الإصدار 3: IMPRESSION وLOG وSKIPPABLE_STATE_CHANGED وSTOPPED وVOLUME_CHANGED وVOLUME_MUTED. مثال على طلب ذي صلة بالتطبيق هناك مشكلة متقطّعة تتمثل في عدم استئناف مشغّل الإعلانات بشكل سليم بعد أن ينقر المستخدم على أحد الإعلانات. على سبيل المثال، في بعض الأحيان، عند الرجوع إلى التطبيق بعد النقر على إعلان، يؤدي استئناف تشغيل هذا الإعلان إلى الانتقال إلى نهايته وإكماله، بدلاً من استئنافه من حيث توقّف قبل النقر عليه. إنّ الإعلانات التي تعرضها علامة الإعلان "Instream 2" غير متوافقة مع الإصدار 3 من حزمة تطوير البرامج لإعلانات الوسائط التفاعلية على Android. لا يوقف مشغّل العيّنات تلقائيًا إمكانية البحث (التمرير السريع) أثناء تشغيل الإعلانات. احرص على إيقاف ميزة البحث في مشغّل الفيديو أثناء عرض الإعلانات.