تاریخچه انتشار Google IMA Android SDK

نسخه تاریخ انتشار یادداشت‌ها
۳.۴۰.۰ ۲۰۲۶-۰۸-۲۰
  • نیاز به ( minSdkVersion ) 24 دارد.
  • مشکلی که باعث می‌شد IMA SDK پس از یک درخواست موفقیت‌آمیز استریم DAI، بی‌سروصدا متدهای onLoadStream() یا loadUrl() را فراخوانی نکند، برطرف شد.
  • کدهای خطای تبلیغاتی زیر را اضافه می‌کند:
    • COMPANION_DIMENSION_MISMATCH : زمانی رخ می‌دهد که ابعاد یک تبلیغ همراه با فضای نمایش آن مطابقت نداشته باشد.
    • STREAM_INITIALIZATION_FAILED : زمانی رخ می‌دهد که در هنگام درج تبلیغ در سمت سرور، خطایی در مقداردهی اولیه جریان (stream) وجود داشته باشد.
    • ASSET_FALLBACK_FAILED : زمانی رخ می‌دهد که مشکلی در رابطه با fallback دارایی وجود داشته باشد.
    • 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 .
  • حاشیه‌نویسی‌های nullability برای APIها را بهبود می‌بخشد تا ایمنی نوع را بهبود بخشد.
۳.۳۹.۰ ۲۰۲۶-۰۱-۲۲
  • یک مشکل شناخته‌شده در این نسخه وجود دارد که در آن IMA SDK پس از یک درخواست موفقیت‌آمیز جریان DAI، به‌طور مخفیانه از فراخوانی متدهای onLoadStream() یا loadUrl() خودداری می‌کند. برای حل این مشکل، از نسخه ۳.۴۰.۰ و بالاتر استفاده کنید.
  • متدهای getAudioMimeType() و getVideoMimeType() را به کلاس AdMediaInfo اضافه می‌کند.
  • حاشیه‌نویسی @Nullable را به متدهای رابط SDK اضافه می‌کند.
  • اگر هیچ رابط AdsLoader نمونه‌سازی نشده باشد، یک متد ImaSdkFactory.release() برای پاکسازی فایل‌های IMA اضافه می‌کند.
  • متدهای رابط AdsRequest منسوخ شده زیر را حذف می‌کند:
    • setExtraParameter()
    • getExtraParameter()
    • getExtraParameters()
  • متدهای منسوخ‌شده‌ی AdDisplayContainer.setPlayer() و StreamDisplayContainer.setVideoStreamPlayer() را حذف می‌کند.
  • متدهای منسوخ شده‌ی رابط BaseDisplayContainer زیر را حذف می‌کند:
    • setAdContainer()
    • registerVideoControlsOverlay()
    • unregisterAllVideoControlsOverlays()
  • متدهای رابط CuePoint منسوخ شده زیر را حذف می‌کند:
    • getStartTime()
    • getEndTime()
  • مشکل نشت حافظه هنگام از بین بردن یک نمونه BaseManager مربوط به Attempted to send bridge message after cleanup » در logcat برطرف شد.
۳.۳۸.۰ ۲۰۲۵-۱۰-۰۷
  • یک مشکل شناخته‌شده در این نسخه وجود دارد که در آن IMA SDK پس از یک درخواست موفقیت‌آمیز جریان DAI، به‌طور مخفیانه از فراخوانی متدهای onLoadStream() یا loadUrl() خودداری می‌کند. برای حل این مشکل، از نسخه ۳.۴۰.۰ و بالاتر استفاده کنید.
  • نیاز به ( minSdkVersion ) 23 دارد.
  • یک رابط AdSlot اضافه می‌کند و رابط CompanionAdSlot را به‌روزرسانی می‌کند تا رابط AdSlot را گسترش دهد.
  • مشکل ANR که هنگام دریافت حجم دستگاه از نخ اصلی رخ می‌داد، برطرف شد.
  • نسخه ۳.۳۸.۰ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۲۷-۰۱-۲۲ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۳۷.۰ ۱۵-۰۷-۲۰۲۵
  • قابلیت desugaring برنامه را به عنوان یک الزام برای برنامه‌هایی که با IMA SDK ادغام می‌شوند، اضافه می‌کند. برنامه‌هایی که desugaring در آنها فعال نباشد، با نسخه‌های فعلی یا آینده IMA ساخته نمی‌شوند. برای فعال کردن desugaring برنامه، به افزودن IMA SDK به پروژه خود مراجعه کنید.
  • حداقل نسخه مورد نیاز برای کامپایل اندروید (Android compileSdk به ۳۵ و افزونه اندروید گریدل (Android Gradle plugin) به ۸.۶.۰ به‌روزرسانی شد.
  • رابط AdPeriodInfo را اضافه می‌کند که با استفاده از متد AdEvent#getAdPeriodInfo() در رویداد AD_PERIOD_STARTED قابل دسترسی است.
  • رابط PlaybackMeasurementCollector را برای ارزیابی عملکرد SDK و زمان‌بندی تبلیغات در برنامه‌های ExoPlayer اضافه کرد.
  • IMA را به‌روزرسانی می‌کند تا در صورت ارسال درخواست تبلیغ یا پخش جریانی با پارامترهای نامعتبر، استثنا ایجاد کند.
  • نوع خطای AdError.WEB_VIEW_ERROR اضافه شده است که در صورت از کار افتادن رندرکننده WebView رخ می‌دهد. این نوع خطای جدید، مشکلی را که در آن از کار افتادن رندرکننده WebView باعث از کار افتادن برنامه می‌شد، برطرف می‌کند.
  • با انتقال بخش‌هایی از مقداردهی اولیه WebView به یک thread پس‌زمینه، تابع ImaSdkFactory.initialize() را بهینه می‌کند. این تغییر احتمال خطاهای ANR را در حین فراخوانی ImaSdkFactory.initialize() کاهش می‌دهد.
  • خطای NullPointerException ناشی از شروع یک درخواست تبلیغات جدید هنگام فراخوانی AdsLoader.release() برطرف شد.
  • رفع مشکل از کار افتادن WebViewCompat.addWebMessageListener که در دستگاه‌های قدیمی CTV رخ می‌داد.
  • مشکلی که باعث می‌شد IMA SDK، getPreviousCuePointForStreamTimeMs() به عنوان nullable علامت‌گذاری نکند، برطرف شد.
  • مشکلی که باعث می‌شد SDK در صورت عدم نصب WebView از کار بیفتد، برطرف شد. توجه: WebView یک جزء حیاتی از SDK است. اگر WebView نصب نشود، SDK نمی‌تواند به درستی کار کند.
  • وابستگی‌های وب‌کیت را به آخرین نسخه‌های پایدار به‌روزرسانی می‌کند.
  • کیت توسعه نرم‌افزار اندروید IMA قصد دارد حداقل سطح API مورد نیاز ( minSdkVersion ) خود را به نسخه ۲۳ به‌روزرسانی کند تا با کتابخانه‌های اندروید جت‌پک (AndroidX) مطابقت داشته باشد. برای اطلاعات بیشتر، به الزامات نسخه جت‌پک مراجعه کنید.
  • متدهای منسوخ شده زیر را حذف می‌کند:
    • 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()
  • نسخه ۳.۳۷.۰ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۲۶-۱۰-۰۷ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۳۶.۰ ۲۰۲۴-۱۱-۰۷
  • یک مشکل شناخته‌شده در این نسخه برای برنامه‌های فوری معرفی شده است. اگر IMA را در برنامه‌های فوری ادغام می‌کنید، توصیه می‌کنیم برنامه خود را به نسخه IMA 3.36.0 به‌روزرسانی نکنید. نسخه بعدی SDK شامل رفع این مشکل خواهد بود.
  • متدهای درخواست جریان جدیدی اضافه می‌کند که شامل پارامتر NetworkCode هستند. متدهای جدید ImaSdkFactory.createLiveStreamRequest() و ImaSdkFactory.createVodStreamRequest() هستند. APIهای مشابهی را که شامل پارامتر networkCode نمی‌شوند، منسوخ می‌کند.
  • فایل‌های خلاقانه همراه را در یک طرح‌بندی قاب مطابق با اندازه اسلات اعلام شده با CompanionAdSlot.setSize() قرار می‌دهد.
  • نسخه ۳.۳۶.۰ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۲۶-۰۷-۱۵ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۳۵.۱ ۲۴-۰۹-۲۰۲۴
  • مشکلی که باعث می‌شد Open Measurement هنگام استفاده از API ImaSdkFactory.initialize() با شکست مواجه شود، برطرف شد.
  • minSdkVersion که IMA پشتیبانی می‌کند را به ۲۱ افزایش می‌دهد.
  • ImaSdkFactory.initialize() را برای دریافت و مقداردهی اولیه دارایی‌های IMA قبل از اولین درخواست تبلیغ اضافه می‌کند. فراخوانی initialize() حافظه مورد نیاز برای پخش تبلیغات در آینده را اختصاص می‌دهد و تأخیر پخش اولین تبلیغ را کاهش می‌دهد. برای اطلاعات بیشتر، به بهبود زمان بارگذاری IMA مراجعه کنید.
  • مشکل URL کلیک‌شونده برای تبلیغات نامعتبر را برطرف می‌کند.
  • رفع مشکل کرش معرفی شده در IMA نسخه ۳.۳۴.۰ که برنامه‌هایی را که از desugaring جاوا۸ در نسخه‌های ۲۵ و پایین‌تر API اندروید استفاده نمی‌کنند، تحت تأثیر قرار می‌داد.
  • بهینه‌سازی‌هایی را به زمان راه‌اندازی IMA در دستگاه‌های CTV قدیمی اضافه می‌کند.
  • بهبود پایداری برای باز کردن لینک‌ها در دستگاه‌هایی که مرورگر نصب نشده است.
  • نسخه ۳.۳۵.۱ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۲۵-۱۱-۰۷ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۳۵.۰ منسوخ شده ۲۰۲۴-۰۸-۲۸
  • یک مشکل شناخته‌شده در این نسخه وجود دارد که اندازه‌گیری OMID هنگام استفاده از API ImaSdkFactory.initialize() با شکست مواجه می‌شود. به جای آن از IMA SDK Android نسخه ۳.۳۵.۱ استفاده کنید.
  • از آنجا که نسخه ۳.۳۵.۰ منسوخ شده است، یادداشت‌های انتشار آن به بخش نسخه ۳.۳۵.۱ منتقل شده‌اند.
۳.۳۴.۰ ۲۰۲۴-۰۶-۱۳
  • یک مشکل شناخته‌شده در این نسخه وجود دارد که برنامه‌هایی را که desugaring API جاوا ۸+ را فعال نمی‌کنند، تحت تأثیر قرار می‌دهد. این مشکل محدود به دستگاه‌هایی با API اندروید نسخه ۲۵ یا پایین‌تر است و ممکن است باعث خرابی برنامه شود.
  • getVideoStitcherSessionOptions() و setVideoStitcherSessionOptions() را به StreamRequest اضافه می‌کند تا جلسات دوخت ویدیو را در گردش کار ImaSdkFactory.createVideoStitcherLiveStreamRequest() یا ImaSdkFactory.createVideoStitcherVodStreamRequest() مدیریت کند.
  • رفع مشکل نادر کرش کردن بازی که به دلیل مقادیر نامعتبر حجم صدا ایجاد می‌شد.
  • تنظیم taskAffinity روی null در مانیفست اندروید را حذف می‌کند. این تغییر مشکلاتی را که در آن رفتار برنامه به طور غیرمنتظره تغییر می‌کرد، برطرف می‌کند.
  • نسخه ۳.۳۴.۰ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۲۵-۰۹-۲۴ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۳۳.۰ ۲۰۲۴-۰۳-۲۸
۳.۳۲.۰ منسوخ شده ۲۰۲۴-۰۱-۳۰
  • این نسخه با دستگاه‌هایی که اندروید API سطح ۲۵ و پایین‌تر را اجرا می‌کنند، مشکل دارد. به جای آن از IMA SDK اندروید نسخه ۳.۳۳.۰ استفاده کنید.
  • پشتیبانی از استریم VOD استیچر شخص ثالث برای سرویس پاد اضافه شد. برای اطلاعات بیشتر به راهنمای سرویس پاد اندروید مراجعه کنید. این تغییر شامل اضافه شدن API های زیر است:
  • minSdkVersion که IMA پشتیبانی می‌کند را به ۱۹ افزایش می‌دهد.
  • مشکلی که باعث می‌شد کلیک‌های تبلیغاتی با استفاده از دکمه «بیشتر بدانید» در اندروید API نسخه ۳۰ و بالاتر صفحه جدیدی باز نکنند، برطرف شد. این مشکل هنوز در نسخه‌های ۳.۳۱.۰ تا ۳.۲۹.۰ کیت توسعه نرم‌افزار IMA وجود دارد که برای عملکرد کلیک‌های تبلیغاتی به یک راه‌حل موقت نیاز است.
  • اشکالی که باعث می‌شد استفاده از AdsLoader.addAdsLoadedListener() باعث ایجاد خطای ArrayIndexOutOfBoundsException شود، برطرف شد.
  • خطای تبلیغ VAST_NO_ADS_AFTER_WRAPPER را اضافه می‌کند.
۳.۳۱.۰ ۲۰۲۳-۰۸-۳۱
  • مشکلی در نسخه‌های ۳.۳۱.۰ تا ۳.۲۹.۰ کیت توسعه نرم‌افزار IMA با رابط برنامه‌نویسی اندروید نسخه ۳۰ و بالاتر وجود دارد که در آن کلیک‌های تبلیغاتی با استفاده از دکمه «بیشتر بدانید» صفحه جدیدی باز نمی‌کنند. به عنوان یک راه حل برای نسخه‌های آسیب‌دیده، باید اعلان‌های اینتنت را برای باز کردن لینک‌های وب در مانیفست برنامه خود به شرح زیر اضافه کنید: 
              <?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 به نسخه ۱.۴.۸ به‌روزرسانی شد که شامل سیگنال‌های تلویزیونی متصل جدید می‌شود.
  • APIهای AdsRequest زیر را منسوخ می‌کند:
    • getExtraParameter()
    • getExtraParameters()
    • setExtraParameter()
  • نسخه ۳.۳۱.۰ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۲۵-۰۳-۲۸ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۳۰.۳ ۲۰۲۳-۰۸-۰۳
  • وابستگی‌های کتابخانه داخلی را به‌روزرسانی می‌کند تا تأخیر راه‌اندازی را بهبود بخشد.
  • نسخه ۳.۳۰.۳ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۲۴-۰۸-۳۱ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۳۰.۲ ۲۰۲۳-۰۷-۲۸
  • خطاهای غیرمنتظره NullPointerException که در نسخه ۳.۳۰.۱ معرفی شده بودند، برطرف شدند.
  • مشکلی در proguarding که باعث می‌شد برخی رویدادها از SDK منتشر نشوند، برطرف شد. این رفع اشکال، افزونه ExoPlayer برای IMA DAI SDK را تحت تأثیر قرار می‌دهد.
  • پشتیبانی از Gradle v8+ اضافه شد. نسخه‌های قبلی Android IMA SDK باید android.enableR8.fullMode=false در فایل gradle.properties تنظیم کنند. برای اطلاعات بیشتر به مقاله حالت کامل R8 مراجعه کنید.
  • نسخه ۳.۳۰.۲ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۲۴-۰۸-۰۳ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۳۰.۱ منسوخ شده ۲۰۲۳-۰۴-۱۸
  • این نسخه با خطاهای غیرمنتظره NullPointerException مشکل دارد. تا زمان انتشار نسخه جدیدتر و کارآمد، از IMA SDK Android نسخه 3.29.0 قدیمی‌تر استفاده کنید.
  • مشکلی که باعث می‌شد برنامه‌هایی که از نسخه ۳.۳۰.۰ استفاده می‌کنند در دستگاه‌های تلویزیون غیر اندروید از کار بیفتند، برطرف شد.
۳.۳۰.۰ منسوخ شده 2023-03-29
  • این نسخه مشکلی دارد که باعث از کار افتادن برنامه‌هایی می‌شود که روی پلتفرم Android TV اجرا نمی‌شوند. به جای آن از IMA SDK Android نسخه ۳.۲۹.۰ استفاده کنید.
  • API مربوط به ImaSdkFactory.createVideoStitcherVodStreamRequest() را اضافه می‌کند.
  • سازگاری برای موجودی هیبریدی تلویزیون‌های گوگل اضافه شد.
  • پشتیبانی از API منسوخ‌شده‌ی ImaSdkFactory.createSdkOwnedPlayer() را حذف می‌کند.
  • کد خطای ADS_PLAYER_NOT_PROVIDED را اضافه می‌کند.
  • کلاس BaseRequest ایجاد می‌کند که هم AdsRequest و هم StreamRequest اکنون آن را پیاده‌سازی می‌کنند.
  • کلاس SecureSignals را اضافه می‌کند.
  • متد BaseRequest.setSecureSignals() را اضافه می‌کند.
  • نسخه ۳.۳۰.۰ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۲۴-۰۴-۱۸ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۲۹.۰ ۱۴-۱۰-۲۰۲۲
  • کلاس EspVersion را به کلاس VersionInfo تغییر نام می‌دهد.
  • APIهای سیگنال‌های رمزگذاری‌شده برای ناشران (ESP) را به APIهای سیگنال‌های امن تغییر نام می‌دهد.
  • APIهای مربوط به feature flags را اضافه می‌کند. می‌توانید از APIهای feature flag برای فعال یا غیرفعال کردن ویژگی‌های خاص در IMA استفاده کنید. از ImaSdkSettings.getFeatureFlags() و ImaSdkSettings.setFeatureFlags() برای دریافت و تنظیم feature flags استفاده کنید.
  • مشکلی که باعث می‌شد برخی از رویدادهای IMA ارسال نشوند، برطرف شد.
  • androidx.webkit:webkit را به عنوان یک وابستگی IMA SDK اضافه می‌کند.
  • نسخه ۳.۲۹.۰ کیت توسعه نرم‌افزار IMA در تاریخ ۲۹-۰۳-۲۰۲۴ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۲۸.۲ ۱۴-۰۹-۲۰۲۲
  • وابستگی‌های SDK را برای استفاده از AndroidX به‌روزرسانی می‌کند.
  • نسخه ۳.۲۸.۲ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۲۳-۱۰-۱۴ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۲۸.۱ منسوخ شده ۲۰۲۲-۰۸-۰۳
  • این نسخه در اندروید نسخه ۲۷ و پایین‌تر مشکل خرابی دارد. به جای آن از IMA SDK Android نسخه ۳.۲۸.۲ استفاده کنید.
  • API مربوط به ImaSdkFactory.createVideoStitcherLiveStreamRequest() را اضافه می‌کند.
  • نسخه ۳.۲۸.۱ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۲۳-۰۹-۱۴ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۲۷.۱ ۲۰۲۲-۰۵-۲۷
  • انتشار سرویس، بدون ویژگی جدید.
  • نسخه ۳.۲۷.۱ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۲۳-۰۸-۰۳ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۲۷.۰ ۲۰۲۲-۰۳-۰۱
  • با تنظیم عرض و ارتفاع همراه برای ثابت IMA FLUID_SIZE ، پشتیبانی از اسلات‌های همراه با اندازه سیال را اضافه می‌کند.
  • نسخه ۳.۲۷.۰ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۲۳-۰۵-۲۷ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۲۶.۰ ۲۰۲۲-۰۱-۱۲
  • APIهای سیگنال‌های رمزگذاری‌شده برای ناشران (ESP) را اضافه می‌کند (که در IMA SDK نسخه ۳.۲۹.۰ به Secure Signals تغییر نام داده شده است). این به ناشران اجازه می‌دهد تا پیشنهاددهندگان شبکه و IDPها را فعال کنند.
  • نسخه ۳.۲۶.۰ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۲۳-۰۳-۰۱ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۲۵.۱ ۲۰۲۱-۱۱-۰۸
  • برای نمایش تبلیغات درون برنامه‌ای با استفاده از تب‌های سفارشی ، دو AdsRenderingSettings.setEnableCustomTabs() و AdsRenderingSettings.getEnableCustomTabs() اضافه شده‌اند.
  • از نسخه ۳.۲۵.۱ به بعد، IMA SDK شامل مجوز com.google.android.gms.permission.AD_ID در مانیفست SDK است که به طور خودکار توسط ابزارهای ساخت اندروید در مانیفست برنامه ادغام می‌شود. برای کسب اطلاعات بیشتر در مورد اعلان مجوز AD_ID ، از جمله نحوه غیرفعال کردن آن، به این مقاله راهنمای کنسول Play مراجعه کنید.
  • پشتیبانی از شناسه مجموعه برنامه برای موارد استفاده مانند گزارش و جلوگیری از کلاهبرداری را اضافه می‌کند.
  • با پشتیبانی از ذخیره‌سازی نخ و استفاده مجدد، بهبودهایی در عملکرد هنگام استفاده از چندین نمونه AdsLoader ایجاد می‌شود.
  • نسخه ۳.۲۵.۱ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۲۳-۰۱-۱۲ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۲۴.۰ ۲۰۲۱-۰۶-۰۳
۳.۲۳.۰ ۲۰۲۱-۰۴-۰۷
  • متدهای ImaSdkSettings.setSessionId() و ImaSdkSettings.getSessionId() را برای دریافت و تنظیم شناسه جلسه (Session ID) اضافه می‌کند. این یک شناسه تصادفی موقت است که منحصراً برای محدود کردن فرکانس استفاده می‌شود.
  • خطای NullPointerException مربوط به تبلیغات همراه را برطرف کرد.
  • جاوا اسکریپت را در تبلیغات همراه پایین‌تر از سطح API 21 غیرفعال می‌کند تا مشکل آسیب‌پذیری‌های امنیتی را برطرف کند.
  • نسخه ۳.۲۳.۰ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۲۲-۰۶-۰۳ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۲۲.۳ ۲۰۲۱-۰۳-۱۶
  • خطای NullPointerException مربوط به آزاد شدن AdsLoader هنگام بارگذاری یک تبلیغ برطرف شد.
  • در مواردی که یک رویداد بارگذاری تبلیغات به طور غیرمنتظره ارسال شود، خطای 1206 را برای UNEXPECTED_ADS_LOADED_EVENT اضافه می‌کند.
  • نسخه ۳.۲۲.۳ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۲۲-۰۴-۰۷ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۲۲.۲ ۲۰۲۱-۰۲-۲۶
  • کیت توسعه نرم‌افزار IMA اکنون به کتابخانه‌های زیر وابسته است:
    • com.google.android.gms:play-services-base
    • com.google.android.gms:play-services-basement
    • androidx.preference:ترجیح
  • پیام خطایی که هنگام دریافت خطا AdsLoader بدون شناسه جلسه معتبر رخ می‌داد، برطرف شد.
  • نسخه ۳.۲۲.۲ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۲۲-۰۳-۱۶ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۲۲.۰ ۲۰۲۱-۰۱-۱۱
  • سرویس پاد برای جریان‌های DAI اضافه می‌کند. در گردش کار سرویس پاد، مدیر تبلیغات فقط مسئول سرویس تبلیغات است. ناشران مسئول محتوا و ایجاد مانیفستی هستند که سپس به مدیر تبلیغات اشاره می‌کند. از ImaSdkFactory.createPodStreamRequest() برای ایجاد درخواست جریان برای سرویس پاد استفاده کنید. در صورت استفاده از این، شما مسئول بارگذاری جریان در streamInit() خواهید بود.
  • نشت حافظه ناشی از عدم پاکسازی صحیح مانیتور چرخه عمر برنامه برطرف شد.
  • نسخه ۳.۲۲.۰ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۲۲-۰۲-۲۶ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۲۱.۴ ۲۰۲۰-۱۲-۰۹
  • پیام هشدار بی‌ضرر مربوط به فراخوانی adsLoader.release() پس از تخریب نمای وب را حذف می‌کند.
  • نسخه ۳.۲۱.۴ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۲۲-۰۱-۰۸ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۲۱.۲ ۲۰۲۰-۱۱-۲۰
  • مشکلات غیرمنتظره‌ی thread-safe ناشی از ارسال به‌روزرسانی‌های پیام از یک صف خالی را برطرف می‌کند.
  • مستندات مربوط به AdsLoader.release() را به‌روزرسانی کرد.
  • نسخه ۳.۲۱.۲ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۲۱-۱۲-۰۹ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۲۱.۱ ۲۰۲۰-۱۱-۱۷
  • مشکلی را که گاهی اوقات منجر به از کار افتادن برنامه هنگام اجرای رویدادها می‌شد، برطرف می‌کند.
  • نسخه ۳.۲۱.۱ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۲۱-۱۱-۲۰ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۲۱.۰ ۲۰۲۰-۱۰-۲۳
  • پشتیبانی از تبلیغات SIMID را در DAI Android SDK اضافه می‌کند.
  • متد AdsLoader.release() را اضافه می‌کند و BaseDisplayContainer.destroy() را منسوخ می‌کند. این تغییر، نشت حافظه‌ای را که هنگام حذف BaseDisplayContainer در وسط یک برنامه تبلیغاتی VMAP رخ داده بود، برطرف می‌کند. AdsLoader.release() روش پیشنهادی جدید برای حذف اشیاء IMA SDK است، به جای استفاده از BaseDisplayContainer.destroy() .
  • نسخه ۳.۲۱.۰ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۲۱-۱۱-۱۷ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۲۰.۱ ۲۰۲۰-۱۰-۱۲
۳.۲۰.۰ ۲۰۲۰-۰۸-۱۸
  • نسخه ۳.۲۰.۰ اولین نسخه‌ای است که تحت تأثیر تغییرات در رفتار مکث IMA قرار خواهد گرفت. اگر از این یا هر نسخه بعدی 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 وجود داشت و در آن رویدادهای تبلیغاتی به درستی گزارش نمی‌شد، برطرف شد.
  • نسخه ۳.۲۰.۰ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۲۱-۱۰-۱۲ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۱۹.۴ ۲۰۲۰-۰۷-۰۸
  • مشکلی که مانع از به‌روزرسانی صحیح timeout setLoadVideoTimeout می‌شد، برطرف شد.
  • نسخه ۳.۱۹.۴ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۲۱-۰۸-۱۸ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۱۹.۳ ۲۰۲۰-۰۶-۲۹
  • مشکلی را در ادغام IAB TCF برای GDPR که باعث خرابی بازیکنانی می‌شد که با SDK های پلتفرم مدیریت رضایت ادغام شده بودند، برطرف کرد.
  • نسخه ۳.۱۹.۳ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۲۱-۰۷-۰۸ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۱۹.۲ ۲۰۲۰-۰۶-۲۲
  • مشکلی که باعث می‌شد SDK رویدادهای VideoAdPlayerCallback.onContentComplete() را خارج از پخش تبلیغات نادیده بگیرد، برطرف شد.
  • قابلیت تعیین مجموعه‌های زیرنویس DAI مختلف برای یک زبان با استفاده از پارامتر subtitle_name برای VideoStreamPlayer.loadUrl() اضافه شد.
  • نسخه ۳.۱۹.۲ کیت توسعه نرم‌افزار IMA در تاریخ ۲۹-۰۶-۲۰۲۱ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۱۹.۰ ۲۰۲۰-۰۵-۱۲
۳.۱۸.۱ ۲۰۲۰-۰۳-۲۵
  • قابلیت مقیاس‌بندی برای تبلیغات همراه در دستگاه‌های با تراکم پیکسلی بالا اضافه شد.
  • پشتیبانی از تبلیغات SIMID سمت کلاینت را اضافه می‌کند.
  • نسخه ۳.۱۸.۱ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۲۱-۰۵-۱۲ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۱۸.۰ ۲۰۲۰-۰۳-۰۴
  • توابع pause() و resume() را به رابط VideoStreamPlayer اضافه می‌کند. این توابع باید برای نسخه ۳.۱۸.۰ و بالاتر پیاده‌سازی شوند.
  • نسخه ۳.۱۸.۰ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۲۱-۰۳-۲۵ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۱۷.۰ ۲۰۲۰-۰۲-۰۷
  • APIهای زیر را برای انتقال اعتبارسنجی کانتینرهای نمایش به زمان ایجاد آنها اضافه می‌کند:
  • ImaSdkFactory.createSdkOwnedPlayer را اضافه می‌کند که باید توسط کسانی که از پخش‌کننده‌ی داخلی IMA (SdkOwnedPlayer) استفاده می‌کنند، مورد استفاده قرار گیرد. این پخش‌کننده باید به صورت دستی ساخته شده و به سازنده‌ی AdDisplayContainer ارسال شود.
  • بررسی‌های عدم تهی بودن را به setAdContainer و setPlayer اضافه می‌کند.
  • داده‌های cuepoint به‌روزرسانی شد تا اکنون از دقت ممیز شناور استفاده کند.
  • متدهای زیر را منسوخ می‌کند:
    • AdDisplayContainer.setPlayer(VideoAdPlayer player)
    • BaseDisplayContainer.setAdContainer(ViewGroup container)
    • BaseManager.isCustomPlaybackUsed()
    • ImaSdkFactory.createAdDisplayContainer()
    • ImaSdkFactory.createAudioAdDisplayContainer(Context context)
    • ImaSdkFactory.createStreamDisplayContainer()
    • StreamDisplayContainer.setVideoStreamPlayer(VideoStreamPlayer player)
  • نسخه ۳.۱۷.۰ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۲۱-۰۳-۰۴ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۱۶.۵ ۲۰۲۰-۰۱-۲۲
  • پشتیبانی از contentUrl مربوط به OMID 1.3 با AdsRequest.setContentUrl و StreamRequest.setContentUrl دوباره انجام می‌شود.
  • پشتیبانی از موانع دوستانه OMID 1.3 با FriendlyObstruction را دوباره انجام می‌دهد.
  • متدهای BaseDisplayContainer.registerVideoControlsOverlay و BaseDisplayContainer.unregisterAllVideoControlsOverlay را به نفع FriendlyObstruction منسوخ می‌کند.
  • مشکلی که باعث می‌شد پس از فراخوانی clear() در CompanionAdSlots خطای NullPointerException رخ دهد، برطرف شد.
  • مشکلی که به طور بالقوه باعث نشت حافظه هنگام فراخوانی destroy() در حین پخش تبلیغات می‌شد، برطرف شد.
  • نسخه ۳.۱۶.۵ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۲۱-۰۲-۰۷ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۱۶.۲ ۲۰۱۹-۱۲-۰۵
  • پشتیبانی از گنجاندن خودکار پارامترهای رضایت از IAB TCFv2 و CCPA را اضافه می‌کند.
  • استفاده از تنظیمات برگزیده اندروید اکنون به بسته androidx نیاز دارد.
  • نسخه ۳.۱۶.۲ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۲۱-۰۱-۲۲ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۱۶.۱ ۲۰۱۹-۱۱-۰۸
  • یک متد جدید به ImaSdkFactory برای createAudioAdDisplayContainer اضافه می‌کند.
  • نسخه ۳.۱۶.۱ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۲۰-۱۲-۰۵ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۱۶.۰ ۲۰۱۹-۱۰-۲۳
  • متد 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()
  • نسخه ۳.۱۶.۰ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۲۰-۱۱-۰۸ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۱۴.۰ ۲۰۱۹-۰۹-۱۱
  • انتشار سرویس، بدون ویژگی جدید.
  • نسخه ۳.۱۴.۰ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۲۰-۱۰-۲۳ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۱۳.۱ ۲۰۱۹-۰۹-۰۳
  • قابلیت تنظیم زمینه پخش مداوم برای درخواست تبلیغات را اضافه می‌کند. برای جزئیات بیشتر، به setContinuousPlayback() مراجعه کنید.
  • متد getUniversalAdIds() را به کلاس Ad اضافه می‌کند.
  • enumهای setAuthToken ، getAuthToken ، setFormat ، getFormat و StreamFormat را اضافه می‌کند.
  • خطایی در دستگاه‌های نکسوس ۵ که هنگام حذف یک کانتینر قبل از دریافت پاسخ تبلیغ رخ می‌داد، برطرف شد.
  • مشکلی که باعث می‌شد تبلیغات همراه فقط یک بار نمایش داده شوند، برطرف شد.
  • مشکلی را برطرف می‌کند که در آن انواع تبلیغات پشتیبانی نشده (غیرخطی، VPAID) به خوبی اجرا نمی‌شدند.
  • نسخه ۳.۱۳.۱ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۲۰-۰۹-۱۱ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۱۱.۳ ۲۰۱۹-۰۶-۱۱
  • رفع اشکال با تنظیم is_lat در دستگاه‌های AOSP.
  • نسخه ۳.۱۱.۳ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۲۰-۰۹-۰۳ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۱۱.۲ ۲۰۱۹-۰۴-۱۶
  • خطای زیر برطرف شد: java.lang.ClassNotFoundException: Didn't find class "j$.util.concurrent.ConcurrentHashMap" .
  • نسخه ۳.۱۱.۰ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۲۰-۰۶-۱۱ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۱۱.۰ منسوخ شده ۲۰۱۹-۰۳-۲۲
۳.۱۰.۹ ۱۳-۰۳-۲۰۱۹
  • اشکال مربوط به شرایط رقابتی که باعث می‌شد رابط کاربری تبلیغ گاهی اوقات پس از رد شدن از اولین تبلیغ، در تبلیغات بعدی نمایش داده نشود، برطرف شد.
  • مشکلی که هنگام فراخوانی API مربوط به getCompanionAds() رخ می‌داد، برطرف شد.
  • نسخه ۳.۱۰.۷ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۲۰-۰۳-۲۲ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۱۰.۷ ۲۰۱۹-۰۲-۱۹
  • رویدادهای تبلیغاتی onAdPeriodStarted() و onAdPeriodEnded() را اضافه می‌کند. این رویدادها فقط برای DAI پشتیبانی می‌شوند.
  • نسخه ۳.۱۰.۶ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۲۰-۰۳-۱۳ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۱۰.۶ ۲۰۱۹-۰۱-۲۳
  • متد seek() را به رابط پخش‌کننده‌ی استریم اضافه می‌کند.
  • پشتیبانی از فراخوانی‌های رویداد تبلیغاتی AD_BUFFERING را اضافه می‌کند.
  • دیگر لازم نیست کانتینرها در درخواست تبلیغ ارسال شوند. گردش کار جدید مستلزم آن است که یک کانتینر از طریق سازنده AdsLoader ارسال شود.
  • متد BaseDisplayContainer.destroy() را اضافه می‌کند.
  • مشکل نشت حافظه که هنگام پخش ویدیو رخ می‌داد، برطرف شد.
  • requestNextAdBreak منسوخ می‌کند. این API در نسخه‌های آینده حذف خواهد شد. پس از آن، تبلیغات به طور خودکار ۴ ثانیه قبل از زمان قطع تبلیغات، نمایش داده می‌شوند.
  • نسخه ۳.۱۰.۲ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۲۰-۰۲-۱۹ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۱۰.۲ ۲۰۱۸-۱۱-۱۳
  • مشکل رقابتی که باعث می‌شد تبلیغ دوم در یک پاد، خطای VAST 402 را نمایش دهد، برطرف شد.
  • محدودیت فرکانس و حذف رقابتی را به DAI Android SDK اضافه می‌کند.
  • getAdProgressInfo() از StreamManager به BaseManager منتقل می‌کند.
  • getVastMediaHeight() ، getVastMediaWidth() و getVastMediaBitrate() را به Ad اضافه می‌کند.
  • نسخه ۳.۹.۴ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۲۰-۰۱-۲۳ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۹.۴ ۲۰۱۸-۰۸-۰۱
  • getCompanionAds() ‎ را به Ad اضافه می‌کند. این تابع فقط در صورت استفاده از DAI، تبلیغات همراه را برمی‌گرداند.
  • کلاس جدید CompanionAd را اضافه می‌کند.
  • رویداد جدید SKIPPABLE_STATE_CHANGED را به AdEvent اضافه می‌کند.
  • مشکلی که باعث می‌شد تنظیمات پیش‌فرض focusSkipButtonWhenAvailable در برخی موارد رعایت نشود، برطرف شد.
  • نسخه ۳.۹.۰ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۱۹-۰۸-۰۱ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۹.۰ ۲۰۱۸-۰۷-۰۹
  • اکنون از اندروید تی‌وی پشتیبانی می‌شود.
  • focusSkipButton() به AdsManager اضافه می‌کند. این فقط در Android TV کار می‌کند.
  • تابع getFocusSkipButtonWhenAvailable() را به AdsRenderingSettings اضافه می‌کند و مقدار پیش‌فرض آن را true قرار می‌دهد. این تابع فقط روی تلویزیون اندروید کار می‌کند.
  • setFocusSkipButtonWhenAvailable() را به AdsRenderingSettings اضافه می‌کند. این تابع فقط روی تلویزیون اندروید کار می‌کند.
  • VideoAdPlayer اکنون رابط VolumeProvider را توسعه می‌دهد. پیاده‌سازی این رابط اکنون برای پخش سفارشی مورد نیاز است.
  • نسخه ۳.۸.۷ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۱۹-۰۷-۰۹ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۸.۷ ۲۰۱۸-۰۵-۲۳
  • امکان نمایش انیمیشن در تبلیغات همراه HTML را فراهم می‌کند.
  • نسخه ۳.۸.۵ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۱۹-۰۵-۲۳ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۸.۵ ۲۰۱۸-۰۴-۰۹
  • مشکل نادیده گرفته شدن ImaSdkSettings برطرف شد.
  • مشکلی که باعث ایجاد تداخل در ساخت با فایل‌های نسخه com.android.support می‌شد، برطرف شد.
  • setAdWillPlayMuted به AdsRequest اضافه می‌کند.
  • setLoadVideoTimeout را به AdsRenderingSettings اضافه می‌کند.
  • نسخه ۳.۸.۲ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۱۹-۰۴-۰۹ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۸.۲ ۲۰۱۸-۰۱-۲۴
  • setLiveStreamPrefetchSeconds به AdsRequest اضافه می‌کند.
  • اصلاحات مختلف مستندات.
  • نسخه ۳.۷.۴ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۱۹-۰۱-۲۴ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۷.۴ ۱۳۹۶-۰۶-۲۹
  • setVastLoadTimeout را به AdsRequest اضافه می‌کند.
  • getSkipTimeOffset را به Ad اضافه می‌کند.
  • نسخه ۳.۷.۲ کیت توسعه نرم‌افزار IMA در تاریخ ۲۹-۰۶-۲۰۱۸ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۷.۲ ۲۰۱۷-۰۵-۲۵
  • setDebugMode به ImaSdkSettings اضافه می‌کند.
  • نسخه ۳.۷.۱ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۱۸-۰۵-۲۵ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۷.۱ ۲۰۱۷-۰۳-۲۴
  • هنگام استفاده از Proguard، تداخل فضای نام را برطرف می‌کند.
  • حجم Jar حدود 30 کیلوبایت کاهش یافته است.
  • نسخه ۳.۷.۰ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۱۸-۰۳-۲۴ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۷.۰ ۱۳۹۶-۰۳-۱۳
  • مشکلی که باعث می‌شد برخی از کلاس‌های IMA سهواً در بسته aaaa نرم‌افزار ProGuard ادغام شوند، برطرف شد.
  • نسخه ۳.۶.۰ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۱۸-۰۳-۱۳ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۶.۰ ۱۳۹۶-۰۲-۱۶
  • موارد زیر را به Ad اضافه می‌کند:
    • getAdWrapperCreativeIds()
    • getAdvertiserName()
    • getCreativeAdId()
    • getCreativeId()
    • getDealId()
    • getSurveyUrl()
    • getUniversalAdIdRegistry()
    • getUniversalAdIdValue()
  • تابع AdsManager.requestNextAdBreak().
  • موارد زیر را به AdsRenderingSettings اضافه می‌کند:
    • setEnablePreloading()
    • getEnablePreloading()
  • موارد زیر را به AdsRequest اضافه می‌کند:
    • setContentDuration()
    • setContentKeywords()
    • setContentTitle()
  • نسخه ۳.۵.۲ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۱۸-۰۲-۱۶ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۵.۲ ۱۳۹۵-۱۱-۱۴
  • یک پخش‌کننده ویدیویی متعلق به SDK اضافه می‌کند که به صورت اختیاری پخش تبلیغات را مدیریت می‌کند.
  • CompanionAdSlot.ClickListener و متدهایی برای اضافه کردن و حذف کردن یک شنونده اضافه می‌کند.
  • مشکل مربوط به گزارش‌های خطای نامعتبر getViewability() برطرف شد.
  • مشکلی که باعث می‌شد آیکون‌ها به درستی نمایش داده نشوند و با کلیک کردن نمایش داده نشوند، برطرف شد.
  • نسخه ۳.۴.۰ کیت توسعه نرم‌افزار IMA در تاریخ ۲۰۱۷-۱۱-۱۴ منسوخ شده است. برای جزئیات بیشتر، به جدول منسوخ‌شده‌ها مراجعه کنید.
۳.۴.۰ ۱۳۹۵-۰۹-۱۲
  • خطای فایل‌های تکراری هنگام استفاده از سرویس‌های گوگل پلی نسخه ۹.۰.۰ و بالاتر برطرف شد.
۳.۳.۲ ۱۳۹۵-۰۷-۱۱
  • رویدادهای AD_BREAK_STARTED و AD_BREAK_ENDED به تابع فراخوانی AdEventListener.onAdEvent اضافه می‌کند.
۳.۳.۰ ۱۳۹۵-۰۵-۳۱
۳.۲.۱ ۲۰۱۶-۰۴-۰۷
  • انتشار سرویس، بدون ویژگی جدید.
۳.۱.۳ ۱۳۹۴-۱۲-۱۶
۳.ب۱۳.۳ (بتا) ۲۰۱۵-۰۹-۱۰
  • انتشار سرویس، بدون ویژگی جدید.
۳.b۱۲.۱ (بتا) ۲۰۱۵-۰۷-۲۰
۳.b۱۱.۴ (بتا) ۲۰۱۵-۰۵-۲۱
  • موارد زیر را به API اضافه می‌کند:
    • AdError.AdErrorCode.VAST_EMPTY_RESPONSE
    • AdError.getErrorNumber()
    • AdsRequest.setAdWillAutoPlay(Boolean)
    • CompanionAdSlot.isFilled()
    • ImaSdkSettings.setPlayerType(String)
    • ImaSdkSettings.setPlayerVersion(String)
۳.b۱۰.۳ (بتا) ۲۰۱۵-۰۳-۲۴
  • 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 استفاده کنید.
نسخه بتا ۹ ۲۰۱۴-۱۰-۱۷
  • APIهای تبلیغاتی getTitle ، getDescription و getContentType را اضافه می‌کند.
  • اطلاعاتی در مورد موقعیت جایگاه تبلیغات در Ad pod به رابط کاربری تبلیغات اضافه می‌کند، برای مثال، "آگهی ۱ از ۴: (۰:۱۳)".
  • شما دیگر نباید مستقیماً مکث/پخش/ازسرگیری تبلیغات را با استفاده از پخش‌کننده ویدیوی خود کنترل کنید. در عوض، AdsManager.pause() و AdsManager.resume() استفاده کنید.
نسخه بتا ۸ ۲۰۱۴-۰۶-۱۲
  • مشکلی که باعث می‌شد رابط کاربری تبلیغات برای تبلیغات قابل رد شدن پاک نشود، برطرف شد.
  • کد خطا مربوط به وقفه‌های زمانی بارگذاری فایل رسانه‌ای را مستند می‌کند.
نسخه بتا ۷ 2014-05-27
  • مشکلی با سرویس‌های گوگل پلی برطرف شد. SDK اکنون مستلزم آن است که سرویس‌های گوگل پلی در برنامه شما تعبیه شده باشند. برای اطلاعات بیشتر، به راه‌اندازی SDK سرویس‌های گوگل پلی مراجعه کنید.
نسخه بتا ۶ ۲۰۱۴-۰۴-۱۴
  • پشتیبانی از VAST 3 اضافه شد.
  • پشتیبانی جزئی از VMAP را اضافه می‌کند (برابر با قوانین فعلی تبلیغات Ad Manager).
  • موارد زیر را به API اضافه می‌کند:
    • خطای شبکه درخواست تبلیغات.کد خطای تبلیغات.خطای شبکه درخواست تبلیغات
    • رویداد تبلیغاتی.نوع رویداد تبلیغاتی.گزارش
    • AdEvent.getAdData()
    • AdPodInfo.getMaximumDuration()
    • AdPodInfo.getPodIndex()
    • AdPodInfo.getTimeOffset()
  • رفع اشکالی که باعث می‌شد تبلیغات میانی با یک پاد بهینه‌شده با یک پوشش، از سایر تبلیغات موجود در پاد صرف‌نظر کنند.
  • تنظیمات AdsRendering که به AdsManager ارسال می‌شوند، دیگر نادیده گرفته نخواهند شد.
  • رفع چندین باگ برای افزایش پایداری.
نسخه بتا ۵ ۲۰۱۳-۱۲-۱۲
  • مشکل تبلیغات قابل رد شدن در لیست‌های پخش برطرف شد.
نسخه بتا ۴ ۲۰۱۳-۱۰-۱۵
  • قابلیت تنظیم مجدد مقادیر همبستگی‌ساز با فراخوانی contentComplete در AdsLoader اضافه شد.
نسخه بتا ۳ ۲۰۱۳-۰۹-۰۵
  • انتشار سرویس، بدون ویژگی جدید.
نسخه بتا ۲ ۲۰۱۳-۰۷-۰۷
  • انتشار عمومی نسخه بتای SDK.
نسخه بتا بسته ۲ ۲۰۱۳-۰۶-۲۴
  • API برای تنظیم زبان رابط کاربری روی شیء ImaSdkSettings اضافه شد. توجه داشته باشید که این برای تنظیم زبان رابط کاربری استفاده می‌شود، نه زبان تبلیغ.
  • تداخلی که هنگام وجود همزمان کتابخانه‌های IMA SDK و AdMob SDK در یک برنامه ایجاد می‌شد، برطرف شد.
  • قابلیت ثبت وقایع برای معیارهای مختلف عملکرد داخلی اضافه شد.
نسخه بتا بسته ۱ ۲۰۱۳-۰۴-۰۲

  • Initial Beta release. The following are known issues with the Beta release:

    SDK-related

    The following AdEvents available within the HTML5 IMA SDK are not supported within the Android v3 IMA SDK: IMPRESSION , LOG , SKIPPABLE_STATE_CHANGED , STOPPED , VOLUME_CHANGED , VOLUME_MUTED

    Sample App-related

    1. There is an intermittent issue where the ad player does not properly resume after the user has clicked through on an ad. For example, occasionally, when you return to the app after clicking through on an ad, resuming play of that ad causes it to skip to the end and complete, rather than resuming where it left off prior to click through.
    2. The ads returned by the "Instream 2" ad tag are not compatible with the v3 IMA Android SDK.
    3. The sample player does not automatically disable seeking (scrubbing) while ads are playing. Be sure to disable seeking in your video player while ads are being played.