کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل (Google Mobile Ads SDK) در حالت تعمیر و نگهداری است. برای دریافت آخرین به‌روزرسانی‌ها و ویژگی‌ها، کیت توسعه نرم‌افزاری نسل بعدی GMA را منتقل و راه‌اندازی کنید.

‫Google برای ترجمه محتوا به زبان ترجیحی شما از فناوری هوشواره استفاده می‌کند. ترجمه‌های هوشواره‌ای ممکن است اشتباه داشته باشند.

انتقال نسخه‌های کیت توسعه نرم‌افزار

انتخاب پلاتفرم: iOS Unity Android (قدیمی)

این صفحه مهاجرت برای نسخه‌های فعلی و قبلی را پوشش می‌دهد.

انتقال از v24 به v25

زیربخش‌های زیر تغییرات اساسی و تفاوت‌های رفتاری بین نسخه اصلی ۲۴ و ۲۵ Google Mobile Ads SDK (Legacy) را شرح می‌دهند.

حداقل سطح Android API برابر با ۲۴ است

از نسخه ۲۵.۵.۰، Google Mobile Ads SDK (Legacy) همه برنامه‌ها را ملزم می‌کند در حداقل سطح Android API 24 اجرا شوند. برای اصلاح سطح میانای برنامه کاربردی، مقدار minSdk را در فایل build.gradle سطح برنامه به ۲۴ یا بالاتر تغییر دهید.

فراخوان‌های آگهی منسوخ‌شده برداشته شد

کاربردهای برگشتی آگهی منسوخ‌شده زیر از کلاس‌های زیر برداشته شد:

کلاس	تماس‌های برگشتی برداشته شد	جایگزین
SignalCallbacks	`onFailure(String)` `onAdFailedToShow(String)`	`onFailure(AdError)` `onAdFailedToShow(AdError)`
MediationAdLoadCallback
MediationInterstitialAdCallback
MediationRewardedAdCallback

تغییرات در میانای برنامه‌سازی کاربردی اندازه برنمای تطبیقی ثابت

نسخه ۲۵.۰.۰ میاناهای برنامه‌سازی کاربردی اندازه برنمای تطبیقی ثابت موجود را منسوخ می‌کند و میاناهای برنامه‌سازی کاربردی اندازه را برای تبلیغات برنمای تطبیقی ثابت بزرگ معرفی می‌کند. ‫Google Mobile Ads SDK (Legacy) می‌تواند بااستفاده از میاناهای برنامه‌سازی کاربردی جدید اندازه بزرگ برنمای تطبیقی ثابت، تقاضای ویدیو را به تبلیغات برنمایی ارائه دهد.

جدول زیر جزئیات مربوط به میاناهای برنامه‌سازی کاربردی منسوخ‌شده اندازه‌گیری و جایگزین‌های آن‌ها را ارائه می‌دهد:

v24 (منسوخ)	v25 (جایگزین)
`getCurrentOrientationAnchoredAdaptiveBannerAdSize(Context, int)`	`getLargeAnchoredAdaptiveBannerAdSize(Context, int)`
`getLandscapeAnchoredAdaptiveBannerAdSize(Context, int)`	`getLargeLandscapeAnchoredAdaptiveBannerAdSize(Context, int)`
`getPortraitAnchoredAdaptiveBannerAdSize(Context context, int width)`	`getLargePortraitAnchoredAdaptiveBannerAdSize(Context context, int width)`

برداشتن کلاس `mediation.VersionInfo`

کلاس VersionInfo در بسته com.google.android.gms.ads.mediation برداشته شد. درعوض، از بسته com.google.android.gms.ads.VersionInfo استفاده کنید.

برداشتن روش `getConfiguration()` در کلاس `RtbSignalData`

روش منسوخ‌شده getConfiguration() API در RtbSignalData برداشته شد. درعوض، از روش getConfigurations() استفاده کنید که فهرست List<MediationConfiguration> را برمی‌گرداند.

انتقال از نسخه ۲۳ به نسخه ۲۴

بخش‌های فرعی زیر تغییرات مخرب و تفاوت‌های رفتاری بین نسخه اصلی ۲۳ و ۲۴ Google Mobile Ads SDK (Legacy) را شرح می‌دهد.

حداقل سطح میانای برنامه‌سازی کاربردی Android‏ ۲۳ است

از نسخه 24.0.0،‏ Google Mobile Ads SDK (Legacy) همه برنامه‌ها را ملزم می‌کند در حداقل سطح میانای برنامه‌سازی کاربردی Android 23 اجرا شوند. برای اصلاح سطح میانای برنامه کاربردی، مقدار minSdk را در فایل build.gradle سطح برنامه به ۲۳ یا بالاتر تغییر دهید.

تغییرات در مقداردهی اولیه و بار کردن بهینه‌سازی‌شده

به‌طور پیش‌فرض، پرچم‌های OPTIMIZE_INITIALIZATION و OPTIMIZE_AD_LOADING روی true تنظیم شده‌اند. برای اطلاعات بیشتر درباره این پرچم‌ها، به بهینه‌سازی مقداردهی اولیه و بار کردن مراجعه کنید.

وابستگی‌های firebase-ads و firebase-ads-lite برداشته شد

از نسخه ۲۴.۰.۰، نسخه‌های پخش «کیت توسعه نرم‌افزار» دیگر وابستگی‌های firebase-ads و firebase-ads-lite را توزیع نمی‌کنند. درعوض از وابستگی play-services-ads استفاده کنید.

تنظیم پارامترهای هدف‌یابی سفارشی

برای تنظیم هدف‌یابی سفارشی در درخواست آگهی، از addCustomTargeting() استفاده کنید.

میاناهای برنامه‌سازی کاربردی منسوخ‌شده گرایش برای آگهی‌های باز کردن برنامه برداشته شد

‫AppOpenAd.load() روش که پارامتر ورودی گرایش را می‌پذیرفت برداشته شد. به‌جای آن از روش‌های AppOpenAd.load() که جهت‌گیری ندارند استفاده کنید.
‫AppOpenAdOrientation شمارش برداشته شد.

بازخوانی پاداش ساده‌شده برای آداپتورهای واسطه‌گری

نسخه ۲۴.۰.۰ onUserEarnedReward() برگشتی را در MediationRewardedAdCallback اضافه می‌کند و onUserEarnedReward(RewardItem) را منسوخ می‌کند. وقتی کاربر پاداشی کسب می‌کند، آداپتورهای میانجی‌گری باید شروع به فراخوانی onUserEarnedReward() کنند.

هنگام بازارسال تماس‌های برگشتی از آداپتورهای میانجی‌گری، همه نسخه‌های Google Mobile Ads SDK (Legacy) پاداش تعریف‌شده در «واسط کاربر Ad Manager» را در OnUserEarnedRewardListener برمی‌گردانند.

کلاس‌ها برداشته شد

کلاس‌های زیر بدون جایگزین برداشته شدند:

DynamicHeightSearchAdRequest
SearchAdRequest
SearchAdView

روش‌ها برداشته شد

روش‌های زیر بدون جایگزین برداشته شدند:

کلاس	روش
RewardedInterstitialAdLoadCallback	`onRewardedInterstitialAdLoaded()`
	`onRewardedInterstitialAdFailedToLoad(int)`
	`onRewardedInterstitialAdFailedToLoad(LoadAdError)`

روش‌های منسوخ‌شده

روش‌های زیر منسوخ شده‌اند و جایگزینی ندارند:

کلاس	روش
سازگار کننده (Adapter)	`loadInterscrollerAd()`
RtbAdapter	`loadRtbInterscrollerAd()`

انتقال از v22 به v23

بخش‌های فرعی زیر تغییرات مخرب و تفاوت‌های رفتار بین نسخه اصلی ۲۲ و ۲۳ Google Mobile Ads SDK (Legacy) را شرح می‌دهد.

حداقل سطح میانای برنامه‌سازی کاربردی Android‏ ۲۱ است

از نسخه ۲۳.۰.۰، Google Mobile Ads SDK (Legacy) همه برنامه‌ها را ملزم می‌کند برای اجرا در حداقل سطح میانای برنامه‌سازی کاربردی Android 21 باشند. برای اصلاح سطح میانای برنامه کاربردی، مقدار minSdkVersion را در فایل build.gradle سطح برنامه به ۲۱ یا بالاتر تغییر دهید.

‫`AdManagerAdRequest.Builder` روش ارث‌بری‌شده از ابرکلاس می‌تواند زنجیره‌ای باشد

در نسخه 23.0.0، AdManagerAdRequest.Builder روش‌های به‌ارث‌رسیده از والد آن می‌توانند به‌هم زنجیر شوند تا AdManagerAdRequest بااستفاده از یک تماس ساخته شوند:

جاوا

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
    .addCustomTargeting("age", "25") // AdManagerAdRequest.Builder method.
    .setContentUrl("https://www.example.com") // Method inherited from parent.
    .build(); // Builds an AdManagerAdRequest.

Kotlin

var request = AdManagerAdRequest.Builder()
  .addCustomTargeting("age", "25") // AdManagerAdRequest.Builder method.
  .setContentUrl("https://www.example.com") // Method inherited from parent.
  .build() // Builds an AdManagerAdRequest.

روش‌های منسوخ‌شده برداشته/جایگزین شد

نسخه ۲۲.۰.۰ API	نسخه ۲۳.۰.۰ API
AdRequest.Builder.addTestDevice()	RequestConfiguration.Builder.setTestDeviceIds()
AdRequest.Builder.tagForChildDirectedTreatment()	RequestConfiguration.Builder.setTagForChildDirectedTreatment()
AdRequest.Builder.setIsDesignedForFamilies()	RequestConfiguration.Builder.setMaxAdContentRating()
AdFormat.UNKNOWN	بدون جایگزین
AdLoader.Builder.forUnifiedNativeAd()	AdLoader.Builder.forNativeAd()
AdLoader.Builder.forCustomTemplateAd()	AdLoader.Builder.forCustomFormatAd()
AdLoader.Builder.withNativeAdOptions(com.google.android.gms.ads.`formats`.NativeAdOptions)	AdLoader.Builder.withNativeAdOptions(com.google.android.gms.ads.`nativead`.NativeAdOptions)
void MobileAds.setSameAppKeyEnabled()	boolean MobileAds.putPublisherFirstPartyIdEnabled()

انتقال از v21 به v22

زیربخش‌های زیر تغییرات مخرب و تفاوت‌های رفتار را بین نسخه اصلی ۲۱ و ۲۲ Google Mobile Ads SDK (Legacy) شرح می‌دهد.

از MobileAds.getVersion()‎ برای دریافت نسخه Google Mobile Ads SDK (Legacy) استفاده کنید

روش MobileAds.getVersionString() در نسخه 22.0.0 برداشته شده است و به‌جای آن MobileAds.getVersion() استفاده می‌شود.

روش جدید شماره نسخه خارجی موردانتظار را برمی‌گرداند—برای مثال، 22.0.0. برای کسب اطلاعات بیشتر درباره این تغییر، به استفاده از روش جدید «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» getVersion() مراجعه کنید.

برداشتن NativeCustomFormatAd.getVideoMediaView() منسوخ

در نسخه ۲۱، Google Mobile Ads SDK (Legacy) روش NativeCustomFormatAd.getVideoMediaView() را برای دریافت دارایی رسانه‌ای برای قالب آگهی سفارشی بومی ارائه کرد.

از نسخه ۲۲، خودتان MediaView ایجاد می‌کنید و محتوای رسانه‌ای آن را تنظیم می‌کنید، و از MediaContent.getVideoController() برای دریافت کنترل‌های ویدیو استفاده می‌کنید.

v22

// Called when a custom native ad loads.
@Override
public void onCustomFormatAdLoaded(NativeCustomFormatAd ad) {
    // Assumes you have a FrameLayout in your view hierarchy with the ID media_placeholder.
    FrameLayout mediaPlaceholder = (FrameLayout) findViewById(R.id.media_placeholder);

    MediaContent mediaContent = ad.getMediaContent();
    if (mediaContent != null && mediaContent.hasVideoContent()) {
        // Create a MediaView and set its media content.
        MediaView mediaView = new MediaView(mediaPlaceholder.getContext());
        mediaView.setMediaContent(mediaContent);
        mediaPlaceholder.addView(mediaView);
    }
}

v21

// Called when a custom native ad loads.
@Override
public void onCustomFormatAdLoaded(NativeCustomFormatAd ad) {
    // Assumes you have a FrameLayout in your view hierarchy with the ID media_placeholder.
    FrameLayout mediaPlaceholder = (FrameLayout) findViewById(R.id.media_placeholder);

    VideoController videoController = ad.getVideoController();
    if (videoController.hasVideoContent()) {
        // Add the media view provided by the native ad.
        mediaPlaceholder.addView(ad.getVideoMediaView());
    }
}

برای اطلاعات بیشتر، به راهنمای آگهی بومی سفارشی مراجعه کنید.

روش‌های برداشته‌شده یا جایگزین‌شده

جدول زیر تغییرات خاص در نسخه ۲۲.۰.۰ را فهرست می‌کند:

v21.0.0	v22.0.0
MobileAds.getVersionString()	MobileAds.getVersion()
NativeCustomFormatAd.getVideoMediaView()	NativeCustomFormatAd.getMediaContent()
NativeCustomFormatAd.getVideoController()	NativeCustomFormatAd.getMediaContent().getVideoController()
AdRequest.Builder.setAdInfo()	AdRequest.Builder.setAdString()
MediationRewardedVideoAdAdapter	Adapter
MediationRewardedVideoAdListener	Adapter
com.google.android.gms.ads.mediation.VersionInfo	com.google.android.gms.ads.VersionInfo
com.google.android.gms.ads.doubleclick.AppEventListener	com.google.android.gms.ads.admanager.AppEventListener

انتقال از v20 به v21

زیربخش‌های زیر تغییرات اساسی و تفاوت‌های رفتاری بین نسخه اصلی ۲۰ و ۲۱ Google Mobile Ads SDK (Legacy) را شرح می‌دهد:

‫minSdkVersion را به ۱۹ یا بالاتر به‌روز کنید

از نسخه 21.0.0، Google Mobile Ads SDK (Legacy) برای اجرا شدن همه برنامه‌ها به حداقل سطح میانای برنامه‌سازی کاربردی Android 19 نیاز دارد. برای تنظیم سطح میانای برنامه کاربردی، مقدار minSdkVersion را در فایل ساخت برنامه به ۱۹ یا بالاتر تغییر دهید.

اجرای تهی بودن دقیق

در آماده‌سازی برای اعمال قابلیت تهی بودن دقیق، در همه میاناهای برنامه‌سازی کاربردی که قبلاً قابلیت تهی بودن را به‌طور صریح تعریف نکرده بودند، @NonNull گزارمان اضافه می‌شود.

اگر نقض ایمنی تهی وجود داشته باشد و قبلاً مقادیر null را به‌روش ایمن مدیریت نکرده باشد، این تغییر ممکن است برنامه‌های Kotlin و برنامه‌هایی را که از چارچوب‌های بررسی تهی جاوا استفاده می‌کنند دچار مشکل کند (مستندات Kotlin درباره ایمنی تهی را ببینید).

برداشتن روش addNetworkExtras()‎

روش addNetworkExtras() که پارامترهای اضافی را به‌عنوان نمونه NetworkExtras به یک آداپتور شبکه تبلیغاتی خاص منتقل می‌کند در نسخه 20.3.0 کیت توسعه نرم‌افزار منسوخ شده است و در نسخه 21.0.0 برداشته خواهد شد. درعوض، از روش addNetworkExtrasBundle() در همان کلاس AdRequest.Builder استفاده کنید.

برداشتن روش‌های مکان

روش‌های مکان زیر در نسخه ۲۱.۰.۰ برداشته خواهد شد:

روش setLocation(Location location) در کلاس AdRequest.Builder که مکان کاربر را برای اهداف هدف‌یابی واسطه‌گری تنظیم می‌کند.
روش getLocation() در کلاس AdRequest که اطلاعات هدف‌یابی مکانی کاربر را که قبلاً به روش setLocation(Location location) ارسال شده است برمی‌گرداند.
روش getLocation() در کلاس MediationAdConfiguration که مکان کاربر را برمی‌گرداند، اگر توسط AdRequest تعریف شده باشد.

‫Google از داده‌های مکان برای هدف‌یابی آگهی‌ها استفاده نمی‌کند. درصورت نیاز، باید از APIهای طرف سوم برای ارائه اطلاعات به شبکه‌های آگهی طرف سوم استفاده کنید.

منسوخ شدن میاناهای رویداد سفارشی

رویدادهای سفارشی به ناشرانی که از میانجی‌گری استفاده می‌کنند امکان می‌دهد منبع آگهی آبشاری راه‌اندازی کنند که یکی از منابع آگهی پشتیبانی‌شده در Ad Manager نباشد.

همه واسط‌های رویداد سفارشی به‌نفع کلاس Adapter و واسط MediationAdLoadCallback منسوخ شده‌اند.

جدول زیر کلاس یا واسط متناظری را که باید برای هر واسط رویداد سفارشی از نسخه 21.0.0 به بعد استفاده کنید فهرست می‌کند:

میاناهای v20.0.0	نسخه ۲۱.۰.۰ کلاس/ میانا
CustomEvent	Adapter
CustomEventBanner
CustomEventInterstitial
CustomEventNative
CustomEventBannerListener	Adapter, MediationAdLoadCallback
CustomEventInterstitialListener
CustomEventListener
CustomEventNativeListener

انتقال از v19 به v20

تغییرات زیادی در نسخه 20.0.0 وجود دارد که سازگاری را می‌شکند. نسخه 19.7.0 بسیاری از APIهای جدید را معرفی کرد و بسیاری از کلاس‌ها را در آماده‌سازی برای نسخه 20.0.0 منسوخ یا تغییر نام داد. این راهنما تغییرات عمده در نسخه 20.0.0 را برجسته می‌کند.

به‌روزرسانی‌های میانای برنامه‌سازی کاربردی قالب تمام‌صفحه

از نسخه ۲۰.۰.۰، قالب‌های آگهی بینابینی، آگهی پاداش‌دار، آگهی بینابینی پاداش‌دار، و آگهی باز کردن برنامه استانداردسازی می‌شوند تا از طراحی یکپارچه میانای برنامه‌سازی کاربردی پیروی کنند.

همه میاناهای برنامه‌سازی کاربردی قالب تمام‌صفحه از اصول زیر استفاده می‌کنند:

روش بار کردن ثابت
سازوکار مشابهی برای پاسخ به تماس یا مدیریت بار
اتکا به کلاس FullScreenContentCallback برای برگشت‌های تماس ارائه

برداشتن «میانای برنامه‌سازی کاربردی» قدیمی «تبلیغ ویدیویی پاداش‌دار»

میانای برنامه‌سازی کاربردی جدیدتر RewardedAd اولین‌بار در مارس ۲۰۱۹ معرفی شد و بیش‌از ۱۸ ماه است که میانای برنامه‌سازی کاربردی پاداش‌دار ترجیحی بوده است. این API نسبت‌به API قدیمی RewardedVideoAd بهبودهای بیشتری داشته است، ازجمله امکان بار کردن بیش‌از یک تبلیغ ویدیویی پاداش‌دار به‌طور هم‌زمان.

میانای برنامه‌سازی کاربردی قدیمی RewardedVideoAd در کیت توسعه نرم‌افزار نسخه 20.0.0 برداشته شده است.

منسوخ شدن برنمای هوشمند به نفع برنمای تطبیقی

آگهی‌های برنمای هوشمند منسوخ شده‌اند و جای خود را به آگهی‌های برنمای تطبیقی داده‌اند. برنمای آگهی‌های تطبیقی عملکرد برتر و انعطاف‌پذیری بیشتری در تنظیم پهنای آگهی ارائه می‌دهد. اگر ترجیح می‌دهید همچنان از برنماهای تمام‌عرض استفاده کنید، می‌توانید همچنان بااستفاده از برنمای تطبیقی این کار را انجام دهید، همان‌طور که در تکه‌کد زیر نشان داده شده است:

جاوا

public class MyActivity extends AppCompatActivity {
  ...
  private AdSize getFullWidthAdaptiveSize() {
    Display display = getWindowManager().getDefaultDisplay();
    DisplayMetrics outMetrics = new DisplayMetrics();
    display.getMetrics(outMetrics);

    float widthPixels = outMetrics.widthPixels;
    float density = outMetrics.density;

    int adWidth = (int) (widthPixels / density);
    return AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(this, adWidth);
  }
}

Kotlin

class MyActivity : AppCompatActivity() {
  ...
  private val adaptiveAdSize: AdSize
    get() {
      val display = windowManager.defaultDisplay
      val outMetrics = DisplayMetrics()
      display.getMetrics(outMetrics)

      val density = outMetrics.density

      var adWidthPixels = ad_view_container.width.toFloat()
      if (adWidthPixels == 0f) {
        adWidthPixels = outMetrics.widthPixels.toFloat()
      }

      val adWidth = (adWidthPixels / density).toInt()
      return AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(this, adWidth)
    }
}

برداشتن فراخوانی پس‌از خروج از برنامه

‫onAdLeftApplication پاسخ‌به‌تماس برای همه قالب‌های آگهی به‌نفع ProcessLifecycleOwner برداشته شده است. بااستفاده از API سطح سیستم‌عامل، هرزمان که کاربران از برنامه‌تان خارج شوند، صرف‌نظر از اینکه این خروج به‌دلیل تعامل با آگهی باشد یا نه، به شما اطلاع داده می‌شود.

توجه داشته باشید که onAdLeftApplication هرگز قرار نبوده است به‌عنوان مدیریت‌کننده کلیک آگهی عمل کند و تکیه بر این برگشت برای گزارش کلیک‌ها سنجه دقیقی تولید نمی‌کرد. برای مثال، کلیک کردن روی نماد «انتخاب‌های آگهی» که مرورگر خارجی را فراخوانی کرده است باعث فراخوانی برگشتی شده است اما به‌عنوان کلیک محاسبه نشده است.

تغییر نام کلاس

جدول زیر نام‌های کلاس خاصی را که تغییر کرده‌اند یا برداشته شده‌اند فهرست می‌کند:

نام اکثر کلاس‌های مربوط به UnifiedNativeAd به NativeAd تغییر کرده است.
کلاس‌ها و نماهای MobileAds.Settings،‏ NativeExpressAdView،‏ NativeAppInstallAd، NativeContentAd، و InstreamAd برداشته شده است.
همه کلاس‌های دارای پیشوند Publisher با پیشوند AdManager جایگزین شده‌اند.
نام بسته InterstitialAd تغییر کرده است.

‫19.5.0 Class	‫20.0.0 Class
com.google.android.gms.ads.	com.google.android.gms.ads.
reward.RewardedVideoAd	rewarded.RewardedAd
reward.RewardedVideoAdListener	‫rewarded.RewardedAdLoadCallback و FullScreenContentCallback
reward.RewardItem	rewarded.RewardItem
rewarded.RewardedAdCallback	OnUserEarnedRewardListener
formats.UnifiedNativeAdView	nativead.NativeAdView
formats.UnifiedNativeAd	nativead.NativeAd
formats.UnifiedNativeAdAssetNames	nativead.NativeAdAssetNames
formats.UnifiedNativeAd.OnUnifiedNativeAdLoadedListener	nativead.NativeAd.OnNativeAdLoadedListener
formats.AdChoicesView	nativead.AdChoicesView
formats.NativeAd.AdChoicesInfo	nativead.NativeAd.AdChoicesInfo
formats.MediaView	nativead.MediaView
formats.NativeAdViewHolder	nativead.NativeAdViewHolder
formats.NativeAdOptions	nativead.NativeAdOptions
formats.NativeCustomTemplateAd	nativead.NativeCustomFormatAd
formats.NativeCustomTemplateAd.OnCustomTemplateAdLoadedListener	nativead.NativeCustomFormatAd.OnCustomFormatAdLoadedListener
MobileAds.Settings	برداشته‌شده
doubleclick.PublisherAdRequest	admanager.AdManagerAdRequest
doubleclick.PublisherAdView	admanager.AdManagerAdView
formats.PublisherAdViewOptions	formats.AdManagerAdViewOptions
doubleclick.PublisherInterstitialAd	admanager.AdManagerInterstitialAd
InterstitialAd	interstitial.InterstitialAd
NativeExpressAdView	برداشته‌شده
instream.InstreamAd	برداشته‌شده
mediation.admob.AdMobExtras	برداشته‌شده
Correlator	برداشته‌شده
search.SearchAdRequest	برداشته‌شده
میانای AdRequest.TagForUnderAgeOfConsent	برداشته‌شده
میانای AdRequest.MaxAdContentRating	برداشته‌شده
formats.NativeAppInstallAd	native.NativeAd
formats.NativeAppInstallAdView	native.NativeAdView
mediation.NativeAppInstallAdMapper	mediation.UnifiedNativeAdMapper
formats.NativeContentAd	native.NativeAd
formats.NativeContentAdView	native.NativeAdView
mediation.NativeContentAdMapper	mediation.UnifiedNativeAdMapper

روش‌ها برداشته/جایگزین شد

جدول زیر تغییرات خاص در نسخه 20.0.0 را فهرست می‌کند:

روش‌های قدیمی مقداردهی اولیه از کلاس MobileAds برداشته شده است.
برخی‌از روش‌های کلاس AdRequest.Builder() یا برداشته شده‌اند یا به کلاس RequestConfiguration منتقل شده‌اند.
«میاناهای برنامه کاربردی» RewardedAd و InterstitialAd به‌روز شده‌اند تا با همه قالب‌های تمام‌صفحه هماهنگ شوند.
ویژگی‌های همبستگی برداشته شده است.

کلاس	v19.5.0 API	v20.0.0 API	یادداشت‌ها
AdSize	getPortraitBannerAdSizeWithWidth()	getPortraitAnchoredAdaptiveBannerAdSize()
	getLandscapeBannerAdSizeWithWidth()	getLandscapeAnchoredAdaptiveBannerAdSize()
	getCurrentOrientationBannerAdSizeWithWidth()	getCurrentOrientationAnchoredAdaptiveBannerAdSize()
MobileAds	initialize(Context, String)	‫MobileAds.initialize(Context, OnInitializationCompleteListener)	شناسه برنامه اکنون در AndroidManifest.xml تنظیم شده است.
	initialize(Context, String, MobileAds.Settings)	initialize(Context, OnInitializationCompleteListener)	کلاس «تنظیمات» منسوخ شده است.
	getRewardedVideoAdInstance()‎	برداشته‌شده	به‌جای آن از «میانای برنامه‌سازی کاربردی آگهی ویدیویی پاداش‌دار» استفاده کنید.
AdListener	onAdFailedToLoad(int)	onAdFailedToLoad(LoadAdError)
AdListener	onAdLeftApplication()	برداشته‌شده	قالب‌های آگهی تمام‌صفحه به‌جای AdListener از FullscreenContentCallback استفاده می‌کنند و روش معادل در FullscreenContentCallback وجود ندارد. این روش از AdListener برداشته شده است.
VideoController	getAspectRatio()	MediaContent.getAspectRatio()
PublisherAdRequest	getGender()	برداشته‌شده
	getBirthday()	برداشته‌شده
	getNetworkExtras()	برداشته‌شده
	setManualImpressionsEnabled()	برداشته‌شده
	updateCorrelator()	برداشته‌شده	به فیلتر کردن محتوای آگهی مراجعه کنید.
PublisherAdRequest.Builder	setBirthday()	برداشته‌شده
	setGender()	برداشته‌شده
	setIsDesignedForFamilies()	برداشته‌شده	راهنما را ببینید.
	addTestDevice()	RequestConfiguration.Builder.setTestDeviceIds()	به فعال کردن آگهی‌های آزمایشی مراجعه کنید.
	tagForChildDirectedTreatment()	RequestConfiguration.Builder.setTagForChildDirectedTreatment()	به فیلتر کردن محتوای آگهی مراجعه کنید.
	setTagForUnderAgeOfConsent()	RequestConfiguration.Builder.setTagForUnderAgeOfConsent()
	setMaxAdContentRating()	RequestConfiguration.Builder.setMaxAdContentRating()
AdView	getMediationAdapterClassName()	ResponseInfo.getMediationAdapterClassName()	شیء `ResponseInfo` بااستفاده از روش `AdView`، `getResponseInfo()` دردسترس است.
NativeAdOptions	setImageOrientation()	setMediaAspectRatio()
NativeAdOptions	getImageOrientation	getMediaAspectRatio()
RewardedAd	loadAd(AdRequest, RewardedAdLoadCallback)	‫RewardedAd.load(Context, String, AdRequest, RewardedAdLoadCallback)	‫RewardedAd اکنون از همان رویکرد بار کردن ایستا مانند دیگر قالب‌های تمام‌صفحه استفاده می‌کند.
	loadAd(PublisherAdRequest, RewardedAdLoadCallback)	‫RewardedAd.load(Context, String, AdManagerAdRequest, RewardedAdLoadCallback)
	isLoaded()	برداشته‌شده	تماس برگشتی از روش بار کردن ایستا آگهی‌ای را ارائه می‌دهد که قبلاً بار شده است.
	نمایش(Activity, RewardedAdCallback)	نمایش(Activity، OnUserEarnedRewardListener)	این روش نمایش از رویکرد کلی‌تر قالب تمام‌صفحه پیروی می‌کند.
RewardedAdLoadCallback	onRewardedAdFailedToLoad(int)	onAdFailedToLoad(LoadAdError)
	onRewardedAdFailedToLoad(LoadAdError)	onAdFailedToLoad(LoadAdError)
	onRewardedAdLoaded()	onAdLoaded(RewardedAd)
AppOpenAdLoadCallback	onAppOpenAdFailedToLoad(int)	onAdFailedToLoad(LoadAdError)
	onAppOpenAdFailedToLoad(LoadAdError)	onAdFailedToLoad(LoadAdError)
	onAppOpenAdLoaded(AppOpenAd)	onAdLoaded(AppOpenAd)
‫RewardedInterstitialAdLoadCallback	onRewardedInterstitialAdFailedToLoad(int)	onAdFailedToLoad(LoadAdError)
	onRewardedInterstitialAdFailedToLoad(LoadAdError)	onAdFailedToLoad(LoadAdError)
	onRewardedInterstitialAdLoaded(RewardedInterstitialAd)	onAdLoaded(RewardedInterstitialAd)
PublisherInterstitialAd	new PublisherInterstitialAd()	InterstitialAd.load(Context, String, AdRequest, InterstitialAdLoadCallback)	‫InterstitialAd اکنون از همان رویکرد بار کردن ایستا مانند دیگر قالب‌های تمام‌صفحه استفاده می‌کند.
PublisherInterstitialAd	setAdListener()
DynamicHeightSearchAdRequest	getNetworkExtras()	برداشته‌شده	کلاس NetworkExtras منسوخ شده است.
AdLoader	برایContentAd()	برداشته‌شده
	برایAppInstallAd()	برداشته‌شده
	withCorrelator()	برداشته‌شده
	getMediationAdapterClassName()	برداشته‌شده

انتقال نسخه‌های کیت توسعه نرم‌افزار با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.

انتقال از v24 به v25

حداقل سطح Android API برابر با ۲۴ است

فراخوان‌های آگهی منسوخ‌شده برداشته شد

تغییرات در میانای برنامه‌سازی کاربردی اندازه برنمای تطبیقی ثابت

برداشتن کلاس mediation.VersionInfo

برداشتن روش getConfiguration() در کلاس RtbSignalData

انتقال از نسخه ۲۳ به نسخه ۲۴

حداقل سطح میانای برنامه‌سازی کاربردی Android‏ ۲۳ است

تغییرات در مقداردهی اولیه و بار کردن بهینه‌سازی‌شده

وابستگی‌های firebase-ads و firebase-ads-lite برداشته شد

تنظیم پارامترهای هدف‌یابی سفارشی

میاناهای برنامه‌سازی کاربردی منسوخ‌شده گرایش برای آگهی‌های باز کردن برنامه برداشته شد

بازخوانی پاداش ساده‌شده برای آداپتورهای واسطه‌گری

کلاس‌ها برداشته شد

روش‌ها برداشته شد

روش‌های منسوخ‌شده

انتقال از v22 به v23

حداقل سطح میانای برنامه‌سازی کاربردی Android‏ ۲۱ است

‫AdManagerAdRequest.Builder روش ارث‌بری‌شده از ابرکلاس می‌تواند زنجیره‌ای باشد

جاوا

Kotlin

روش‌های منسوخ‌شده برداشته/جایگزین شد

انتقال از v21 به v22

از MobileAds.getVersion()‎ برای دریافت نسخه Google Mobile Ads SDK (Legacy) استفاده کنید

برداشتن NativeCustomFormatAd.getVideoMediaView() منسوخ

v22

v21

روش‌های برداشته‌شده یا جایگزین‌شده

انتقال از v20 به v21

‫minSdkVersion را به ۱۹ یا بالاتر به‌روز کنید

اجرای تهی بودن دقیق

برداشتن روش addNetworkExtras()‎

برداشتن روش‌های مکان

منسوخ شدن میاناهای رویداد سفارشی

انتقال از v19 به v20

به‌روزرسانی‌های میانای برنامه‌سازی کاربردی قالب تمام‌صفحه

برداشتن «میانای برنامه‌سازی کاربردی» قدیمی «تبلیغ ویدیویی پاداش‌دار»

منسوخ شدن برنمای هوشمند به نفع برنمای تطبیقی

جاوا

Kotlin

برداشتن فراخوانی پس‌از خروج از برنامه

تغییر نام کلاس

روش‌ها برداشته/جایگزین شد

انتقال نسخه‌های کیت توسعه نرم‌افزار

برداشتن کلاس `mediation.VersionInfo`

برداشتن روش `getConfiguration()` در کلاس `RtbSignalData`

‫`AdManagerAdRequest.Builder` روش ارث‌بری‌شده از ابرکلاس می‌تواند زنجیره‌ای باشد