העברת SDK

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

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

בקטעי המשנה הבאים מתוארים שינויים שעלולים לשבור את התאימות לאחור והבדלים בהתנהגות בין גרסה 23 לגרסה 24 של Google Mobile Ads SDK.

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

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

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

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

הוסרו התלויות (dependencies) firebase-ads ו-firebase-ads-lite

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

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

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

הודעת קריאה חוזרת פשוטה יותר לגבי תגמול למתאמי גישור

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

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

הכיתות הוסרו

הכיתות הבאות הוסרו ללא החלפה:

• DynamicHeightSearchAdRequest
• SearchAdRequest
• SearchAdView

השיטות הוסרו

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

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

השיטות הבאות הוצאו משימוש ולא יוחלפו:

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

בקטעי המשנה הבאים מתוארים שינויים שעלולים לשבור את התאימות לאחור והבדלים בהתנהגות בין גרסה 22 לגרסה 23 של Google Mobile Ads SDK.

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

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

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

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

בקטעי המשנה הבאים מתוארים שינויים שעלולים לשבור את התאימות לאחור והבדלים בהתנהגות בין גרסה 21 לגרסה 22 של Google Mobile Ads SDK.

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

הוסר בגרסה 22.0.0 לטובת MobileAds.getVersion().MobileAds.getVersionString()

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

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

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

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

בקטעי המשנה הבאים מתוארים שינויים שעלולים לשבור את התאימות לאחור והבדלים בהתנהגות בין גרסה 20 לגרסה 21 של Google Mobile Ads SDK:

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

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

אכיפת ביטול ערך קפדני

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

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

הסרה של השיטה addNetworkExtras()

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

הסרת Legacy RewardedVideoAd API

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

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

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

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

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 callback לכל הפורמטים של המודעות, ועכשיו משתמשים ב-ProcessLifecycleOwner. שימוש ב-API ברמת מערכת ההפעלה מאפשר לכם לקבל הודעה בכל פעם שמשתמשים יוצאים מהאפליקציה, בלי קשר לשאלה אם זה קורה בגלל אינטראקציה עם מודעה או לא.

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

שינוי שם של כיתה

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

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

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

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

• הסרנו מהמחלקה MobileAds שיטות הפעלה לא עדכניות.
• חלק מהשיטות במחלקה AdRequest.Builder() הוסרו או הועברו למחלקה RequestConfiguration.
• ממשקי ה-API‏ RewardedAd ו-InterstitialAd עודכנו כדי להתאים לכל הפורמטים של מודעות במסך מלא.
• התכונות של קורלטור הוסרו.