‫Google Mobile Ads SDK נמצא במצב תחזוקה. כדי ליהנות מהעדכונים והתכונות האחרונים, כדאי migrate ל-GMA Next-Gen SDK ולהגדיר אותו.

‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

העברת גרסאות SDK

בדף הזה מפורטות העברות לגרסאות הנוכחיות והקודמות.

מעבר מגרסה 24 לגרסה 25

בסעיפי המשנה הבאים מתוארים שינויי תוכנה שעלולים לגרום לכשל והבדלים בהתנהגות בין גרסה ראשית 24 לגרסה ראשית 25 של Google Mobile Ads SDK (Legacy).

רמת ה-API המינימלית ב-Android היא 24

החל מגרסה 25.5.0, כדי להפעיל את Google Mobile Ads SDK (Legacy), כל האפליקציות צריכות לפעול ברמת API‏ 24 ומעלה של Android. כדי לשנות את רמת ה-API, משנים את הערך של minSdk בקובץ build.gradle ברמת האפליקציה ל-24 ומעלה.

הסרנו קריאות חוזרות (callbacks) של מודעות שהוצאו משימוש

הקריאות החוזרות (callbacks) הבאות של מודעות שהוצאו משימוש הוסרו מהמחלקות הבאות:

מחלקה	הסרת קריאות חוזרות (callback)	החלפה
SignalCallbacks	`onFailure(String)` `onAdFailedToShow(String)`	`onFailure(AdError)` `onAdFailedToShow(AdError)`
MediationAdLoadCallback
MediationInterstitialAdCallback
MediationRewardedAdCallback

שינויים בממשקי ה-API של גודל מודעות הבאנר המותאמות והמעוגנות

בגרסה 25.0.0, ממשקי ה-API הקיימים של גודל מודעות הבאנר המותאמות והמעוגנות הוצאו משימוש, ונוספו ממשקי API של גודל מודעות הבאנר המותאמות והמעוגנות הגדולות. Google Mobile Ads SDK (Legacy) יכולה להציג מודעות וידאו במודעות באנר באמצעות ממשקי ה-API החדשים של גודל מודעות באנר מותאמות ומעוגנות גדולות.

בטבלה הבאה מפורטים ממשקי ה-API להגדרת גודל שהוצאו משימוש והתחליפים שלהם:

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`

ה-API של השיטה getConfiguration() שהוצאה משימוש ב-RtbSignalData הוסר. במקום זאת, משתמשים ב-method‏ getConfigurations() שמחזירה רשימה של List<MediationConfiguration>.

מעבר מגרסה 23 לגרסה 24

בסעיפי המשנה הבאים מתוארים שינויי תוכנה שעלולים לגרום לכשל והבדלים בהתנהגות בין הגרסה הראשית 23 לגרסה הראשית 24 של Google Mobile Ads SDK (Legacy).

רמת ה-API המינימלית ב-Android היא 23

החל מגרסה 24.0.0, כדי להפעיל את Google Mobile Ads SDK (Legacy) בכל האפליקציות, נדרשת רמת API מינימלית של Android ‏23. כדי לשנות את רמת ה-API, משנים את הערך של minSdk בקובץ build.gradle ברמת האפליקציה ל-23 ומעלה.

שינויים באופטימיזציה של האתחול והטעינה

כברירת מחדל, הדגלים OPTIMIZE_INITIALIZATION ו-OPTIMIZE_AD_LOADING מוגדרים כ-true. מידע נוסף על הדגלים האלה זמין במאמר אופטימיזציה של האתחול והטעינה.

הוסרו יחסי התלות firebase-ads ו-firebase-ads-lite

החל מגרסה 24.0.0, גרסאות ה-SDK לא כוללות יותר את יחסי התלות firebase-ads ו-firebase-ads-lite. במקום זאת, צריך להשתמש ביחסי התלות play-services-ads.

הגדרת פרמטרים של טירגוט בהתאמה אישית

כדי להגדיר טירגוט בהתאמה אישית בבקשה להצגת מודעה, משתמשים ב-addCustomTargeting().

הסרנו ממשקי API של כיוון מסך שהוצאו משימוש במודעות בפתיחת האפליקציה

הוסרו AppOpenAd.load() שיטות שמקבלות פרמטר קלט של כיוון. במקום זאת, צריך להשתמש ב-methods של AppOpenAd.load() שלא מקבלות כיוון.
הוסר AppOpenAdOrientation enum.

קריאה חוזרת (callback) פשוטה יותר של תגמול למתאמים של תהליך בחירת הרשת (Mediation)

בגרסה 24.0.0 נוספה הקריאה החוזרת (callback) onUserEarnedReward() ב-MediationRewardedAdCallback, והוצאה משימוש onUserEarnedReward(RewardItem). מתאמים של תהליך בחירת הרשת (Mediation) צריכים להתחיל להפעיל את onUserEarnedReward() כשהמשתמש מקבל תגמול.

כשמעבירים קריאות חוזרות (callbacks) ממתאמים של תהליך בחירת הרשת, כל הגרסאות של Google Mobile Ads SDK (Legacy) מחזירות את התגמול שהוגדר בממשק המשתמש של Ad Manager ב-OnUserEarnedRewardListener.

הכיתות הוסרו

המחלקות הבאות הוסרו בלי תחליף:

DynamicHeightSearchAdRequest
SearchAdRequest
SearchAdView

השיטות הוסרו

ה-methods הבאות הוסרו בלי תחליף:

מחלקה	שיטה
RewardedInterstitialAdLoadCallback	`onRewardedInterstitialAdLoaded()`
	`onRewardedInterstitialAdFailedToLoad(int)`
	`onRewardedInterstitialAdFailedToLoad(LoadAdError)`

שיטות שהוצאו משימוש

ה-methods הבאות הוצאו משימוש ואין להן תחליף:

מחלקה	שיטה
Adapter	`loadInterscrollerAd()`
RtbAdapter	`loadRtbInterscrollerAd()`

מעבר מגרסה 22 לגרסה 23

בסעיפי המשנה הבאים מתוארים שינויי תוכנה שעלולים לגרום לכשל והבדלים בהתנהגות בין הגרסה הראשית 22 לגרסה הראשית 23 של Google Mobile Ads SDK (Legacy).

רמת ה-API המינימלית ב-Android היא 21

החל מגרסה 23.0.0, כדי להפעיל את Google Mobile Ads SDK (Legacy), כל האפליקציות צריכות להיות ברמת API ‏21 ומעלה של Android. כדי לשנות את רמת ה-API, משנים את הערך של minSdkVersion בקובץ build.gradle ברמת האפליקציה ל-21 ומעלה.

אפשר לשרשר `AdManagerAdRequest.Builder` שיטות שעוברות בירושה ממחלקה ראשית

בגרסה 23.0.0, אפשר לשרשר יחד את השיטות של AdManagerAdRequest.Builder שעברו בירושה מההורה שלו כדי ליצור AdManagerAdRequest באמצעות קריאה אחת:

Java

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.

שיטות שהוצאו משימוש הוסרו או הוחלפו

גרסה 22.0.0 של ה-API	‫API בגרסה 23.0.0
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()

מעבר מגרסה 21 לגרסה 22

בסעיפי המשנה הבאים מתוארים שינויי תוכנה שעלולים לגרום לכשל והבדלים בהתנהגות בין הגרסה הראשית 21 לגרסה הראשית 22 של Google Mobile Ads SDK (Legacy).

משתמשים ב-MobileAds.getVersion()‎ כדי לקבל את הגרסה של Google Mobile Ads SDK (Legacy)

השיטה MobileAds.getVersionString() הוסרה בגרסה 22.0.0, ובמקומה משתמשים ב-MobileAds.getVersion().

השיטה החדשה מחזירה את מספר הגרסה החיצונית הצפוי, לדוגמה 22.0.0. מידע נוסף על השינוי הזה זמין במאמר שימוש בשיטה החדשה של Google Mobile Ads SDK getVersion().

הסרה של NativeCustomFormatAd.getVideoMediaView()‎ שהוצא משימוש

בגרסה 21, Google Mobile Ads SDK (Legacy) סיפק את השיטה NativeCustomFormatAd.getVideoMediaView() כדי לקבל את נכס המדיה של פורמט מודעה מותאם אישית מודעה מותאמת.

החל מגרסה 22, אתם יוצרים 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());
    }
}

מידע נוסף זמין במדריך בנושא מודעות מותאמות אישית.

שיטות שהוסרו או הוחלפו

בטבלה הבאה מפורטים השינויים הספציפיים בגרסה 22.0.0:

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

מעבר מגרסה 20 לגרסה 21

בסעיפי המשנה הבאים מתוארים שינויי תוכנה שעלולים לגרום לכשל והבדלים בהתנהגות בין גרסאות ראשיות 20 ו-21 של Google Mobile Ads SDK (Legacy):

צריך לעדכן את minSdkVersion ל-19 ומעלה

החל מגרסה 21.0.0, כדי להפעיל את Google Mobile Ads SDK (Legacy), כל האפליקציות צריכות להיות ברמת API מינימלית של Android‏ 19. כדי לשנות את רמת ה-API, משנים את הערך של minSdkVersion בקובץ ה-build של האפליקציה ל-19 ומעלה.

אכיפה של ערכי null מחמירים

כהכנה לאכיפה של יכולת הכלה מחמירה של ערכי null, אנוטציות @NonNull נוספות לכל ממשקי ה-API שלא הגדירו בעבר באופן מפורש את מאפיין המציין אם ערך יכול להיות ריק (nullability).

השינוי הזה עלול לשבש את האפליקציות של Kotlin ואפליקציות שמשתמשות במסגרות לבדיקת ערכי null ב-Java, אם יש הפרות של בטיחות ערכי null והן לא טיפלו בעבר בערכי null בצורה בטוחה (אפשר לעיין במסמכי התיעוד של Kotlin בנושא בטיחות ערכי null).

הסרת השיטה addNetworkExtras()‎

השיטה addNetworkExtras() שמעבירה פרמטרים נוספים כמו מופע של NetworkExtras למתאם ספציפי של רשת מודעות הוצאה משימוש בגרסה 20.3.0 של ה-SDK, ותוסר בגרסה 21.0.0. במקום זאת, צריך להשתמש ב-method‏ addNetworkExtrasBundle() מאותה מחלקה AdRequest.Builder.

הסרה של שיטות מיקום

השיטות הבאות למיקום יוסרו בגרסה 21.0.0:

השיטה setLocation(Location location) במחלקה AdRequest.Builder שמגדירה את מיקום המשתמש למטרות טירגוט בתהליך בחירת הרשת (Mediation).
השיטה getLocation() במחלקה AdRequest שמחזירה את פרטי הטירגוט למיקום גיאוגרפי של המשתמש, שהועברו קודם לשיטה setLocation(Location location).
השיטה getLocation() במחלקה MediationAdConfiguration שמחזירה את המיקום של המשתמש, אם הוא מוגדר על ידי AdRequest.

‫Google לא משתמשת בנתוני המיקום כדי לטרגט מודעות. אם צריך, אתם יכולים להשתמש בממשקי API של צד שלישי כדי לספק את המידע לרשתות מודעות של צד שלישי.

הוצאה משימוש של ממשקי אירועים בהתאמה אישית

אירועים בהתאמה אישית מאפשרים לבעלי תוכן דיגיטלי שמשתמשים בתהליך בחירת הרשת (Mediation) להגדיר מקור מודעות ב-Waterfall שהוא לא אחד ממקורות המודעות הנתמכים ב-Ad Manager.

כל הממשקים של אירועים מותאמים אישית הוצאו משימוש, ובמקומם צריך להשתמש במחלקה Adapter ובממשק MediationAdLoadCallback.

בטבלה הבאה מפורטים המחלקה או הממשק המתאימים שבהם צריך להשתמש לכל ממשק של אירוע בהתאמה אישית, החל מגרסה 21.0.0:

ממשקים בגרסה 20.0.0	מחלקה/ממשק בגרסה 21.0.0
CustomEvent	מתאם
CustomEventBanner
CustomEventInterstitial
CustomEventNative
CustomEventBannerListener	Adapter, MediationAdLoadCallback
CustomEventInterstitialListener
CustomEventListener
CustomEventNativeListener

מעבר מגרסה 19 לגרסה 20

בגרסה 20.0.0 יש הרבה שינויי תוכנה שעלולים לגרום לכשל. בגרסה 19.7.0 הוספנו הרבה ממשקי API חדשים, והוצאנו משימוש או שינינו את השם של הרבה מחלקות כהכנה לגרסה 20.0.0. במדריך הזה מפורטים השינויים העיקריים בגרסה 20.0.0.

עדכונים ב-API של פורמט מסך מלא

החל מגרסה 20.0.0, הפורמטים של מודעות מעברון, מודעות מתגמלות, מודעות מעברון מתגמלות ומודעות בפתיחת האפליקציה עברו סטנדרטיזציה כדי להתאים לעיצוב עקבי של ה-API.

כל ממשקי ה-API של פורמטים במסך מלא פועלים לפי העקרונות הבאים:

שיטת טעינה סטטית
מנגנון דומה של קריאה חוזרת (callback) או handler לטעינה
הסתמכות על המחלקה FullScreenContentCallback בקריאות חוזרות (callbacks) של המצגת

הסרת RewardedVideoAd API מדור קודם

‫RewardedAd API החדש יותר הוצג לראשונה במרץ 2019, והוא ה-API המועדף למודעות מתגמלות כבר יותר מ-18 חודשים. הוא כולל יותר שיפורים בהשוואה ל-API הקודם של RewardedVideoAd, כולל היכולת לטעון יותר ממודעה מתגמלת אחת בכל פעם.

ה-API הקודם של RewardedVideoAd הוסר בגרסה 20.0.0 של ה-SDK.

הוצאה משימוש של מודעות באנר חכמות לטובת מודעות באנר מותאמות

מודעות באנר חכמות הוצאו משימוש, ובמקומן אנחנו ממליצים להשתמש במודעות באנר מותאמות. מודעות באנר מותאמות מספקות ביצועים טובים יותר וגמישות רבה יותר בהגדרת רוחב המודעה. אם אתם מעדיפים להמשיך להשתמש במודעות באנר ברוחב מלא, אתם עדיין יכולים לעשות זאת באמצעות מודעות באנר מותאמות, כמו שמוצג בקטע הקוד הבא:

Java

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)
    }
}

הסרת קריאה חוזרת (callback) של אפליקציה כשיוצאים ממנה

הקריאה החוזרת (callback) של onAdLeftApplication לכל הפורמטים של המודעות הוסרה, ובמקומה יש להשתמש ב-ProcessLifecycleOwner. שימוש ב-API ברמת מערכת ההפעלה מאפשר לכם לקבל התראה בכל פעם שמשתמשים יוצאים מהאפליקציה, גם אם זה לא קשור לאינטראקציה עם מודעה.

חשוב לציין שהקריאה החוזרת (callback) onAdLeftApplication אף פעם לא נועדה לשמש כ-handler של קליקים על מודעות, והסתמכות על הקריאה החוזרת הזו לדיווח על קליקים לא הניבה מדד מדויק. לדוגמה, קליק על הסמל של AdChoices שהפעיל דפדפן חיצוני הפעיל את הקריאה החוזרת (callback), אבל לא נספר כקליק.

שינוי שמות של כיתות

בטבלה הבאה מפורטים שמות ספציפיים של כיתות שהשתנו או הוסרו:

השם של רוב המחלקות שקשורות ל-UnifiedNativeAd שונה ל-NativeAd.
התצוגות והמחלקות MobileAds.Settings,‏ NativeExpressAdView,‏ NativeAppInstallAd,‏ NativeContentAd ו-InstreamAd הוסרו.
כל המחלקות עם הקידומת Publisher הוחלפו בקידומת AdManager.
שם החבילה של InterstitialAd השתנה.

‫19.5.0 Class	כיתה 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	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.
חלק מה-methods מהמחלקה AdRequest.Builder() הוסרו או הועברו למחלקה RequestConfiguration.
ממשקי ה-API של RewardedAd ו-InterstitialAd עודכנו כדי להתאים לכל הפורמטים של מסך מלא.
התכונות של Correlator הוסרו.

מחלקה	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)‎
AdListener	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` זמין באמצעות ה-method‏ `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()	הוסר	הקריאה החוזרת (callback) משיטת הטעינה הסטטית מספקת מודעה שכבר נטענה.
	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 משתמש באותה גישת טעינה סטטית כמו פורמטים אחרים של מסך מלא.
PublisherInterstitialAd	setAdListener()
DynamicHeightSearchAdRequest	getNetworkExtras()	הוסר	המחלקה NetworkExtras הוצאה משימוש.
AdLoader	forContentAd()‎	הוסר
	forAppInstallAd()‎	הוסר
	withCorrelator()	הוסר
	getMediationAdapterClassName()‎	הוסר

העברת גרסאות SDK קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

מעבר מגרסה 24 לגרסה 25

רמת ה-API המינימלית ב-Android היא 24

הסרנו קריאות חוזרות (callbacks) של מודעות שהוצאו משימוש

שינויים בממשקי ה-API של גודל מודעות הבאנר המותאמות והמעוגנות

הסרה של כיתה אחת (mediation.VersionInfo)

הסרת השיטה getConfiguration() במחלקה RtbSignalData

מעבר מגרסה 23 לגרסה 24

רמת ה-API המינימלית ב-Android היא 23

שינויים באופטימיזציה של האתחול והטעינה

הוסרו יחסי התלות firebase-ads ו-firebase-ads-lite

הגדרת פרמטרים של טירגוט בהתאמה אישית

הסרנו ממשקי API של כיוון מסך שהוצאו משימוש במודעות בפתיחת האפליקציה

קריאה חוזרת (callback) פשוטה יותר של תגמול למתאמים של תהליך בחירת הרשת (Mediation)

הכיתות הוסרו

השיטות הוסרו

שיטות שהוצאו משימוש

מעבר מגרסה 22 לגרסה 23

רמת ה-API המינימלית ב-Android היא 21

אפשר לשרשר AdManagerAdRequest.Builder שיטות שעוברות בירושה ממחלקה ראשית

Java

Kotlin

שיטות שהוצאו משימוש הוסרו או הוחלפו

מעבר מגרסה 21 לגרסה 22

משתמשים ב-MobileAds.getVersion()‎ כדי לקבל את הגרסה של Google Mobile Ads SDK (Legacy)

הסרה של NativeCustomFormatAd.getVideoMediaView()‎ שהוצא משימוש

v22

v21

שיטות שהוסרו או הוחלפו

מעבר מגרסה 20 לגרסה 21

צריך לעדכן את minSdkVersion ל-19 ומעלה

אכיפה של ערכי null מחמירים

הסרת השיטה addNetworkExtras()‎

הסרה של שיטות מיקום

הוצאה משימוש של ממשקי אירועים בהתאמה אישית

מעבר מגרסה 19 לגרסה 20

עדכונים ב-API של פורמט מסך מלא

הסרת RewardedVideoAd API מדור קודם

הוצאה משימוש של מודעות באנר חכמות לטובת מודעות באנר מותאמות

Java

Kotlin

הסרת קריאה חוזרת (callback) של אפליקציה כשיוצאים ממנה

שינוי שמות של כיתות

אמצעי התשלום שהוסרו או הוחלפו

העברת גרסאות SDK

הסרה של כיתה אחת (`mediation.VersionInfo`)

הסרת השיטה `getConfiguration()` במחלקה `RtbSignalData`

אפשר לשרשר `AdManagerAdRequest.Builder` שיטות שעוברות בירושה ממחלקה ראשית