این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

مهاجرت SDK

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

از نسخه 22 به نسخه 23 مهاجرت کنید

حداقل سطح API اندروید 21 است

با شروع نسخه 23.0.0، Google Mobile Ads SDK به همه برنامه‌ها نیاز دارد که در حداقل سطح Android API 21 اجرا شوند. برای تنظیم سطح API، مقدار minSdkVersion را در فایل build.gradle سطح برنامه خود به 21 یا بالاتر تغییر دهید.

روش‌های منسوخ حذف/جایگزین شدند

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.NUNKNOWN	بدون جایگزینی
AdLoader.Builder.forUnifiedNativeAd()	AdLoader.Builder.forNativeAd()
AdLoader.Builder.forCustomTemplateAd()	AdLoader.Builder.forCustomFormatAd()
AdLoader.Builder.withNativeAdOptions( `formats` com.google.android.gms.ads. NativeAdOptions)	AdLoader.Builder.withNativeAdOptions(com.google.android.gms.ads. `nativead` .NativeAdOptions)
void MobileAds.setSameAppKeyEnabled()	Boolean MobileAds.putPublisherFirstPartyIdEnabled()

از نسخه ۲۱ به نسخه ۲۲ مهاجرت کنید

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

متد MobileAds.getVersionString() در نسخه 22.0.0 به نفع MobileAds.getVersion() حذف شده است.

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

روش های حذف یا جایگزین شده است

جدول زیر تغییرات خاص نسخه 22.0.0 را فهرست می کند.

نسخه 21.0.0	نسخه 22.0.0
MobileAds.getVersionString()	MobileAds.getVersion()
NativeCustomFormatAd.getVideoMediaView()	NativeCustomFormatAd.getMediaContent()
NativeCustomFormatAd.getVideoController()	NativeCustomFormatAd.getMediaContent().getVideoController()
AdRequest.Builder.setAdInfo()	AdRequest.Builder.setAdString()
MediationRewardedVideoAdapter	آداپتور
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

از نسخه 20 به نسخه 21 مهاجرت کنید

minSdkVersion را به 19 یا بالاتر به روز کنید

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

ابطال پذیری شدید را اعمال کنید

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

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

حذف متد addNetworkExtras()

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

حذف روش های مکان یابی

روش های مکان یابی زیر در نسخه 21.0.0 حذف خواهند شد:

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

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

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

رویدادهای سفارشی ناشران را قادر می‌سازد از آن استفاده کنندمیانجیگری AdMob برای راه اندازی یک منبع آگهی آبشار که یکی از آنها نیست AdMobمنابع تبلیغاتی پشتیبانی شده

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

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

رابط های v20.0.0	v21.0.0 کلاس/رابط
رویداد سفارشی	آداپتور
CustomEventBanner
CustomEventInterstitial
CustomEventNative
CustomEventBannerListener	آداپتور ، MediationAdLoadCallback
CustomEventInterstitialListener
CustomEventListener
CustomEventNativeListener

از نسخه 19 به نسخه 20 مهاجرت کنید

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

به روز رسانی API با فرمت تمام صفحه

با شروع نسخه 20.0.0، قالب‌های تبلیغاتی بینابینی، پاداش‌دهی، تبلیغاتی با پاداش و برنامه Open برای پیروی از یک طراحی API سازگار استاندارد شده‌اند.

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

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

حذف API Legacy RewardedVideoAd

API جدیدتر RewardedAd برای اولین بار در مارس 2019 معرفی شد و برای بیش از 18 ماه بهترین API پاداش دار بوده است. در مقایسه با API قدیمی RewardedVideoAd ، پیشرفت‌های بیشتری داشته است، از جمله توانایی بارگیری بیش از یک آگهی با پاداش در یک زمان.

API قدیمی RewardedVideoAd در SDK نسخه 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);
  }
}

کاتلین

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 هرگز به عنوان یک کنترل کننده کلیک بر روی تبلیغات در نظر گرفته نشده است و تکیه بر این تماس برای گزارش کلیک ها معیار دقیقی ایجاد نمی کند. به عنوان مثال، با کلیک بر روی نماد AdChoices که یک مرورگر خارجی را راه‌اندازی می‌کند، پاسخ تماس را فراخوانی می‌کند اما به عنوان یک کلیک حساب نمی‌شود.

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

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

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

کلاس 19.5.0	کلاس 20.0.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
NativeExpressAdView	حذف شد
instream.InstreamAd	حذف شد
mediation.admob.AdMobExtras	حذف شد
همبسته	حذف شد
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 منتقل شده اند.
API های RewardedAd و InterstitialAd به روز شده اند تا با همه قالب های تمام صفحه هماهنگ شوند.
ویژگی های همبسته حذف شده است.

کلاس	v19.5.0 API	v20.0.0 API	یادداشت ها
AdSize	getPortraitBanner AdSizeWithWidth()	getPortraitAnchored AdaptiveBannerAdSize()
	getLandscapeBanner AdSizeWithWidth()	getLandscapeAnchored AdaptiveBannerAdSize()
	getCurrentOrientation BannerAdSizeWithWidth()	getCurrentOrientationAnchored AdaptiveBannerAdSize()
تبلیغات موبایلی	مقداردهی اولیه (زمینه، رشته)	MobileAds.initialize (Context، OnInitializationComplete Liner)	شناسه برنامه اکنون در AndroidManifest.xml تنظیم شده است.
	مقداردهی اولیه (Context، String، MobileAds.Settings)	مقداردهی اولیه (Context، OnInitializationComplete Lister)	کلاس تنظیمات منسوخ شده است.
	getRewardedVideo AdInstance()	حذف شد	به جای آن از RewardedAd API استفاده کنید.
AdListener	onAdFailedToLoad(int)	onAd FailedToLoad (LoadAdError)
AdListener	onAdLeftApplication()	حذف شد	قالب‌های تبلیغات تمام‌صفحه از FullscreenContentCallback به جای AdListener استفاده می‌کنند و هیچ روش مشابهی در FullscreenContentCallback وجود ندارد. این روش از AdListener حذف شده است.
VideoController	getAspectRatio()	MediaContent.getAspectRatio()
AdRequest	getGender()	حذف شد
	getBirthday()	حذف شد
	getNetworkExtras()	حذف شد
	setManualImpressions فعال شد()	حذف شد
	updateCorrelator()	حذف شد	فیلتر کردن محتوای آگهی را ببینید.
AdRequest.سازنده	setBirthday()	حذف شد
	setGender()	حذف شد
	setIsDesignedForFamilies()	حذف شد	راهنما را ببینید.
	addTestDevice()	RequestConfiguration .Builder .setTestDeviceIds()	فعال کردن تبلیغات آزمایشی را ببینید.
	tagForChildDirectedTreatment()	RequestConfiguration .Builder.setTagFor ChildDirectedTreatment()	فیلتر کردن محتوای آگهی را ببینید.
	setTagFor UnderAgeOfConsent()	RequestConfiguration .Builder.setTagFor UnderAgeOfConsent()
	setMaxAdContentRating()	RequestConfiguration .Builder .setMaxAdContentRating()
AdView	getMediationAdapter ClassName()	ResponseInfo .getMediationAdapter ClassName()	یک شی ResponseInfo اکنون از طریق متد AdView ()getResponseInfo در دسترس است.
NativeAdOptions	setImageOrientation()	setMediaAspectRatio()
NativeAdOptions	getImageOrientation	getMediaAspectRatio()
Rewarded Ad	loadAd (AdRequest، RewardedAdLoadCallback)	RewardedAd.load (Context، رشته، AdRequest، RewardedAdLoadCallback)	RewardedAd اکنون از همان رویکرد بارگذاری ثابت مانند سایر قالب‌های تمام صفحه استفاده می‌کند.
	loadAd (PublisherAdRequest، RewardedAdLoadCallback)	RewardedAd.load (Context، String، AdManagerAdRequest، RewardedAdLoadCallback)
	isLoaded()	حذف شد	فراخوانی از روش بارگذاری استاتیک، تبلیغی را ارائه می دهد که قبلاً بارگذاری شده است.
	نمایش (فعالیت، RewardedAdCallback)	نمایش (فعالیت، OnUserEarnedRewardListener)	این روش نمایش به رویکرد گسترده تر قالب تمام صفحه پایبند است.
RewardedAdLoadCallback	onRewardedAd FailedToLoad(int)	onAd FailedToLoad (LoadAdError)
	onRewardedAd FailedToLoad (LoadAdError)	onAd FailedToLoad (LoadAdError)
	onRewardedAdLoaded()	onAdLoaded (RewardedAd)
AppOpenAdLoadCallback	onAppOpenAd FailedToLoad(int)	onAd FailedToLoad (LoadAdError)
	onAppOpenAd FailedToLoad (LoadAdError)	onAd FailedToLoad (LoadAdError)
	onAppOpenAd بارگیری شد (AppOpenAd)	onAdLoaded (AppOpenAd)
RewardedInterstitialAdLoad Callback	onRewardedInterstitialAd FailedToLoad(int)	onAd FailedToLoad (LoadAdError)
	onRewardedInterstitialAd FailedToLoad(LoadAdError)	onAd FailedToLoad (LoadAdError)
	onRewardedInterstitialAd Loaded(RewardedInterstitialAd)	onAd Loaded (RewardedInterstitialAd)
InterstitialAd	جدید InterstitialAd()	InterstitialAd.load(Context، String، AdRequest، InterstitialAdLoadCallback)	InterstitialAd اکنون از همان رویکرد بارگذاری ثابت مانند سایر فرمت های تمام صفحه استفاده می کند.
InterstitialAd	setAdListener()
درخواست تبلیغ DynamicHeightSearch	getNetworkExtras()	حذف شد	کلاس NetworkExtras منسوخ شده است.
AdLoader	forContentAd()	حذف شد
	forAppInstallAd()	حذف شد
	withCorrelator()	حذف شد
	getMediationAdapter ClassName()	حذف شد