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

نسخه تاریخ انتشار یادداشت ها
24.5.0 2025-07-24
  • ناشران فهرست مجاز اکنون از پشتیبانی از شناسه مکان برای همه قالب‌های تبلیغاتی برخوردار هستند.
  • رفع خرابی با پیام خطای Fatal Exception: java.util.ConcurrentModificationException .
24.4.0 2025-06-09
  • چندین API جدید برای بارگذاری اولیه تبلیغات اضافه کرد و APIهای موجود را منسوخ کرد. پیش بارگذاری تبلیغات همچنان یک ویژگی آلفای محدود است.
24.3.0 2025-05-19
  • وابستگی SDK پلت فرم پیام‌رسانی کاربر به نسخه 3.2.0 به‌روزرسانی شد.
24.2.0 2025-04-07
  • رفع اشکال و بهبود عملکرد.
24.1.0 2025-03-12
  • حداقل نسخه Kotlin اکنون 2.1.0 است.
  • رفع اشکال و بهبود عملکرد.
  • play-services-ads-lite به سرعت انتشار کاهش یافته است و با این نسخه توزیع نمی شود. برای اطلاعات بیشتر، به مستندات Lite SDK مراجعه کنید.
24.0.0 2025-02-24
  • شکستن تغییرات:
    • حداقل سطح API Android را به 23 افزایش داد.
    • SDK دیگر پارامترهای اضافی ارسال شده از طریق addNetworkExtrasBundle() را به عنوان پارامترهای هدفمند سفارشی به Ad Manager ارسال نمی کند. برای تنظیم هدف گذاری سفارشی، به جای آن addCustomTargeting() استفاده کنید. برای اطلاعات بیشتر، هدف گذاری سفارشی را ببینید.
    • همه API های مربوط به قالب تبلیغات بین اسکرولر حذف شد.
    • APIهای جهت یابی AppOpenAd منسوخ شده حذف شدند.
    • کلاس های SearchAdView و DynamicHeightSearchAdRequest حذف شدند.
  • وابستگی SDK پلتفرم پیام‌رسانی کاربر به نسخه 3.1.0 به‌روزرسانی شد.
  • بهینه سازی مقداردهی اولیه و بارگیری آگهی اکنون در دسترس است و به طور پیش فرض فعال است.
  • MediationRewardedAdCallback.onUserEarnedReward() و MediationRewardedAdCallback.onUserEarnedReward(RewardItem) منسوخ شده اضافه شد. آداپتورهای میانجی باید برای استفاده از روش جدید به روز شوند.
  • برچسب ویژگی android.adservices.AD_SERVICES_CONFIG را از فایل مانیفست SDK حذف کرد تا از تداخل ادغام برنامه‌هایی که سرویس‌های تبلیغاتی مخصوص API را پیکربندی می‌کنند جلوگیری کند.
23.6.0 2024-12-03
  • تمام APIهای مربوط به قالب تبلیغات بین اسکرولر منسوخ شد. به عنوان مثال، AdSize.getCurrentOrientationInterscrollerAdSize() .
23.5.0 2024-10-29
  • پیام‌های Logcat شکست بار آگهی به‌روزرسانی شده در نسخه 23.4.0 از سطح خطا به سطح اطلاعات معرفی شدند.
  • بهبود درآمدزایی از تبلیغات شخصی سازی شده در تب های سفارشی برای WebView API برای تبلیغات.
23.4.0 2024-09-30
  • خرابی های بارگذاری آگهی اکنون یک پیام logcat را فراخوانی می کند که می گوید ad failed to load . ردیابی پشته این پیام را به عنوان یک خطا ثبت می کند، اما به معنی خرابی نیست. برای تفسیر خرابی‌های رایج بارگیری آگهی ، پیام‌های ثبت خطای رایج اشکال زدایی را بررسی کنید. اگر خطای مکرر مربوط به ارائه آگهی را مشاهده کردید که مستند نیست، ردیابی پشته را با پشتیبانی Google Mobile Ads SDK به اشتراک بگذارید.
  • متدهای addCustomTargeting() به AdRequest اضافه کرد.
23.3.0 2024-08-12
  • وابستگی SDK پلتفرم پیام‌رسانی کاربر به نسخه 3.0.0 به‌روزرسانی شد.
23.2.0 2024-06-27
  • AdView.isCollapsible() اضافه شد تا نشان دهد آیا آخرین بنر بارگذاری شده قابل جمع شدن است یا خیر.
23.1.0 2024-05-09
  • به حداقل compileSdkVersion 34 نیاز دارد.
  • آداپتورهای Native Mediation : loadNativeAd و loadRtbNativeAd() منسوخ شده به نفع loadNativeAdMapper() و loadRtbNativeAdMapper() . آداپتورها باید به استفاده از این روش‌های بارگذاری جدید و اشیاء مرتبط مهاجرت کنند.
23.0.0 2024-03-07
  • شکستن تغییرات:
    • حداقل سطح API Android را به 21 افزایش داد.
    • برای ادامه جمع‌آوری معیارهای کاربر در AdMob ، برنامه AdMob خود را به Firebase پیوند دهید و Google Analytics برای 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() را برای بهبود درآمدزایی برای تبلیغات در تب های سفارشی اضافه می کند. برای اطلاعات بیشتر به بهینه سازی برگه های سفارشی مراجعه کنید.
  • وابستگی SDK پلتفرم پیام‌رسانی کاربر به نسخه 2.2.0 به‌روزرسانی شد.
22.6.0 2023-12-06
  • MobileAds.setSameAppKeyEnabled() منسوخ شد و نام متد را به MobileAds.putPublisherFirstPartyIdEnabled() تغییر داد.
  • منسوخ شده AdFormat.UNKNOWN بدون جایگزینی. برنامه‌هایی که از QueryInfo.generate() استفاده می‌کنند باید یک قالب تبلیغاتی داشته باشند.
22.5.0 2023-10-30
22.4.0 2023-09-13
  • به حداقل compileSdkVersion 33 نیاز دارد.
  • Ad inspector: پشتیبانی از SDK برای درخواست و نمایش تبلیغات درخواست شده از طریق Ad Inspector UI اضافه شده است.
  • یک روش QueryInfo.generate() جدید اضافه کرد که شناسه واحد تبلیغات را می گیرد.
  • آزمایش اولیه Attribution Reporting Beta و Topics Beta را برای حفظ حریم خصوصی فعال می‌کند. برای اطلاعات بیشتر به راهنمای Ad Manager Privacy Sandbox در Android مراجعه کنید.
22.3.0 2023-08-22
  • پشتیبانی برای ایجاد اندازه‌های تطبیقی ​​با استفاده از AdSize.FULL_WIDTH به عنوان عرض اضافه شد. قبلاً، اندازه‌های آگهی ایجاد شده با استفاده از AdSize.FULL_WIDTH به عنوان AdSize.SMART_BANNER تلقی می‌شد.
22.2.0 2023-07-05
22.1.0 2023-05-18
  • Ad inspector: قابلیت فعال کردن درخواست‌های آگهی از رابط کاربری بازرس آگهی در دستگاه‌هایی که خدمات Google Play ندارند.
22.0.0 2023-03-29
  • شکستن تغییرات:
    • 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 منسوخ شده است.
21.5.0 2023-01-31
  • App Open Ads: متدهای AppOpenAd.load() منسوخ شده که یک پارامتر ورودی جهت را می پذیرند و متدهای جدیدی اضافه می کنند که ورودی جهت گیری نمی گیرند. روش‌های جدید جهت‌گیری را در زمان درخواست تعیین می‌کنند و با رفتار سایر قالب‌های تمام صفحه مطابقت دارند.
  • میانجیگری: پشتیبانی میانجیگری برای تبلیغات باز برنامه اضافه شده است.
  • مجوز RECEIVE_BOOT_COMPLETED از وابستگی androidx.work:work-runtime حذف شد. اگر از نسخه‌های Gradle قدیمی‌تر از 7.2.0 استفاده می‌کنید و برای برنامه خود به مجوز نیاز دارید، ممکن است لازم باشد مجوز را به صراحت در مانیفست Android خود اعلام کنید.
21.4.0 2022-12-14
  • شناسه برنامه Ad Manager اکنون برای همه برنامه‌های Ad Manager لازم است و به قالب ca-app-pub-################~########## نیاز دارد. برای جزئیات بیشتر به پیکربندی برنامه خود مراجعه کنید.
  • بازرس آگهی: پشتیبانی SDK را برای نمایش تبلیغات بنری و تبلیغات بومی درخواست شده از طریق رابط کاربری بازرس آگهی گسترش دهید.
  • پشتیبانی از شناسه شخص اول Publisher (که قبلاً به عنوان کلید برنامه مشابه شناخته می‌شد) اضافه شد تا به شما کمک کند با استفاده از داده‌های جمع‌آوری‌شده از برنامه‌هایتان، تبلیغات مرتبط‌تر و شخصی‌شده‌تری ارائه دهید.
  • نسخه رسمی انتشار برای نسل QueryInfo .
21.3.0 2022-10-10
21.2.0 2022-09-06
  • بازرس آگهی: پشتیبانی از SDK برای صادر کردن گزارش‌های درخواست آگهی از طریق اشتراک‌گذاری Android اضافه شد.
21.1.0 2022-07-14
  • پشتیبانی برای کسب درآمد از تبلیغات در WebView اضافه شده است. برای جزئیات بیشتر به ادغام WebView API برای تبلیغات مراجعه کنید.
  • getResponseExtras() را به ResponseInfo اضافه کرد که ممکن است اطلاعات اضافی در مورد پاسخ آگهی را بازگرداند.
21.0.0 2022-05-25
  • شکستن تغییرات:
    • Google Mobile Ads SDK اکنون برای اجرا به همه برنامه‌ها نیاز دارد که حداقل در سطح Android API 19 باشند.
    • حاشیه‌نویسی‌های @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()
  • پشتیبانی از رویدادهای سفارشی در بازرس آگهی اضافه شده است.
20.6.0 2022-02-22
20.5.0 2021-11-18
  • پشتیبانی از دستگاه‌های Android 12 برای برنامه‌های هدفمند API 31 اضافه شده است.
  • پشتیبانی از شناسه مجموعه برنامه برای موارد استفاده مانند گزارش دهی و جلوگیری از کلاهبرداری اضافه شده است.
20.4.0 2021-09-22
  • از نسخه 20.4.0، Google Mobile Ads SDK شامل مجوز com.google.android.gms.permission.AD_ID در مانیفست SDK است که به‌طور خودکار با ابزارهای ساخت Android در مانیفست برنامه ادغام می‌شود. برای کسب اطلاعات بیشتر درباره اعلامیه مجوز AD_ID ، از جمله نحوه غیرفعال کردن آن، به این مقاله راهنمای کنسول Play مراجعه کنید.
  • پاسخ تماس onAdClicked() را به FullScreenContentCallback اضافه کرد.
  • پاسخ تماس onAdClicked() را در کلاس AdListener برای قالب تبلیغات بومی فعال کرد.
20.3.0 2021-08-23
20.2.0 2021-06-08
  • پشتیبانی بازرس آگهی (بتا) برای ناشران Google Ad Manager اضافه شد.
20.1.0 2021-04-29
20.0.0 2021-04-05
  • شکستن تغییرات:
    • API Interstitial قدیمی حذف شد.
    • API قدیمی RewardedVideoAd حذف شد.
    • کلاس های حذف شده با پیشوند Publisher (به عنوان مثال: PublisherAdView ).
    • CustomRenderedAd حذف شد.
    • InstreamAd حذف شد.
    • SearchAdRequest حذف شد.
    • AdListener.onAdLeftApplication() حذف شد.
    • NativeAppInstallAd ، NativeContentAd ، و UnifiedNativeAd حذف شد. اکنون یک قالب تبلیغاتی بومی به نام NativeAd وجود دارد.
    • RewardedAd اکنون یک کلاس انتزاعی است. از روش استاتیک RewardedAd.load() برای بارگذاری یک تبلیغ پاداش استفاده کنید.
  • AdSize.SMART_BANNER به نفع تبلیغات بنری تطبیقی ​​منسوخ شد.
  • حاشیه‌نویسی‌های صریح پوچ‌پذیری در همه APIهای عمومی اضافه شده است.
19.8.0 2021-03-15
  • یک وابستگی به SDK پلتفرم پیام‌رسانی کاربر اضافه شد.
  • پاسخ تماس onAdImpression() را به FullScreenContentCallback اضافه کرد.
  • قالب InstreamAd منسوخ شده است.
  • آداپتورهای میانجیگری:
    • MediationBannerAdapter ، MediationInterstitialAdapter ، و MediationNativeAdapter منسوخ شده است. آداپتورهای جدید باید کلاس Adapter را برای بارگذاری این فرمت ها پیاده سازی کنند.
    • آداپتورهای مناقصه اکنون می توانند روش های بارگذاری مجزا را در کلاس Adapter برای فرمت های خاص RTB پیاده سازی کنند.
19.7.0 2021-01-20
  • تغییرات عمده در:
    • InterstitialAd
    • RewardedAd
    • NativeAd
    • AppOpenAd
  • CustomRenderedAd منسوخ شده است.
  • کلاس ها و بسته های دارای پیشوند Publisher منسوخ شده و با پیشوند AdManager جایگزین شده اند.
  • آخرین نسخه جزئی قبل از نسخه 20.0.0. همه APIهایی که در این نسخه و نسخه‌های قبلی به‌عنوان منسوخ علامت‌گذاری شده‌اند، در نسخه 20.0.0 حذف خواهند شد. برای جزئیات بیشتر به راهنمای مهاجرت نسخه 20.0.0 مراجعه کنید.
19.6.0 2020-12-04
  • متد onAdLeftApplication() AdListener منسوخ شد.
  • رفع اشکالی که در آن از کاربران دستگاه‌های اندروید 11 خواسته می‌شود هنگام کلیک کردن بر روی تبلیغ، مرورگری را انتخاب کنند.
19.5.0 2020-10-20
19.4.0 2020-09-10
  • پشتیبانی از دستگاه‌های Android 11 برای برنامه‌های هدفمند API 30 اضافه شده است.
  • تبلیغات باز برنامه: قالب AppOpenAd را تغییر داد تا بیشتر شبیه فرمت تمام صفحه باشد تا نمای بنر. متدهای getResponseInfo() و show() به AppOpenAd اضافه شد. کلاس های AppOpenAdView و AppOpenAdPresentationCallback منسوخ شده است.
  • میانجیگری: گزارش وضعیت میانجیگری اکنون در دسترس است. از ResponseInfo.getAdapterResponses() برای دریافت اطلاعات پاسخ برای هر شبکه تبلیغاتی که در درخواست تبلیغات شرکت کرده است استفاده کنید.
  • تبلیغات دارای پاداش قدیمی: منسوخ شده RewardedVideoAd .
  • قالب RewardedInterstitialAd اضافه شد که در حال حاضر در نسخه بتا خصوصی است.
  • رفع اشکالی که در آن MobileAds.initialize() فقط یک بار کنترل کننده تکمیل را فراخوانی می کند. هر تماس با MobileAds.initialize() اکنون پاسخ تماس تکمیلی را فراخوانی می کند.
19.3.0 2020-07-20
  • متدهای getDomain() و getCause() را به AdError اضافه کرد.
  • به همه قالب‌های تبلیغاتی که LoadAdError برمی‌گردانند، تماس‌های شکست بار جدید اضافه شد. به عنوان مثال، onAdFailedToLoad(LoadAdError) .
  • بازخوانی های شکست بار منسوخ شده که یک int برمی گرداند. به عنوان مثال، onAdFailedToLoad(int) .
  • تبلیغات پاداش: در onRewardedAdFailedToShow(AdError) اضافه شد و onRewardedAdFailedToShow(int) منسوخ شد.
  • میانجیگری پاداش: کد خطای ارائه MEDIATION_SHOW_ERROR اضافه شد. همه خطاهای ارائه مربوط به تبلیغات واسطه‌ای اکنون MEDIATION_SHOW_ERROR را برای AdError.getCode() و یک AdError.getCause() نشان دهنده خطای میانجیگری است.
19.2.0 2020-06-18
  • تبلیغات بومی: یک واسط اعتبارسنجی بومی در درخواست‌های آزمایشی اضافه شد تا به شما کمک کند نقض خط‌مشی‌های بومی را پیدا کرده و رفع کنید.
  • متد MobileAds.disableMediationAdapterInitialization() اضافه شد. برای غیرفعال کردن مقداردهی اولیه آداپتور میانجی، قبل از مقداردهی اولیه Google Mobile Ads SDK، این روش را فراخوانی کنید.
19.1.0 2020-04-16
19.0.1 2020-03-18
  • تبلیغات بومی: رفع نشت حافظه که هنگام استفاده از NativeCustomTemplateAd رخ داد.
19.0.0 2020-03-02
  • پشتیبانی برای خواندن پارامترهای رضایت از IAB TCF نسخه 2.0 و رشته IAB us_privacy اضافه شده است.
  • setNeighboringContentUrls() و getNeighboringContentUrls() به AdRequest اضافه شد.
  • کلاس ResponseInfo اضافه شد که اطلاعاتی در مورد یک تبلیغ بارگذاری شده ارائه می دهد.
  • برای همه قالب‌های تبلیغاتی، getMediationAdapterClassName() را به نفع getResponseInfo() منسوخ کرد.
  • تبلیغات بومی: متدهای getDuration() و getCurrentTime() به MediaContent اضافه شد.
  • Native Mediation: متدهای getDuration() و getCurrentTime() را به UnifiedNativeAdMapper اضافه کرد تا آداپتورها آن را پیاده سازی کنند.
  • AdRequest.Builder.addTestDevice() منسوخ شد. به جای آن RequestConfiguration.Builder.setTestDeviceIds() استفاده کنید.
18.3.0 2019-11-05
  • APIهایی برای قالب تبلیغات InstreamAd اضافه شده است. این ویژگی در حال حاضر در نسخه بتا خصوصی است. برای درخواست دسترسی با مدیر حساب خود تماس بگیرید.
  • Adaptive Banner : روش های ایجاد بنر تطبیقی ​​را در کلاس AdSize تغییر داد. برای مثال، AdSize.getCurrentOrientationBannerAdSizeWithWidth() را به AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize() تغییر نام داد.
  • میانجیگری : Google Mobile Ads SDK اکنون استثناهایی را که توسط آداپتورهای میانجی ایجاد می‌شود، می‌گیرد.
  • میانجی‌گری با پاداش : اشکالی را برطرف کرد که در آن اگر چندین آگهی پاداش‌دار با واسطه ذخیره شوند، فقط یکی نشان داده می‌شود.
  • روش setTestDeviceIds() را برای فعال کردن تنظیم دستگاه های آزمایشی یک بار برای همه درخواست های تبلیغاتی اضافه کرد.
18.2.0 2019-08-29
  • API های اضافه شده برای قالب AppOpenAd . این ویژگی در حال حاضر در نسخه بتا خصوصی است. برای درخواست دسترسی با مدیر حساب خود تماس بگیرید.
18.1.1 2019-07-23
  • میانجی‌گری : وقتی برنامه‌ها با MobileAds.initialize(Context, OnInitializationCompleteListener) تماس می‌گیرند، آداپتورها اکنون راه‌اندازی می‌شوند.
  • میانجی‌گری : استثناهای آداپتورهایی که ردپای پشته‌شان شامل SDK تبلیغات موبایلی Google است، اکنون توسط Google Mobile Ads SDK شناسایی و مدیریت می‌شود.
18.1.0 2019-07-09
  • انتشار رسمی برای پشتیبانی از App Measurement.
  • یک روش اولیه جدید اضافه شد، 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 . برنامه ها دیگر نیازی به افزودن این وابستگی ها به صراحت ندارند.
18.0.0 2019-06-17
  • مهاجرت از کتابخانه های پشتیبانی اندروید به کتابخانه های Jetpack (AndroidX). برای اطلاعات بیشتر به یادداشت‌های انتشار خدمات Google Play مراجعه کنید.
  • برای جلوگیری از خرابی در اولین راه‌اندازی پس از نصب برنامه از پلی استور، این نسخه از ناشران می‌خواهد وابستگی‌های اضافی را در build.gradle خود اعلام کنند: 
    com.google.android.gms:play-services-measurement:17.0.0
com.google.android.gms:play-services-measurement-sdk:17.0.0
17.2.1 2019-05-21
  • رفع ANR از android.media.AudioManager.getStreamVolume .
17.2.0 2019-03-11
  • ویدیوی با پاداش: مجموعه جدیدی از 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 استفاده کنند.
17.1.3 2019-01-31
  • ناشرانی که از firebase-analytics همراه با نسخه 17.1.3 هر یک از کتابخانه تبلیغات استفاده می کنند (به عنوان مثال، com.google.android.gms:play-services-ads:17.1.3 ) باید از com.google.firebase:firebase-analytics:16.3.0 استفاده کنند.
17.1.2 2018-12-03
  • ناشرانی که از firebase-analytics همراه با نسخه 17.1.2 هر یک از کتابخانه تبلیغات استفاده می کنند (به عنوان مثال، com.google.android.gms:play-services-ads:17.1.2 ) باید از com.google.firebase:firebase-analytics:16.0.6 استفاده کنند.
17.1.1 2018-11-12
  • رفع اشکالی که در آن ترکیب‌های خاصی از 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 استفاده کنند.
17.1.0 2018-11-02
17.0.0 2018-10-05
  • ناشران Google Ad Manager باید یک برچسب <meta-data> با کلید com.google.android.gms.ads.AD_MANAGER_APP در AndroidManifest.xml خود تعیین کنند. برای جزئیات بیشتر به راهنمای شروع کار مراجعه کنید.
  • تبلیغات بومی: NativeAppInstallAd ، NativeContentAd ، و APIهای مرتبط به نفع UnifiedNativeAd منسوخ شده‌اند. برای دستورالعمل های بیشتر در مورد استفاده از API های جدید به Native Ads Advanced Unified مراجعه کنید.
  • تبلیغات بومی: ویژگی «بی‌صدا کردن این آگهی» اضافه شد.
  • تبلیغات بومی: گزارش هشدار خوش‌خیم: «تا زمانی که ClickConfirmingView تنظیم شده است، UnconfirmedClickListener نباید پوچ باشد». حذف شده است.
  • Rewarded Ads: روش setAdMetadataListener را در RewardedVideoAd اضافه کرد تا تغییرات فراداده تبلیغات را بشنوید.
  • تبلیغات پاداش: فراخوانی destroy() شنونده را باطل می کند.
  • روش‌های زیر را درAdRequest.Builder منسوخ کرد.
  • رفع اشکالی که در آن onRewardedVideoCompleted() روی شبیه سازها شلیک نمی کرد.
16.0.0 2018-10-02
15.0.0 2018-04-12
  • نسخه بتای MRAID v3.
  • تبلیغات بومی: API یکپارچه تبلیغات بومی را اضافه کرد. این NativeAppInstallAds و NativeContentAds را در یک نوع جدید ترکیب می‌کند: UnifiedNativeAd .
  • توجه: هنگام استفاده از تبلیغات بومی، یک هشدار خوش‌خیم وجود دارد که با کلیک بر روی تبلیغ بومی در گزارش‌ها نشان داده می‌شود: " UnconfirmedClickListener نباید تا زمانی که ClickConfirmingView تنظیم شده است پوچ باشد. " این هشدار را می‌توان نادیده گرفت و در نسخه بعدی حذف خواهد شد.
12.0.1 2018-03-28
12.0.0 2018-03-20
  • ویدیوی پاداش: روش پاسخ به تماس onRewardedVideoCompleted() را به RewardedVideoAdListener اضافه کرد.
  • Native mediation: متد trackViews() را به NativeAdMapper اضافه کرد که به آداپتورها امکان دسترسی به View اشیاء مربوط به دارایی‌های تبلیغاتی بومی را می‌دهد. trackView() به نفع trackViews() منسوخ شد.
11.8.0 2017-12-18
  • رفع اشکال و بهبودهای کلی.
11.6.0 2017-11-07
  • کلاس NativeAdViewHolder و متدهای مرتبط را در NativeAppInstallAd و NativeContentAd اضافه کرد.
  • AdLoader.getMediationAdapterClassName منسوخ شده است (ناشران باید در عوض از روش‌هایی با همین نام در NativeAppInstallAd و NativeContentAd استفاده کنند).
  • اکنون تبلیغات آزمایشی یک برچسب در بالای آگهی نشان می دهد. برای جزئیات بیشتر به راهنمای تست مراجعه کنید.
11.4.0 2017-09-19
  • متدهای getMediationAdapterClassName() را به کلاس‌های NativeAppInstallAd و NativeContentAd اضافه کرد. روشی با همین نام در AdLoader منسوخ خواهد شد.
  • یک متد onVideoEnd() به کلاس MediationNativeListener ، متدهای hasVideoContent() , setHasVideoContent() و setMediaView() به کلاس NativeAdMapper و متدهای getAdVolume() و isAdMuted() به NativeMediationAdRequest video class support toAdd.
  • کلاس SearchAdRequest حذف شد.
11.2.2 2017-09-05
  • یک متد loadAd() جدید اضافه کرد که یک شی PublisherAdRequest را به کلاس RewardedVideoAd می برد.
11.2.0 2017-08-14
  • متد loadAds() را به کلاس AdLoader اضافه کرد که به برنامه‌ها اجازه می‌دهد چندین آگهی منحصربه‌فرد را در یک درخواست بارگیری کنند.
  • هنگامی که برنامه خود را به نسخه 11.2.0 یا بالاتر از Google Mobile Ads SDK ارتقا می دهید، build.gradle برنامه شما نیز باید به روز شود تا compileSdkVersion حداقل 26 (Android O) مشخص شود. این روش اجرای برنامه شما را تغییر نمی دهد. شما نیازی به به روز رسانی targetSdkVersion ندارید.
  • با شروع نسخه 11.2.0، Google Mobile Ads SDK از طریق مخزن Maven Google در دسترس است. برای اطلاعات بیشتر، به یادداشت‌های انتشار خدمات Google Play مراجعه کنید.
11.0.0 2017-06-07
  • متدهای onAdClicked() و onAdImpression() را به کلاس AdListener اضافه کرد. این روش‌ها فقط برای نصب برنامه بومی و تبلیغات محتوای بومی استفاده می‌شوند.
  • متدهای getInAppPurchaseListener() و setInAppPurchaseListener() را از کلاس‌های AdView ، InterstitialAd ، و NativeExpressAdView حذف کرد. همچنین کلاس‌های خرید درون‌برنامه مرتبط حذف شد.
  • متدهای OnVideoMute() ، OnVideoPause() ، OnVideoPlay() و OnVideoStart() را به کلاس VideoController.VideoLifecycleCallbacks اضافه کرد.
  • با افزودن متد setImmersiveMode() به کلاس‌های PublisherInterstitialAd و RewardedVideoAd ، قابلیت فعال کردن حالت غوطه‌وری در تبلیغات تمام صفحه را اضافه کرد.
  • رابط OnPublisherAdViewLoadedListener ، کلاس PublisherAdViewOptions و کلاس PublisherAdViewOptions.Builder را برای استفاده با AdLoader برای درخواست‌های Native-plus-banner اضافه کرد.
  • رابط اختیاری OnImmersiveModeUpdatedListener اضافه شده است که آداپتورهای واسطه می توانند برای اطلاع از به روز رسانی های حالت همهجانبه پیاده سازی کنند.
  • متد getMediationAdapterClassName() را به کلاس RewardedVideoAd اضافه کرد.
  • قوانین keep را برای حفظ خودکار نام کلاس های آداپتور میانجی هنگام استفاده از ProGuard اضافه کرد.
10.2.0 2017-2-15
  • Google Play Services 10.2.x اولین نسخه ای است که دیگر از نسخه 2.3.x اندروید (Gingerbread) پشتیبانی کامل نمی کند. برنامه‌هایی که با استفاده از نسخه SDK نسخه 10.2.x و نسخه‌های بعدی توسعه یافته‌اند به حداقل سطح API Android 14 نیاز دارند و نمی‌توان آنها را روی دستگاه‌هایی که سطح API کمتر از 14 دارند نصب کرد. برای اطلاعات بیشتر درباره گزینه‌های خود، از جمله ساختن چندین APK برای گسترش پشتیبانی برنامه‌تان از Android Gingerbread، به وبلاگ برنامه‌نویسان Android مراجعه کنید.
  • پشتیبانی از دارایی های ویدیویی برای محتوای پیشرفته بومی و تبلیغات قالب سفارشی اضافه شده است.
  • متدهای getVideoController() ، setVideoOptions() و getVideoOptions() را به کلاس PublisherAdView اضافه کرد.
  • کلاس AdChoicesView اضافه شد.
  • متدهای getAdChoicesContent() و setAdChoicesContent() را به کلاس NativeAdMapper اضافه کرد.
  • رابط InitializableMediationRewardedVideoAdAdapter را برای آداپتورهای واسطه ویدیویی پاداش داده شده که می‌خواهند قبل از درخواست آگهی، در شروع اولیه شرکت کنند، اضافه شد.
  • پشتیبانی برای پیش‌نمایش درون‌برنامه و عیب‌یابی در Google Ad Manager اضافه شده است.
10.0.1 2016-11-21
  • رفع اشکال و بهبودهای کلی.
9.8.0 2016-10-24
  • MobileAds.Initialize(Context) منسوخ نشده است. ناشران Google Ad Manager باید این روش را هنگام تنظیم اولیه برنامه های خود فراخوانی کنند. ناشران AdMob باید همچنان از MobileAds.Initialize(Context, String) استفاده کنند و کد برنامه خود را ارسال کنند.
9.6.0 2016-09-22
  • کلاس MediaView را برای تبلیغات ویدیویی پیشرفته Native Ads اضافه کرد.
  • یک متد openDebugMenu() به کلاس MobileAds برای پیش‌نمایش خلاقانه و عیب‌یابی واحدهای تبلیغاتی Ad Manager اضافه کرد.
  • پشتیبانی از رویدادهای سفارشی ویدیویی با پاداش اضافه شده است.
9.4.0 2016-08-01
  • رفع اشکال و بهبودهای کلی.
9.2.0 2016-06-27
  • متد setAdChoicesPlacement() را به کلاس NativeAdOptions.Builder اضافه کرد که ناشران برنامه اکنون می توانند از آن برای تعیین مکان AdChoices خود در تبلیغات بومی استفاده کنند.
  • پخش تبلیغات ویدیویی با رفع چندین اشکال بهبود یافته است.
9.0.1 2016-05-26
  • مشکل ProGuard معرفی شده در 9.0.0 را حل می کند. ناشران دیگر نیازی به گزینه keep برای com.google.android.gms.common.util.DynamiteApi ندارند.
9.0.0 2016-05-18
  • جمع‌بندی خودکار اطلاعات مکان برای برنامه‌هایی که صراحتاً مجوز مکان را می‌دهند، اضافه شد.
  • پشتیبانی از رویدادهای سفارشی واسطه‌گری ویدیوی پاداش اضافه شد.
  • گزینه های ویدیویی برای تبلیغات Native Express اضافه شده است.
  • API تبلیغات جستجوی سفارشی به‌روزرسانی شد.
  • متد setAppMuted() اضافه شد.
  • روش MobileAds.initialize(android.content.Context, java.lang.String) دیگر منسوخ نشده است.
  • روش MobileAds.initialize(android.content.Context) اکنون منسوخ شده است.
  • متد MediationNativeListener.onAdImpression() را برای گزارش نمایش در آداپتورهای میانجی اضافه کرد.
  • فقط برای این نسخه ، برنامه‌هایی که از ProGuard برای پس‌پردازش برنامه‌شان استفاده می‌کنند، باید گزینه keep زیر را به فایل پیکربندی ProGuard خود اضافه کنند:

    -keep public @com.google.android.gms.common.util.DynamiteApi class * { *; }
8.4.0 2015-12-18
  • یک روش عمومی، MobileAds.setAppVolume() اضافه کرد تا Google Mobile Ads SDK را از سطح صدای فعلی برنامه مطلع کند.
  • رفع اشکال و بهبودها.
8.3.0 2015-11-6
  • پشتیبانی از تبلیغات ویدیویی با پاداش اضافه شده است.
  • یک متد isLoading() به PublisherAdView و PublisherInterstitialAd اضافه کرد تا بررسی کند که آیا درخواست تبلیغات در حال انجام است یا خیر.
  • متد setIsDesignedForFamilies() را به AdRequest.Builder و PublisherAdRequest.Builder اضافه کرد.
  • یک متد destroy() struct به NativeAdView اضافه کرد.
8.1.0 2015-09-24 رفع اشکال مختلف
7.8.0 2015-08-13
  • نسخه رسمی انتشار MRAID v2.
  • یک روش isLoading() به AdLoader ، AdView و InterstitialAd اضافه شده است تا بررسی کند که آیا درخواست AD در حال انجام است یا خیر.
  • PublisherAdRequest.Builder#setManualImpressionsEnabled() . به جای آن از PublisherAdView#setManualImpressionsEnabled() استفاده کنید.
7.5.0 2015-05‑28
  • پشتیبانی برای نصب برنامه و قالبهای تبلیغاتی بومی در Admob و Ad Manager اضافه شده است.
  • پشتیبانی اضافه شده برای قالب های تبلیغاتی بومی سفارشی ، برای رزرو مدیر تبلیغات در دسترس است.
7.3.0 2015-04‑28 رفع اشکال مختلف
7.0.0 2015-03-19
  • روشهای افزودنی اضافه addCustomTargeting() و addCategoryExclusion() روشها را به PublisherAdRequest.Builder .
  • مسئله ای را که باعث PublisherAdView.recordManualImpression() در هنگام استفاده از شمارش برداشت دستی ، چندین برداشت را در مدیر تبلیغ ثبت کرد.
  • مسئله ای را که باعث می شود تبلیغات هنگام استفاده از android:largestWidthLimitDp ویژگی WromeStHlimitDP در برچسب <supports-screens> .
  • روش setRequestAgent() به AdRequest.Builder و PublisherAdRequest.Builder اضافه کرد. این روش باید برای بیان منشأ درخواست آگهی توسط اشخاص ثالث که واسطه Google Mobile ADS SDK هستند ، استفاده شود.
6.5.87 2014‑12-08
  • معماری JAR Split Architecture-Android Studio Developers اکنون فقط می تواند قسمت تبلیغات خدمات Google Play را بسته به com.google.android.gms: play‑services‑ads :6.+ .
    توجه: برنامه هایی که تبلیغات بنر را در XML ایجاد می کنند ، هنوز هم باید به کل کتابخانه com.google.android.gms: play‑services :6.+ .
  • رفع اشکال مختلف
6.1 2014—0808
  • یک روش getLocation() به com.google.android.gms.ads.MediationAdRequest اضافه کرد.
  • توضیحات محتوا را برای دسترسی به دکمه بستن بینابینی اضافه کرد.
  • هنگام پیوند صحیح پروژه کتابخانه ، ورود به سیستم "Google Play Resources یافت نشد".
  • اضافه شده getMediationAdapterClassName() به AdView برای دریافت نام کلاس آداپتور واسطه گری شبکه تبلیغاتی که در حال حاضر یک تبلیغ را نشان می دهد.
5.0 2014‑06‑25
  • API های جدید برای اجرای رویدادهای سفارشی اضافه شده است.
  • با استفاده از API صورتحساب Google Play ، جریان خرید پیش فرض را برای خرید درون برنامه اضافه کرد.
4.4 2014-05‑07
  • API های آداپتور میانجیگری جدید اضافه شده است.
  • فرمت تبلیغاتی جدید 320x100 LARGE_BANNER برای هر دو تلفن و قرص اضافه شده است.
  • فرمت بینابینی جدید برای خرید درون برنامه اضافه شده است. برای گوش دادن به رویدادهای خرید درون برنامه ، یک InAppPurchaseListener روی InterstitialAd تنظیم کنید.
  • رفع اشکال برای SecurityException Crash به دلیل خواندن gservice بدون اجازه.
4.3 2014-03-17
  • در صورت تصویب یک زمینه کاربردی ، InterstitialAd اکنون کار می کند.
  • روش setContentUrl() را به PublisherAdRequest.Builder اضافه کرد.
  • هنگام ثبت نام سرویس ، استثنا را برطرف کنید.
4.2 2014‑02‑03 رفع اشکال مختلف
4.1 2014‑01-16
  • پشتیبانی از مدیر تبلیغات و تبلیغات جستجو برای برنامه های تلفن همراه اضافه شده است.
  • AdRequest.Builder اکنون یک روش setLocation() دارد.
  • در صورت درخواست یک آگهی بینابینی ، تصادف که رخ داده است ، برطرف شده است اما در مانیفست AdActivity مشخص نشده است.
4.0 2013-10-31
  • API های تبلیغاتی Google Mobile اکنون بخشی از خدمات Google Play هستند.
  • به روزرسانی های آینده API های تبلیغات Google Mobile به طور خودکار از طریق خدمات Google Play به دستگاه ها منتقل می شوند.
  • مدیر تبلیغات و تبلیغات جستجو برای برنامه های تلفن همراه هنوز پشتیبانی نشده است.