העברת SDK

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

מעבר מגרסת v23 ל-v24

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

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

החל מגרסה 24.0.0, כל האפליקציות צריכות לפעול ברמת Android API 23 לפחות כדי לפעול עם Google Mobile Ads SDK. כדי לשנות את רמת ה-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.

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

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

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

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

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

כיתות שהוסרו

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

• DynamicHeightSearchAdRequest
• SearchAdRequest
• SearchAdView

שיטות שהוסרו

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

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

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

מעבר מגרסת v22 ל-v23

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

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

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

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

מעבר מ-v21 ל-v22

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

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

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

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

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

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

מעבר מ-v20 ל-v21

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

מעדכנים את minSdkVersion ל-19 ואילך

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

אכיפת תנאי נכונות קפדני של ערך null

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

השינוי הזה עלול לשבש את האפליקציות של 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 שמגדירה את המיקום של המשתמש למטרות טירגוט של תהליך בחירת הרשת.
• השיטה getLocation() בכיתה AdRequest שמחזירה את פרטי הטירגוט לפי מיקום של המשתמש שהועברו בעבר לשיטה setLocation(Location location).
• השיטה getLocation() בכיתה MediationAdConfiguration שמחזירה את המיקום של המשתמש, אם הוא מוגדר על ידי AdRequest.

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

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

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

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

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

מעבר מגרסת v19 ל-v20

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

עדכוני API לפורמט מסך מלא

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

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

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

הסרה של ה-API הקודם של RewardedVideoAd

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

ממשק ה-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)
    }
}

הסרת קריאה חוזרת (callback) של בקשת הצטרפות לאפליקציה

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

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

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

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

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

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

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

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