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

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

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

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

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

از نسخه ۲۵.۵.۰، Google Mobile Ads SDK (Legacy) همه برنامه‌ها را ملزم می‌کند که حداقل در سطح میانای برنامه‌سازی کاربردی Android ۲۴ اجرا شوند. برای تنظیم سطح میانای برنامه‌سازی کاربردی، مقدار 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‏ ۲۳ است

از نسخه ۲۴.۰.۰، Google Mobile Ads SDK (Legacy) همه برنامه‌ها را ملزم می‌کند که حداقل در سطح میانای برنامه‌سازی کاربردی Android نسخه ۲۳ اجرا شوند. برای تنظیم سطح میانای برنامه‌سازی کاربردی، مقدار 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 enum حذف شد.

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

نسخه ۲۴.۰.۰، 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()

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

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

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

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

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

در نسخه ۲۳.۰.۰، 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.

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

v22.0.0 API v23.0.0 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()

انتقال از نسخه ۲۱ به نسخه ۲۲

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

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

روش MobileAds.getVersionString() در نسخه ۲۲.۰.۰ به‌نفع MobileAds.getVersion() برداشته شده است.

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

برداشتن 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 آداپتور
MediationRewardedVideoAdListener
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

انتقال از نسخه ۲۰ به نسخه ۲۱

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

به‌روزرسانی minSdkVersion به ۱۹ یا بالاتر

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

اجرای سخت‌گیرانه تهی‌پذیری

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

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

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

روش addNetworkExtras() که پارامترهای اضافی را به‌عنوان نمونه NetworkExtras به آداپتور شبکه آگهی خاصی ارسال می‌کند در کیت توسعه نرم‌افزار نسخه ۲۰.۳.۰ منسوخ شده است و در نسخه ۲۱.۰.۰ برداشته خواهد شد. درعوض از روش addNetworkExtrasBundle() از همان کلاس AdRequest.Builder استفاده کنید.

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

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

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

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

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

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

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

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

میاناهای نسخه ۲۰.۰.۰ کلاس/ میانا نسخه ۲۱.۰.۰
CustomEvent آداپتور
CustomEventBanner
CustomEventInterstitial
CustomEventNative
CustomEventBannerListener Adapter, MediationAdLoadCallback
CustomEventInterstitialListener
CustomEventListener
CustomEventNativeListener

انتقال از نسخه ۱۹ به نسخه ۲۰

تغییرات ناسازگار زیادی در نسخه ۲۰.۰.۰ وجود دارد. نسخه ۱۹.۷.۰ میاناهای برنامه‌سازی کاربردی جدید زیادی را معرفی کرد و بسیاری از کلاس‌ها را برای آماده‌سازی نسخه ۲۰.۰.۰ منسوخ کرد یا نام آن‌ها را تغییر داد. این راهنما تغییرات عمده در نسخه ۲۰.۰.۰ را برجسته می‌کند.

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

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

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

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

برداشتن Legacy RewardedVideoAd API

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

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

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

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

جاوا

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 برداشته شده است. استفاده از میانای برنامه‌سازی کاربردی سطح سیستم‌عامل به شما اطلاع می‌دهد که کاربران چه زمانی برنامه شما را ترک می‌کنند، صرف‌نظر از اینکه این ترک به‌دلیل تعامل با آگهی باشد یا نه.

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

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

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

  • نام اکثر کلاس‌های مرتبط با UnifiedNativeAd به NativeAd تغییر کرده است.
  • کلاس‌ها و نماهای MobileAds.Settings،‏ NativeExpressAdView،‏ NativeAppInstallAd، NativeContentAd، و InstreamAd برداشته شده‌اند.
  • همه کلاس‌های دارای پیشوند Publisher با پیشوند AdManager جایگزین شده‌اند.
  • نام بسته InterstitialAd تغییر کرده است.
کلاس 19.5.0 کلاس ۲۰.۰.۰
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

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

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

  • روش‌های مقداردهی اولیه قدیمی از کلاس 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) کلاس Settings منسوخ شده است.
getRewardedVideoAdInstance() برداشته‌شده درعوض از RewardedAd API استفاده کنید.
AdListener onAdFailedToLoad(int) onAdFailedToLoad(LoadAdError)
onAdLeftApplication() برداشته‌شده قالب‌های آگهی تمام‌صفحه از FullscreenContentCallback به‌جای AdListener استفاده می‌کنند و روش معادلی در 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()
getImageOrientation getMediaAspectRatio()
RewardedAd loadAd(AdRequest, RewardedAdLoadCallback) RewardedAd.load(Context, String, AdRequest, RewardedAdLoadCallback) ‫RewardedAd اکنون از همان رویکرد بارگذاری ایستا مانند سایر قالب‌های تمام‌صفحه استفاده می‌کند.
loadAd(PublisherAdRequest, RewardedAdLoadCallback) RewardedAd.load(Context, String, AdManagerAdRequest, RewardedAdLoadCallback)
isLoaded() برداشته‌شده فراخوانی برگشتی از روش بارگیری ایستا آگهی‌ای را ارائه می‌دهد که ازقبل بار شده است.
show(Activity, RewardedAdCallback) show(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 اکنون از همان رویکرد بارگذاری ایستا مانند سایر قالب‌های تمام‌صفحه استفاده می‌کند.
setAdListener()
DynamicHeightSearchAdRequest getNetworkExtras() برداشته‌شده کلاس NetworkExtras منسوخ شده است.
AdLoader forContentAd() برداشته‌شده
forAppInstallAd() برداشته‌شده
withCorrelator() برداشته‌شده
getMediationAdapterClassName() برداشته‌شده