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

نسخه تاریخ انتشار یادداشت‌ها
1.6.0 2026-10-22
  • برگه هم‌رسانی بازرس آگهی هنگام صادر کردن درخواست آگهی و پاسخ برای ارائه پیش‌نمایش‌های نوشتاری، دکمه کپی، و پیشنهادهای هم‌رسانی مستقیم به‌روز شد.
  • اشکالی در آگهی‌های تمام‌صفحه پاداشی و پاداش‌دار برطرف شد که در آن OnUserEarnedRewardListener.onUserEarnedReward() روش می‌توانست پس‌از AdEventCallback.onAdDismissedFullScreenContent() روش فراخوانی شود.
  • وابستگی com.google.android.play:hsdp را به نسخه ۲.۲.۰ به‌روز کردیم تا ازکارافتادن java.lang.IllegalStateException را برطرف کنیم.
  • قوانین ProGuard مصرف‌کننده به‌روز شد تا از خرابی java.lang.RuntimeException در کلاس androidx.work.WorkManagerInitializer هنگام فعال بودن حالت کامل R8 جلوگیری شود.
  • اشکالی که در آن بافت Activity دردسترس هنگام نمایش آگهی‌های تمام‌صفحه میانجی‌شده به کیت‌های توسعه نرم‌افزار طرف سوم منتقل نمی‌شد برطرف شد.
1.5.0 2026-09-24
  • میاناهای برنامه‌سازی کاربردی تولید و پردازش سیگنال برای قالب SwipeableInterstitialAd اضافه شد. این ویژگی در نسخه بتای خصوصی است. برای درخواست دسترسی، با مدیر حسابتان تماس بگیرید.
  • یک میانای برنامه‌سازی کاربردی excludedAppIds به درخواست‌های آگهی نمادی اضافه شد که به ناشران اجازه می‌دهد به‌طور اختیاری فهرستی از شناسه‌های برنامه را از پاسخ‌های آگهی نمادی مستثنی کنند.
1.4.0 2026-08-20
  • پشتیبانی از قالب PictureInPictureAd اضافه شد. آگهی‌های «تصویردرتصویر» در نسخه بتای باز است.
  • ‫onInitializationFailed(AdError) اضافه شد و onInitializationFailed(String) در InitializationCompleteCallback منسوخ شد. اکنون آداپتورهای میانجی می‌توانند خطاهای مقداردهی اولیه کیت توسعه نرم‌افزار طرف سوم را با کد خطا، دامنه خطا، و پیام خطا به کیت توسعه نرم‌افزار گزارش کنند.
1.3.1 2026-07-29
  • رفع اشکال‌ها و بهبود عملکرد برای ویژگی دسترسی محدود.
1.3.0 2026-07-21
  • ‫AdView.loadAd() تغییر کرد تا وقتی بازآوری خودکار برای واحد آگهی غیرفعال است، تلاش‌های مجدد خودکار برای درخواست‌های آگهی ناموفق موقتاً متوقف شود.
  • وقتی درخواست آگهی برای چند آگهی بومی یا آگهی نمادی هیچ آگهی دردسترسی را برنمی‌گرداند، کیت توسعه نرم‌افزار اکنون به‌جای INTERNAL_ERROR، خطای NO_FILL را برمی‌گرداند.
  • پرچم مانیفست برای غیرفعال کردن بازرس آگهی اضافه شد.
  • روش Ad.getAdUnitId() برای شناسایی شناسه واحد آگهی استفاده‌شده برای درخواست آگهی اضافه شد.
  • روش InitializationConfig.Builder.disableSdkCrashReporting() اضافه شد که امکان انصراف دستی از کنترل‌کننده پیش‌فرض خرابی را در GMA Next-Gen SDK فراهم می‌کند. به‌طور پیش‌فرض، کیت توسعه نرم‌افزار همچنان خرابی‌ها را به دیگر گرداننده‌های ثبت‌شده (مثل Crashlytics) واگذار می‌کند.
  • هنگام استفاده از میانجی‌گری با منابع آگهی رویداد سفارشی، ResponseInfo.getAdapterClassName() اکنون نام کلاس رویداد سفارشی شما را به‌جای com.google.ads.mediation.customevent.CustomEventAdapter برمی‌گرداند.
1.2.1 2026-06-15
  • برای برنامه‌هایی که از WebView API برای Ads استفاده می‌کنند، مشکلی را برطرف کردیم که مانع از ارائه سیگنال توسط کیت توسعه نرم‌افزار به برچسب‌های آگهی پشتیبانی‌شده (کد AdSense،‏ Google Publisher Tag،‏ IMA برای HTML5) می‌شد. این مشکل به‌دلیل فراخوانی نادرست روش‌های Webkit در رشته پس‌زمینه ایجاد شده است.
1.2.0 2026-06-11
  • اشکالی که باعث ایجاد 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) حفظ شود.
1.1.1 2026-05-27
  • مشکلی که باعث می‌شد غلاف‌های آگهی پاداش‌دار درطول انتقال‌ها ثابت بمانند و مانع از بستن آگهی توسط کاربران شوند برطرف شد.
1.1.0 2026-05-18
1.0.1 2026-04-30
  • مشکلی که باعث می‌شد آگهی‌های استفاده‌کننده از window.open() یا پیوندهای دارای target="_blank" نتوانند صفحه‌های مقصد را باز کنند برطرف شد.
1.0.0 2026-04-14
0.25.0-beta01 2026-03-24
  • مشکلی که باعث می‌شد Ad.getResponseInfo() فراداده ResponseInfo به‌روزشده را هنگام بازآوری آگهی برنمایشی برنگرداند برطرف شد.
0.24.0-beta03 2026-03-07
  • مشکلی برطرف شد که در آن AdView.destroy() نمی‌توانست پس‌از ناموفق بودن بار کردن آگهی، تلاش‌های مجدد برای بار کردن آگهی را متوقف کند.
  • سازنده‌های بدون آرگومان به NativeAdMapper و UnifiedNativeAdMapper اضافه شد تا سازگاری با Kotlin بهبود یابد.
  • دارایی packageName به میانای IconAd اضافه شد.
  • گزینه‌ای اضافه شده است تا کیت توسعه نرم‌افزار را مجبور کند به‌جای OkHttp از Cronet برای عملیات شبکه استفاده کند. برای حل خطاهای زمان اجرا در پروژه‌هایی که از OkHttp 5 استفاده می‌کنند، توصیه می‌کنیم Cronet را برای عملیات شبکه اجباری کنید. برای اجباری کردن Cronet، هنگام فراخوانی MobileAds.initialize()، force_use_cronet اضافی را در InitializationConfig.Builder روی true تنظیم کنید: 
    val config = InitializationConfig.Builder()
  .setExtras(bundleOf("force_use_cronet" to true))
  .build()
MobileAds.initialize(this, config)
  • پشتیبانی از Java 11 اضافه شد. برای استفاده از Java 11، کد زیر را به بلوک android در فایل build.gradle اضافه کنید: 
    android {
  compileOptions {
    sourceCompatibility JavaVersion.VERSION_11
    targetCompatibility JavaVersion.VERSION_11
  }
  kotlinOptions {
    jvmTarget = '11'
  }
}
0.24.0-beta02 2026-03-03
  • مشکل بارگیری کلاس وابستگی شخص ثالث که بر تولید سیگنال درخواست آگهی سرور به سرور تأثیر می‌گذاشت برطرف شد.
0.24.0-beta01 2026-02-13
0.23.0-beta01 2026-01-26
  • حداقل نسخه لازم «افزایه Android Gradle»‏ (AGP) به ۸.۳.۰ به‌روز شد.
  • اشکالی که باعث می‌شد سازنده AdView هنگام فراخوانی از Kotlin،‏ java.lang.NoSuchMethodError را پرتاب کند برطرف شد.
  • اشکالی که باعث می‌شد آداپتورهای رویداد سفارشی درطول اجرای آبشاری فراخوانده نشوند برطرف شد.
  • RtbSignalData به‌روز شد تا درصورت دردسترس بودن، «بافت فعالیت» را به RtbAdapter.collectSignals() ارائه دهد.
  • وابستگی androidx.webkit به نسخه ۱.۱۵.۰ به‌روز شد.
  • وابستگی کیت توسعه نرم‌افزار پلاتفرم پیام‌رسانی کاربر به نسخه ۴.۰.۰ به‌روز شد.
  • منسوخ شدن AdPreloader.getConfiguration() و AdPreloader.getConfigurations() برگردانده شد.
0.22.0-beta04 2025-12-04
  • مشکلی در نسخه 0.22.0-beta02 کیت توسعه نرم‌افزار برطرف شد که در آن فراداده پیش‌نمایش Java 17 به‌اشتباه در فایل‌های کلاس گنجانده شده بود.
0.22.0-beta03 2025-11-25
  • اشکالی که در آن درخواست‌های آگهی سرور به سرور بااستفاده از NativeSignalRequest.Builder.setAdSize() اندازه آگهی درخواست‌شده را به‌درستی تنظیم نمی‌کرد برطرف شد.
0.22.0-beta02 2025-11-24
  • اشکال بار کردن Ad Manager که در آن درخواست‌های آگهی سروربه‌سرور بااستفاده از NativeSignalRequest درصورت نوع NativeAd.NativeAdType.BANNER بودن پاسخ آگهی، ارائه نمی‌شد برطرف شد.
0.22.0-beta01 2025-11-20
  • به‌روزرسانی میانای برنامه‌سازی کاربردی آگهی‌های برنما:
    • کلاس AdView اضافه شد.
    • ‫BannerAd.load() و BannerAd.loadFromAdResponse() منسوخ شده است. برای بار کردن یک آگهی برنمای تکی، به‌جای آن از AdView.loadAd() و AdView.loadFromAdResponse() استفاده کنید.
    • ‫BannerAd.getView() منسوخ شد. برای رندر کردن BannerAd بارشده با BannerAdPreloader، یک نمونه AdView ایجاد کنید و از AdView.registerBannerAd() استفاده کنید.
  • اشکالی در آگهی‌های میانجی‌گری‌شده برطرف شد که در آن NativeAdRequest.Builder.setAdChoicesPlacement() رعایت نمی‌شد و باعث می‌شد نماد «گزینه‌های آگهی» در جای نادرستی قرار بگیرد.
  • حداقل نسخه لازم «افزایه Android Gradle»‏ (AGP) از ۸.۲.۰ به ۷.۳.۱ کاهش یافت.
  • ‫AdPreloader.getConfigurations() و AdPreloader.getConfiguration(preloadId) منسوخ شده است. جایگزینی وجود ندارد.
0.21.0-beta01 2025-10-08
  • روش InitializationConfig.Builder.disableMediationAdapterInitialization() اضافه شد. این روش را قبل‌از مقداردهی اولیه GMA Next-Gen SDK فراخوانی کنید تا مقداردهی اولیه آداپتور میانجی غیرفعال شود.
  • استفاده از مقداردهی اولیه WebView برای کاهش خطاهای ANR بهبود یافت.
  • وابستگی androidx.webkit از نسخه ۱.۱۳.۰ به ۱.۱۲.۱ تنزل داده شد.
  • اجازه android.permission.RECEIVE_BOOT_COMPLETED مورداستفاده بسته androidx.work برداشته شد.
  • فیلدی با نام اشتباه در کلاس NativeAdMapper اصلاح شد.
0.20.0-beta01 2025-09-19
  • اشکالی که باعث می‌شد برخی‌از آگهی‌های ویدیویی بومی به‌طور خودکار پخش نشوند برطرف شد.
0.19.0-beta01 2025-08-14
  • نسخه‌های دو وابستگی تنزل داده شد.
    • androidx.work:work-runtime از نسخه ۲.۱۰.۰ به ۲.۷.۰.
    • androidx.core:core and androidx.core:core-ktx از ۱.۱۵.۰ به ۱.۱۲.۰.
  • نام ویژگی loadedAdSourceResponse در ResponseInfo به loadedAdSourceResponseInfo تغییر کرد.
  • اشکالی را برطرف کردیم که به کاربران اجازه می‌داد برخی‌از آگهی‌های تمام‌صفحه را با دکمه برگشتن زودتر از موعد ببندند.
  • ناشرانی که به این ویژگی دسترسی دارند اکنون از پشتیبانی شناسه جای آگهی برای همه قالب‌های آگهی برخوردارند.
  • یک فراخوانی destroy() به NativeAdMapper برای آداپتورهای میانجی‌گری بومی اضافه شد.
0.18.0-beta01 2025-07-17
  • اشکال میانجی‌گری بومی که باعث می‌شد ارائه آگهی برای آداپتورهایی که به com.google.android.gms.ads.NativeAd.MediaView ارجاع می‌دادند خراب شود برطرف شد.
  • ‫MobileAds.registerCustomTabsSession() با @JvmStatic حاشیه‌نویسی شد.
  • اشکالی برطرف شد که در آن آگهی‌های برنما که بااستفاده از «آبشار شبکه AdMob» بار شده بودند دیگر بازآوری نمی‌شدند.
0.17.0-alpha02 2025-06-23
  • اشکال پیشنهاد قیمت میانجی‌گری بومی برطرف شد که در آن آداپتورهایی که پیشنهاد قیمت را پیاده‌سازی می‌کنند اما آبشاری را پیاده‌سازی نمی‌کنند (مثلاً Meta Audience Network) همیشه در ارائه آگهی‌های بومی ناموفق بودند.
  • مشکل ازکارافتادنی که هنگام فراخوانی چند روش MediationAdLoadCallback توسط آداپتور میانجی‌گری برای یک درخواست آگهی رخ می‌داد برطرف شد.
0.17.0-alpha01 2025-06-18
  • نسخه 0.17.0-alpha01 به‌طور تصادفی منتشر شده است و حاوی ویژگی‌های جدید موردنظر نیست. درعوض از 0.17.0-alpha02 استفاده کنید.
0.16.0-alpha01 2025-05-23
  • دیگر نیازی به فعال کردن پشتیبانی از شکرزدایی Java 8+ API نیست.
  • وابستگی کیت توسعه نرم‌افزار «پلاتفرم پیام‌رسانی کاربر» به نسخه ۳.۲.۰ به‌روز شد.
  • اشکال میانجی‌گری آگهی‌های بومی که باعث ازکارافتادن آداپتورهای ارجاع‌دهنده به کلاس com.google.android.gms.ads.formats.MediaView می‌شد برطرف شد.
  • پیش‌بارگیری آگهی: getNumAdsAvailable() اضافه شد و numAdsAvailable() منسوخ شد.
  • برچسب ویژگی android.adservices.AD_SERVICES_CONFIG را از فایل مانیفست کیت توسعه نرم‌افزار برداشته‌ایم تا از تداخل‌های ادغام برای برنامه‌هایی که سرویس‌های تبلیغاتی مختص API را پیکربندی می‌کنند جلوگیری شود.
0.15.1-alpha01 2025-04-28
0.15.0-alpha01 2025-04-24
  • آگهی‌های بومی: پشتیبانی از بار کردن چندین آگهی بومی اضافه شد.
    • روش NativeAdLoader.load(NativeAdRequest, numberOfAds, NativeAdLoaderCallback) اضافه شد که چندین آگهی را به‌طور هم‌زمان درخواست می‌کند.
    • یک NativeAdLoaderCallback.onAdLoadingCompleted() فراخوانی برگشتی اضافه شد که وقتی بار کردن همه آگهی‌های بومی تکمیل می‌شود، فعال می‌شود.
    • برای پشتیبانی از بار کردن ناهمگام Kotlin، روش NativeAdLoader.load(NativeAdRequest, numberOfAds) اضافه شد که Flow<NativeAdLoadResult> را برمی‌گرداند.
  • وابستگی kotlinx-coroutines-android از نسخه ۱.۷.۳ به ۱.۹.۰ به‌روز شد.
0.14.0-alpha01 2025-03-20
  • اگر کیت توسعه نرم‌افزار را با شناسه برنامه نامعتبر مقداردهی اولیه کنید، درخواست‌های آگهی ناموفق خواهد بود.
  • روش AdPreloader.start() دیگر به فراخوانی PreloadCallback نیاز ندارد.
  • ویژگی bufferSize هنگام ایجاد شیء ازطریق کلاس داده PreloadConfiguration اختیاری است. برای اینکه Google بتواند اندازه میان‌گیر را بهینه‌سازی کند، ویژگی bufferSize را تنظیم نکنید.
  • ویژگی maxAdsPerSession در کلاس داده PreloadConfiguration برداشته شد.
  • ویژگی‌های shouldRequestMultipleImages و shouldReturnUrlsForImageAssets به کلاس NativeAdOptions اضافه شد.
0.13.0-alpha01 2025-02-26
  • MediationRewardedAdCallback.onUserEarnedReward() اضافه شد و MediationRewardedAdCallback.onUserEarnedReward(RewardItem) منسوخ شد.
  • میاناهای برنامه‌سازی کاربردی پیش‌بارگیری آگهی اضافه شد.
0.12.0-alpha01 2025-01-22
  • اشکالی که باعث می‌شد برخی‌از روش‌های داخل AdRequest، AdRequest.Builder، SignalRequest، و SignalRequest.Builder مبهم‌سازی شوند برطرف شد.
  • برای کاربران WebView API for Ads که شناسه برنامه Ad Manager ندارند، InitializationConfig.WEBVIEW_APIS_FOR_ADS_APPLICATION_ID اضافه شد که می‌تواند درطول مقداردهی اولیه کیت توسعه نرم‌افزار ارسال شود.
  • پشتیبانی از ترکیب آگهی‌های بومی و برنمایی در درخواست‌های آگهی Ad Manager اضافه شد.
0.11.0-alpha01 2024-12-12
  • وابستگی به کیت توسعه نرم‌افزار پلاتفرم پیام‌رسانی کاربر به نسخه ۳.۱.۰ به‌روز شد.
  • پشتیبانی از اشاره‌های کلیک سفارشی در آگهی‌های بومی اضافه شد.
  • پشتیبانی از شمارش دستی ظهور آگهی‌های برنما در رزروهای Ad Manager اضافه شد.
0.10.0-alpha01 2024-11-08
  • توابع DSL برای VideoOptions و RequestConfiguration برای پشتیبانی بهتر از Kotlin اضافه شد.
  • پشتیبانی از Publisher Privacy Treatment API با RequestConfiguration.setPublisherPrivacyPersonalizationState() اضافه شد.
  • میاناهای برنامه‌سازی کاربردی تعلیق Kotlin برای بار کردن آگهی‌ها و تولید سیگنال‌ها اضافه شد.
  • ‫IconAd.LoadAdResult برداشته شد و با AdLoadResult جایگزین شد.
  • مشکلی که باعث می‌شد جلسه‌های OMID برای آگهی‌های ویدیویی بومی شروع نشود برطرف شد.
0.9.0-alpha01 2024-10-02
0.8.0-alpha01 2024-08-22
  • وابستگی به کیت توسعه نرم‌افزار «پلاتفرم پیام‌رسانی کاربر» به نسخه ۳.۰.۰ به‌روزرسانی شد.
  • آگهی‌های بومی:
    • نسخه رسمی پخش برای قالب آگهی بومی.
    • پشتیبانی از ارائه ویدیو در دارایی MediaContent اضافه شد.
    • فراخوانی‌های چرخه حیات ویدیو اضافه شد.
    • کنترل‌های سفارشی بازپخش ویدیو اضافه شد.
    • «سنجش باز» برای آگهی‌های بومی و بومی سفارشی فعال شد.
  • signalType اکنون فیلدی الزامی هنگام ساختن SignalRequest است.
0.6.0-alpha01 2024-06-20
  • کدی اضافه کردیم که از میاناهای برنامه‌سازی کاربردی Java 8+‎ دردسترس ازطریق شکرزدایی استفاده می‌کند. برنامه‌هایی که از minSdkVersion پایین‌تر از 26 استفاده می‌کنند باید پشتیبانی از شکرزدایی Java 8+ API را فعال کنند.
  • پشتیبانی از قالب‌های آگهی بومی و بومی سفارشی که فاقد دارایی‌های ویدیویی هستند اضافه شد.
  • پشتیبانی از MRAID نسخه ۳ اضافه شد.
  • وابستگی به کیت توسعه نرم‌افزار پلاتفرم پیام‌رسانی کاربر نسخه ۲.۲.۰ اضافه شد.
  • دامنه خطای به‌روزشده برای خطاهای Google از com.google.android.gms.ads به com.google.android.libraries.ads.mobile.sdk.
  • روش MobileAds.isInitialized() برای بررسی اینکه آیا کیت توسعه نرم‌افزار قبلاً مقداردهی اولیه شده است یا نه اضافه شد.
  • BannerAd.isCollapsible() اضافه شد تا بررسی شود که آیا آگهی برگردانده‌شده جمع‌شدنی است یا نه.
  • MobileAds.registerCustomTabsSession() برای بهبود درآمدزایی آگهی‌ها در «برگه‌های سفارشی» اضافه شد.
  • نام OnInitializationCompleteListener به OnAdapterInitializationCompleteListener تغییر کرد.
  • نام AdapterResponseInfo به AdSourceResponseInfo تغییر کرد.
  • نام AdRequest.Builder.putAdNetworkExtrasBundle() به AdRequest.Builder.putAdSourceExtrasBundle() تغییر کرد.
  • اشکالی که باعث می‌شد کلاس‌های آداپتور پیشنهاد قیمت به‌درستی نمونه‌سازی نشوند برطرف شد.
0.3.0-alpha01 2024-03-20
  • اولین نسخه پخش GMA Next-Gen SDK.
  • از آگهی‌های برنمایی، بینابینی، پاداش‌دار، بینابینی پاداش‌دار، و آگهی در صفحه باز شدن برنامه پشتیبانی می‌کند.
  • از میانجی‌گری برای همه قالب‌های آگهی پشتیبانی می‌کند. آداپتورهای نوشته‌شده برای «کیت توسعه نرم‌افزار آگهی‌های تلفن همراه» فعلی با GMA Next-Gen SDK پیش‌سازگار هستند.
  • وابستگی به نسخه ۱.۴.۱۰ کیت توسعه نرم‌افزار Open Measurement اضافه شد.