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

نسخه	تاریخ انتشار	یادداشت‌ها
۰.۲۱.۰-بتا۰۱	۲۰۲۵-۱۰-۰۸	متد InitializationConfig.Builder.disableMediationAdapterInitialization() اضافه شد. این متد را قبل از مقداردهی اولیه GMA Next Gen SDK فراخوانی کنید تا مقداردهی اولیه آداپتور میانجیگری غیرفعال شود. فراخوانی این متد می‌تواند تأثیر منفی بر عملکرد میانجیگری گوگل شما داشته باشد. این متد فقط باید در صورتی فراخوانی شود که آداپتورهای میانجیگری گوگل را در برنامه خود گنجانده باشید اما در طول یک جلسه خاص برنامه، مانند اجرای تست میانجیگری A/B، از میانجیگری AdMob استفاده نکنید. بهبود استفاده از مقداردهی اولیه WebView برای کاهش ANRها. وابستگی androidx.webkit از ۱.۱۳.۰ به ۱.۱۲.۱ کاهش یافت تا سازگاری با افزونه Android Gradle نسخه ۷.۳.۱ حفظ شود. مجوز 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	۲۰۲۵-۰۴-۲۸	اکنون لازم است پشتیبانی از desugaring در رابط برنامه‌نویسی جاوا ۸+ فعال شود. برای برنامه‌های توسعه‌یافته با استفاده از کاتلین، حداقل نسخه کاتلین مورد نیاز از ۲.۱ به ۱.۹ کاهش یافته است.
۰.۱۵.۰-آلفا۰۱	۲۴-۰۴-۲۰۲۵	تبلیغات بومی : پشتیبانی از بارگذاری چندین تبلیغ بومی اضافه شده است. یک متد 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 برای کاربران تبلیغات که شناسه برنامه AdMob ندارند، InitializationConfig.WEBVIEW_APIS_FOR_ADS_APPLICATION_ID اضافه شده است که می‌تواند در طول مقداردهی اولیه SDK ارسال شود. پشتیبانی از ترکیب تبلیغات بومی و بنری در درخواست‌های تبلیغات Ad Manager اضافه شد.
۰.۱۱.۰-آلفا۰۱	۲۰۲۴-۱۲-۱۲	وابستگی به SDK پلتفرم پیام‌رسانی کاربر به نسخه ۳.۱.۰ به‌روزرسانی شد. پشتیبانی از حرکات کلیک سفارشی در تبلیغات بومی اضافه شد.
۰.۱۰.۰-آلفا۰۱	۲۰۲۴-۱۱-۰۸	برای پشتیبانی بهتر از کاتلین، توابع DSL برای VideoOptions و RequestConfiguration اضافه شده است. پشتیبانی از API مربوط به حریم خصوصی ناشر با RequestConfiguration.setPublisherPrivacyPersonalizationState() اضافه شد. APIهای تعلیق کاتلین برای بارگذاری تبلیغات و تولید سیگنال اضافه شد. IconAd.LoadAdResult حذف و با AdLoadResult جایگزین شد. مشکلی که باعث می‌شد جلسات OMID برای تبلیغات ویدیویی بومی شروع نشوند، برطرف شد.
۰.۹.۰-آلفا۰۱	۲۰۲۴-۱۰-۰۲	وابستگی به APIهای جاوا ۸+ که از طریق desugaring از نسخه ۰.۶.۰-alpha۰۱ در دسترس بودند، حذف شد. برنامه‌هایی که از minSdkVersion پایین‌تر از 26 استفاده می‌کنند، دیگر نیازی به فعال کردن پشتیبانی desugaring از API جاوا ۸+ ندارند. پشتیبانی از بازرس تبلیغات اضافه شد. پشتیبانی از ویدیو برای قالب تبلیغات بومی سفارشی اضافه شد. انتشار رسمی برای جمع‌آوری سیگنال و ارائه APIها.
۰.۸.۰-آلفا۰۱	۲۰۲۴-۰۸-۲۲	وابستگی به 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 تغییرات عمده‌ای را با APIهای جدید معرفی می‌کند. برای جزئیات بیشتر در مورد نحوه مهاجرت از SDK تبلیغات موبایل فعلی، به راهنمای مهاجرت مراجعه کنید. انتشار اولیه‌ی GMA Next Gen SDK. از تبلیغات بنری، بینابینی، پاداشی، بینابینی پاداشی و تبلیغات باز برنامه پشتیبانی می‌کند. از میانجیگری برای همه قالب‌های تبلیغاتی پشتیبانی می‌کند. آداپتورهایی که برای SDK تبلیغات موبایل فعلی نوشته شده‌اند، با SDK نسل بعدی GMA سازگار هستند. وابستگی به Open Measurement SDK نسخه ۱.۴.۱۰ اضافه شد.