یادداشت های انتشار

نسخه تاریخ انتشار یادداشت‌ها
۱.۵.۰ ۲۴-۰۹-۲۰۲۶
  • APIهای تولید و رندر سیگنال برای قالب SwipeableInterstitialAd اضافه شد. این ویژگی در نسخه بتای خصوصی است. برای درخواست دسترسی با مدیر حساب خود تماس بگیرید.
  • یک API excludedAppIds به درخواست‌های تبلیغات آیکون اضافه شد که به ناشران اجازه می‌دهد به صورت اختیاری لیستی از شناسه‌های برنامه را از پاسخ‌های تبلیغات آیکون حذف کنند.
۱.۴.۰ ۲۰۲۶-۰۸-۲۰
۱.۳.۱ ۲۹-۰۷-۲۰۲۶
  • رفع اشکال و بهبود عملکرد برای یک ویژگی دسترسی محدود.
۱.۳.۰ ۲۰۲۶-۰۷-۲۱
  • تابع AdView.loadAd() ‎ تغییر کرد تا در صورت غیرفعال بودن به‌روزرسانی خودکار برای واحد تبلیغ، تلاش‌های مجدد خودکار برای درخواست‌های تبلیغ ناموفق را متوقف کند.
  • وقتی درخواست تبلیغ برای چندین تبلیغ بومی یا تبلیغات آیکونی منجر به عدم نمایش تبلیغ می‌شود، SDK اکنون به جای INTERNAL_ERROR خطای NO_FILL را برمی‌گرداند.
  • یک پرچم مانیفست برای غیرفعال کردن بازرس تبلیغات اضافه شد.
  • متد Ad.getAdUnitId() برای شناسایی شناسه واحد تبلیغاتی مورد استفاده برای درخواست تبلیغ اضافه شد.
  • متد InitializationConfig.Builder.disableSdkCrashReporting() اضافه شد که امکان غیرفعال‌سازی دستی برای مدیریت‌کننده‌ی پیش‌فرض کرش در GMA Next-Gen SDK را فراهم می‌کند. به‌طور پیش‌فرض، SDK همچنان کرش‌ها را به سایر مدیریت‌کننده‌های ثبت‌شده (مانند Crashlytics) واگذار می‌کند.
  • هنگام استفاده از میانجیگری با منابع تبلیغاتی رویداد سفارشی، ResponseInfo.getAdapterClassName() اکنون نام کلاس رویداد سفارشی شما را به جای com.google.ads.mediation.customevent.CustomEventAdapter برمی‌گرداند.
۱.۲.۱ ۲۰۲۶-۰۶-۱۵
  • برای برنامه‌هایی که از WebView API برای تبلیغات استفاده می‌کنند، مشکلی که مانع از ارائه سیگنال توسط SDK به تگ‌های تبلیغاتی پشتیبانی‌شده (کد AdSense، تگ Google Publisher، IMA برای HTML5) می‌شد، برطرف شد. این مشکل به دلیل فراخوانی نادرست متدهای Webkit در یک رشته پس‌زمینه ایجاد شده بود.
۱.۲.۰ ۲۰۲۶-۰۶-۱۱
  • اشکالی که باعث ایجاد خطای java.lang.NullPointerException در androidx.webkit.internal.PrefetchOperationCallbackAdapter می‌شد، برطرف شد.
  • قالب SwipeableInterstitialAd اضافه شد. این ویژگی در نسخه بتای خصوصی است. برای درخواست دسترسی با مدیر حساب خود تماس بگیرید.
  • برای برنامه‌هایی که چندین آیکون تبلیغاتی درخواست می‌کنند، IconAd.load(IconAdRequest, int, IconAdLoadCallback) اضافه شده و IconAd.load(IconAdRequest, int, AdLoadCallback<IconAd>) منسوخ شده است. IconAdLoadCallback شامل یک متد onAdLoadingCompleted() است که زمان اتمام بارگذاری تمام تبلیغات را اعلام می‌کند.
  • آداپتورهای میانجیگری:
    • متد RequestConfiguration.getAgeRestrictedTreatment() اضافه شد تا به آداپتورها اجازه دهد تنظیمات مربوط به سن را بخوانند.
    • تابع untrackView() به جای View? View را بپذیرد تا سازگاری با آداپتورهای ساخته شده برای Google Mobile Ads SDK (Legacy) حفظ شود.
۱.۱.۱ ۲۰۲۶-۰۵-۲۷
  • مشکلی که باعث می‌شد پادهای تبلیغاتی جایزه‌دار در حین انتقال متوقف شوند و کاربران نتوانند تبلیغ را ببندند، برطرف شد.
۱.۱.۰ ۲۰۲۶-۰۵-۱۸
۱.۰.۱ ۲۰۲۶-۰۴-۳۰
  • مشکلی که باعث می‌شد تبلیغاتی که از window.open() استفاده می‌کنند یا لینک‌هایی با target="_blank" در باز کردن صفحات فرود ناموفق باشند، برطرف شد.
۱.۰.۰ ۱۴-۰۴-۲۰۲۶
۰.۲۵.۰-بتا۰۱ ۲۴-۰۳-۲۰۲۶
  • مشکلی که باعث می‌شد تابع Ad.getResponseInfo() هنگام به‌روزرسانی یک بنر تبلیغاتی، فراداده‌های به‌روزرسانی‌شده‌ی ResponseInfo را برنگرداند، برطرف شد.
۰.۲۴.۰-بتا۰۳ ۲۰۲۶-۰۳-۰۷
  • مشکلی که باعث می‌شد AdView.destroy() پس از ناموفق بودن بارگذاری یک تبلیغ، نتواند تلاش‌های مجدد برای بارگذاری آن را متوقف کند، برطرف شد.
  • برای بهبود سازگاری با کاتلین، سازنده‌های بدون آرگومان به NativeAdMapper و UnifiedNativeAdMapper اضافه شدند.
  • ویژگی packageName به رابط IconAd اضافه شد.
  • گزینه‌ای اضافه شده است که SDK را مجبور می‌کند برای عملیات شبکه از Cronet به جای OkHttp استفاده کند. برای رفع خطاهای زمان اجرا در پروژه‌هایی که از OkHttp 5 استفاده می‌کنند، توصیه می‌کنیم Cronet را برای عملیات شبکه مجبور کنید. برای مجبور کردن Cronet، هنگام فراخوانی MobileAds.initialize() در InitializationConfig.Builder ، مقدار force_use_cronet extra را روی true تنظیم کنید: 
    val config = InitializationConfig.Builder()
  .setExtras(bundleOf("force_use_cronet" to true))
  .build()
MobileAds.initialize(this, config)
  • پشتیبانی از جاوا ۱۱ اضافه شد. برای استفاده از جاوا ۱۱، کد زیر را به بلوک android در فایل build.gradle خود اضافه کنید: 
    android {
  compileOptions {
    sourceCompatibility JavaVersion.VERSION_11
    targetCompatibility JavaVersion.VERSION_11
  }
  kotlinOptions {
    jvmTarget = '11'
  }
}
۰.۲۴.۰-بتا۰۲ ۲۰۲۶-۰۳-۰۳
  • مشکل بارگذاری کلاس وابستگی شخص ثالث که بر تولید سیگنال درخواست تبلیغات سرور به سرور تأثیر می‌گذاشت، برطرف شد.
۰.۲۴.۰-بتا۰۱ ۲۰۲۶-۰۲-۱۳
۰.۲۳.۰-بتا۰۱ ۲۶-۰۱-۲۰۲۶
  • حداقل نسخه مورد نیاز افزونه اندروید گریدل (AGP) به ۸.۳.۰ به‌روزرسانی شد.
  • اشکالی که باعث می‌شد سازنده‌ی AdView هنگام فراخوانی از کاتلین، خطای java.lang.NoSuchMethodError را نمایش دهد، برطرف شد.
  • اشکالی که باعث می‌شد آداپتورهای رویداد سفارشی در حین اجرای آبشاری فراخوانی نشوند، برطرف شد.
  • RtbSignalData به‌روزرسانی شد تا در صورت وجود، یک Activity Context برای RtbAdapter.collectSignals() ارائه دهد.
  • وابستگی androidx.webkit به نسخه ۱.۱۵.۰ به‌روزرسانی شد.
  • وابستگی SDK پلتفرم پیام‌رسانی کاربر به نسخه ۴.۰.۰ به‌روزرسانی شد.
  • منسوخ شدن AdPreloader.getConfiguration() و AdPreloader.getConfigurations() را بازگرداند.
۰.۲۲.۰-بتا۰۴ ۲۰۲۵-۱۲-۰۴
  • مشکلی که در SDK نسخه 0.22.0-beta02 وجود داشت و در آن متادیتای پیش‌نمایش جاوا 17 به اشتباه در فایل‌های کلاس گنجانده می‌شد، برطرف شد.
۰.۲۲.۰-بتا۰۳ ۲۰۲۵-۱۱-۲۵
  • اشکالی که باعث می‌شد درخواست‌های تبلیغ سرور به سرور با استفاده از NativeSignalRequest.Builder.setAdSize() اندازه تبلیغ درخواستی را به درستی تنظیم نکنند، برطرف شد.
۰.۲۲.۰-بتا۰۲ ۲۰۲۵-۱۱-۲۴
  • اشکال بارگذاری Ad Manager که در آن درخواست‌های تبلیغاتی سرور به سرور با استفاده از NativeSignalRequest در صورت وجود نوع پاسخ تبلیغ NativeAd.NativeAdType.BANNER ، اجرا نمی‌شد، برطرف شد.
۰.۲۲.۰-بتا۰۱ ۲۰۲۵-۱۱-۲۰
  • به‌روزرسانی API تبلیغات بنری:
    • کلاس AdView اضافه شد.
    • BannerAd.load() و BannerAd.loadFromAdResponse() منسوخ شده‌اند. برای بارگذاری یک بنر تبلیغاتی، به جای آنها AdView.loadAd() و AdView.loadFromAdResponse() استفاده کنید.
    • BannerAd.getView() منسوخ شده است. برای رندر کردن یک BannerAd بارگذاری شده با BannerAdPreloader ، یک نمونه AdView ایجاد کنید و AdView.registerBannerAd() استفاده کنید.
  • اشکالی در تبلیغات واسطه‌ای که در آن NativeAdRequest.Builder.setAdChoicesPlacement() رعایت نمی‌شد و باعث می‌شد جایگذاری آیکون Ad Choices نادرست باشد، برطرف شد.
  • حداقل نسخه مورد نیاز افزونه اندروید گریدل (AGP) از ۸.۲.۰ به ۷.۳.۱ کاهش یافت.
  • AdPreloader.getConfigurations() و AdPreloader.getConfiguration(preloadId) منسوخ شده‌اند. جایگزینی برای آنها وجود ندارد.
۰.۲۱.۰-بتا۰۱ ۲۰۲۵-۱۰-۰۸
  • متد InitializationConfig.Builder.disableMediationAdapterInitialization() اضافه شد. این متد را قبل از مقداردهی اولیه GMA Next-Gen SDK فراخوانی کنید تا مقداردهی اولیه آداپتور میانجیگری غیرفعال شود.
  • بهبود استفاده از مقداردهی اولیه WebView برای کاهش ANRها.
  • وابستگی androidx.webkit از ۱.۱۳.۰ به ۱.۱۲.۱ کاهش یافت.
  • مجوز android.permission.RECEIVE_BOOT_COMPLETED که توسط بسته androidx.work استفاده می‌شد، حذف شد.
  • فیلدی که در کلاس NativeAdMapper نام اشتباهی داشت، اصلاح شد.
۰.۲۰.۰-بتا۰۱ ۲۰۲۵-۰۹-۱۹
  • اشکالی که باعث می‌شد برخی از تبلیغات ویدیویی بومی به طور خودکار پخش نشوند، برطرف شد.
۰.۱۹.۰-بتا۰۱ ۱۴-۰۸-۲۰۲۵
  • نسخه‌های تنزل‌یافته از دو وابستگی.
    • androidx.work:work-runtime از نسخه ۲.۱۰.۰ تا ۲.۷.۰.
    • androidx.core:core and androidx.core:core-ktx از نسخه ۱.۱۵.۰ به ۱.۱۲.۰.
  • نام ویژگی loadedAdSourceResponse در ResponseInfo را به loadedAdSourceResponseInfo تغییر داد.
  • اشکالی که به کاربران اجازه می‌داد برخی از تبلیغات تمام صفحه را با دکمه بازگشت، قبل از موعد مقرر رد کنند، برطرف شد.
  • ناشرانی که به این ویژگی دسترسی دارند، اکنون از پشتیبانی شناسه قرارگیری برای همه قالب‌های تبلیغاتی برخوردارند.
  • یک تابع فراخوانی destroy() برای آداپتورهای میانجیگری بومی به NativeAdMapper اضافه شد.
۰.۱۸.۰-بتا۰۱ ۲۰۲۵-۰۷-۱۷
  • اشکال میانجیگری بومی که باعث اختلال در نمایش تبلیغات برای آداپتورهایی می‌شد که به com.google.android.gms.ads.NativeAd.MediaView ارجاع می‌دادند، برطرف شد.
  • MobileAds.registerCustomTabsSession() ‎ با @JvmStatic ‎ حاشیه‌نویسی شده است.
  • اشکالی که باعث می‌شد بنرهای تبلیغاتی بارگذاری شده با استفاده از AdMob Network Waterfall دیگر به‌روزرسانی نشوند، برطرف شد.
۰.۱۷.۰-آلفا۰۲ ۲۳-۰۶-۲۰۲۵
  • اشکال مربوط به پیشنهاد قیمت میانجیگری بومی برطرف شد که در آن آداپتورهایی که پیشنهاد قیمت را اجرا می‌کنند اما از روش آبشاری استفاده نمی‌کنند (مثلاً شبکه مخاطبان متا) همیشه در ارائه تبلیغات بومی با مشکل مواجه می‌شدند.
  • مشکلی که هنگام فراخوانی چندین متد MediationAdLoadCallback توسط آداپتور میانجیگری برای یک درخواست تبلیغ واحد رخ می‌داد، برطرف شد.
۰.۱۷.۰-آلفا۰۱ ۲۰۲۵-۰۶-۱۸
  • نسخه ۰.۱۷.۰-alpha۰۱ یک انتشار تصادفی بود که شامل ویژگی‌های جدید مورد نظر نمی‌شود. به جای آن از ۰.۱۷.۰-alpha۰۲ استفاده کنید.
۰.۱۶.۰-آلفا۰۱ ۲۰۲۵-۰۵-۲۳
  • دیگر نیازی به فعال کردن پشتیبانی از desugaring در API جاوا ۸+ نیست.
  • وابستگی SDK پلتفرم پیام‌رسانی کاربر به نسخه ۳.۲.۰ به‌روزرسانی شد.
  • اشکال میانجیگری تبلیغات بومی که باعث خرابی در آداپتورهای ارجاع دهنده به کلاس com.google.android.gms.ads.formats.MediaView می‌شد، برطرف شد.
  • پیش‌بارگذاری تبلیغ : تابع getNumAdsAvailable() اضافه و تابع numAdsAvailable() منسوخ شده است.
  • تگ ویژگی android.adservices.AD_SERVICES_CONFIG از فایل مانیفست SDK حذف شد تا از تداخل ادغام برای برنامه‌هایی که سرویس‌های تبلیغاتی مختص API را پیکربندی می‌کنند، جلوگیری شود.
0.15.1-alpha01 ۲۰۲۵-۰۴-۲۸
۰.۱۵.۰-آلفا۰۱ ۲۴-۰۴-۲۰۲۵
  • تبلیغات بومی : پشتیبانی از بارگذاری چندین تبلیغ بومی اضافه شده است.
    • یک متد NativeAdLoader.load(NativeAdRequest, numberOfAds, NativeAdLoaderCallback) اضافه شده است که چندین تبلیغ را به طور همزمان درخواست می‌کند.
    • یک تابع فراخوانی NativeAdLoaderCallback.onAdLoadingCompleted() اضافه شده است که وقتی بارگذاری همه تبلیغات بومی کامل می‌شود، اجرا می‌شود.
    • برای پشتیبانی از بارگذاری ناهمزمان کاتلین، یک متد NativeAdLoader.load(NativeAdRequest, numberOfAds) اضافه شده است که Flow<NativeAdLoadResult> را برمی‌گرداند.
  • وابستگی kotlinx-coroutines-android از نسخه ۱.۷.۳ به ۱.۹.۰ به‌روزرسانی شد.
۰.۱۴.۰-آلفا۰۱ ۲۰۲۵-۰۳-۲۰
  • اگر SDK را با شناسه برنامه نامعتبر مقداردهی اولیه کنید، درخواست‌های تبلیغ با شکست مواجه می‌شوند.
  • متد AdPreloader.start() دیگر نیازی به فراخوانی PreloadCallback ندارد.
  • ویژگی bufferSize هنگام ایجاد یک شیء از طریق کلاس داده PreloadConfiguration اختیاری است. برای اینکه گوگل بتواند اندازه بافر را بهینه کند، ویژگی bufferSize را تنظیم نکنید.
  • ویژگی maxAdsPerSession در کلاس داده PreloadConfiguration حذف شد.
  • ویژگی‌های shouldRequestMultipleImages و shouldReturnUrlsForImageAssets به کلاس NativeAdOptions اضافه شد.
۰.۱۳.۰-آلفا۰۱ ۲۰۲۵-۰۲-۲۶
  • اضافه شدن MediationRewardedAdCallback.onUserEarnedReward() و منسوخ شدن MediationRewardedAdCallback.onUserEarnedReward(RewardItem) .
  • APIهای پیش‌بارگذاری تبلیغات اضافه شد.
۰.۱۲.۰-آلفا۰۱ ۲۰۲۵-۰۱-۲۲
  • اشکالی که باعث می‌شد برخی از متدهای داخل AdRequest ، AdRequest.Builder ، SignalRequest و SignalRequest.Builder مبهم‌سازی شوند، برطرف شد.
  • برای WebView API مخصوص کاربران تبلیغات که شناسه برنامه Ad Manager ندارند، InitializationConfig.WEBVIEW_APIS_FOR_ADS_APPLICATION_ID اضافه شده است که می‌تواند در طول مقداردهی اولیه SDK ارسال شود.
  • پشتیبانی از ترکیب تبلیغات بومی و بنری در درخواست‌های تبلیغات Ad Manager اضافه شد.
۰.۱۱.۰-آلفا۰۱ ۲۰۲۴-۱۲-۱۲
  • وابستگی به SDK پلتفرم پیام‌رسانی کاربر به نسخه ۳.۱.۰ به‌روزرسانی شد.
  • پشتیبانی از حرکات کلیک سفارشی در تبلیغات بومی اضافه شد.
  • پشتیبانی از شمارش دستی نمایش بنرهای تبلیغاتی در رزروهای مدیریت تبلیغات اضافه شد.
۰.۱۰.۰-آلفا۰۱ ۲۰۲۴-۱۱-۰۸
  • برای پشتیبانی بهتر از کاتلین، توابع DSL برای VideoOptions و RequestConfiguration اضافه شده است.
  • پشتیبانی از API مربوط به حریم خصوصی ناشر با RequestConfiguration.setPublisherPrivacyPersonalizationState() اضافه شد.
  • APIهای تعلیق کاتلین برای بارگذاری تبلیغات و تولید سیگنال اضافه شد.
  • IconAd.LoadAdResult حذف و با AdLoadResult جایگزین شد.
  • مشکلی که باعث می‌شد جلسات OMID برای تبلیغات ویدیویی بومی شروع نشوند، برطرف شد.
۰.۹.۰-آلفا۰۱ ۲۰۲۴-۱۰-۰۲
۰.۸.۰-آلفا۰۱ ۲۰۲۴-۰۸-۲۲
  • وابستگی به SDK پلتفرم پیام‌رسانی کاربر به نسخه ۳.۰.۰ به‌روزرسانی شد.
  • تبلیغات بومی:
    • نسخه رسمی انتشار برای قالب تبلیغات بومی.
    • پشتیبانی از ارائه ویدیو در محتوای MediaContent اضافه شد.
    • فراخوانی‌های چرخه حیات ویدیو اضافه شد.
    • کنترل‌های سفارشی پخش ویدیو اضافه شد.
    • اندازه‌گیری باز برای تبلیغات بومی و سفارشی بومی فعال شد.
  • فیلد signalType اکنون هنگام ساخت SignalRequest الزامی است.
۰.۶.۰-آلفا۰۱ ۲۰۲۴-۰۶-۲۰
  • کدی اضافه شده که از APIهای جاوا نسخه ۸+ که از طریق desugaring در دسترس هستند استفاده می‌کند. برنامه‌هایی که minSdkVersion پایین‌تر از 26 استفاده می‌کنند، باید پشتیبانی از desugaring API جاوا نسخه ۸+ را فعال کنند.
  • پشتیبانی از قالب‌های تبلیغات بومی و سفارشی بومی که شامل محتوای ویدیویی نمی‌شوند، اضافه شد.
  • پشتیبانی از MRAID نسخه ۳ اضافه شد.
  • وابستگی به SDK پلتفرم پیام‌رسانی کاربر نسخه ۲.۲.۰ اضافه شد.
  • دامنه خطای مربوط به خطاهای گوگل از com.google.android.gms.ads به com.google.android.libraries.ads.mobile.sdk به‌روزرسانی شد.
  • متد MobileAds.isInitialized() برای بررسی اینکه آیا SDK از قبل مقداردهی اولیه شده است یا خیر، اضافه شد.
  • تابع BannerAd.isCollapsible() برای بررسی قابلیت جمع شدن بنر تبلیغاتی برگردانده شده اضافه شد.
  • برای بهبود کسب درآمد از تبلیغات در تب‌های سفارشی MobileAds.registerCustomTabsSession() اضافه شد.
  • نام OnInitializationCompleteListener به OnAdapterInitializationCompleteListener تغییر یافت.
  • نام AdapterResponseInfo به AdSourceResponseInfo تغییر یافت.
  • نام AdRequest.Builder.putAdNetworkExtrasBundle() به AdRequest.Builder.putAdSourceExtrasBundle() تغییر یافت.
  • اشکالی که باعث می‌شد کلاس‌های آداپتور پیشنهاد قیمت به درستی نمونه‌سازی نشوند، برطرف شد.
۰.۳.۰-آلفا۰۱ ۲۰۲۴-۰۳-۲۰
  • انتشار اولیه‌ی GMA Next-Gen SDK .
  • از تبلیغات بنری، بینابینی، پاداشی، بینابینی پاداشی و تبلیغات باز برنامه پشتیبانی می‌کند.
  • از میانجیگری برای همه قالب‌های تبلیغاتی پشتیبانی می‌کند. آداپتورهایی که برای SDK تبلیغات موبایل فعلی نوشته شده‌اند، با GMA Next-Gen SDK سازگار هستند.
  • وابستگی به Open Measurement SDK نسخه ۱.۴.۱۰ اضافه شد.