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

نسخه تاریخ انتشار یادداشت‌ها
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
  • برای برنامه‌هایی که از «میانای برنامه‌سازی کاربردی وب‌نما» برای «تبلیغات» استفاده می‌کنند، مشکلی را که مانع از ارائه نشان‌ها توسط کیت توسعه نرم‌افزار به برچسب‌های تبلیغات پشتیبانی‌شده (کد AdSense، برچسب ناشر Google،‏ 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 به نسخه 1.15.0 به‌روز شد.
  • وابستگی «کیت توسعه نرم‌افزار پلاتفرم پیام‌رسانی کاربر» به نسخه ۴.۰.۰ به‌روزرسانی شد.
  • منسوخ شدن 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 از نسخه 1.13.0 به نسخه 1.12.1 تنزل داده شد.
  • اجازه 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») همیشه در ارائه آگهی‌های بومی ناموفق بودند برطرف شد.
  • ازکارافتادگی‌ای که وقتی میانجی‌گر میانجی‌گری چندین روش MediationAdLoadCallback را برای یک درخواست آگهی فرا می‌خواند برطرف شد.
0.17.0-alpha01 2025-06-18
  • نسخه 0.17.0-alpha01 به‌طور تصادفی منتشر شده است و ویژگی‌های جدید موردنظر را ندارد. درعوض از 0.17.0-alpha02 استفاده کنید.
0.16.0-alpha01 2025-05-23
  • دیگر لازم نیست پشتیبانی از تجزیه و ترکیب 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 ویژه آگهی‌ها» که شناسه برنامه Ad Manager ندارند، InitializationConfig.WEBVIEW_APIS_FOR_ADS_APPLICATION_ID اضافه شد که می‌تواند درطول مقداردهی اولیه کیت توسعه نرم‌افزار منتقل شود.
  • پشتیبانی از ترکیب آگهی‌های بومی و برنمایی در درخواست‌های آگهی Ad Manager اضافه شد.
0.11.0-alpha01 2024-12-12
  • وابستگی به «کیت توسعه نرم‌افزار پلاتفرم پیام‌رسانی کاربر» به نسخه ۳.۱.۰ به‌روزرسانی شد.
  • پشتیبانی از اشاره‌های کلیک سفارشی در آگهی‌های بومی اضافه شد.
  • پشتیبانی برای شمارش دستی ظهورهای آگهی‌های برنمایی در رزروهای «مدیر آگهی» اضافه شد.
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+ دردسترس ازطریق desugaring استفاده می‌کند. برنامه‌هایی که از minSdkVersion پایین‌تر از 26 استفاده می‌کنند باید پشتیبانی از حذف قند Java 8+ API را فعال کنند.
  • پشتیبانی از قالب‌های آگهی بومی و بومی سفارشی که دارایی‌های ویدیویی ندارند اضافه شد.
  • پشتیبانی از MRAID v3 اضافه شد.
  • وابستگی به «کیت توسعه نرم‌افزار پلاتفرم پیام‌رسانی کاربر» نسخه ۲.۲.۰ اضافه شد.
  • دامنه خطای 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 سازگار هستند.
  • وابستگی به نسخه ۱.۴.۱۰ کیت توسعه نرم‌افزار «اندازه‌گیری باز» اضافه شد.