کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل (Google Mobile Ads SDK) در حالت تعمیر و نگهداری است. برای دریافت آخرین به‌روزرسانی‌ها و ویژگی‌ها، کیت توسعه نرم‌افزاری نسل بعدی GMA رامنتقل و راه‌اندازی کنید.
Google برای ترجمه محتوا به زبان ترجیحی شما از فناوری هوشواره استفاده می‌کند. ترجمه‌های هوشواره‌ای ممکن است اشتباه داشته باشند.
یادداشتهای نشر
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
نسخه
تاریخ انتشار
یادداشت‌ها
25.5.0
۲۰۲۶-۰۹-۱۷
حداقل سطح Android API به ۲۴ افزایش یافت.
onInitializationFailed() به InitializationCompleteCallback اضافه شد. اکنون آداپتورهای میانجی‌گری خطاهای مقداردهی اولیه کیت توسعه نرم‌افزار طرف سوم را با کد خطا، حوزه خطا، و پیام خطا به «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» گزارش می‌کنند.
هنگام استفاده از میانجی‌گری با منابع آگهی رویداد سفارشی، ResponseInfo.getAdapterClassName() اکنون به‌جای com.google.ads.mediation.customevent.CustomEventAdapter، نام کلاس رویداد سفارشی شما را برمی‌گرداند.
25.4.0
۲۰۲۶-۰۶-۱۷
رفع اشکال‌ها و بهبود عملکرد.
25.3.0
۲۰۲۶-۰۵-۲۱
روش setAgeRestrictedTreatment() را در RequestConfiguration.Builder اضافه کرد و setTagForChildDirectedTreatment() و setTagForUnderAgeOfConsent() را منسوخ کرد. از روش جدید برای پیکربندی درمان محدودشده براساس سن برای کاربران کودک و نوجوان استفاده کنید.
25.2.0
۲۰۲۶-۰۴-۱۳
رفع اشکال‌ها و بهبود عملکرد.
25.1.0
۲۰۲۶-۰۳-۱۶
اشکالی در بازرس آگهی برطرف شد که می‌توانست هنگام درخواست آگهی آزمایشی خارج از زمینه با نشانی وب محتوای خالی باعث بروز خطا شود.
25.0.0
۲۰۲۶-۰۲-۱۷
تغییرات ناگهانی:
کلاس VersionInfo را در بسته
com.google.android.gms.ads.mediation برداشت.
روش منسوخ‌شده getConfiguration() را در کلاس
RtbSignalData
برداشت.
روش‌های منسوخ‌شده onFailure(String) و
onAdFailedToShow(String) در کلاس‌های زیر برداشته شد:
کلاس NativeAdViewHolder را از بسته
com.google.android.gms.ads.nativead برداشت.
MIN_WIDTH_RATIO و
MIN_HEIGHT_RATIO از
MediationUtils
برداشته شد تا از آستانه‌های انعطاف‌پذیرتر برای مطابقت اندازه آگهی در میانجی‌گری
اندازه‌های آگهی پشتیبانی شود.
وابستگی «کیت توسعه نرم‌افزار پلاتفرم پیام‌رسانی کاربر» به نسخه ۴.۰.۰ به‌روزرسانی شد.
پشتیبانی از برنماهای تطبیقی لنگرشده بزرگ اضافه شد. برنماهای تطبیقی
بزرگ لنگرشده برای افزایش تعامل و درآمد طراحی شده‌اند.
بااستفاده از روش‌های زیر در کلاس
AdSize، درخواست برنمای تطبیقی لنگرشده بزرگ کنید:
ترجمه‌های ازدست‌رفته برای منابع «کیت توسعه نرم‌افزار» در نسخه‌های ۲۴.۶.۰ و
۲۴.۷.۰ اصلاح شد.
NativeAdViewHolder منسوخ شده است. به‌جای آن از NativeAdView
برای پرداز کردن آگهی‌های بومی استفاده کنید.
روش‌های AdPreloader.getConfigurations() و AdPreloader.getConfiguration(preloadId)
منسوخ شد. جایگزینی برای این روش‌ها وجود ندارد.
24.7.0
۲۰۲۵-۱۰-۰۹
حاشیه‌نویسی تهی‌پذیر ازدست‌رفته در نوع برگشتی برای
NativeCustomFormatAd.getDisplayOpenMeasurement() تصحیح شد.
عملکرد تغییر نکرده است، زیرا قابلیت روش برای برگرداندن مقدار تهی ازقبل انتظار می‌رفت.
وابستگی androidx.webkit:webkit از نسخه ۱.۱۴.۰ به نسخه ۱.۱۲.۱ تنزل داده شد تا سازگاری با افزایه Android Gradle نسخه ۷.۳.۱ حفظ شود.
24.6.0
۲۰۲۵-۰۹-۰۸
اکنون میانجی‌گری بومی می‌تواند NativeAdMapper.destroy()
را پیاده‌سازی کند تا وقتی آگهی بومی ازبین می‌رود اعلان دریافت کند.
24.5.0
۲۰۲۵-۰۷-۲۴
ناشرانی که به این ویژگی دسترسی دارند اکنون از شناسه جای آگهی برای همه قالب‌های آگهی پشتیبانی می‌کنند.
خرابی با پیام خطای Fatal Exception: java.util.ConcurrentModificationException برطرف شد.
24.4.0
۲۰۲۵-۰۶-۰۹
چندین API جدید برای پیش‌بار کردن آگهی اضافه شد و APIهای موجود منسوخ شدند.
پیش‌بار کردن آگهی همچنان یک ویژگی آلفای محدود است.
24.3.0
۲۰۲۵-۰۵-۱۹
وابستگی «کیت توسعه نرم‌افزار پلاتفرم پیام‌رسانی کاربر» به نسخه ۳.۲.۰ به‌روزرسانی شد.
24.2.0
۲۰۲۵-۰۴-۰۷
رفع اشکال‌ها و بهبود عملکرد.
24.1.0
۲۰۲۵-۰۳-۱۲
حداقل نسخه Kotlin اکنون ۲.۱.۰ است.
رفع اشکال‌ها و بهبود عملکرد.
play-services-ads-lite به آهنگ انتشار کاهش‌یافته‌ای منتقل می‌شود و با این انتشار توزیع نمی‌شود. برای اطلاعات بیشتر،
مستندات
کیت توسعه نرم‌افزار Lite را ببینید.
24.0.0
۲۰۲۵-۰۲-۲۴
تغییرات ناگهانی:
حداقل سطح «میانای برنامه‌سازی کاربردی Android» به ۲۳ افزایش یافت.
MediationRewardedAdCallback.onUserEarnedReward() اضافه شد
و MediationRewardedAdCallback.onUserEarnedReward(RewardItem) منسوخ شد.
کاربران میانجی‌گری باید برای استفاده از روش جدید به‌روزرسانی کنند.
برچسب دارایی android.adservices.AD_SERVICES_CONFIG
از فایل مانیفست کیت توسعه نرم‌افزار برداشته شد تا از تداخل ادغام برای برنامه‌هایی که
«پیکربندی خدمات آگهی ویژه API» را انجام می‌دهند جلوگیری شود.
23.6.0
۲۰۲۴-۱۲-۰۳
همه «میاناهای برنامه‌سازی کاربردی» مربوط به قالب آگهی بین پیمایشی را منسوخ کردیم. برای
مثال،
AdSize.getCurrentOrientationInterscrollerAdSize().
23.5.0
۲۰۲۴-۱۰-۲۹
پیام‌های logcat مربوط به خطای بار آگهی به‌روزشده که در نسخه ۲۳.۴.۰ از سطح خطا به سطح اطلاعات معرفی شده است.
بهبود درآمدزایی از آگهی‌های شخصی‌سازی‌شده در «برگه سفارشی» برای WebView
واسط برنامه‌سازی کاربردی برای آگهی‌ها.
23.4.0
۲۰۲۴-۰۹-۳۰
اکنون درصورت ناموفق بودن بار آگهی، پیام logcat با محتوای ad failed
to load در ردیابی پشته‌ای خرابی فراخوانی می‌شود. گزارش ردیابی پشته این پیام را به‌عنوان خطا ثبت می‌کند، اما به معنای خرابی نیست. برای تفسیر کردن خطاهای رایج در بار کردن آگهی، به عیب‌یابی پیام‌های گزارش‌گیری خطای رایج
مراجعه کنید. اگر خطای تکرارشونده‌ای
مرتبط با ارائه آگهی مشاهده کردید که مستند نشده است، ردپای پشته را با
پشتیبانی Google Mobile Ads SDK (Legacy) هم‌رسانی کنید.
وابستگی «کیت توسعه نرم‌افزار پلاتفرم پیام‌رسانی کاربر» به نسخه ۳.۰.۰ به‌روزرسانی شد.
23.2.0
۲۰۲۴-۰۶-۲۷
AdView.isCollapsible() اضافه شد
تا نشان دهد آیا آخرین برنمای بارشده جمع‌شدنی است یا خیر.
23.1.0
۲۰۲۴-۰۵-۰۹
حداقل compileSdkVersion آن باید ۳۴ باشد.
تبدیل‌های میانجی‌گری بومی: loadNativeAd
و loadRtbNativeAd() منسوخ شده‌اند و به‌جای آن‌ها از loadNativeAdMapper() و loadRtbNativeAdMapper() استفاده می‌شود.
تبدیل‌کننده‌ها باید به استفاده از این روش‌های بار جدید و
اشیاء مرتبط انتقال یابند.
23.0.0
۲۰۲۴-۰۳-۰۷
تغییرات ناگهانی:
حداقل سطح Android API به ۲۱ افزایش یافت.
برای ادامه جمع‌آوری سنجه‌های کاربر در AdMob،
برنامه AdMob خود را به Firebase پیوند دهید و «کیت توسعه نرم‌افزار Google Analytics برای
Firebase» را در برنامه‌تان ادغام کنید.
میانای برنامه‌سازی کاربردی MobileAds.enableSameAppKey() منسوخ‌شده را برداشتیم
و روش جایگزین MobileAds.putPublisherFirstPartyIdEnabled() را به‌روز کردیم
تا مقدار بولی درباره موفقیت‌آمیز بودن یا نبودن ماندگاری کنترل برگرداند.
Native Ads:
AdLoader.forUnifiedNativeAd() برداشته شد. درعوض از
AdLoader.forNativeAd() استفاده کنید.
AdLoader.forCustomTemplateAd() برداشته شد. درعوض از
AdLoader.forCustomFormatAd() استفاده کنید.
AdFormat.UNKNOWN بدون جایگزین برداشته شد. برنامه‌هایی که از
QueryInfo.generate()
استفاده می‌کنند باید قالب آگهی را بگذرانند.
اکنون می‌توان روش‌های AdManagerAdRequest.Builder که از
والدش به‌ارث برده است را به‌هم زنجیر کرد تا از یک تماس واحد شیء بسازد.
این امر مستلزم تغییر در ساختار وراثت به‌گونه‌ای بود که
AdManagerAdRequest.Builder
دیگر از AdRequest.Builder ارث نبرد.
واسطه‌گری: مقدار برگشتی برای
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
۲۰۲۳-۰۱-۳۱
آگهی‌های باز کردن برنامه: روش‌های منسوخ‌شده AppOpenAd.load()
که پارامتر ورودی گرایش را می‌پذیرفتند و روش‌های جدیدی که
ورودی گرایش را نمی‌پذیرفتند اضافه شدند. روش‌های جدید جهت‌یابی را در زمان درخواست تعیین می‌کنند و با عملکرد دیگر قالب‌های تمام‌صفحه مطابقت دارند.
واسطه‌گری: پشتیبانی واسطه‌گری برای آگهی‌های باز برنامه اضافه شد.
اجازه RECEIVE_BOOT_COMPLETED را از
وابستگی androidx.work:work-runtime برداشت. اگر از
نسخه‌های Gradle قدیمی‌تر از 7.2.0 استفاده می‌کنید و برنامه‌تان به اجازه نیاز دارد،
ممکن است لازم باشد اجازه را به‌طور صریح در مانیفست Android اعلام کنید.
21.4.0
۲۰۲۲-۱۲-۱۴
اکنون «شناسه برنامه Ad Manager» برای همه برنامه‌های Ad Manager الزامی است و
به قالب ca-app-pub-################~########## نیاز دارد. برای جزئیات بیشتر، به پیکربندی برنامه
مراجعه کنید.
بازرس آگهی: پشتیبانی «کیت توسعه نرم‌افزار» را برای نمایش آگهی‌های برنمایی و
آگهی‌های بومی که ازطریق واسط کاربر بازرس آگهی درخواست شده‌اند گسترش دهید.
پشتیبانی از «شناسه طرف اول ناشر» (که قبلاً به‌عنوان کلید برنامه یکسان شناخته می‌شد) اضافه شد تا بااستفاده از داده‌های جمع‌آوری‌شده از برنامه‌هایتان به شما کمک کند آگهی‌های مرتبط‌تر و شخصی‌سازی‌شده‌تری ارائه دهید.
نسخه پخش رسمی برای نسل QueryInfo.
21.3.0
۲۰۲۲-۱۰-۱۰
بازرس آگهی: پشتیبانی کیت توسعه نرم‌افزار برای درخواست و نمایش آگهی‌های
درخواست‌شده ازطریق واسط کاربر بازرس آگهی اضافه شد.
Google Mobile Ads SDK (Legacy) وقتی RequestConfiguration.Builder.setTagForChildDirectedTreatment() با TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE فراخوانده شود (به
تنظیم محتوای کودک‌پسند مراجعه کنید)، یا وقتی
RequestConfiguration.Builder.setTagForUnderAgeOfConsent()
با TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE فراخوانده شود (به
تنظیم کاربران زیر سن رضایت مراجعه کنید)،
انتقال شناسه تبلیغاتی Android (AAID) را غیرفعال می‌کند.
20.5.0
۲۰۲۱-۱۱-۱۸
پشتیبانی از دستگاه‌های Android 12 برای برنامه‌های هدف‌یابی API 31 اضافه شد.
پشتیبانی از
شناسه مجموعه برنامه
برای موارد استفاده‌ای مثل گزارش‌دهی و جلوگیری از کلاهبرداری اضافه شد.
20.4.0
۲۰۲۱-۰۹-۲۲
از نسخه ۲۰.۴.۰، Google Mobile Ads SDK (Legacy) اجازه
com.google.android.gms.permission.AD_ID را در
مانیفست کیت توسعه نرم‌افزار که به‌طور خودکار توسط
ابزارهای ساخت Android در مانیفست برنامه ادغام می‌شود، اضافه کرده است. برای کسب اطلاعات بیشتر درباره AD_ID
اظهارنامه اجازه، ازجمله نحوه غیرفعال کردن آن، به
این مقاله «راهنمای کنسول Play» مراجعه کنید.
کاربرگ
onAdClicked()
به FullScreenContentCallback اضافه شد.
بازخوان
onAdClicked()
در کلاس AdListener برای قالب آگهی‌های بومی فعال شد.
onAdImpression() برگشتی به
FullScreenContentCallback اضافه شد.
قالب InstreamAd منسوخ شد.
آداپتورهای میانجی‌گری:
MediationBannerAdapter،
MediationInterstitialAdapter، و
MediationNativeAdapter منسوخ شده است. آداپتورهای جدید باید کلاس
Adapter را برای بار کردن این قالب‌ها پیاده‌سازی کنند.
اکنون تبدیل‌های پیشنهاد قیمت می‌توانند روش‌های بار کردن متمایزی را در کلاس
Adapter برای
قالب‌های ویژه «مزایده قیمت هم‌زمان» پیاده‌سازی کنند.
19.7.0
۲۰۲۱-۰۱-۲۰
تغییرات عمده در:
InterstitialAd
RewardedAd
NativeAd
AppOpenAd
CustomRenderedAd منسوخ شده است.
کلاس‌ها و بسته‌های دارای پیشوند Publisher منسوخ شده‌اند و با پیشوند AdManager جایگزین شده‌اند.
آخرین نسخه فرعی قبل‌از نسخه ۲۰.۰.۰. همه میاناهای برنامه‌سازی کاربردی علامت‌گذاری‌شده به‌عنوان منسوخ
در این نسخه و نسخه‌های قبلی در نسخه ۲۰.۰.۰ برداشته خواهند شد. برای جزئیات بیشتر، راهنمای انتقال نسخه ۲۰.۰.۰ را ببینید.
19.6.0
۲۰۲۰-۱۲-۰۴
روش onAdLeftApplication() AdListener منسوخ شد.
اشکالی برطرف شد که در آن از کاربران دستگاه‌های Android 11 خواسته می‌شد
هنگام کلیک کردن روی آگهی، مرورگر انتخاب کنند.
19.5.0
۲۰۲۰-۱۰-۲۰
آگهی‌های برنمایی: روش onAdImpression()
AdListener اکنون برای آگهی‌های برنمایی فراخوانده می‌شود.
روش setHttpTimeoutMillis()
برای سفارشی‌سازی کردن زمان اتمام تماس‌های HTTPS برقرارشده توسط
«کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» اضافه شد.
پشتیبانی از دستگاه‌های Android 11 برای برنامه‌های هدف‌یابی‌کننده API 30 اضافه شد.
آگهی‌های باز کردن برنامه: قالب AppOpenAd تغییر کرده است تا بیشتر
شبیه قالب تمام‌صفحه عمل کند تا نمای برنمایی. getResponseInfo() و show() روش به
AppOpenAd اضافه شد. کلاس‌های AppOpenAdView
و AppOpenAdPresentationCallback منسوخ شده است.
واسطه‌گری: گزارش وضعیت واسطه‌گری اکنون دردسترس است. از
ResponseInfo.getAdapterResponses()
برای دریافت اطلاعات پاسخ برای هر شبکه آگهی که در درخواست آگهی شرکت کرده است استفاده کنید.
قالب RewardedInterstitialAd در
نسخه بتای خصوصی اضافه شد.
اشکالی برطرف شد که در آن MobileAds.initialize()
فقط یک‌بار کنترل‌کننده تکمیل تماس را برمی‌گرداند. اکنون هر تماسی با
MobileAds.initialize() باعث فراخوانی کردن برگشت تماس تکمیل می‌شود.
کاربرگ‌های تماس خرابی بار جدید به همه قالب‌های آگهی که
LoadAdError برمی‌گردانند اضافه شد. برای نمونه onAdFailedToLoad(LoadAdError).
بازخوان‌های نامعتبر خطای بار کردن که عدد صحیح برمی‌گردانند. برای نمونه، onAdFailedToLoad(int).
آگهی‌های پاداش‌دار:onRewardedAdFailedToShow(AdError) اضافه شد
و onRewardedAdFailedToShow(int) منسوخ شد.
واسطه‌گری پاداش‌دار: کد خطای ارائه MEDIATION_SHOW_ERROR
اضافه شد. اکنون همه خطاهای ارائه مربوط به آگهی‌های واسطهای
برای AdError.getCode() مقدار MEDIATION_SHOW_ERROR برمی‌گردانند
و AdError.getCause() غیرتهی نشان‌دهنده خطای واسطهای
زمینه‌ای است.
19.2.0
۲۰۲۰-۰۶-۱۸
آگهی‌های بومی: «واسط کاربر اعتبارسنج آگهی بومی» به درخواست‌های آزمایش اضافه شد تا به شما کمک کند نقض‌های خط‌مشی آگهی‌های بومی را پیدا و اصلاح کنید.
میاناهای برنامه‌سازی کاربردی برای قالب آگهی InstreamAd اضافه شد. این ویژگی در
نسخه بتای خصوصی است. برای درخواست دسترسی، با مدیر حسابتان تماس بگیرید.
برنمای تطبیقی: روش‌های ساختن برنمای تطبیقی در کلاس
AdSize
تغییر کرد. برای مثال، نام AdSize.getCurrentOrientationBannerAdSizeWithWidth()
به AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize() تغییر کرد.
میانجی‌گری: Google Mobile Ads SDK (Legacy) اکنون استثناهای پرتاب‌شده توسط
آداپتورهای میانجی‌گری را می‌گیرد.
واسطه‌گری پاداش‌دار: اشکالی برطرف شد که در آن اگر چندین آگهی پاداش‌دار واسطه‌گری‌شده
ذخیره می‌شد، فقط یکی نمایش داده می‌شد.
روش setTestDeviceIds() برای فعال کردن تنظیم
دستگاه‌های آزمایشی یک‌بار برای همه درخواست‌های آگهی اضافه شد.
18.2.0
2019‑08‑29
میاناهای برنامه‌سازی کاربردی برای
قالب AppOpenAd اضافه شد. این ویژگی در مرحله بتا خصوصی است.
برای درخواست دسترسی، با مدیر حسابتان تماس بگیرید.
واسطه‌گری: استثناهای آداپتور که ردیابی پشته‌ای آن‌ها شامل
Google Mobile Ads SDK (Legacy) است اکنون توسط Google Mobile Ads SDK (Legacy) دریافت و مدیریت می‌شود.
آگهی‌های بومی: برای آگهی‌های غیرویدیویی، نوع مقیاس تصویر MediaView
اکنون می‌تواند بااستفاده از MediaView.setImageScaleType() تنظیم شود.
آگهی‌های بومی: UnifiedNativeAd.getMediaContent() اضافه شد.
ناشرانی که فقط بااستفاده از نشانی‌های وب تصویر بار می‌کنند اکنون می‌توانند محتوای رسانه‌ای آگهی را دریافت کنند،
تصویری را به آن ارائه دهند، و
MediaView.setMediaContent() را برای تکمیل داده‌های تصویر
ازطریق MediaView برای آگهی‌های غیرویدیویی فراخوانی کنند.
آگهی‌های بومی: میاناهای برنامه‌سازی کاربردی اضافه شد تا از «سنجش باز» برای
قالب‌های آگهی بومی سفارشی غیرویدیویی پشتیبانی شود.
برای جلوگیری از خرابی که در اولین راه‌اندازی پس‌از نصب برنامه از
«فروشگاه Play» رخ می‌دهد، این نسخه از ناشران می‌خواهد وابستگی‌های
اضافی را در build.gradle خود اعلام کنند:
رفع مشکل ANR که در
android.media.AudioManager.getStreamVolume ایجاد شده است.
17.2.0
۲۰۱۹-۰۳-۱۱
ویدیو پاداش‌دار: مجموعه جدیدی از «میاناهای برنامه‌سازی کاربردی پاداش‌دار» (به
بسته پاداش‌دار
نگاه کنید) اضافه شده است که به شما امکان می‌دهد چندین آگهی پاداش‌دار را به‌طور هم‌زمان بار کنید.
واسطه‌گری: مجموعه جدیدی از میاناهای برنامه‌سازی کاربردی آداپتور واسطه‌گری اضافه شد که از
راه‌اندازی اولیه پشتیبانی می‌کند. تبدیل‌کننده‌هایی که میانای برنامه‌سازی کاربردی جدید را پیاده‌سازی می‌کنند، کلاس
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
۲۰۱۹-۰۱-۳۱
ناشرانی که از 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
۲۰۱۸-۱۱-۱۲
اشکالی برطرف شد که در آن ترکیب‌های خاصی از 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،
و میاناهای برنامه‌سازی کاربردی مرتبط به نفع UnifiedNativeAd منسوخ شده‌اند.
برای دستورالعمل‌های بیشتر درباره استفاده از میاناهای برنامه‌سازی کاربردی جدید، به آگهی‌های بومی
یکپارچه پیشرفته مراجعه کنید.
آگهی‌های بومی: ویژگی «بی‌صدا کردن این آگهی» اضافه شد.
آگهی‌های بومی: گزارش هشدار بی‌خطر «UnconfirmedClickListener نباید
وقتی ClickConfirmingView تنظیم شده است تهی باشد» برداشته شده است.
آگهی‌های پاداش‌دار: روش setAdMetadataListener در
RewardedVideoAd برای گوش دادن به تغییرات فراداده آگهی اضافه شد.
آگهی‌های پاداش‌دار: فراخوانی destroy() شنونده را
تهی می‌کند.
اشکالی که باعث می‌شد onRewardedVideoCompleted() در شبیه‌سازها اجرا نشود برطرف شد.
16.0.0
۲۰۱۸-۱۰-۰۲
بدون تغییر در آگهی‌ها. برای اطلاعات بیشتر، به
یادداشتهای
انتشار «خدمات Google Play» مراجعه کنید.
15.0.0
۲۰۱۸‑۰۴‑۱۲
نسخه بتای MRAID v3.
آگهی‌های بومی: «میانای برنامه‌سازی کاربردی آگهی بومی یکپارچه» اضافه شد. این کار NativeAppInstallAds و NativeContentAds را در نوع جدیدی به‌نام UnifiedNativeAd ترکیب می‌کند.
توجه: هنگام استفاده از آگهی‌های بومی، هشدار بی‌خطری در گزارش‌های
وقتی آگهی بومی کلیک می‌شود نشان داده می‌شود:
"UnconfirmedClickListener نباید تهی باشد درحالی‌که ClickConfirmingView
تنظیم شده است." این هشدار را می‌توانید نادیده بگیرید و در نسخه پخش بعدی برداشته خواهد شد.
12.0.1
2018‑03‑28
بدون تغییر در آگهی‌ها. برای جزئیات بیشتر، یادداشتهای انتشار خدمات Google Play را ببینید.
12.0.0
۲۰۱۸‑۰۳‑۲۰
ویدیو پاداش‌دار: روش onRewardedVideoCompleted()
فراخوانی برگشتی به RewardedVideoAdListener اضافه شد.
واسطه‌گری بومی: روش trackViews()
به NativeAdMapper اضافه شد و به
View شیء مربوط به دارایی‌های آگهی بومی جداگانه دسترسی داد.
trackView() منسوخ شد و trackViews() جایگزین آن شد.
11.8.0
۲۰۱۷-۱۲-۱۸
رفع اشکال‌ها و بهبودهای کلی.
11.6.0
۲۰۰۷-۱۱-۰۷
کلاس NativeAdViewHolder و روش‌های مرتبط در
NativeAppInstallAd و NativeContentAd اضافه شد.
AdLoader.getMediationAdapterClassName منسوخ شده است (ناشران باید به‌جای آن از روش‌های هم‌نام در
NativeAppInstallAd و NativeContentAd استفاده کنند).
آگهی‌های آزمایشی اکنون برچسبی در بالای آگهی نشان می‌دهند. برای جزئیات بیشتر،
راهنمای آزمایش را ببینید.
11.4.0
۲۰۱۷-۰۹-۱۹
getMediationAdapterClassName() روش به
کلاس‌های NativeAppInstallAd و NativeContentAd اضافه شد. روش
با همین نام در AdLoader
منسوخ خواهد شد.
روش loadAd() جدیدی اضافه شد که شیء PublisherAdRequest
را به کلاس RewardedVideoAd می‌گیرد.
11.2.0
۲۰۱۷‑۰۸‑۱۴
روش loadAds() به کلاس AdLoader اضافه شد،
که به برنامه‌ها امکان می‌دهد چندین آگهی یکتا را در یک درخواست بار کنند.
وقتی برنامه‌تان را به نسخه ۱۱.۲.۰ یا بالاتر «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» ارتقا می‌دهید، build.gradle برنامه شما نیز باید به‌روز شود تا compileSdkVersion حداقل 26 (Android O) را مشخص کند. این کار نحوه اجرای برنامه شما را تغییر نمی‌دهد. ملزم به به‌روزرسانی
targetSdkVersion نخواهید بود.
از نسخه ۱۱.۲.۰، Google Mobile Ads SDK (Legacy) ازطریق مخزن Maven در Google دردسترس است. برای کسب اطلاعات بیشتر، یادداشتهای انتشار «خدمات Google Play» را ببینید.
روش‌های getInAppPurchaseListener() و
setInAppPurchaseListener() را از کلاس‌های AdView، InterstitialAd،
و NativeExpressAdView برداشت. همچنین کلاس‌های خرید درون‌برنامه‌ای مرتبط را برداشت.
با افزودن روش
setImmersiveMode() به
PublisherInterstitialAd و کلاس‌های RewardedVideoAd
، امکان فعال کردن حالت فراگیر در آگهی‌های تمام‌صفحه اضافه شد.
واسط OnPublisherAdViewLoadedListener، کلاس PublisherAdViewOptions، و کلاس PublisherAdViewOptions.Builder برای استفاده با AdLoader برای درخواست‌های
آگهی بومی + برنمایی اضافه شد.
واسط اختیاری OnImmersiveModeUpdatedListener
را اضافه کرد که میانجی‌های واسط می‌توانند برای اطلاع از به‌روزرسانی‌های
حالت فراگیر پیاده‌سازی کنند.
روش getMediationAdapterClassName() به کلاس
RewardedVideoAd اضافه شد.
keep قانون اضافه شد تا نام‌های کلاس
میانجی‌گری آداپتور هنگام استفاده از ProGuard به‌طور خودکار حفظ شود.
10.2.0
۲۰۱۷-۲-۱۵
«خدمات Google Play» نسخه ۱۰.۲.x اولین نسخه پخشی است که دیگر
از نسخه ۲.۳.x سیستم‌عامل Android (Gingerbread) به‌طور کامل پشتیبانی نمی‌کند.
برنامه‌های توسعه‌یافته بااستفاده از نسخه پخش کیت توسعه نرم‌افزار ۱۰.۲.x و نسخه‌های جدیدتر به حداقل سطح میانای برنامه‌سازی کاربردی ۱۴ نیاز دارند و نمی‌توانند در دستگاه‌هایی که سطح میانای برنامه‌سازی کاربردی آن‌ها کمتر از ۱۴ است نصب شوند. برای کسب اطلاعات بیشتر درباره گزینه‌هایتان،
ازجمله ساختن چندین فایل APK برای گسترش پشتیبانی برنامه از
Android Gingerbread، به
وبلاگ توسعه‌دهندگان Android مراجعه کنید.
پشتیبانی از دارایی‌های ویدیویی برای محتوای «پیشرفته بومی»
و آگهی‌های الگوی سفارشی اضافه شد.
روش‌های getVideoController()،
setVideoOptions()، و getVideoOptions()
را به کلاس PublisherAdView اضافه کرد.
کلاس AdChoicesView اضافه شد.
روش‌های getAdChoicesContent() و
setAdChoicesContent() را به کلاس
NativeAdMapper اضافه کرد.
واسط InitializableMediationRewardedVideoAdAdapter
را برای میانجی‌گری آداپتورهای ویدیو پاداش‌دار که می‌خواهند
پیش‌از درخواست آگهی، در مقداردهی اولیه زودهنگام شرکت کنند اضافه کرد.
پشتیبانی از پیش‌نمایش درون‌برنامه‌ای و عیب‌یابی در Google Ad
Manager اضافه شد.
10.0.1
۲۰۱۶‑۱۱‑۲۱
رفع اشکال‌ها و بهبودهای کلی.
9.8.0
۲۰۱۶-۱۰-۲۴
MobileAds.Initialize(Context) منسوخ نشده است.
ناشران Google Ad Manager باید هنگام مقداردهی اولیه برنامه‌هایشان این روش را فراخوانی کنند. ناشران AdMob همچنان باید از
MobileAds.Initialize(Context, String) استفاده کنند و کد
برنامه خود را ارسال کنند.
9.6.0
۲۰۱۶-۰۹-۲۲
کلاس MediaView برای آگهی‌های ویدیویی پیشرفته آگهی‌های بومی اضافه شد.
روش openDebugMenu() به کلاس
MobileAds برای پیش‌نمایش طرح‌آگهی و
عیب‌یابی واحدهای آگهی «مدیر آگهی» اضافه شد.
پشتیبانی از رویدادهای سفارشی ویدیو پاداش‌دار اضافه شد.
بازپخش آگهی ویدیویی با رفع چندین اشکال بهبود یافته است.
9.0.1
2016-05-26
مشکل ProGuard که در نسخه ۹.۰.۰ معرفی شده بود را برطرف می‌کند.
ناشران دیگر به گزینه keep برای
com.google.android.gms.common.util.DynamiteApi نیاز ندارند.
9.0.0
۲۰۱۶-۰۵-۱۸
افزودن تکمیل خودکار اطلاعات مکان
برای برنامه‌هایی که صریحاً اجازه مکان را اعطا می‌کنند.
پشتیبانی از رویدادهای سفارشی میانجی‌گری «ویدیو پاداش‌دار» اضافه شد.
گزینه‌های ویدیویی برای آگهی‌های «بیان بومی» اضافه شد.
«میانای برنامه‌سازی کاربردی آگهی‌های جستجوی سفارشی» به‌روزرسانی شد.
فقط برای این نسخه پخش، برنامه‌هایی که از ProGuard برای پس‌پردازش کردن برنامه‌شان استفاده می‌کنند
باید گزینه keep زیر را به فایل پیکربندی ProGuard خود اضافه کنند:
-keep public @com.google.android.gms.common.util.DynamiteApi class * { *; }
8.4.0
۲۰۱۵-۱۲-۱۸
روش عمومی
MobileAds.setAppVolume()
را اضافه کردیم تا Google Mobile Ads SDK (Legacy) را از سطح صدای فعلی برنامه مطلع کنیم.
رفع اشکال‌ها و بهبود عملکردها پیاده‌سازی شد.
8.3.0
۲۰۱۵‑۱۱‑۶
پشتیبانی از آگهی‌های ویدیویی پاداش‌دار اضافه شد.
روش isLoading() به PublisherAdView
و PublisherInterstitialAd اضافه شد تا بررسی شود آیا درخواست آگهی درحال
پیشرفت است یا نه.
روش setIsDesignedForFamilies() به
AdRequest.Builder
و PublisherAdRequest.Builder اضافه شد.
روش destroy() به NativeAdView اضافه شد.
8.1.0
۲۰۱۵-۰۹-۲۴
رفع اشکال‌های مختلف.
7.8.0
۲۰۱۵‑۰۸‑۱۳
نسخه رسمی انتشار MRAID v2.
روش isLoading() به
AdLoader،
AdView،
و InterstitialAd
اضافه شد تا بررسی شود آیا درخواست آگهی درحال انجام است یا نه.
PublisherAdRequest.Builder#setManualImpressionsEnabled() منسوخ شده است.
درعوض از PublisherAdView#setManualImpressionsEnabled() استفاده کنید.
7.5.0
2015‑05‑28
پشتیبانی از قالب‌های آگهی بومی محتوا و نصب برنامه در AdMob و Ad Manager اضافه شد.
پشتیبانی از قالب‌های آگهی بومی سفارشی اضافه شد که برای رزروهای Ad Manager دردسترس است.
7.3.0
۲۰۱۵-۰۴-۲۸
رفع اشکال‌های مختلف.
7.0.0
۲۰۱۵‑۰۳‑۱۹
addCustomTargeting() و
addCategoryExclusion() روش به
PublisherAdRequest.Builder اضافه شد.
رفع مشکلی که باعث می‌شد PublisherAdView.recordManualImpression()
هنگام استفاده از شمارش دستی ظهور، چندین ظهور را در Ad Manager ضبط کند.
روش setRequestAgent()
به AdRequest.Builder
و PublisherAdRequest.Builder اضافه شد.
این روش باید برای نشان دادن مبدأهای درخواست آگهی توسط طرف‌های سومی که
برای Google Mobile Ads SDK (Legacy) میانجی‌گری می‌کنند استفاده شود.
6.5.87
۲۰۰۸/۱۲/۰۸
معماری JAR تقسیم‌شده معرفی شد--توسعه‌دهندگان Android Studio اکنون می‌توانند
فقط بخش آگهی «خدمات Google Play» را با اتکا به
com.google.android.gms:play‑services‑ads:6.+ اضافه کنند.
توجه: برنامه‌هایی که آگهی‌های برنمایی را در XML ایجاد می‌کنند باید همچنان به کل کتابخانه com.google.android.gms:play‑services:6.+ ارجاع دهند.
رفع اشکال‌های مختلف.
۶.۱
۲۰۰۸-۱۰-۰۸
روش getLocation() به
com.google.android.gms.ads.MediationAdRequest اضافه شد.
شرح محتوایی به دکمه بستن میان‌آگهی برای
دست‌یابی‌پذیری اضافه شد.
وقتی پروژه کتابخانه به‌درستی پیوند شده باشد، گزارش «منابع Google Play پیدا نشد» برداشته می‌شود.
getMediationAdapterClassName() به AdView اضافه شد
تا نام کلاس میانجی‌گری شبکه آگهی که آگهی نشان می‌دهد را دریافت کنید.
17.0.0
۲۰۱۸-۱۰-۰۵
میاناهای برنامه‌سازی کاربردی جدیدی برای پیاده‌سازی «رویدادهای سفارشی» اضافه شد.
جریان خرید پیش‌فرض برای «خرید درون‌برنامه‌ای» بااستفاده از Google Play Billing API اضافه شد.
۴٫۴
۲۰۱۴-۰۵-۰۷
«میاناهای برنامه‌سازی کاربردی» جدید «آداپتور میانجی‌گری» اضافه شد.
قالب آگهی جدید LARGE_BANNER × ۳۲۰ برای تلفن‌ها و رایانه‌های لوحی اضافه شد.
قالب میان‌آگهی جدیدی برای «خرید درون‌برنامه» اضافه شد. برای گوش دادن به رویدادهای خرید درون‌برنامه،
InAppPurchaseListener را در InterstitialAd تنظیم کنید.
رفع اشکال برای ازکارافتادن SecurityException به‌دلیل خواندن
gservices بدون اجازه.
۴٫۳
۲۰۱۴-۰۳-۱۷
InterstitialAd اکنون درصورت ارسال بافت برنامه کار می‌کند.
روش setContentUrl() به PublisherAdRequest.Builder اضافه شد.
رفع استثنا درصورت ثبت نشدن سرویس.
۲-۴
2014‑02‑03
رفع اشکال‌های مختلف.
۱-۴
۲۰۱۴-۰۱-۱۶
پشتیبانی از Ad Manager و «آگهی‌های جستجو برای برنامه‌های تلفن همراه» اضافه شد.
AdRequest.Builder اکنون روش setLocation() دارد.
رفع خرابی که درصورت درخواست آگهی بینابینی و مشخص نشدن
AdActivity در مانیفست رخ می‌داد.
۴٫۰
۲۰۱۳-۱۰-۳۱
میاناهای برنامه‌سازی کاربردی «آگهی‌های تلفن همراه Google» اکنون بخشی از
خدمات Google Play است.
به‌روزرسانی‌های آتی «میاناهای برنامه‌سازی کاربردی تبلیغات تلفن همراه Google» به‌طور خودکار ازطریق «خدمات Google Play» به
دستگاه‌ها ارسال می‌شود.
Ad Manager و «آگهی‌های جستجو برای برنامه‌های تلفن همراه» هنوز پشتیبانی نمی‌شوند.
تاریخ آخرین به‌روزرسانی 2026-10-12 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین به‌روزرسانی 2026-10-12 بهوقت ساعت هماهنگ جهانی."],[],["Key actions and information: The content details changes across multiple versions of an ads SDK. These changes include deprecating older methods and classes, introducing new ad formats (like `NativeAd` and `AppOpenAd`), and updating existing APIs with new features such as `Ad Inspector` UI, `User Messaging Platform SDK` updates, `QueryInfo`, `MediaContent`, and `ResponseInfo`. Major version updates introduced breaking changes, minimum API level increases, and migration to Jetpack/AndroidX libraries. Ad loading and request configurations were also enhanced.\n"]]
