کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل (Google Mobile Ads SDK) در حالت تعمیر و نگهداری است. برای دریافت آخرین به‌روزرسانی‌ها و ویژگی‌ها، کیت توسعه نرم‌افزاری نسل بعدی GMA رامنتقل و راه‌اندازی کنید.
Google برای ترجمه محتوا به زبان ترجیحی شما از فناوری هوشواره استفاده می‌کند. ترجمه‌های هوشواره‌ای ممکن است اشتباه داشته باشند.
یادداشت‌های انتشار
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
نسخه
تاریخ انتشار
یادداشت‌ها
25.5.0
2026‑09‑17
حداقل سطح میانای برنامه‌سازی کاربردی Android به ۲۴ افزایش یافت.
onInitializationFailed() به InitializationCompleteCallback اضافه شد. اکنون آداپتورهای میانجی خطاهای مقداردهی اولیه کیت توسعه نرم‌افزار طرف سوم را با کد خطا، دامنه خطا، و پیام خطا به کیت توسعه نرم‌افزار Google Mobile Ads گزارش می‌کنند.
هنگام استفاده از میانجی‌گری با منابع آگهی رویداد سفارشی، ResponseInfo.getAdapterClassName() اکنون نام کلاس رویداد سفارشی شما را به‌جای com.google.ads.mediation.customevent.CustomEventAdapter برمی‌گرداند.
25.4.0
2026‑06‑17
رفع اشکال‌ها و بهبود عملکرد.
25.3.0
2026‑05‑21
روش setAgeRestrictedTreatment() در RequestConfiguration.Builder اضافه شد و setTagForChildDirectedTreatment() و setTagForUnderAgeOfConsent() منسوخ شدند. از روش جدید برای پیکربندی رفتار محدودشده براساس سن برای کاربران کودک و نوجوان استفاده کنید.
25.2.0
2026‑04‑13
رفع اشکال‌ها و بهبود عملکرد.
25.1.0
2026‑03‑16
اشکالی در بازرس آگهی برطرف شد که می‌توانست هنگام درخواست آگهی آزمایشی خارج از زمینه با نشانی وب محتوای خالی، باعث ایجاد خطا شود.
۲۵.۰.۰
2026‑02‑17
تغییرات ناگهانی:
کلاس 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
2025‑10‑09
حاشیه‌نویسی تهی‌پذیر حذف‌شده در نوع پاسخ برای
NativeCustomFormatAd.getDisplayOpenMeasurement() اصلاح شد.
عملکرد تغییری نکرده است، زیرا توانایی روش برای برگرداندن مقدار تهی ازقبل انتظار می‌رفت.
وابستگی androidx.webkit:webkit از نسخه ۱.۱۴.۰ به نسخه ۱.۱۲.۱ تنزل داده شد تا سازگاری با افزایه Android Gradle نسخه ۷.۳.۱ حفظ شود.
24.6.0
2025‑09‑08
اکنون آداپتورهای میانجی بومی می‌توانند NativeAdMapper.destroy() را پیاده‌سازی کنند
تا وقتی آگهی بومی ازبین می‌رود مطلع شوند.
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
وابستگی کیت توسعه نرم‌افزار پلاتفرم پیام‌رسانی کاربر به نسخه ۳.۲.۰ به‌روز شد.
24.2.0
2025‑04‑07
رفع اشکال‌ها و بهبود عملکرد.
24.1.0
۲۰۲۵/۰۳/۱۲
حداقل نسخه Kotlin اکنون ۲.۱.۰ است.
رفع اشکال‌ها و بهبود عملکرد.
play-services-ads-lite درحال انتقال به آهنگ انتشار کاهش‌یافته است و با این نسخه توزیع نمی‌شود. برای اطلاعات بیشتر،
به
سند Lite SDK مراجعه کنید.
24.0.0
2025‑02‑24
تغییرات ناگهانی:
حداقل سطح میانای برنامه‌سازی کاربردی Android به ۲۳ افزایش یافت.
همه میاناهای برنامه‌سازی کاربردی مربوط به قالب آگهی بین‌پیمایشی برداشته شد.
میاناهای برنامه‌سازی کاربردی جهت‌گیری AppOpenAd منسوخ‌شده برداشته شد.
SearchAdView و
DynamicHeightSearchAdRequest کلاس برداشته شد.
وابستگی کیت توسعه نرم‌افزار پلاتفرم پیام‌رسانی کاربر به نسخه ۳.۱.۰ به‌روز شد.
MediationRewardedAdCallback.onUserEarnedReward() اضافه شد
و
MediationRewardedAdCallback.onUserEarnedReward(RewardItem) منسوخ شد.
آداپتورهای میانجی باید به‌روزرسانی شوند تا از روش جدید استفاده کنند.
برچسب ویژگی android.adservices.AD_SERVICES_CONFIG
از فایل مانیفست کیت توسعه نرم‌افزار برداشته شد تا از تداخل‌های ادغام برای
برنامه‌هایی که
سرویس‌های تبلیغاتی مختص API را پیکربندی می‌کنند جلوگیری شود.
23.6.0
2024‑12‑03
همه میاناهای برنامه‌سازی کاربردی مربوط به قالب آگهی بین‌پیمایشی منسوخ شده است. برای
مثال،
AdSize.getCurrentOrientationInterscrollerAdSize().
23.5.0
۲۰۲۴/۱۰/۲۹
پیام‌های logcat مربوط به عدم بارگیری آگهی که در نسخه ۲۳.۴.۰ معرفی شده بود
از سطح خطا به سطح اطلاعات به‌روز شد.
بهبود درآمدزایی آگهی‌های شخصی‌سازی‌شده در «برگه‌های سفارشی» برای WebView
API برای آگهی‌ها.
23.4.0
2024‑09‑30
اکنون خطاهای بار کردن آگهی پیام logcat را فراخوانی می‌کند که در ردیابی پشته‌ای خطا ad failed
to load می‌گوید. رد پشته این پیام را به‌عنوان خطا ثبت می‌کند، اما به معنی ازکارافتادن نیست. برای تفسیر کردن خطاهای رایج بار کردن آگهی، به اشکال‌زدایی پیام‌های ثبت خطای رایج مراجعه کنید. اگر خطای تکرارشونده‌ای
مربوط به ارائه آگهی می‌بینید که مستند نشده است، ردیابی پشته را با
Google Mobile Ads SDK (Legacy) پشتیبانی هم‌رسانی کنید.
وابستگی کیت توسعه نرم‌افزار پلاتفرم پیام‌رسانی کاربر به نسخه ۳.۰.۰ به‌روز شد.
23.2.0
2024‑06‑27
AdView.isCollapsible() اضافه شد
تا نشان دهد آیا آخرین برنمای بارشده جمع‌شدنی است یا نه.
23.1.0
2024‑05‑09
حداقل compileSdkVersion ۳۴ لازم است.
آداپتورهای میانجی‌گری بومی: loadNativeAd
و loadRtbNativeAd() منسوخ شده‌اند و loadNativeAdMapper() و loadRtbNativeAdMapper() جایگزین آن‌ها شده‌اند.
آداپتورها باید به استفاده از این روش‌های بارگیری جدید و اشیاء مرتبط منتقل شوند.
23.0.0
۲۰۲۴/۰۳/۰۷
تغییرات ناگهانی:
حداقل سطح میانای برنامه‌سازی کاربردی Android به ۲۱ افزایش یافت.
برای ادامه جمع‌آوری سنجه‌های کاربر در AdMob،
برنامه AdMob خود را به Firebase پیوند دهید و Google Analytics برای
کیت توسعه نرم‌افزار Firebase را در برنامه‌تان ادغام کنید.
MobileAds.enableSameAppKey() API منسوخ‌شده را برداشتیم
و روش جایگزین 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
2023‑01‑31
آگهی‌های باز شدن برنامه: روش‌های AppOpenAd.load() منسوخ‌شده که پارامتر ورودی جهت را می‌پذیرند و روش‌های جدیدی اضافه شده‌اند که ورودی جهت را نمی‌پذیرند. روش‌های جدید جهت را در زمان درخواست تعیین می‌کنند و با رفتار سایر قالب‌های تمام‌صفحه مطابقت دارند.
میانجی‌گری: پشتیبانی میانجی‌گری برای آگهی‌های باز برنامه اضافه شد.
اجازه RECEIVE_BOOT_COMPLETED از وابستگی androidx.work:work-runtime برداشته شد. اگر از نسخه‌های Gradle قدیمی‌تر از ۷.۲.۰ استفاده می‌کنید و برای برنامه‌تان به اجازه نیاز دارید، ممکن است لازم باشد اجازه را به‌طور صریح در مانیفست Android خود اعلام کنید.
21.4.0
2022‑12‑14
اکنون «شناسه برنامه Ad Manager» برای همه برنامه‌های Ad Manager الزامی است و
باید قالب ca-app-pub-################~########## داشته باشد. برای جزئیات بیشتر،
پیکربندی برنامه را ببینید.
بازرس آگهی: پشتیبانی کیت توسعه نرم‌افزار را برای نمایش آگهی‌های برنما و
آگهی‌های بومی درخواست‌شده ازطریق واسط کاربر بازرس آگهی گسترش دهید.
پشتیبانی از شناسه طرف اول ناشر (که قبلاً با نام کلید برنامه یکسان شناخته می‌شد) اضافه شد تا به شما کمک کند بااستفاده از داده‌های جمع‌آوری‌شده از برنامه‌هایتان، آگهی‌های مرتبط‌تر و شخصی‌سازی‌شده‌تری ارائه دهید.
نسخه پخش رسمی برای نسل QueryInfo.
21.3.0
2022‑10‑10
بازرس آگهی: پشتیبانی کیت توسعه نرم‌افزار (SDK) برای درخواست و نمایش آگهی‌های درخواست‌شده ازطریق واسط کاربر بازرس آگهی اضافه شد.
Google Mobile Ads SDK (Legacy) انتقال شناسه تبلیغاتی Android (AAID) را غیرفعال می‌کند وقتی که RequestConfiguration.Builder.setTagForChildDirectedTreatment() با TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE فراخوانده شود (به تنظیم مختص کودکان مراجعه کنید)، یا RequestConfiguration.Builder.setTagForUnderAgeOfConsent() با TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE فراخوانده شود (به تنظیم کاربران زیر سن قانونی مراجعه کنید).
20.5.0
2021‑11‑18
پشتیبانی از دستگاه‌های Android 12 برای برنامه‌هایی که میانای برنامه‌سازی کاربردی ۳۱ را هدف قرار می‌دهند اضافه شد.
پشتیبانی از
شناسه مجموعه برنامه
برای موارد استفاده‌ای مثل گزارش‌دهی و جلوگیری از کلاهبرداری اضافه شد.
20.4.0
2021‑09‑22
از نسخه ۲۰.۴.۰، 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 برای
قالب‌های خاص RTB پیاده‌سازی کنند.
19.7.0
2021‑01‑20
تغییرات عمده در:
InterstitialAd
RewardedAd
NativeAd
AppOpenAd
CustomRenderedAd منسوخ شده است.
کلاس‌ها و بسته‌های دارای پیشوند Publisher منسوخ شده‌اند و پیشوند AdManager جایگزین آن‌ها شده است.
آخرین نسخه فرعی قبل‌از نسخه ۲۰.۰.۰. همه میاناهای برنامه‌سازی کاربردی که در این نسخه پخش و نسخه‌های پخش قبلی به‌عنوان منسوخ‌شده علامت‌گذاری شده‌اند در نسخه ۲۰.۰.۰ برداشته خواهند شد. برای جزئیات بیشتر، راهنمای انتقال
نسخه ۲۰.۰.۰ را ببینید.
19.6.0
2020‑12‑04
روش onAdLeftApplication() AdListener منسوخ شده است.
اشکالی که باعث می‌شد از کاربران دستگاه‌های Android 11 خواسته شود هنگام کلیک کردن روی آگهی، مرورگری را انتخاب کنند برطرف شد.
19.5.0
2020‑10‑20
آگهی‌های برنما: اکنون روش onAdImpression()
AdListener برای آگهی‌های برنما فراخوانی می‌شود.
روش setHttpTimeoutMillis() برای سفارشی‌سازی کردن زمان اتمام تماس‌های HTTPS برقرارشده توسط کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google اضافه شد.
۱۹.۴.۰
2020‑09‑10
پشتیبانی از دستگاه‌های Android 11 برای برنامه‌هایی که میانای برنامه‌سازی کاربردی ۳۰ را هدف قرار می‌دهند اضافه شد.
آگهی‌های باز شدن برنامه: قالب AppOpenAd را تغییر دادیم تا بیشتر شبیه به قالب تمام‌صفحه عمل کند تا نمای برنمایشی. روش‌های
getResponseInfo() و show() به
AppOpenAd اضافه شد. کلاس‌های AppOpenAdView
و AppOpenAdPresentationCallback منسوخ‌شده.
میانجی‌گری: گزارش وضعیت میانجی‌گری اکنون دردسترس است. از
ResponseInfo.getAdapterResponses()
برای دریافت اطلاعات پاسخ برای هر شبکه آگهی که در درخواست آگهی شرکت کرده است استفاده کنید.
اشکالی که در آن MobileAds.initialize()
فقط یک‌بار گرداننده تکمیل را فراخوانی می‌کرد برطرف شد. هر تماس با
MobileAds.initialize() اکنون فراخوانی برگشتی تکمیل را فراخوانی می‌کند.
فراخوان‌های برگشتی جدیدی برای بارگیری ناموفق به همه قالب‌های آگهی که
LoadAdError را برمی‌گردانند اضافه شده است. برای نمونه onAdFailedToLoad(LoadAdError).
فراخوانی‌های برگشتی ناموفق بارگیری منسوخ‌شده که یک int برمی‌گردانند. برای مثال، onAdFailedToLoad(int).
آگهی‌های پاداش‌دار:onRewardedAdFailedToShow(AdError) اضافه شد
و onRewardedAdFailedToShow(int) منسوخ شد.
میانجی‌گری پاداش‌دار: کد خطای ارائه MEDIATION_SHOW_ERROR اضافه شد. اکنون همه خطاهای ارائه مربوط به آگهی‌های میانجی‌گری‌شده
MEDIATION_SHOW_ERROR را برای AdError.getCode()
و NonNull AdError.getCause() را که نشان‌دهنده خطای میانجی‌گری
اصلی است برمی‌گردانند.
19.2.0
2020‑06‑18
قالب RewardedInterstitialAd اضافه شد. این ویژگی در
نسخه بتای خصوصی است. برای درخواست دسترسی، با مدیر حسابتان تماس بگیرید.
آگهی‌های بومی: واسط کاربر «اعتبارسنج آگهی بومی» به درخواست‌های آزمایشی اضافه شد تا به شما کمک کند نقض خط‌مشی آگهی‌های بومی را شناسایی و برطرف کنید.
میاناهای برنامه‌سازی کاربردی برای قالب آگهی InstreamAd اضافه شد. این ویژگی در نسخه بتای خصوصی است. برای درخواست دسترسی، با مدیر حسابتان تماس بگیرید.
Adaptive Banner: Changed adaptive banner creation methods in the
AdSize
class. برای مثال، نام 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) گرفته و مدیریت می‌شوند.
18.1.0
2019‑07‑09
انتشار رسمی برای پشتیبانی از «سنجش برنامه».
سنجش برنامه به‌طور پیش‌فرض داده‌ها را در شروع برنامه مقداردهی اولیه و ارسال می‌کند.
گزینه‌ای برای
به‌تأخیر انداختن سنجش برنامه
تا زمانی که Google Mobile Ads SDK (Legacy) به‌طور صریح فراخوانده شود اضافه شد.
آگهی‌های بومی: برای آگهی‌های غیرویدیویی، نوع مقیاس تصویر MediaView
اکنون می‌تواند بااستفاده از MediaView.setImageScaleType() تنظیم شود.
آگهی‌های بومی: UnifiedNativeAd.getMediaContent() اضافه شد.
ناشرانی که فقط بااستفاده از نشانی‌های وب تصاویر را بار می‌کنند اکنون می‌توانند محتوای رسانه‌ای آگهی را دریافت کنند، تصویری برای آن ارائه دهند، و
MediaView.setMediaContent() را برای پر کردن داده‌های تصویر
ازطریق MediaView برای آگهی‌های غیرویدیویی فراخوانی کنند.
وابستگی‌ها به play-services-measurement و
play-services-measurement-sdk اضافه شد. برنامه‌ها دیگر
نیازی به افزودن صریح این وابستگی‌ها ندارند.
18.0.0
2019‑06‑17
انتقال از «کتابخانه‌های پشتیبانی Android» به کتابخانه‌های Jetpack (AndroidX). برای اطلاعات بیشتر، به
یادداشت‌های انتشار خدمات Google Play مراجعه کنید.
برای جلوگیری از خرابی‌ای که در اولین راه‌اندازی پس‌از نصب برنامه از
فروشگاه Play رخ می‌دهد، این نسخه از ناشران می‌خواهد وابستگی‌های بیشتری را
در build.gradle خود اعلام کنند:
رفع مشکل ANR که از
android.media.AudioManager.getStreamVolume شروع می‌شود.
17.2.0
2019‑03‑11
ویدیو پاداش‌دار: مجموعه جدیدی از میاناهای برنامه‌سازی کاربردی پاداش‌دار اضافه شده است (به
بسته پاداش‌دار
مراجعه کنید) که به شما امکان می‌دهد چندین آگهی پاداش‌دار را به‌طور هم‌زمان بار کنید.
میانجی‌گری: مجموعه جدیدی از میاناهای برنامه‌سازی کاربردی آداپتور میانجی‌گری اضافه شد که از مقداردهی اولیه پشتیبانی می‌کنند. آداپتورهایی که 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 استفاده کنند.
ناشران Google AdMob باید برچسب
<meta-data> را با کلید
com.google.android.gms.ads.APPLICATION_ID
در AndroidManifest.xml خود مشخص کنند. برای جزئیات بیشتر، به
راهنمای
شروع به کار مراجعه کنید.
آگهی‌های بومی:NativeAppInstallAd، NativeContentAd،
و میاناهای برنامه‌سازی کاربردی مرتبط به‌نفع UnifiedNativeAd منسوخ شده‌اند.
برای دستورالعمل‌های بیشتر درباره استفاده از میاناهای برنامه‌سازی کاربردی جدید، به آگهی‌های بومی
پیشرفته یکپارچه مراجعه کنید.
آگهی‌های بومی: ویژگی «بی‌صدا کردن این آگهی» اضافه شد.
آگهی‌های بومی: گزارش هشدار بی‌خطر: «UnconfirmedClickListener must
not be null while ClickConfirmingView is set.» برداشته شده است.
آگهی‌های پاداش‌دار: روش setAdMetadataListener در
RewardedVideoAd برای گوش دادن به تغییرات فراداده آگهی اضافه شد.
آگهی‌های پاداش‌دار: فراخوانی destroy() شنونده را باطل می‌کند.
اشکالی که باعث می‌شد onRewardedVideoCompleted() در شبیه‌سازها اجرا نشود برطرف شد.
16.0.0
2018‑10‑02
تغییری در آگهی‌ها ایجاد نشد. برای اطلاعات بیشتر، به یادداشت‌های انتشار خدمات Google Play مراجعه کنید.
15.0.0
2018‑04‑12
نسخه بتای MRAID v3.
آگهی‌های بومی: Unified Native Ad API اضافه شد. این کار NativeAppInstallAds و NativeContentAds را در یک نوع جدید ترکیب می‌کند: UnifiedNativeAd.
توجه: هنگام استفاده از آگهی‌های بومی، هشدار بی‌خطری وجود دارد که
هنگام کلیک روی آگهی بومی در گزارش‌ها نشان داده می‌شود:
«UnconfirmedClickListener must not be null while ClickConfirmingView is
set.» می‌توانید این هشدار را نادیده بگیرید و در نسخه پخش بعدی برداشته خواهد شد.
12.0.1
2018‑03‑28
تغییری در آگهی‌ها ایجاد نشد. برای جزئیات بیشتر، یادداشت‌های انتشار خدمات Google Play را ببینید.
12.0.0
2018‑03‑20
ویدیو پاداش‌دار: روش بازخوانی onRewardedVideoCompleted() به RewardedVideoAdListener اضافه شد.
میانجی‌گری بومی: روش 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
منسوخ خواهد شد.
روش loadAd() جدیدی اضافه شد که شیء PublisherAdRequest را به کلاس RewardedVideoAd می‌برد.
11.2.0
۲۰۱۷/۰۸/۱۴
روش loadAds() به کلاس AdLoader اضافه شد،
که به برنامه‌ها امکان می‌دهد چندین آگهی منحصربه‌فرد را در یک درخواست بار کنند.
وقتی برنامه‌تان را به نسخه ۱۱.۲.۰ یا بالاتر از کیت توسعه نرم‌افزار Google Mobile
Ads ارتقا می‌دهید، build.gradle برنامه‌تان نیز باید به‌روز شود تا
compileSdkVersion حداقل 26 (Android O) را مشخص کند. این
تغییر نحوه اجرای برنامه‌تان را تغییر نمی‌دهد. نیازی به به‌روزرسانی
targetSdkVersion نخواهید داشت.
از نسخه ۱۱.۲.۰، Google Mobile Ads SDK (Legacy) ازطریق مخزن Maven در Google دردسترس است. برای اطلاعات بیشتر، یادداشت‌های انتشار خدمات Google Play را ببینید.
11.0.0
2017‑06‑07
روش‌های onAdClicked() و
onAdImpression()
به کلاس AdListener اضافه شد.
این روش‌ها فقط برای نصب برنامه به زبان اصلی دستگاه و آگهی‌های محتوای بومی فراخوانده می‌شوند.
روش‌های getInAppPurchaseListener() و setInAppPurchaseListener() از کلاس‌های AdView، InterstitialAd، و NativeExpressAdView برداشته شد. کلاس‌های خرید درون‌برنامه‌ای مرتبط را نیز حذف کردیم.
امکان فعال کردن حالت فراگیر در آگهی‌های تمام‌صفحه با افزودن روش
setImmersiveMode() به کلاس‌های
PublisherInterstitialAd و RewardedVideoAd
اضافه شد.
میانای OnPublisherAdViewLoadedListener،
کلاس PublisherAdViewOptions، و
کلاس PublisherAdViewOptions.Builder برای استفاده با AdLoader برای درخواست‌های
بومی-به‌علاوه-برنما اضافه شد.
رابط اختیاری OnImmersiveModeUpdatedListener اضافه شد که آداپتورهای میانجی می‌توانند برای مطلع شدن از به‌روزرسانی‌های حالت فراگیر پیاده‌سازی کنند.
روش getMediationAdapterClassName() به کلاس RewardedVideoAd اضافه شد.
قوانین keep برای حفظ خودکار نام‌های کلاس آداپتور میانجی هنگام استفاده از ProGuard اضافه شد.
10.2.0
2017‑2‑15
«خدمات Google Play» نسخه ۱۰.۲.x اولین نسخه‌ای است که دیگر
شامل پشتیبانی کامل از Android نسخه ۲.۳.x (نان زنجبیلی) نیست.
برنامه‌هایی که بااستفاده از کیت توسعه نرم‌افزار نسخه 10.2.x و جدیدتر توسعه یافته‌اند، به حداقل سطح میانای برنامه‌سازی کاربردی Android نسخه ۱۴ نیاز دارند و نمی‌توانند در دستگاه‌هایی که سطح میانای برنامه‌سازی کاربردی آن‌ها پایین‌تر از ۱۴ است نصب شوند. برای کسب اطلاعات بیشتر درباره گزینه‌هایتان،
ازجمله ساختن چند 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
2016‑09‑22
کلاس MediaView برای آگهی‌های ویدیویی «آگهی‌های بومی پیشرفته» اضافه شد.
روش openDebugMenu() به کلاس
MobileAds برای پیش‌نمایش طرح‌آگهی و
عیب‌یابی واحدهای آگهی «مدیر آگهی» اضافه شد.
پشتیبانی از رویدادهای سفارشی ویدیو پاداش‌دار اضافه شد.
بازپخش آگهی ویدیویی با رفع چندین اشکال بهبود یافته است.
9.0.1
2016‑05‑26
مشکل ProGuard را که در نسخه ۹.۰.۰ ایجاد شده بود برطرف می‌کند.
ناشران دیگر به گزینه keep برای
com.google.android.gms.common.util.DynamiteApi نیاز ندارند.
9.0.0
2016‑05‑18
درج خودکار اطلاعات مکان برای برنامه‌هایی که صریحاً اجازه مکان را اعطا می‌کنند اضافه شد.
پشتیبانی از رویدادهای سفارشی میانجی‌گری «ویدیو پاداش‌دار» اضافه شد.
گزینه‌های ویدیو برای آگهی‌های Native Express اضافه شد.
میانای برنامه‌سازی کاربردی «آگهی‌های جستجوی سفارشی» به‌روز شد.
فقط برای این نسخه، برنامه‌هایی که از 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 (Legacy) از سطح صدای فعلی برنامه مطلع شود.
رفع اشکال‌ها و بهبودهایی اعمال شده است.
8.3.0
۲۰۱۵/۱۱/۶
پشتیبانی از آگهی‌های ویدیویی پاداش‌دار اضافه شد.
روش isLoading() به PublisherAdView
و PublisherInterstitialAd اضافه شد تا بررسی شود که آیا درخواست آگهی درحال انجام است یا نه.
روش setIsDesignedForFamilies() به
AdRequest.Builder
و PublisherAdRequest.Builder اضافه شد.
روش destroy() به NativeAdView اضافه شد.
8.1.0
۲۰۱۵/۰۹/۲۴
رفع اشکال‌های مختلف.
7.8.0
2015‑08‑13
نسخه رسمی پخش 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
2015‑04‑28
رفع اشکال‌های مختلف.
7.0.0
2015‑03‑19
روش‌های 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
2018‑10‑05
میاناهای برنامه‌سازی کاربردی جدیدی برای پیاده‌سازی «رویدادهای سفارشی» اضافه شده است.
جریان خرید پیش‌فرض برای «خرید درون‌برنامه‌ای» بااستفاده از Google Play Billing API اضافه شد.
۴٫۴
2014‑05‑07
میاناهای برنامه‌سازی کاربردی جدید «آداپتور میانجی‌گری» اضافه شد.
قالب آگهی جدید LARGE_BANNER ۳۲۰×۱۰۰ برای تلفن‌ها و رایانه‌های لوحی اضافه شد.
قالب بینابینی جدیدی برای «خرید درون‌برنامه» اضافه شد. InAppPurchaseListener را در InterstitialAd تنظیم کنید تا برای رویدادهای خرید درون‌برنامه گوش دهد.
رفع اشکال برای ازکارافتادن SecurityException به‌دلیل خواندن
gservices بدون اجازه.
۴٫۳
2014‑03‑17
InterstitialAd اکنون درصورت ارسال بافت برنامه کار می‌کند.
روش setContentUrl() به PublisherAdRequest.Builder اضافه شد.
رفع مشکل استثنا درصورت ثبت نشدن سرویس.
۲-۴
2014‑02‑03
رفع اشکال‌های مختلف.
۱-۴
2014‑01‑16
پشتیبانی از Ad Manager و Search Ads برای برنامه‌های تلفن همراه اضافه شد.
AdRequest.Builder اکنون روش setLocation() دارد.
خرابی‌ای که درصورت درخواست آگهی بینابینی رخ می‌داد اما
AdActivity در مانیفست مشخص نشده بود برطرف شد.
۴٫۰
2013‑10‑31
میاناهای برنامه‌سازی کاربردی Google Mobile Ads اکنون بخشی از
خدمات Google Play هستند.
به‌روزرسانی‌های آینده میاناهای برنامه‌سازی کاربردی Google Mobile Ads به‌طور خودکار ازطریق «خدمات Google Play» به دستگاه‌ها ارسال می‌شود.
Ad Manager و «آگهی جستجوها برای برنامه‌های تلفن همراه» هنوز پشتیبانی نمی‌شوند.
تاریخ آخرین به‌روزرسانی 2026-11-10 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","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-11-10 بهوقت ساعت هماهنگ جهانی."],[],[]]
