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

نسخه تاریخ انتشار یادداشت‌ها
۲۴.۷.۰ ‎۲۰۲۵‑۱۰‑۰۹
  • حاشیه‌نویسی nullable مربوط به نوع بازگشتی برای NativeCustomFormatAd.getDisplayOpenMeasurement() اصلاح شد. عملکرد بدون تغییر باقی مانده است، زیرا از قبل انتظار می‌رفت که این متد بتواند مقدار null را برگرداند.
  • وابستگی androidx.webkit:webkit از نسخه ۱.۱۴.۰ به ۱.۱۲.۱ کاهش یافت تا سازگاری با افزونه اندروید Gradle نسخه ۷.۳.۱ حفظ شود.
۲۴.۶.۰ ۲۰۲۵–۰۹–۰۸
  • آداپتورهای میانجیگری بومی اکنون می‌توانند NativeAdMapper.destroy() را پیاده‌سازی کنند تا هنگام از بین رفتن یک تبلیغ بومی، مطلع شوند.
۲۴.۵.۰ ‎۲۴-۰۷-۲۰۲۵‎
  • ناشرانی که به این ویژگی دسترسی دارند، اکنون از پشتیبانی شناسه قرارگیری برای همه قالب‌های تبلیغاتی برخوردارند.
  • مشکل از کار افتادن برنامه با پیام خطای Fatal Exception: java.util.ConcurrentModificationException برطرف شد.
۲۴.۴.۰ ‎۲۰۲۵‑۰۶‑۰۹
  • چندین API جدید برای پیش‌بارگذاری تبلیغات اضافه شده و APIهای موجود منسوخ شده‌اند. پیش‌بارگذاری تبلیغات همچنان یک ویژگی محدود در نسخه آلفا است.
۲۴.۳.۰ ۲۰۲۵‑۰۵‑۱۹
  • وابستگی SDK پلتفرم پیام‌رسانی کاربر به نسخه ۳.۲.۰ به‌روزرسانی شد.
۲۴.۲.۰ ۲۰۲۵–۰۴–۰۷
  • رفع اشکالات و بهبود عملکرد.
۲۴.۱.۰ ‎۲۰۲۵‑۰۳‑۱۲
  • حداقل نسخه کاتلین اکنون ۲.۱.۰ است.
  • رفع اشکالات و بهبود عملکرد.
  • play-services-ads-lite به تدریج در حال کاهش سرعت انتشار است و با این نسخه توزیع نمی‌شود. برای اطلاعات بیشتر، به مستندات Lite SDK مراجعه کنید.
۲۴.۰.۰ ‎۲۴ فوریه ۲۰۲۵‎
  • تغییرات ناگهانی:
    • حداقل سطح API اندروید به ۲۳ افزایش یافت.
    • SDK دیگر پارامترهای اضافی ارسالی از طریق addNetworkExtrasBundle() را به عنوان پارامترهای هدف‌گیری سفارشی به Ad Manager ارسال نمی‌کند. برای تنظیم هدف‌گیری سفارشی، به جای آن از addCustomTargeting() استفاده کنید. برای اطلاعات بیشتر، به هدف‌گیری سفارشی مراجعه کنید.
    • تمام API های مربوط به قالب تبلیغات بین اسکرولی حذف شد.
    • APIهای جهت‌یابی AppOpenAd که منسوخ شده بودند، حذف شدند.
    • کلاس‌های SearchAdView و DynamicHeightSearchAdRequest حذف شدند.
  • وابستگی SDK پلتفرم پیام‌رسانی کاربر به نسخه ۳.۱.۰ به‌روزرسانی شد.
  • بهینه‌سازی مقداردهی اولیه و بارگذاری تبلیغات اکنون به طور کلی در دسترس است و به طور پیش‌فرض فعال است.
  • MediationRewardedAdCallback.onUserEarnedReward() MediationRewardedAdCallback.onUserEarnedReward(RewardItem) منسوخ شده است. آداپتورهای Mediation باید برای استفاده از متد جدید به‌روزرسانی شوند.
  • تگ ویژگی android.adservices.AD_SERVICES_CONFIG از فایل مانیفست SDK حذف شد تا از تداخل ادغام برای برنامه‌هایی که سرویس‌های تبلیغاتی مختص API را پیکربندی می‌کنند، جلوگیری شود.
۲۳.۶.۰ ۲۰۲۴–۱۲–۰۳
  • تمام API های مربوط به قالب تبلیغات بین اسکرولی را منسوخ کرد. برای مثال، AdSize.getCurrentOrientationInterscrollerAdSize() .
۲۳.۵.۰ ۲۰۲۴–۱۰–۲۹
  • پیام‌های لاگ‌کت مربوط به خطای بارگذاری تبلیغات که در نسخه ۲۳.۴.۰ از سطح خطا به اطلاعات معرفی شدند، به‌روزرسانی شدند.
  • بهبود کسب درآمد از تبلیغات شخصی‌سازی‌شده در تب‌های سفارشی برای API وب‌ویو برای تبلیغات.
۲۳.۴.۰ ‎۲۰۲۴‑۰۹‑۳۰
  • خرابی‌های بارگذاری تبلیغات اکنون یک پیام logcat را فراخوانی می‌کنند که می‌گوید ad failed to load در ردیابی پشته مربوط به خرابی ناموفق بود. ردیابی پشته این پیام را به عنوان یک خطا ثبت می‌کند، اما به معنای خرابی نیست. برای تفسیر خرابی‌های رایج بارگذاری تبلیغات ، به پیام‌های ثبت خطاهای رایج اشکال‌زدایی مراجعه کنید. اگر خطای تکراری مربوط به نمایش تبلیغات مشاهده کردید که مستند نشده است، ردیابی پشته را با پشتیبانی SDK تبلیغات موبایل گوگل به اشتراک بگذارید.
  • متدهای addCustomTargeting() به AdRequest اضافه شد.
۲۳.۳.۰ ۲۰۲۴–۰۸–۱۲
  • وابستگی SDK پلتفرم پیام‌رسانی کاربر به نسخه ۳.۰.۰ به‌روزرسانی شد.
۲۳.۲.۰ ۲۰۲۴‑۰۶‑۲۷
  • AdView.isCollapsible() اضافه شد تا نشان دهد که آیا آخرین بنر بارگذاری شده قابل جمع شدن است یا خیر.
۲۳.۱.۰ ۲۰۲۴‑۰۵‑۰۹
  • به حداقل compileSdkVersion 34 نیاز دارد.
  • آداپتورهای Native Mediation : loadNativeAd و loadRtbNativeAd() منسوخ شده‌اند و به جای آنها از loadNativeAdMapper() و loadRtbNativeAdMapper() استفاده می‌شود. آداپتورها باید به استفاده از این متدهای بارگذاری جدید و اشیاء مرتبط مهاجرت کنند.
۲۳.۰.۰ ۲۰۲۴‑۰۳‑۰۷
  • تغییرات ناگهانی:
    • حداقل سطح API اندروید به ۲۱ افزایش یافت.
    • برای ادامه جمع‌آوری معیارهای کاربر در AdMob ، برنامه AdMob خود را به Firebase پیوند دهید و Google Analytics for Firebase SDK را در برنامه خود ادغام کنید.
    • API منسوخ‌شده‌ی MobileAds.enableSameAppKey() حذف شد و متد جایگزین MobileAds.putPublisherFirstPartyIdEnabled() به‌روزرسانی شد تا یک مقدار بولی در مورد موفقیت‌آمیز بودن یا نبودن ماندگاری کنترل برگرداند.
    • Native Ads :
      • AdLoader.forUnifiedNativeAd() حذف شد. به جای آن از AdLoader.forNativeAd() استفاده کنید.
      • AdLoader.forCustomTemplateAd() حذف شد. به جای آن از AdLoader.forCustomFormatAd() استفاده کنید.
    • AdFormat.UNKNOWN بدون جایگزینی حذف شد. برنامه‌هایی که از QueryInfo.generate() استفاده می‌کنند باید فرمت تبلیغ را ارسال کنند.
    • متدهای AdManagerAdRequest.Builder که از والد خود به ارث رسیده‌اند، اکنون می‌توانند به صورت زنجیروار به هم متصل شوند تا یک شیء را از یک فراخوانی واحد بسازند. این امر مستلزم تغییر در ساختار ارث‌بری بود، به طوری که AdManagerAdRequest.Builder دیگر از AdRequest.Builder ارث‌بری نکند.
  • برای بهبود کسب درآمد از تبلیغات در تب‌های سفارشی، MobileAds.registerCustomTabsSession() اضافه شد. برای اطلاعات بیشتر به Optimize Custom Tabs مراجعه کنید.
  • وابستگی SDK پلتفرم پیام‌رسانی کاربر به نسخه ۲.۲.۰ به‌روزرسانی شد.
۲۲.۶.۰ ۲۰۲۳‑۱۲‑۰۶
  • MobileAds.setSameAppKeyEnabled() منسوخ شده و متد آن به MobileAds.putPublisherFirstPartyIdEnabled() تغییر نام داده شده است.
  • AdFormat.UNKNOWN منسوخ شده و هیچ جایگزینی ندارد. برنامه‌هایی که از QueryInfo.generate() استفاده می‌کنند باید یک قالب تبلیغ (ad format) را ارسال کنند.
۲۲.۵.۰ ۲۰۲۳‑۱۰‑۳۰
۲۲.۴.۰ ۲۰۲۳‑۰۹‑۱۳
  • به حداقل compileSdkVersion 33 نیاز دارد.
  • بازرس تبلیغات: پشتیبانی از SDK برای درخواست و نمایش تبلیغات درخواستی از طریق رابط کاربری بازرس تبلیغات اضافه شده است.
  • یک متد جدید QueryInfo.generate() اضافه شده است که یک شناسه واحد تبلیغاتی را دریافت می‌کند.
  • آزمایش اولیه APIهای حفظ حریم خصوصی نسخه بتای گزارش‌دهی انتساب و نسخه بتای موضوعات را فعال می‌کند. برای اطلاعات بیشتر به راهنمای Ad Manager Privacy Sandbox در اندروید مراجعه کنید.
۲۲.۳.۰ ۲۰۲۳–۰۸–۲۲
  • پشتیبانی برای ایجاد اندازه‌های تطبیقی ​​با استفاده از AdSize.FULL_WIDTH به عنوان عرض اضافه شد. پیش از این، اندازه‌های تبلیغاتی که با استفاده از AdSize.FULL_WIDTH ایجاد می‌شدند، به عنوان AdSize.SMART_BANNER در نظر گرفته می‌شدند.
۲۲.۲.۰ ۲۰۲۳‑۰۷‑۰۵
۲۲.۱.۰ ۲۰۲۳‑۰۵‑۱۸
  • بازرس تبلیغات: قابلیت فعال‌سازی درخواست‌های تبلیغاتی از رابط کاربری بازرس تبلیغات در دستگاه‌هایی که سرویس‌های گوگل پلی ندارند.
۲۲.۰.۰ ۲۰۲۳‑۰۳‑۲۹
  • تغییرات ناگهانی:
    • NativeCustomFormatAd.getVideoController() و NativeCustomFormatAd.getVideoMediaView() حذف و NativeCustomFormatAd.getMediaContent() جایگزین آن شد.
    • MobileAds.getVersionString() به نفع MobileAds.getVersion() حذف شد.
    • AdRequest.Builder.setAdInfo() حذف و تابع AdRequest.Builder.setAdString() جایگزین آن شد.
    • AdManager.Builder.setAdString() اکنون نوع AdRequest.Builder را برمی‌گرداند.
    • MediationRewardedVideoAdAdapter و APIهای مرتبط به نفع Adapter حذف شدند.
  • AdRequest.getRequestAgent() اضافه شد.
  • میانجیگری: مقدار بازگشتی برای Adapter.getVersionInfo() و Adapter.getSDKVersionInfo() از نوع com.google.android.gms.ads.mediation.VersionInfo به com.google.android.gms.ads.VersionInfo تغییر کرده است. توصیه می‌کنیم آداپتورها نوع جدید را برگردانند زیرا com.google.android.gms.ads.mediation.VersionInfo منسوخ شده است.
۲۱.۵.۰ ۲۰۲۳‑۰۱‑۳۱
  • تبلیغات باز برنامه: متدهای AppOpenAd.load() که پارامتر ورودی orientation را می‌پذیرفتند، منسوخ شده و متدهای جدیدی اضافه شده‌اند که ورودی orientation را نمی‌پذیرند. متدهای جدید، جهت‌گیری را در زمان درخواست تعیین می‌کنند و با رفتار سایر قالب‌های تمام صفحه مطابقت دارند.
  • میانجیگری: پشتیبانی از میانجیگری برای تبلیغات باز برنامه اضافه شده است.
  • مجوز RECEIVE_BOOT_COMPLETED از وابستگی androidx.work:work-runtime حذف شد. اگر از نسخه‌های Gradle قبل از ۷.۲.۰ استفاده می‌کنید و برای برنامه خود به مجوز نیاز دارید، ممکن است لازم باشد مجوز را به صراحت در مانیفست اندروید خود اعلام کنید.
۲۱.۴.۰ ۲۰۲۲–۱۲–۱۴
  • شناسه برنامه مدیریت تبلیغات اکنون برای همه برنامه‌های مدیریت تبلیغات مورد نیاز است و به قالب ca-app-pub-################~########## نیاز دارد. برای جزئیات بیشتر به پیکربندی برنامه خود مراجعه کنید.
  • بازرس تبلیغات: پشتیبانی از SDK را برای نمایش تبلیغات بنری و تبلیغات بومی درخواست شده از طریق رابط کاربری بازرس تبلیغات گسترش دهید.
  • پشتیبانی از شناسه شخص ثالث ناشر (که قبلاً با نام کلید برنامه شناخته می‌شد) اضافه شده است تا به شما کمک کند با استفاده از داده‌های جمع‌آوری‌شده از برنامه‌هایتان، تبلیغات مرتبط‌تر و شخصی‌سازی‌شده‌تری ارائه دهید.
  • نسخه رسمی انتشار برای تولید QueryInfo .
۲۱.۳.۰ ۲۰۲۲‑۱۰‑۱۰
۲۱.۲.۰ ۲۰۲۲‑۰۹‑۰۶
  • بازرس تبلیغات: پشتیبانی از SDK برای خروجی گرفتن از گزارش‌های درخواست تبلیغات از طریق Android Sharesheet اضافه شد.
۲۱.۱.۰ ۲۰۲۲‑۰۷‑۱۴
  • پشتیبانی از کسب درآمد از تبلیغات در WebView اضافه شد. برای جزئیات بیشتر به بخش «ادغام API وب‌ویو برای تبلیغات» مراجعه کنید.
  • تابع getResponseExtras() به ResponseInfo اضافه شد که ممکن است اطلاعات اضافی در مورد پاسخ تبلیغ را برگرداند.
۲۱.۰.۰ 2022‑05‑25
  • تغییرات ناگهانی:
    • کیت توسعه نرم‌افزاری تبلیغات موبایل گوگل (Google Mobile Ads SDK) اکنون برای اجرا، همه برنامه‌ها را ملزم می‌کند که حداقل از سطح API اندروید ۱۹ برخوردار باشند.
    • حاشیه‌نویسی‌های @NonNull در هر متدی که قبلاً صراحتاً قابلیت تهی بودن را تعریف نمی‌کرد، اضافه شد.
    • متد AdRequest.Builder.addNetworkExtras() حذف شد. به جای آن از AdRequest.Builder.addNetworkExtrasBundle() استفاده کنید.
    • روش‌های مکان‌یابی زیر حذف شدند:
      • setLocation() روی AdRequest.Builder
      • getLocation() روی AdRequest
      • getLocation() روی MediationAdConfiguration
  • پرچم‌های مانیفست برای بهینه‌سازی مقداردهی اولیه و بارگذاری تبلیغات اضافه شد، برای جزئیات بیشتر به راهنمای بهینه‌سازی مقداردهی اولیه و بارگذاری تبلیغات مراجعه کنید.
  • MobileAds.getVersionString() منسوخ شده است. به جای آن از MobileAds.getVersion() استفاده کنید.
  • متد getLoadedAdapterResponseInfo() در ResponseInfo اضافه شد.
  • متدهای زیر در AdapterResponseInfo اضافه شده‌اند:
    • getAdSourceName()
    • getAdSourceId()
    • getAdSourceInstanceName()
    • getAdSourceInstanceId()
  • پشتیبانی از رویدادهای سفارشی در بازرس تبلیغات اضافه شد.
۲۰.۶.۰ ۲۰۲۲‑۰۲‑۲۲
۲۰.۵.۰ ۲۰۲۱–۱۱–۱۸
  • پشتیبانی از دستگاه‌های اندروید ۱۲ برای برنامه‌هایی که API 31 را هدف قرار می‌دهند، اضافه شد.
  • پشتیبانی از شناسه مجموعه برنامه برای موارد استفاده مانند گزارش و جلوگیری از کلاهبرداری اضافه شده است.
۲۰.۴.۰ ۲۰۲۱–۰۹–۲۲
  • از نسخه ۲۰.۴.۰ به بعد، SDK تبلیغات موبایل گوگل شامل مجوز com.google.android.gms.permission.AD_ID در مانیفست SDK می‌شود که به طور خودکار توسط ابزارهای ساخت اندروید در مانیفست برنامه ادغام می‌شود. برای کسب اطلاعات بیشتر در مورد اعلان مجوز AD_ID ، از جمله نحوه غیرفعال کردن آن، به این مقاله راهنمای کنسول Play مراجعه کنید.
  • تابع فراخوانی onAdClicked() به FullScreenContentCallback اضافه شد.
  • تابع فراخوانی onAdClicked() در کلاس AdListener برای فرمت تبلیغات بومی فعال شد.
۲۰.۳.۰ ۲۰۲۱–۰۸–۲۳
۲۰.۲.۰ ۲۰۲۱-۰۶-۰۸
  • پشتیبانی از بازرس تبلیغات (بتا) برای ناشران Google Ad Manager اضافه شد.
۲۰.۱.۰ ۲۰۲۱-۰۴-۲۹
۲۰.۰.۰ ۲۰۲۱-۰۴-۰۵
  • تغییرات ناگهانی:
    • API Interstitial قدیمی حذف شد.
    • API قدیمی RewardedVideoAd حذف شد.
    • کلاس‌هایی که پیشوند Publisher داشتند حذف شدند (مثلاً: PublisherAdView ).
    • CustomRenderedAd حذف شد.
    • InstreamAd حذف شد.
    • SearchAdRequest حذف شد.
    • AdListener.onAdLeftApplication() حذف شد.
    • NativeAppInstallAd ، NativeContentAd و UnifiedNativeAd حذف شدند. اکنون یک فرمت تبلیغات بومی به نام NativeAd وجود دارد.
    • RewardedAd اکنون یک کلاس انتزاعی است. از متد استاتیک RewardedAd.load() برای بارگذاری یک تبلیغ جایزه‌دار استفاده کنید.
  • AdSize.SMART_BANNER منسوخ شده و جای خود را به تبلیغات بنری تطبیقی ​​داده است.
  • حاشیه‌نویسی‌های صریح مربوط به قابلیت تهی‌سازی در تمام APIهای عمومی اضافه شد.
۱۹.۸.۰ ۲۰۲۱‑۰۳‑۱۵
  • یک وابستگی به SDK پلتفرم پیام‌رسانی کاربر اضافه شد.
  • تابع فراخوانی onAdImpression() به FullScreenContentCallback اضافه شد.
  • فرمت InstreamAd منسوخ شد.
  • آداپتورهای میانجیگری:
    • MediationBannerAdapter جدید باید کلاس MediationInterstitialAdapter Adapter برای بارگذاری این فرمت‌ها پیاده‌سازی MediationNativeAdapter .
    • آداپتورهای پیشنهاد دهنده اکنون می‌توانند متدهای بارگذاری متمایزی را در کلاس Adapter برای فرمت‌های خاص RTB پیاده‌سازی کنند.
۱۹.۷.۰ ۲۰۲۱-۰۱-۲۰۲۰
  • تغییرات عمده در:
    • InterstitialAd
    • RewardedAd
    • NativeAd
    • AppOpenAd
  • CustomRenderedAd منسوخ شده.
  • کلاس‌ها و بسته‌هایی که پیشوند Publisher داشتند، منسوخ شده و با پیشوند AdManager جایگزین شده‌اند.
  • آخرین نسخه فرعی قبل از نسخه 20.0.0. تمام APIهایی که در این نسخه و نسخه‌های قبلی به عنوان منسوخ علامت‌گذاری شده‌اند، در نسخه 20.0.0 حذف خواهند شد. برای جزئیات بیشتر به راهنمای مهاجرت به نسخه 20.0.0 مراجعه کنید.
۱۹.۶.۰ ۲۰۲۰‑۱۲‑۰۴
  • متد onAdLeftApplication() AdListener منسوخ شد.
  • اشکالی که باعث می‌شد از کاربران دستگاه‌های اندروید ۱۱ هنگام کلیک روی یک تبلیغ، مرورگر مورد نظرشان را انتخاب کنند، برطرف شد.
۱۹.۵.۰ ۲۰۲۰–۱۰–۲۰
۱۹.۴.۰ ‎2020-09-10
  • پشتیبانی از دستگاه‌های اندروید ۱۱ برای برنامه‌هایی که API 30 را هدف قرار می‌دهند، اضافه شد.
  • تبلیغات باز برنامه: فرمت AppOpenAd تغییر کرد تا بیشتر شبیه یک فرمت تمام صفحه عمل کند تا یک نمایش بنر. متدهای getResponseInfo() و show() به AppOpenAd اضافه شد. کلاس‌های AppOpenAdView و AppOpenAdPresentationCallback منسوخ شدند.
  • میانجیگری: گزارش وضعیت میانجیگری اکنون در دسترس است. از ResponseInfo.getAdapterResponses() برای دریافت اطلاعات پاسخ برای هر شبکه تبلیغاتی که در یک درخواست تبلیغ شرکت کرده است، استفاده کنید.
  • تبلیغات جایزه‌دار قدیمی: RewardedVideoAd منسوخ‌شده.
  • قالب RewardedInterstitialAd در نسخه بتای خصوصی اضافه شد.
  • اشکالی که باعث می‌شد MobileAds.initialize() فقط یک بار تابع completion handler را فراخوانی کند، برطرف شد. اکنون هر فراخوانی MobileAds.initialize() تابع completion callback را فراخوانی می‌کند.
۱۹.۳.۰ ۲۰۲۰‑۰۷‑۲۰
  • متدهای getDomain() و getCause() به AdError اضافه شد.
  • فراخوانی‌های خطای بارگذاری جدید به تمام قالب‌های تبلیغاتی که خطای LoadAdError برمی‌گردانند اضافه شد. به عنوان مثال، onAdFailedToLoad(LoadAdError) .
  • فراخوانی‌های ناموفق بارگذاری که یک عدد صحیح برمی‌گردانند، منسوخ شده‌اند. مثلاً onAdFailedToLoad(int) .
  • تبلیغات جایزه‌دار: در onRewardedAdFailedToShow(AdError) اضافه و در onRewardedAdFailedToShow(int) منسوخ شده است.
  • میانجیگری پاداش‌دار: کد خطای نمایش MEDIATION_SHOW_ERROR اضافه شد. اکنون همه خطاهای نمایش مربوط به تبلیغات واسطه‌ای MEDIATION_SHOW_ERROR برای AdError.getCode() و یک AdError.getCause() غیر تهی که نشان دهنده خطای میانجیگری اساسی است، برمی‌گردانند.
۱۹.۲.۰ ‎2020‑06‑18
  • تبلیغات بومی: رابط کاربری اعتبارسنج تبلیغات بومی به درخواست‌های آزمایشی اضافه شد تا به شما در تشخیص و رفع تخلفات سیاست تبلیغات بومی کمک کند.
  • متد MobileAds.disableMediationAdapterInitialization() اضافه شد. این متد را قبل از مقداردهی اولیه SDK تبلیغات موبایلی گوگل فراخوانی کنید تا مقداردهی اولیه آداپتور میانجیگری غیرفعال شود.
۱۹.۱.۰ ۲۰۲۰‑۰۴‑۱۶
۱۹.۰.۱ ۲۰۲۰‑۰۳‑۱۸
  • تبلیغات بومی: مشکل نشت حافظه که هنگام استفاده از NativeCustomTemplateAd رخ می‌داد، برطرف شد.
۱۹.۰.۰ ۲۰۲۰‑۰۳‑۰۲
  • پشتیبانی از پارامترهای رضایت خواندن از IAB TCF نسخه ۲.۰ و رشته us_privacy در IAB اضافه شد.
  • setNeighboringContentUrls() و getNeighboringContentUrls() به AdRequest اضافه شدند.
  • کلاس ResponseInfo اضافه شده است که اطلاعاتی در مورد یک تبلیغ بارگذاری شده ارائه می‌دهد.
  • برای همه قالب‌های تبلیغاتی، تابع getMediationAdapterClassName() منسوخ شده و از getResponseInfo() استفاده می‌شود.
  • تبلیغات بومی: متدهای getDuration() و getCurrentTime() به MediaContent اضافه شدند.
  • میانجیگری بومی: متدهای getDuration() و getCurrentTime() به UnifiedNativeAdMapper برای پیاده‌سازی توسط آداپتورها اضافه شد.
  • AdRequest.Builder.addTestDevice() منسوخ شده است. به جای آن از RequestConfiguration.Builder.setTestDeviceIds() استفاده کنید.
۱۸.۳.۰ ۲۰۱۹-۱۱-۰۵
  • APIهایی برای قالب تبلیغات InstreamAd اضافه شد. این ویژگی در نسخه بتای خصوصی است. برای درخواست دسترسی با مدیر حساب خود تماس بگیرید.
  • بنر تطبیقی : متدهای ایجاد بنر تطبیقی ​​در کلاس AdSize تغییر یافته است. برای مثال، AdSize.getCurrentOrientationBannerAdSizeWithWidth() به AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize() تغییر نام داده است.
  • میانجیگری : SDK تبلیغات موبایل گوگل اکنون استثنائات ایجاد شده توسط آداپتورهای میانجیگری را دریافت می‌کند.
  • تبلیغات پاداش‌دار : اشکالی که باعث می‌شد اگر چندین تبلیغ پاداش‌دار با واسطه ذخیره شوند، فقط یکی از آنها نمایش داده شود، برطرف شد.
  • متد setTestDeviceIds() اضافه شد تا تنظیم دستگاه‌های آزمایشی یک بار برای همه درخواست‌های تبلیغاتی فعال شود.
۱۸.۲.۰ 2019-08-29
  • API های مربوط به قالب AppOpenAd اضافه شد. این ویژگی در نسخه بتای خصوصی است. برای درخواست دسترسی با مدیر حساب خود تماس بگیرید.
۱۸.۱.۱ ۲۰۱۹-۰۷-۲۳
  • میانجیگری : آداپتورها اکنون وقتی برنامه‌ها MobileAds.initialize(Context, OnInitializationCompleteListener) را فراخوانی می‌کنند، مقداردهی اولیه می‌شوند.
  • میانجیگری : استثنائات آداپتور که ردیابی پشته آنها شامل SDK تبلیغات موبایل گوگل است، اکنون توسط SDK تبلیغات موبایل گوگل دریافت و مدیریت می‌شوند.
۱۸.۱.۰ 2019-07-09
  • انتشار رسمی پشتیبانی از اندازه‌گیری برنامه.
  • یک متد مقداردهی اولیه جدید، MobileAds.initialize(Context, OnInitializationCompleteListener) اضافه شده است که وقتی Google Mobile Ads SDK و تمام آداپتورهای میانجی پیکربندی شده، مقداردهی اولیه را تکمیل کردند، به شما اطلاع می‌دهد.
  • MobileAds.getInitializationStatus() اضافه شد تا وضعیت راه‌اندازی اولیه همه شبکه‌های تبلیغاتی پیکربندی‌شده برای برنامه شما را ارائه دهد.
  • MobileAds.getRequestConfiguration() اضافه شد. پارامترهای هدف‌گیری تنظیم‌شده روی این شیء پیکربندی برای همه درخواست‌های تبلیغ استفاده می‌شوند.
  • تبلیغات بومی : متد NativeAdOptions.Builder.setMediaAspectRatio() برای درخواست نسبت ابعاد خاص برای محتوای رسانه‌ای یک تبلیغ بومی اضافه شده است. این گزینه بر متد setImageOrientation() که اکنون منسوخ شده است، اولویت دارد.
  • تبلیغات بومی : برای تبلیغات غیر ویدیویی، اکنون می‌توان نوع مقیاس تصویر MediaView را با استفاده از MediaView.setImageScaleType() تنظیم کرد.
  • تبلیغات بومی : UnifiedNativeAd.getMediaContent() اضافه شد. ناشرانی که فقط تصاویر را با استفاده از URL بارگذاری می‌کنند، اکنون می‌توانند محتوای رسانه‌ای تبلیغ را دریافت کنند، تصویری به آن اضافه کنند و MediaView.setMediaContent() را برای پر کردن داده‌های تصویر از طریق MediaView برای تبلیغات غیر ویدیویی فراخوانی کنند.
  • تبلیغات بومی : APIهایی اضافه شده است تا پشتیبانی از اندازه‌گیری باز (Open Measurement) را برای قالب‌های تبلیغاتی بومی سفارشی غیر ویدیویی فعال کند.
  • واسطه‌گری تبلیغات بومی : آداپتورها اکنون می‌توانند با استفاده از UnifiedNativeAdMapper.setMediaContentAspectRatio() نسبت ابعاد را ارائه دهند.
  • کلاس Correlator و API های مرتبط با آن حذف شد. این ویژگی قبلاً غیرفعال بود.
  • وابستگی‌هایی به play-services-measurement و play-services-measurement-sdk اضافه شد. برنامه‌ها دیگر نیازی به اضافه کردن صریح این وابستگی‌ها ندارند.
۱۸.۰.۰ ۲۰۱۹-۰۶-۱۷
  • مهاجرت از کتابخانه‌های پشتیبانی اندروید به کتابخانه‌های جت‌پک (اندروید ایکس). برای اطلاعات بیشتر به یادداشت‌های انتشار سرویس‌های گوگل پلی مراجعه کنید.
  • برای جلوگیری از خرابی که در اولین اجرا پس از نصب برنامه از فروشگاه Play رخ می‌دهد، این نسخه از ناشران می‌خواهد که وابستگی‌های اضافی را در build.gradle خود اعلام کنند:
    com.google.android.gms:play-services-measurement:17.0.0
    com.google.android.gms:play-services-measurement-sdk:17.0.0
۱۷.۲.۱ 2019-05-21
  • رفع مشکل ANR که از android.media.AudioManager.getStreamVolume سرچشمه می‌گرفت.
۱۷.۲.۰ ۲۰۱۹-۰۳-۱۱
  • ویدیوی جایزه‌دار: مجموعه‌ای جدید از APIهای جایزه‌دار اضافه شده است (به بسته جایزه‌دار مراجعه کنید) که به شما امکان می‌دهد چندین تبلیغ جایزه‌دار را همزمان بارگذاری کنید.
  • میانجیگری: مجموعه‌ای جدید از APIهای آداپتور میانجیگری اضافه شده است که از مقداردهی اولیه پشتیبانی می‌کنند. آداپتورهایی که API جدید را پیاده‌سازی می‌کنند، کلاس Adapter را پیاده‌سازی می‌کنند.
  • ناشرانی که از firebase-analytics به همراه نسخه 17.2.0 هر یک از کتابخانه‌های تبلیغاتی (مثلاً com.google.android.gms:play-services-ads:17.2.0 ) استفاده می‌کنند، باید از com.google.firebase:firebase-analytics:16.3.0 استفاده کنند.
۱۷.۱.۳ ۲۰۱۹-۰۱-۳۱
  • ناشرانی که از firebase-analytics به همراه نسخه 17.1.3 هر یک از کتابخانه‌های تبلیغاتی (مثلاً com.google.android.gms:play-services-ads:17.1.3 ) استفاده می‌کنند، باید از com.google.firebase:firebase-analytics:16.3.0 استفاده کنند.
۱۷.۱.۲ ۲۰۱۸–۱۲–۰۳
  • ناشرانی که از firebase-analytics به همراه نسخه 17.1.2 هر یک از کتابخانه‌های تبلیغاتی (مثلاً com.google.android.gms:play-services-ads:17.1.2 ) استفاده می‌کنند، باید از com.google.firebase:firebase-analytics:16.0.6 استفاده کنند.
۱۷.۱.۱ ۲۰۱۸–۱۱–۱۲
  • اشکالی که باعث می‌شد ترکیب‌های خاصی از play-services-ads و firebase-analytics (مثلاً ads:17.1.0 و analytics:16.0.5 ) منجر به خطای duplicate entry کامپایلر شوند، برطرف شد. ناشرانی که از firebase-analytics به همراه نسخه 17.1.1 هر یک از کتابخانه‌های تبلیغات (مثلاً com.google.android.gms:play-services-ads:17.1.1 ) استفاده می‌کنند، باید از com.google.firebase:firebase-analytics:16.0.5 استفاده کنند.
۱۷.۱.۰ ۲۰۱۸–۱۱–۰۲
۱۷.۰.۰ ۲۰۱۸–۱۰–۰۵
  • ناشران Google Ad Manager موظفند یک برچسب <meta-data> با کلید com.google.android.gms.ads.AD_MANAGER_APP در AndroidManifest.xml خود مشخص کنند. برای جزئیات بیشتر به راهنمای شروع به کار مراجعه کنید.
  • تبلیغات بومی: NativeAppInstallAd ، NativeContentAd و APIهای مرتبط به نفع UnifiedNativeAd منسوخ شده‌اند. برای دستورالعمل‌های بیشتر در مورد استفاده از APIهای جدید، به Native Ads Advanced Unified مراجعه کنید.
  • تبلیغات بومی: ویژگی «بی‌صدا کردن این تبلیغ» اضافه شد.
  • تبلیغات بومی: گزارش هشدار بی‌خطر: «UnconfirmedClickListener نباید در هنگام تنظیم ClickConfirmingView مقدار null داشته باشد.» حذف شده است.
  • تبلیغات پاداشی: متد setAdMetadataListener در RewardedVideoAd اضافه شد تا تغییرات فراداده‌های تبلیغ را بررسی کند.
  • تبلیغات جایزه‌دار: فراخوانی destroy() باعث می‌شود شنونده بی‌اثر شود.
  • متدهای زیر درAdRequest.Builder منسوخ شده‌اند.
  • اشکالی که باعث می‌شد تابع onRewardedVideoCompleted() روی شبیه‌سازها اجرا نشود، برطرف شد.
۱۶.۰.۰ ۲۰۱۸–۱۰–۰۲
۱۵.۰.۰ ۲۰۱۸-۰۴-۱۲
  • نسخه بتای MRAID v3.
  • تبلیغات بومی: رابط برنامه‌نویسی کاربردی یکپارچه تبلیغات بومی اضافه شد. این رابط، NativeAppInstallAds و NativeContentAds را در یک نوع جدید به UnifiedNativeAd ترکیب می‌کند.
  • نکته: هنگام استفاده از تبلیغات بومی، یک هشدار بی‌خطر وجود دارد که هنگام کلیک روی تبلیغ بومی در گزارش‌ها نشان داده می‌شود: « UnconfirmedClickListener نباید در هنگام تنظیم ClickConfirmingView تهی باشد. » این هشدار را می‌توان نادیده گرفت و در نسخه بعدی حذف خواهد شد.
۱۲.۰.۱ ۲۰۱۸-۰۳-۲۸
۱۲.۰.۰ ۲۰۱۸-۰۳-۲۰۲۰
  • ویدیوی پاداش داده شده: متد فراخوانی onRewardedVideoCompleted() به RewardedVideoAdListener اضافه شد.
  • میانجیگری بومی: متد trackViews() به NativeAdMapper اضافه شد و به آداپتورها دسترسی به اشیاء View مربوط به دارایی‌های تبلیغاتی بومی منفرد را داد. trackView() منسوخ شده و trackViews() جایگزین آن شد.
۱۱.۸.۰ ۲۰۱۷–۱۲–۱۸
  • رفع اشکالات و بهبودهای کلی.
۱۱.۶.۰ 2017-11-07
  • کلاس NativeAdViewHolder و متدهای مرتبط در NativeAppInstallAd و NativeContentAd اضافه شد.
  • AdLoader.getMediationAdapterClassName منسوخ شده است (ناشران باید به جای آن از متدهای همنام در NativeAppInstallAd و NativeContentAd استفاده کنند).
  • تبلیغات آزمایشی اکنون یک برچسب در بالای تبلیغ نشان می‌دهند. برای جزئیات بیشتر به راهنمای آزمایش مراجعه کنید.
۱۱.۴.۰ ۲۰۱۷-۰۹-۱۹
  • متدهای getMediationAdapterClassName() به کلاس‌های NativeAppInstallAd و NativeContentAd اضافه شد. متدی با همین نام در AdLoader منسوخ خواهد شد.
  • یک متد onVideoEnd() به کلاس MediationNativeListener ، hasVideoContent() ، setHasVideoContent() و setMediaView() به کلاس NativeAdMapper ، و متدهای getAdVolume() و isAdMuted() به کلاس NativeMediationAdRequest برای پشتیبانی از میانجیگری ویدیویی بومی اضافه شده است.
  • کلاس SearchAdRequest حذف شد.
۱۱.۲.۲ ۲۰۱۷-۰۹-۰۵
  • یک متد جدید loadAd() اضافه شده است که یک شیء PublisherAdRequest را به کلاس RewardedVideoAd دریافت می‌کند.
۱۱.۲.۰ ‎۲۰۱۷–۰۸–۱۴
  • متد loadAds() به کلاس AdLoader اضافه شد که به برنامه‌ها اجازه می‌دهد چندین تبلیغ منحصر به فرد را در یک درخواست واحد بارگذاری کنند.
  • وقتی برنامه خود را به نسخه ۱۱.۲.۰ یا بالاتر از SDK تبلیغات موبایلی گوگل ارتقا می‌دهید، build.gradle برنامه شما نیز باید به‌روزرسانی شود تا compileSdkVersion حداقل 26 (Android O) را مشخص کند. این موضوع نحوه اجرای برنامه شما را تغییر نمی‌دهد. نیازی به به‌روزرسانی targetSdkVersion نخواهید داشت.
  • از نسخه ۱۱.۲.۰ به بعد، SDK تبلیغات موبایلی گوگل از طریق مخزن Maven گوگل در دسترس است. برای اطلاعات بیشتر، به یادداشت‌های انتشار سرویس‌های گوگل پلی مراجعه کنید.
۱۱.۰.۰ ۲۰۱۷-۰۶-۰۷
  • متدهای onAdClicked() و onAdImpression() به کلاس AdListener اضافه شدند. این متدها فقط برای نصب اپلیکیشن بومی و تبلیغات محتوای بومی فراخوانی می‌شوند.
  • متدهای getInAppPurchaseListener() و setInAppPurchaseListener() از کلاس‌های AdView ، InterstitialAd و NativeExpressAdView حذف شدند. همچنین کلاس‌های خرید درون‌برنامه‌ای مرتبط نیز حذف شدند.
  • متدهای OnVideoMute() ، OnVideoPause() ، OnVideoPlay() و OnVideoStart() را به کلاس VideoController.VideoLifecycleCallbacks اضافه کردیم.
  • با افزودن متد setImmersiveMode() به کلاس‌های PublisherInterstitialAd و RewardedVideoAd ، امکان فعال‌سازی حالت فراگیر (immersive mode) در تبلیغات تمام‌صفحه اضافه شد.
  • رابط OnPublisherAdViewLoadedListener ، کلاس PublisherAdViewOptions و کلاس PublisherAdViewOptions.Builder برای استفاده با AdLoader برای درخواست‌های native-plus-banner اضافه شد.
  • رابط کاربری اختیاری OnImmersiveModeUpdatedListener اضافه شد که آداپتورهای میانجی می‌توانند برای اطلاع از به‌روزرسانی‌های حالت فراگیر پیاده‌سازی کنند.
  • متد getMediationAdapterClassName() به کلاس RewardedVideoAd اضافه شد.
  • قوانین keep اضافه شد تا هنگام استفاده از ProGuard ، نام کلاس‌های آداپتور میانجیگری به طور خودکار حفظ شود.
۱۰.۲.۰ ۲۰۱۷-۲-۱۵
  • سرویس‌های گوگل پلی ۱۰.۲.x اولین نسخه‌ای است که دیگر پشتیبانی کامل از اندروید نسخه ۲.۳.x (نان زنجبیلی) را شامل نمی‌شود. برنامه‌های توسعه‌یافته با استفاده از SDK نسخه ۱۰.۲.x و بالاتر به حداقل سطح API اندروید ۱۴ نیاز دارند و نمی‌توانند روی دستگاه‌هایی که سطح API پایین‌تر از ۱۴ را اجرا می‌کنند نصب شوند. برای کسب اطلاعات بیشتر در مورد گزینه‌های شما، از جمله ساخت چندین APK برای گسترش پشتیبانی برنامه شما از اندروید نان زنجبیلی، به وبلاگ توسعه‌دهندگان اندروید مراجعه کنید.
  • پشتیبانی از فایل‌های ویدیویی برای محتوای پیشرفته بومی و تبلیغات قالب سفارشی اضافه شد.
  • متدهای getVideoController() ، setVideoOptions() و getVideoOptions() به کلاس PublisherAdView اضافه شدند.
  • کلاس AdChoicesView اضافه شد.
  • متدهای getAdChoicesContent() و setAdChoicesContent() به کلاس NativeAdMapper اضافه شدند.
  • رابط InitializableMediationRewardedVideoAdAdapter برای آداپتورهای میانجیگری ویدیویی پاداش‌دار که می‌خواهند قبل از درخواست تبلیغ، مقداردهی اولیه اولیه را انجام دهند، اضافه شد.
  • پشتیبانی از پیش‌نمایش درون‌برنامه‌ای و عیب‌یابی در Google Ad Manager اضافه شد.
۱۰.۰.۱ ۲۰۱۶–۱۱–۲۱
  • رفع اشکالات و بهبودهای کلی.
۹.۸.۰ ۲۰۱۶–۱۰–۲۴
  • MobileAds.Initialize(Context) از رده خارج شده است. ناشران Google Ad Manager باید هنگام مقداردهی اولیه برنامه‌های خود این متد را فراخوانی کنند. ناشران AdMob همچنان باید از MobileAds.Initialize(Context, String) استفاده کرده و کد برنامه خود را ارسال کنند.
۹.۶.۰ ۲۰۱۶–۰۹–۲۲
  • کلاس MediaView برای تبلیغات ویدیویی پیشرفته Native Ads اضافه شد.
  • برای پیش‌نمایش خلاقانه و عیب‌یابی واحدهای تبلیغاتی Ad Manager، یک متد openDebugMenu() به کلاس MobileAds اضافه شد.
  • پشتیبانی از رویدادهای سفارشی ویدیویی جایزه‌دار اضافه شد.
۹.۴.۰ ۲۰۱۶–۰۸–۰۱
  • رفع اشکالات و بهبودهای کلی.
۹.۲.۰ ۲۰۱۶–۰۶–۲۷
  • متد setAdChoicesPlacement() به کلاس NativeAdOptions.Builder اضافه شد، که ناشران برنامه اکنون می‌توانند از آن برای مشخص کردن مکان AdChoices های خود در تبلیغات بومی استفاده کنند.
  • پخش تبلیغات ویدیویی با رفع چندین اشکال بهبود یافته است.
۹.۰.۱ 2016-05-26
  • مشکل ProGuard که در نسخه ۹.۰.۰ معرفی شده بود، برطرف شد. ناشران دیگر نیازی به گزینه keep برای com.google.android.gms.common.util.DynamiteApi ندارند.
۹.۰.۰ 2016-05-18
  • اضافه شدن قابلیت جمع‌آوری خودکار اطلاعات موقعیت مکانی برای برنامه‌هایی که صراحتاً مجوز موقعیت مکانی را اعطا می‌کنند.
  • پشتیبانی از رویدادهای سفارشی میانجیگری ویدیویی پاداشی اضافه شد.
  • گزینه‌های ویدیویی برای تبلیغات Native Express اضافه شد.
  • API تبلیغات جستجوی سفارشی به‌روزرسانی شد.
  • متد setAppMuted() اضافه شد.
  • متد MobileAds.initialize(android.content.Context, java.lang.String) دیگر منسوخ شده است.
  • متد MobileAds.initialize(android.content.Context) اکنون منسوخ شده است.
  • متد MediationNativeListener.onAdImpression() برای گزارش نمایش‌ها در آداپتورهای میانجی‌گری اضافه شد.
  • For this release only , apps that use ProGuard to post-process their application need to add the following keep option to their ProGuard configuration file: -keep public @com.google.android.gms.common.util.DynamiteApi class * { *; }
8.4.0 2015‑12‑18
  • Added a public method, MobileAds.setAppVolume() , to inform Google Mobile Ads SDK of an app's current volume level.
  • Implemented bug fixes and improvements.
8.3.0 2015‑11‑6
  • Added support for rewarded video ads.
  • Added an isLoading() method to PublisherAdView and PublisherInterstitialAd to check if an ad request is in progress.
  • Added the setIsDesignedForFamilies() method to AdRequest.Builder and PublisherAdRequest.Builder .
  • Added a destroy() method to NativeAdView .
8.1.0 2015‑09‑24 Various bug fixes.
7.8.0 2015‑08‑13
  • MRAID v2 official release version.
  • Added an isLoading() method to AdLoader , AdView , and InterstitialAd to check if an ad request is in progress.
  • Deprecated PublisherAdRequest.Builder#setManualImpressionsEnabled() . Use PublisherAdView#setManualImpressionsEnabled() instead.
7.5.0 2015‑05‑28
  • Added support for app install and content native ad formats across AdMob and Ad Manager.
  • Added support for custom native ad formats, available for Ad Manager reservations.
7.3.0 2015‑04‑28 Various bug fixes.
۷.۰.۰ 2015‑03‑19
  • Added addCustomTargeting() and addCategoryExclusion() methods to PublisherAdRequest.Builder .
  • Fixed an issue causing PublisherAdView.recordManualImpression() to record multiple impressions in Ad Manager when using manual impression counting.
  • Fixed an issue causing ads to render improperly when using the android:largestWidthLimitDp attribute on the <supports-screens> tag.
  • Added the setRequestAgent() method to AdRequest.Builder and PublisherAdRequest.Builder . This method should be used to denote ad request origins by third parties that mediate to Google Mobile Ads SDK.
6.5.87 2014‑12‑08
  • Introduced split JAR architecture--Android Studio developers can now just include the ads portion of Google Play services by depending on com.google.android.gms: play‑services‑ads :6.+ .
    Note: Apps that create banner ads in XML must still reference the entire library com.google.android.gms: play‑services :6.+ .
  • Various bug fixes.
6.1 2014‑10‑08
  • Added a getLocation() method to com.google.android.gms.ads.MediationAdRequest .
  • Added a content description to the interstitial close button for accessibility.
  • Removed logging of "Google Play resources not found" when the library project is linked correctly.
  • Added getMediationAdapterClassName() to AdView to get the class name of the ad network mediation adapter showing an ad.
17.0.0 2018‑10‑05
  • Added new APIs to implement Custom Events.
  • Added default purchase flow for In-App Purchase, using the Google Play Billing API.
۴.۴ 2014‑05‑07
  • Added new Mediation Adapter APIs.
  • Added new 320x100 LARGE_BANNER ad format for both phones and tablets.
  • Added new interstitial format for In-App Purchase. Set an InAppPurchaseListener on InterstitialAd to listen for in-app purchase events.
  • Bug fix for SecurityException crash due to reading gservices without permission.
۴.۳ 2014‑03‑17
  • InterstitialAd now functions if passed an application context.
  • Added the setContentUrl() method to PublisherAdRequest.Builder .
  • Fix for exception when Service not registered .
۴.۲ 2014‑02‑03 Various bug fixes.
۴.۱ 2014‑01‑16
  • Added support for Ad Manager and Search Ads for Mobile Apps.
  • AdRequest.Builder now has a setLocation() method.
  • Fixed a crash that occurred if an interstitial ad was requested but AdActivity wasn't specified in the manifest.
۴.۰ 2013‑10‑31
  • Google Mobile Ads APIs are now part of Google Play services .
  • Future updates to the Google Mobile Ads APIs get automatically pushed to devices through Google Play services.
  • Ad Manager and Search Ads for Mobile Apps not yet supported.