הערות מוצר

גרסה תאריך פרסום הערות
24.9.0 2025‑12‑11
  • תיקוני באגים ושיפורי ביצועים.
24.8.0 2025‑11‑20
  • תוקנה בעיה שגרמה לכך שתרגומים של משאבי SDK לא הופיעו בגרסאות 24.6.0 ו-24.7.0.
  • הוצא משימוש NativeAdViewHolder. במקום זאת, אפשר להשתמש ב-NativeAdView כדי להציג מודעות מותאמות.
  • הוצאנו משימוש את השיטות AdPreloader.getConfigurations() ו-AdPreloader.getConfiguration(preloadId). אין שיטות חלופיות לשיטות האלה.
24.7.0 2025‑10‑09
  • תוקנה הערה חסרה של nullable בסוג ההחזרה של NativeCustomFormatAd.getDisplayOpenMeasurement(). הפונקציונליות לא משתנה, כי היכולת של השיטה להחזיר null הייתה צפויה כבר קודם.
  • הורדנו את התלות androidx.webkit:webkit מגרסה 1.14.0 לגרסה 1.12.1 כדי לשמור על תאימות לפלאגין Android Gradle 7.3.1.
24.6.0 2025‑09‑08
  • מעכשיו אפשר להטמיע מתאמי גישור של מודעות Native‏ NativeAdMapper.destroy() כדי לקבל התראה כשמודעת Native נמחקת.
24.5.0 ‫2025‑07‑24
  • בעלי אפליקציות שיש להם גישה לתכונה יכולים עכשיו להשתמש במזהה מיקום מודעה בכל פורמט של מודעה.
  • תוקנה קריסה עם הודעת השגיאה Fatal Exception: java.util.ConcurrentModificationException.
24.4.0 2025‑06‑09
  • הוספנו כמה ממשקי API חדשים לטעינה מראש של מודעות והוצאנו משימוש ממשקי API קיימים. טעינה מראש של מודעות היא עדיין תכונת אלפא מוגבלת.
24.3.0 ‫2025‑05‑19
  • עדכנו את התלות ב-User Messaging Platform SDK לגרסה 3.2.0.
24.2.0 ‫2025‑04‑07
  • תיקוני באגים ושיפורי ביצועים.
24.1.0 ‫2025‑03‑12
  • הגרסה המינימלית של Kotlin היא עכשיו 2.1.0.
  • תיקוני באגים ושיפורי ביצועים.
  • המוצר play-services-ads-lite עובר לקצב הפצה מופחת, ולא מופץ עם הגרסה הזו. מידע נוסף זמין במאמרי העזרה בנושא Lite SDK.
24.0.0 2025‑02‑24
  • שינויי תוכנה שעלולים לגרום לכשלים:
    • הגדרנו רמת API מינימלית של Android ‏23.
    • הסרנו את כל ממשקי ה-API שקשורים לפורמט המודעה שמוצגת בין פסקאות.
    • הוסרו ממשקי ה-API של AppOpenAd orientation שהוצאו משימוש.
    • הוסרו הכיתות SearchAdView ו-DynamicHeightSearchAdRequest.
  • עדכנו את התלות ב-User Messaging Platform SDK לגרסה 3.1.0.
  • התכונה אופטימיזציה של ההפעלה וטעינת המודעות זמינה עכשיו לכלל המשתמשים, והיא מופעלת כברירת מחדל.
  • נוספו MediationRewardedAdCallback.onUserEarnedReward() והוצאו משימוש MediationRewardedAdCallback.onUserEarnedReward(RewardItem). מתאמי הגישור צריכים לעבור עדכון כדי להשתמש בשיטה החדשה.
  • הסרנו את תג המאפיין android.adservices.AD_SERVICES_CONFIG מקובץ המניפסט של ה-SDK כדי למנוע התנגשויות מיזוג באפליקציות ש מגדירות שירותי מודעות ספציפיים ל-API.
23.6.0 2024‑12‑03
  • הוצאנו משימוש את כל ממשקי ה-API שקשורים לפורמט המודעה בין פסקאות. לדוגמה, AdSize.getCurrentOrientationInterscrollerAdSize().
23.5.0 ‫2024‑10‑29
  • עדכנו את הודעות ה-logcat על כשל בטעינת מודעות שנוספו בגרסה 23.4.0 מרמת שגיאה לרמת מידע.
  • שיפור המונטיזציה של מודעות בהתאמה אישית בכרטיסיות בהתאמה אישית ב-WebView API for ads.
23.4.0 ‫2024‑09‑30
  • אם טעינת המודעה נכשלת, מוצגת עכשיו הודעה ב-logcat עם הכיתוב ad failed to load במעקב אחר מחסנית הקריאות של הכשל. יומני מעקב אחר מחסנית הקריאות מתעדים את ההודעה הזו כשגיאה, אבל לא מציינים קריסה. כדי להבין כשלים נפוצים בטעינת מודעות, אפשר לעיין במאמר בנושא ניפוי באגים בהודעות נפוצות של רישום שגיאות. אם מופיעה שגיאה חוזרת שקשורה להצגת מודעות ולא מתועדת, צריך לשתף את מעקב המחסנית עם התמיכה של Google Mobile Ads SDK.
  • נוספו addCustomTargeting() שיטות ל-AdRequest.
23.3.0 ‫2024‑08‑12
  • עדכנו את התלות ב-User Messaging Platform SDK לגרסה 3.0.0.
23.2.0 2024‑06‑27
  • נוסף AdView.isCollapsible() כדי לציין אם מודעת הבאנר האחרונה שנטענה ניתנת לכיווץ.
23.1.0 2024‑05‑09
  • הערך המינימלי הוא compileSdkVersion‏ 34.
  • מתאמי גישור מותאמים: הוצאו משימוש loadNativeAd ו-loadRtbNativeAd() לטובת loadNativeAdMapper() ו-loadRtbNativeAdMapper(). מתאמים צריכים לעבור לשימוש בשיטות הטעינה החדשות האלה ובאובייקטים הקשורים.
23.0.0 2024‑03‑07
  • שינויי תוכנה שעלולים לגרום לכשלים:
    • רמת ה-API המינימלית ב-Android עלתה ל-21.
    • כדי להמשיך לאסוף מדדי משתמשים ב-AdMob, צריך לקשר את האפליקציה ב-AdMob ל-Firebase ולשלב את Google Analytics for Firebase SDK באפליקציה.
    • הוסר ה-API‏ MobileAds.enableSameAppKey() שהוצא משימוש ועודכנה השיטה החלופית MobileAds.putPublisherFirstPartyIdEnabled() כדי להחזיר ערך בוליאני שקובע אם השמירה של אמצעי הבקרה הצליחה או לא.
    • Native Ads:
      • בוצעה הסרה של AdLoader.forUnifiedNativeAd(). במקום זאת, אתם צריכים להשתמש ב-AdLoader.forNativeAd().
      • בוצעה הסרה של AdLoader.forCustomTemplateAd(). במקום זאת, אתם צריכים להשתמש ב-AdLoader.forCustomFormatAd().
    • הוסר AdFormat.UNKNOWN ללא החלפה. אפליקציות שמשתמשות ב-QueryInfo.generate() חייבות להעביר פורמט מודעה.
    • אפשר עכשיו לשרשר יחד את השיטות של AdManagerAdRequest.Builder שירש מאב האב שלו כדי ליצור אובייקט משיחה אחת. השינוי הזה דרש שינוי במבנה ההורשה, כך ש-AdManagerAdRequest.Builder לא יורש יותר מ-AdRequest.Builder.
  • נוספה הפונקציה MobileAds.registerCustomTabsSession() כדי לשפר את המונטיזציה של מודעות בכרטיסיות מותאמות אישית. מידע נוסף זמין במאמר אופטימיזציה של כרטיסיות מותאמות אישית.
  • עדכנו את התלות ב-User Messaging Platform SDK לגרסה 2.2.0.
22.6.0 2023‑12‑06
  • הוצא משימוש MobileAds.setSameAppKeyEnabled() ושם ה-method שונה ל-MobileAds.putPublisherFirstPartyIdEnabled().
  • המאפיין AdFormat.UNKNOWN הוצא משימוש, ואין לו תחליף. אפליקציות שמשתמשות ב-QueryInfo.generate() חייבות להעביר פורמט מודעה.
‫22.5.0 2023‑10‑30
22.4.0 2023‑09‑13
  • נדרש מינימום compileSdkVersion של 33.
  • הכלי לבדיקת מודעות: הוספנו תמיכה ב-SDK לבקשה ולהצגה של מודעות שנשלחו דרך ממשק המשתמש של הכלי לבדיקת מודעות.
  • נוספה שיטה חדשה, QueryInfo.generate(), שמקבלת מזהה של יחידת מודעות.
  • ההרחבה מאפשרת לבצע בדיקות ראשוניות של גרסת הבטא של Attribution Reporting API ושל גרסת הבטא של Topics API, שהם ממשקי API לשמירה על הפרטיות. מידע נוסף זמין במדריך בנושא ארגז החול לפרטיות ב-Android.
22.3.0 2023‑08‑22
22.2.0 2023‑07‑05
‫22.1.0 2023‑05‑18
  • הכלי לבדיקת מודעות: הוספנו אפשרות להפעיל בקשות להצגת מודעות מממשק המשתמש של הכלי לבדיקת מודעות במכשירים שאין בהם שירותי Google Play.
22.0.0 2023‑03‑29
  • שינויי תוכנה שעלולים לגרום לכשלים:
    • הוסרו NativeCustomFormatAd.getVideoController() ו-NativeCustomFormatAd.getVideoMediaView() לטובת NativeCustomFormatAd.getMediaContent().
    • הסרנו את MobileAds.getVersionString() לטובת MobileAds.getVersion().
    • הסרנו את AdRequest.Builder.setAdInfo() לטובת AdRequest.Builder.setAdString().
    • הפונקציה AdManager.Builder.setAdString() מחזירה עכשיו סוג AdRequest.Builder.
    • הוסרו MediationRewardedVideoAdAdapter וממשקי API משויכים לטובת Adapter.
  • AdRequest.getRequestAgent() נוסף.
  • גישור: ערך ההחזרה של ‫Adapter.getVersionInfo() ושל Adapter.getSDKVersionInfo() השתנה מהסוג com.google.android.gms.ads.mediation.VersionInfo לסוג com.google.android.gms.ads.VersionInfo. מומלץ להחזיר את הסוג החדש של מתאמים כי com.google.android.gms.ads.mediation.VersionInfo הוצא משימוש.
21.5.0 2023‑01‑31
  • מודעות לפתיחת אפליקציות: הוצאנו משימוש שיטות AppOpenAd.load() שמקבלות פרמטר קלט של כיוון, והוספנו שיטות חדשות שלא מקבלות קלט של כיוון. השיטות החדשות קובעות את הכיוון בזמן השליחה של הבקשה, בהתאם להתנהגות של פורמטים אחרים במסך מלא.
  • בחירת רשת: נוספה תמיכה בבחירת רשת למודעות בפתיחת אפליקציה.
  • הוסרה ההרשאה RECEIVE_BOOT_COMPLETED מהתלות androidx.work:work-runtime. אם אתם משתמשים בגרסאות של Gradle שקודמות ל-7.2.0 ונדרשת הרשאה לאפליקציה שלכם, יכול להיות שתצטרכו להצהיר על ההרשאה באופן מפורש במניפסט של Android.
21.4.0 ‫2022‑12‑14
  • מעכשיו נדרש מזהה אפליקציה ב-Ad Manager לכל האפליקציות ב-Ad Manager, והפורמט הנדרש הוא ca-app-pub-################~##########. פרטים נוספים מופיעים במאמר בנושא הגדרת האפליקציה.
  • הכלי לבדיקת מודעות: הרחבת התמיכה ב-SDK להצגת מודעות באנר ומודעות מותאמות שהתבקשו דרך ממשק המשתמש של הכלי לבדיקת מודעות.
  • הוספנו תמיכה במזהה מאינטראקציה ישירה של בעל האפליקציה (שנקרא בעבר מפתח אפליקציה זהה) כדי לעזור לכם להציג מודעות בהתאמה אישית שרלוונטיות יותר למשתמשים על סמך הנתונים שנאספו מהאפליקציות שלכם.
  • גרסת ההפצה הרשמית של דור QueryInfo.
21.3.0 2022‑10‑10
21.2.0 2022‑09‑06
  • הכלי לבדיקת מודעות: נוספה תמיכה ב-SDK לייצוא יומני בקשות להצגת מודעות באמצעות Android Sharesheet.
21.1.0 ‫2022‑07‑14
  • הוספנו תמיכה במונטיזציה של מודעות ב-WebView. פרטים נוספים זמינים במאמר בנושא שילוב WebView API for Ads.
  • נוסף getResponseExtras() אל ResponseInfo שיכול להחזיר מידע נוסף על תגובת המודעה.
‫21.0.0 2022‑05‑25
  • שינויי תוכנה שעלולים לגרום לכשלים:
    • כדי להפעיל את Google Mobile Ads SDK, כל האפליקציות צריכות להיות ברמת API מינימלית של Android‏ 19.
    • הוספנו הערות @NonNull לכל שיטה שלא הוגדרה בה בעבר אפשרות מפורשת לערך null.
    • הוסרה השיטה AdRequest.Builder.addNetworkExtras(). במקום זאת, אתם צריכים להשתמש ב-AdRequest.Builder.addNetworkExtrasBundle().
    • הוסרו שיטות המיקום הבאות:
      • setLocation() בתאריך AdRequest.Builder
      • getLocation() ב-AdRequest
      • getLocation() בתאריך MediationAdConfiguration
  • נוספו פקודות מאניפסט לאופטימיזציה של האתחול וטעינת המודעות. פרטים נוספים זמינים במאמר בנושא אופטימיזציה של האתחול וטעינת המודעות.
  • הוצא משימוש MobileAds.getVersionString(). במקום זאת, אתם צריכים להשתמש ב-MobileAds.getVersion().
  • הוספנו את השיטה getLoadedAdapterResponseInfo() ב-ResponseInfo.
  • הוספנו את השיטות הבאות ב- AdapterResponseInfo:
    • getAdSourceName()
    • getAdSourceId()
    • getAdSourceInstanceName()
    • getAdSourceInstanceId()
  • נוספה תמיכה באירועים מותאמים אישית בכלי לבדיקת מודעות.
20.6.0 2022‑02‑22
20.5.0 2021‑11‑18
  • הוספנו תמיכה במכשירי Android 12 לאפליקציות שמטרגטות את API 31.
  • נוספה תמיכה ב מזהה קבוצת אפליקציות לתרחישי שימוש כמו דיווח ומניעת הונאה.
20.4.0 2021‑09‑22
  • החל מגרסה 20.4.0,‏ Google Mobile Ads SDK כולל את ההרשאה com.google.android.gms.permission.AD_ID בקובץ המניפסט של ה-SDK, שמשולב באופן אוטומטי בקובץ המניפסט של האפליקציה באמצעות כלי ה-build של Android. מידע נוסף על הצהרת ההרשאה AD_ID, כולל הסברים איך להשבית אותה, זמין במאמר הזה במרכז העזרה של Play Console.
  • הוספנו את onAdClicked() השיחה החוזרת אל FullScreenContentCallback.
  • הפעלת ה-callback‏ onAdClicked() במחלקה AdListener עבור פורמט המודעות המותאמות.
20.3.0 2021‑08‑23
20.2.0 2021‑06‑08
  • נוספה תמיכה בכלי לבדיקת מודעות (בטא) לבעלי תוכן דיגיטלי שמשתמשים ב-Google Ad Manager.
20.1.0 2021‑04‑29
‫20.0.0 2021‑04‑05
  • שינויי תוכנה שעלולים לגרום לכשלים:
    • הוסר API מדור קודם Interstitial.
    • הוסר API מדור קודם RewardedVideoAd.
    • הוסרו כיתות עם הקידומת Publisher (לדוגמה: PublisherAdView).
    • בוצעה הסרה של CustomRenderedAd.
    • בוצעה הסרה של InstreamAd.
    • בוצעה הסרה של SearchAdRequest.
    • בוצעה הסרה של AdListener.onAdLeftApplication().
    • הוסרו NativeAppInstallAd, NativeContentAd ו-UnifiedNativeAd. עכשיו יש פורמט אחד של מודעות מותאמות בשם NativeAd.
    • RewardedAd היא עכשיו מחלקה מופשטת. משתמשים בשיטה הסטטית RewardedAd.load() כדי לטעון מודעה מתגמלת.
  • נוסף הכלי לבדיקת מודעות (בטא).
  • הוצא משימוש AdSize.SMART_BANNER לטובת מודעות באנר מותאמות.
  • נוספו הערות מפורשות לגבי האפשרות להגדיר ערך null בכל ממשקי ה-API הציבוריים.
19.8.0 2021‑03‑15
  • נוספה תלות ב-User Messaging Platform SDK.
  • הוספתי את הפונקציה onAdImpression() callback ל-FullScreenContentCallback.
  • הוצאנו משימוש את הפורמט InstreamAd.
  • מתאמי בחירת רשתות:
    • הוצאו משימוש: MediationBannerAdapter,‏ MediationInterstitialAdapter ו-MediationNativeAdapter. מתאמים חדשים צריכים להטמיע את המחלקה Adapter כדי לטעון את הפורמטים האלה.
    • עכשיו אפשר להטמיע שיטות טעינה שונות במתאמי בידינג במחלקה Adapter עבור פורמטים ספציפיים של RTB.
19.7.0 2021‑01‑20
  • שינויים משמעותיים ב:
    • InterstitialAd
    • RewardedAd
    • NativeAd
    • AppOpenAd
  • הוצא משימוש CustomRenderedAd.
  • הוצאנו משימוש את המחלקות והחבילות עם הקידומת Publisher והחלפנו אותן בקידומת AdManager.
  • הגרסה המשנית האחרונה לפני גרסה 20.0.0. כל ממשקי ה-API שסומנו כפריטים שהוצאו משימוש בגרסה הזו ובגרסאות קודמות יוסרו בגרסה 20.0.0. פרטים נוספים זמינים במדריך להעברת נתונים לגרסה 20.0.0.
19.6.0 2020‑12‑04
  • הוצאה משימוש של השיטה onAdLeftApplication() AdListener.
  • תוקן באג שבו משתמשים במכשירי Android 11 מתבקשים לבחור דפדפן כשהם לוחצים על מודעה.
19.5.0 2020‑10‑20
  • מודעות באנר: עכשיו מתבצעת קריאה לשיטה onAdImpression() AdListener עבור מודעות באנר.
  • הוספנו את השיטה setHttpTimeoutMillis() כדי להתאים אישית את הזמן הקצוב לתפוגה של קריאות HTTPS שמתבצעות על ידי Google Mobile Ads SDK.
19.4.0 2020‑09‑10
  • הוספנו תמיכה במכשירי Android 11 לאפליקציות שמטרגטות API 30.
  • מודעות בפתיחת אפליקציה: שינינו את הפורמט AppOpenAd כך שיפעל יותר כמו פורמט של מסך מלא ולא כמו תצוגת באנר. נוספו ה-methods‏ getResponseInfo() ו-show() ל-AppOpenAd. הוצאו משימוש הכיתות AppOpenAdView ו-AppOpenAdPresentationCallback.
  • תהליך בחירת הרשת (Mediation): מעכשיו אפשר לראות דוחות על סטטוס תהליך בחירת הרשת. משתמשים ב-‎ ResponseInfo.getAdapterResponses() כדי לקבל מידע על התגובה של כל רשת מודעות שהשתתפה בבקשה להצגת מודעה.
  • מודעות מתגמלות מדור קודם: הוצאו משימוש RewardedVideoAd.
  • תוקן באג שבו MobileAds.initialize() רק קורא חזרה לטיפול בהשלמה פעם אחת. כל שיחה אל MobileAds.initialize() מפעילה עכשיו את קריאת החזרה של ההשלמה.
19.3.0 2020‑07‑20
  • נוספו ה-methods‏ getDomain() ו-getCause() ל-AdError.
  • נוספו קריאות חוזרות (callbacks) חדשות לכל פורמטי המודעות, שמחזירות שגיאה בטעינה LoadAdError. למשל: onAdFailedToLoad(LoadAdError).
  • קריאות חוזרות (callbacks) לטיפול בכשלים בטעינה שהוצאו משימוש ומחזירות מספר שלם (int). למשל: onAdFailedToLoad(int).
  • מודעות מתגמלות: נוסף onRewardedAdFailedToShow(AdError) והוצא משימוש onRewardedAdFailedToShow(int).
  • תהליך בחירת הרשת (Mediation) של מודעות מתגמלות: נוסף קוד השגיאה של MEDIATION_SHOW_ERROR הצגת המודעה. כל שגיאות ההצגה שקשורות למודעות שמוצגות באמצעות תיווך מחזירות עכשיו MEDIATION_SHOW_ERROR עבור AdError.getCode() ו-NonNull AdError.getCause() שמייצג את שגיאת התיווך הבסיסית.
19.2.0 2020‑06‑18
  • הפורמט RewardedInterstitialAd נוסף. התכונה הזו נמצאת בגרסת בטא פרטית. כדי לבקש גישה, צריך לפנות למנהל החשבון.
  • מודעות מותאמות: הוספנו ממשק משתמש של מאמת מודעות מותאמות לבקשות בדיקה, כדי לעזור לכם לזהות ולתקן הפרות מדיניות במודעות מותאמות.
  • נוספה השיטה MobileAds.disableMediationAdapterInitialization(). צריך לקרוא לשיטה הזו לפני שמפעילים את Google Mobile Ads SDK כדי להשבית את ההפעלה של המתאם לתהליך בחירת הרשת.
19.1.0 2020‑04‑16
‫19.0.1 ‫2020‑03‑18
  • מודעות מותאמות: תוקן דליפת זיכרון קבועה שהתרחשה כשנעשה שימוש ב-NativeCustomTemplateAd.
19.0.0 2020‑03‑02
  • נוספה תמיכה בקריאת פרמטרים של הסכמה מגרסה 2.0 של IAB TCF וממחרוזת us_privacy של IAB.
  • הוספת את setNeighboringContentUrls() ואת getNeighboringContentUrls() אל AdRequest.
  • נוספה הכיתה ResponseInfo שמספקת מידע על מודעה שנטענה.
  • לכל הפורמטים של המודעות, הוצא משימוש getMediationAdapterClassName() לטובת getResponseInfo().
  • מודעות מותאמות: נוספו ה-methods‏ getDuration() ו-getCurrentTime() ל-MediaContent.
  • גישור מקורי: נוספו ה-methods‏ getDuration() ו-getCurrentTime() ל-UnifiedNativeAdMapper כדי שהמתאמים יוכלו להטמיע אותם.
  • הוצא משימוש AdRequest.Builder.addTestDevice(). במקום זאת, אתם צריכים להשתמש ב- RequestConfiguration.Builder.setTestDeviceIds().
18.3.0 2019‑11‑05
  • הוספנו ממשקי API לפורמט המודעה InstreamAd. התכונה הזו נמצאת בגרסת בטא פרטית. כדי לבקש גישה, צריך לפנות למנהל החשבון.
  • מודעת באנר מותאמת: שינינו את שיטות היצירה של מודעות באנר מותאמות במחלקה AdSize. לדוגמה, השם AdSize.getCurrentOrientationBannerAdSizeWithWidth() שונה ל-AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize().
  • גישור: Google Mobile Ads SDK תופס עכשיו חריגים שנוצרים על ידי מתאמי גישור.
  • Mediation של מודעות מתגמלות: תוקן באג שגרם לכך שאם כמה מודעות מתגמלות שעוברות Mediation נשמרות במטמון, רק אחת מהן מוצגת.
  • הוספנו את השיטה setTestDeviceIds() כדי לאפשר הגדרה של מכשירים לבדיקה פעם אחת לכל הבקשות להצגת מודעות.
18.2.0 2019‑08‑29
  • הוספנו ממשקי API לפורמט AppOpenAd. התכונה הזו נמצאת בגרסת בטא פרטית. כדי לבקש גישה, צריך לפנות למנהל החשבון.
18.1.1 2019‑07‑23
  • תהליך בחירת הרשת (Mediation): מתאמים מאותחלים עכשיו כשאפליקציות קוראות ל- MobileAds.initialize(Context, OnInitializationCompleteListener).
  • גישור: חריגים של מתאמים שכוללים מעקב אחר מחסנית (stack trace) של Google Mobile Ads SDK נתפסים ומטופלים עכשיו על ידי Google Mobile Ads SDK.
18.1.0 2019‑07‑09
  • השקה רשמית של תמיכה במדידת אפליקציות.
  • מדידת האפליקציה מתחילה ושולחת נתונים כשהאפליקציה מופעלת כברירת מחדל. נוספה אפשרות לדחות את המדידה של האפליקציה עד להפעלה מפורשת של Google Mobile Ads SDK.
  • נוספה שיטת אתחול חדשה, MobileAds.initialize(Context, OnInitializationCompleteListener), ששולחת לכם הודעה כש-Google Mobile Ads SDK וכל המתאמים לתהליך בחירת הרשת שהוגדרו מסיימים את האתחול.
  • נוספה MobileAds.getInitializationStatus() כדי לספק את סטטוס האתחול של כל רשתות המודעות שהוגדרו לאפליקציה.
  • הוספת את MobileAds.getRequestConfiguration(). פרמטרי הטירגוט שמוגדרים באובייקט ההגדרה הזה משמשים לכל הבקשות להצגת מודעות.
  • מודעות מותאמות: נוספה השיטה NativeAdOptions.Builder.setMediaAspectRatio() לשליחת בקשה ליחס גובה-רוחב ספציפי לנכס מדיה של מודעה מותאמת. האפשרות הזו מקבלת עדיפות על פני ה-method setImageOrientation(), שכבר הוצאה משימוש.
  • מודעות מותאמות: במודעות שאינן מודעות וידאו, אפשר להגדיר את סוג קנה המידה של התמונה ב-MediaView באמצעות MediaView.setImageScaleType().
  • מודעות מותאמות: נוסף UnifiedNativeAd.getMediaContent(). בעלי אפליקציות שרק טוענים תמונות באמצעות כתובות URL יכולים עכשיו לקבל את תוכן המדיה של המודעה, לספק לה תמונה ולהפעיל את MediaView.setMediaContent() כדי לאכלס נתוני תמונה באמצעות MediaView למודעות שאינן מודעות וידאו.
  • תהליך בחירת הרשת למודעות מותאמות: עכשיו מתאמים יכולים לספק יחס גובה-רוחב באמצעות UnifiedNativeAdMapper.setMediaContentAspectRatio().
  • נוספו יחסי תלות ב-play-services-measurement וב-play-services-measurement-sdk. אין יותר צורך להוסיף את התלויות האלה באופן מפורש לאפליקציות.
‫18.0.0 2019‑06‑17
  • העברה מספריות התמיכה של Android לספריות Jetpack ‏ (AndroidX). מידע נוסף זמין בהערות הגרסה של Google Play Services.
  • כדי למנוע קריסה שמתרחשת בהפעלה הראשונה אחרי התקנת האפליקציה מחנות Play, בגרסה הזו בעלי תוכן דיגיטלי צריכים להצהיר על תלות נוספת בקובץ build.gradle:
    com.google.android.gms:play-services-measurement:17.0.0
    com.google.android.gms:play-services-measurement-sdk:17.0.0
17.2.1 2019‑05‑21
  • תיקון של שגיאת ANR שמקורה בכתובת android.media.AudioManager.getStreamVolume.
17.2.0 ‫2019‑03‑11
  • מודעות וידאו מתגמלות: נוסף סט חדש של ממשקי API מתגמלים (ראו את חבילת rewarded) שמאפשר לכם לטעון כמה מודעות מתגמלות בו-זמנית.
  • Mediation: נוסף סט חדש של ממשקי API של מתאמי Mediation שתומכים באתחול. מתאמים שמטמיעים את ה-API החדש מטמיעים את המחלקה Adapter.
  • בעלי תוכן דיגיטלי שמשתמשים ב-firebase-analytics יחד עם גרסה 17.2.0 של כל אחת מהספריות של המודעות (למשל, ‫com.google.android.gms:play-services-ads:17.2.0) חייבים להשתמש ב-com.google.firebase:firebase-analytics:16.3.0.
17.1.3 2019‑01‑31
  • בעלי תוכן דיגיטלי שמשתמשים ב-firebase-analytics יחד עם גרסה 17.1.3 של כל אחת מהספריות של המודעות (למשל, ‫com.google.android.gms:play-services-ads:17.1.3) חייבים להשתמש ב-com.google.firebase:firebase-analytics:16.3.0.
17.1.2 2018‑12‑03
  • בעלי תוכן דיגיטלי שמשתמשים ב-firebase-analytics יחד עם גרסה 17.1.2 של כל אחת מהספריות של המודעות (למשל, ‫com.google.android.gms:play-services-ads:17.1.2) חייבים להשתמש ב-com.google.firebase:firebase-analytics:16.0.6.
17.1.1 ‫2018‑11‑12
  • תוקן באג שגרם לכך ששילובים מסוימים של play-services-ads ו-firebase-analytics (למשל, ‫ads:17.1.0 & analytics:16.0.5) resulted in a duplicate entry compiler error. בעלי תוכן דיגיטלי שמשתמשים ב-firebase-analytics יחד עם גרסה 17.1.1 של כל אחת מהספריות של המודעות (למשל, ‫com.google.android.gms:play-services-ads:17.1.1) חייבים להשתמש ב-com.google.firebase:firebase-analytics:16.0.5.
17.1.0 2018‑11‑02
17.0.0 2018‑10‑05
  • בעלי אפליקציות ב-Google AdMob נדרשים לציין תג <meta-data> עם מפתח com.google.android.gms.ads.APPLICATION_ID בקובץ AndroidManifest.xml. פרטים נוספים זמינים במדריך לתחילת העבודה.
  • מודעות מותאמות: הוצאנו משימוש את NativeAppInstallAd, NativeContentAd ואת ממשקי ה-API המשויכים, לטובת UnifiedNativeAd. הוראות נוספות לשימוש בממשקי ה-API החדשים מופיעות במאמר מודעות מותאמות מתקדמות ומאוחדות.
  • מודעות מותאמות: נוספה התכונה 'השתקת המודעה הזו'.
  • מודעות מותאמות: יומן האזהרות הבא, שלא מצביע על בעיה: "UnconfirmedClickListener must not be null while ClickConfirmingView is set." הוסר.
  • מודעות מתגמלות: נוספה השיטה setAdMetadataListener ב-RewardedVideoAd להאזנה לשינויים במטא-נתונים של המודעות.
  • מודעות מתגמלות: קריאה ל-destroy() תגרום להחזרת ערך null למאזין.
  • הוצאנו משימוש את השיטות הבאות ב-AdRequest.Builder.
  • תוקן באג שגרם לכך שהתג onRewardedVideoCompleted() לא הופעל באמולטורים.
16.0.0 2018‑10‑02
  • לא בוצעו שינויים במודעות. מידע נוסף זמין בהערות הגרסה של Google Play Services.
15.0.0 2018‑04‑12
  • גרסת בטא של MRAID v3.
  • מודעות מותאמות: נוסף Unified Native Ad API. הפעולה הזו משלבת את NativeAppInstallAds ואת NativeContentAds לסוג חדש אחד: UnifiedNativeAd.
  • הערה: כשמשתמשים במודעות מותאמות, מופיעה אזהרה לא מזיקה ביומנים כשלוחצים על המודעה המותאמת: UnconfirmedClickListener must not be null while ClickConfirmingView is set. אפשר להתעלם מהאזהרה הזו, והיא תוסר בגרסה הבאה.
12.0.1 2018‑03‑28
  • לא בוצעו שינויים במודעות. פרטים נוספים זמינים בהערות הגרסה של Google Play Services.
12.0.0 ‫2018‑03‑20
  • סרטון מתגמל: נוספה שיטת הקריאה החוזרת onRewardedVideoCompleted() ל-RewardedVideoAdListener.
  • גישור מובנה: נוספה השיטה trackViews() ל-NativeAdMapper, שמעניקה למתאמים גישה לאובייקטים של View שמתאימים לנכסים ספציפיים של מודעות מותאמות. המאפיין trackView() הוצא משימוש לטובת trackViews().
11.8.0 2017‑12‑18
  • תיקוני באגים ושיפורים כלליים.
11.6.0 2017‑11‑07
  • הוספנו את המחלקה NativeAdViewHolder ואת ה-methods שקשורות אליה ב-NativeAppInstallAd וב-NativeContentAd.
  • הוצא משימוש AdLoader.getMediationAdapterClassName (בעלי אפליקציות צריכים להשתמש במקום זאת בשיטות עם אותו שם ב-NativeAppInstallAd וב-NativeContentAd).
  • עכשיו מודעות בדיקה מציגות תווית בחלק העליון של המודעה. פרטים נוספים זמינים במדריך לבדיקות.
11.4.0 2017‑09‑19
  • נוספו methods‏ getMediationAdapterClassName() למחלקות NativeAppInstallAd ו-NativeContentAd. השיטה עם אותו שם ב-AdLoader תצא משימוש.
  • הוספנו שיטה של onVideoEnd() למחלקה MediationNativeListener, שיטות של hasVideoContent(), setHasVideoContent() ו-setMediaView() למחלקה NativeAdMapper, ושיטות של getAdVolume() ו-isAdMuted() למחלקה NativeMediationAdRequest כדי לתמוך בתיווך מקורי של סרטונים.
  • הסרנו את הכיתה SearchAdRequest.
11.2.2 2017‑09‑05
  • נוסף method חדש, loadAd(), שמקבל אובייקט PublisherAdRequest למחלקה RewardedVideoAd.
11.2.0 ‫2017‑08‑14
  • הוספנו את השיטה loadAds() למחלקה AdLoader, שמאפשרת לאפליקציות לטעון כמה מודעות ייחודיות בבקשה אחת.
  • כשמשדרגים את האפליקציה לגרסה 11.2.0 ואילך של Google Mobile Ads SDK, צריך לעדכן גם את build.gradle של האפליקציה כך שיצוין compileSdkVersion של 26 לפחות (Android O). הפעולה הזו לא משנה את אופן הפעלת האפליקציה. לא תצטרכו לעדכן את targetSdkVersion.
  • החל מגרסה 11.2.0, ‏ Google Mobile Ads SDK זמין דרך מאגר Maven של Google. מידע נוסף זמין בהערות על הגרסה של Google Play Services.
11.0.0 2017‑06‑07
  • הוספנו את ה-methods‏ onAdClicked() ו-onAdImpression() למחלקה AdListener. השיטות האלה מופעלות רק במודעות מותאמות להתקנת אפליקציות ובמודעות מותאמות באתרי תוכן.
  • הוסרו ה-methods‏ getInAppPurchaseListener() ו-setInAppPurchaseListener() מהמחלקות AdView,‏ InterstitialAd ו-NativeExpressAdView. הסרנו גם שיעורים שקשורים לרכישות מתוך האפליקציה.
  • נוספו ה-methods‏ OnVideoMute(),‏ OnVideoPause(),‏ OnVideoPlay() ו-OnVideoStart() למחלקה VideoController.VideoLifecycleCallbacks.
  • נוספה האפשרות להפעיל מצב immersive במודעות במסך מלא על ידי הוספת השיטה setImmersiveMode() למחלקות PublisherInterstitialAd ו-RewardedVideoAd.
  • נוספו הממשק OnPublisherAdViewLoadedListener, המחלקה PublisherAdViewOptions והמחלקה PublisherAdViewOptions.Builder לשימוש עם AdLoader לבקשות של מודעות מותאמות + באנר.
  • נוסף הממשק האופציונלי OnImmersiveModeUpdatedListener שאפשר להטמיע מתאמי בחירת רשת כדי לקבל עדכונים על מצב הצגת המודעות במסך מלא.
  • הוספנו את ה-method‏ getMediationAdapterClassName() למחלקה RewardedVideoAd.
  • נוספו keep כללים לשימור אוטומטי של שמות מחלקות של מתאמי תהליך בחירת הרשת כשמשתמשים ב-ProGuard.
10.2.0 ‫2017‑2‑15
  • גרסה 10.2.x של Google Play Services היא הגרסה הראשונה שכבר לא כוללת תמיכה מלאה ב-Android גרסה 2.3.x ‏ (Gingerbread). אפליקציות שפותחו באמצעות גרסת SDK‏ 10.2.x ואילך דורשות רמת API מינימלית של Android‏ 14, ולא ניתן להתקין אותן במכשירים שפועלת בהם רמת API נמוכה מ-14. מידע נוסף על האפשרויות שלכם, כולל יצירת כמה קובצי APK כדי להרחיב את התמיכה של האפליקציה ב-Android Gingerbread, זמין ב בלוג של מפתחי Android.
  • נוספה תמיכה בנכסי וידאו עבור תוכן מתקדם מותאם ומודעות עם תבנית בהתאמה אישית.
  • נוספו ה-methods‏ getVideoController(),‏ setVideoOptions() ו-getVideoOptions() למחלקה PublisherAdView.
  • הוספתי את הכיתה AdChoicesView.
  • נוספו ה-methods‏ getAdChoicesContent() ו-setAdChoicesContent() למחלקה NativeAdMapper.
  • נוסף ממשק InitializableMediationRewardedVideoAdAdapter למתאמי גישור של מודעות וידאו מתגמלות שרוצים להפעיל אתחול מוקדם לפני שליחת בקשה להצגת מודעה.
  • נוספה תמיכה בתצוגה מקדימה בתוך האפליקציה ובפתרון בעיות ב-Google Ad Manager.
10.0.1 2016‑11‑21
  • תיקוני באגים ושיפורים כלליים.
9.8.0 2016‑10‑24
  • MobileAds.Initialize(Context) הוצא משימוש. בעלי אפליקציות שמשתמשים ב-Google Ad Manager צריכים להפעיל את השיטה הזו כשמפעילים את האפליקציות שלהם. בעלי אפליקציות ב-AdMob עדיין צריכים להשתמש ב-MobileAds.Initialize(Context, String) ולהעביר את קוד האפליקציה שלהם.
9.6.0 2016‑09‑22
  • נוסף המחלקה MediaView למודעות וידאו מתקדמות מותאמות.
  • נוספה שיטה openDebugMenu() למחלקה MobileAds לתצוגה מקדימה של קריאייטיב ולפתרון בעיות ביחידות של מודעות ב-Ad Manager.
  • נוספה תמיכה באירועים מותאמים אישית של סרטונים מתגמלים.
9.4.0 2016‑08‑01
  • תיקוני באגים ושיפורים כלליים.
9.2.0 2016‑06‑27
  • הוספנו את ה-method‏ setAdChoicesPlacement() לכיתה NativeAdOptions.Builder, שבעלי אפליקציות יכולים להשתמש בה עכשיו כדי לציין את המיקום של AdChoices במודעות מותאמות.
  • ביצענו כמה תיקוני באגים כדי לשפר את הפעלת מודעות הווידאו.
9.0.1 2016‑05‑26
  • תוקנה בעיה ב-ProGuard שהופיעה בגרסה 9.0.0. מוציאים לאור לא צריכים יותר להשתמש באפשרות keep עבור com.google.android.gms.common.util.DynamiteApi.
9.0.0 2016‑05‑18
  • הוספנו מילוי אוטומטי של פרטי מיקום לאפליקציות שמעניקות במפורש הרשאת גישה למיקום.
  • נוספה תמיכה באירועים מותאמים אישית לבחירת רשת של מודעות וידאו מתגמלות.
  • הוספנו אפשרויות וידאו למודעות Native Express.
  • עדכנו את Custom Search Ads API.
  • נוספה שיטת התשלום setAppMuted().
  • השיטה MobileAds.initialize(android.content.Context, java.lang.String) כבר לא הוצאה משימוש.
  • השיטה MobileAds.initialize(android.content.Context) הוצאה משימוש.
  • הוספנו את השיטה MediationNativeListener.onAdImpression() לדיווח על חשיפות במתאמי תהליך בחירת הרשת.
  • בגרסה הזו בלבד, אפליקציות שמשתמשות ב-ProGuard לעיבוד שלאחר ההרכבה של האפליקציה צריכות להוסיף את האפשרות keep הבאה לקובץ ההגדרה של ProGuard: -keep public @com.google.android.gms.common.util.DynamiteApi class * { *; }
8.4.0 ‫2015‑12‑18
  • נוספה שיטה ציבורית, MobileAds.setAppVolume(), כדי לעדכן את Google Mobile Ads SDK לגבי רמת עוצמת הקול הנוכחית של האפליקציה.
  • בוצעו תיקוני באגים ושיפורים.
8.3.0 ‫2015‑11‑6
  • נוספה תמיכה במודעות וידאו מתגמלות.
  • הוספנו שיטה isLoading() ל-PublisherAdView ול-PublisherInterstitialAd כדי לבדוק אם בקשה להצגת מודעה נמצאת בתהליך.
  • הוספנו את ה-method‏ setIsDesignedForFamilies() אל AdRequest.Builder ואל PublisherAdRequest.Builder.
  • הוספנו את השיטה destroy() אל NativeAdView.
8.1.0 2015‑09‑24 תיקנו באגים שונים.
7.8.0 2015‑08‑13
  • גרסת ההפצה הרשמית של MRAID v2.
  • נוספה שיטה isLoading() אל AdLoader, אל AdView ואל InterstitialAd כדי לבדוק אם בקשה להצגת מודעה נמצאת בתהליך.
  • הוצא משימוש PublisherAdRequest.Builder#setManualImpressionsEnabled(). במקום זאת, אתם צריכים להשתמש ב-PublisherAdView#setManualImpressionsEnabled().
7.5.0 2015‑05‑28
  • נוספה תמיכה בפורמטים של מודעות מותאמות להתקנת אפליקציות ולתוכן ב-AdMob וב-Ad Manager.
  • נוספה תמיכה בפורמטים מותאמים אישית של מודעות מותאמות, שזמינים להזמנות ב-Ad Manager.
7.3.0 2015‑04‑28 תיקנו באגים שונים.
7.0.0 2015‑03‑19
  • נוספו ה-methods‏ addCustomTargeting() ו-addCategoryExclusion() ל-PublisherAdRequest.Builder.
  • תוקנה בעיה שגרמה לרישום של חשיפות מרובות ב-Ad Manager כשמשתמשים בספירה ידנית של חשיפות.PublisherAdView.recordManualImpression()
  • תוקנה בעיה שגרמה להצגה שגויה של מודעות כשנעשה שימוש במאפיין android:largestWidthLimitDp בתג <supports-screens>.
  • הוספנו את ה-method‏ setRequestAgent() ל-AdRequest.Builder ול-PublisherAdRequest.Builder. צריך להשתמש בשיטה הזו כדי לציין את המקורות של בקשות להצגת מודעות שנשלחות על ידי צדדים שלישיים שמבצעים תהליך גישור אל Google Mobile Ads SDK.
6.5.87 2014‑12‑08
  • הוספנו ארכיטקטורת JAR מפוצלת – מפתחים ב-Android Studio יכולים עכשיו לכלול רק את החלק של המודעות ב-Google Play Services על ידי הסתמכות על com.google.android.gms:play‑services‑ads:6.+.
    הערה: באפליקציות שיוצרות מודעות באנר ב-XML, עדיין צריך להפנות לספרייה com.google.android.gms:play‑services:6.+ כולה.
  • תיקנו באגים שונים.
6.1 2014‑10‑08
  • הוספנו את השיטה getLocation() אל com.google.android.gms.ads.MediationAdRequest.
  • נוסף תיאור תוכן ללחצן הסגירה של מודעת הביניים לצורך נגישות.
  • הוסר הרישום ביומן של השגיאה 'לא נמצאו משאבים של Google Play' כשהפרויקט של הספרייה מקושר בצורה נכונה.
  • נוסף getMediationAdapterClassName() אל AdView כדי לקבל את שם הסיווג של המתאם לבחירת רשת של רשת המודעות שמציגה מודעה.
17.0.0 2018‑10‑05
  • נוספו ממשקי API חדשים להטמעה של אירועים מותאמים אישית.
  • נוסף תהליך רכישה שמוגדר כברירת מחדל לרכישות מתוך האפליקציה, באמצעות Google Play Billing API.
4.4 2014‑05‑07
  • נוספו ממשקי API חדשים של מתאמי גישור.
  • הוספנו פורמט חדש של מודעה בגודל 320x100 LARGE_BANNER לטלפונים ולטאבלטים.
  • נוסף פורמט חדש של מודעות מעברון לרכישות מתוך האפליקציה. מגדירים InAppPurchaseListener ב-InterstitialAd כדי להאזין לאירועי רכישה מתוך האפליקציה.
  • תיקון באג שגרם לקריסת SecurityException בגלל קריאה של gservices ללא הרשאה.
4.3 2014‑03‑17
  • הפונקציה InterstitialAd פועלת עכשיו אם מעבירים לה הקשר של אפליקציה.
  • הוספנו את אמצעי התשלום setContentUrl() לחשבון PublisherAdRequest.Builder.
  • תיקון חריגה כשמופיעה ההודעה השירות לא רשום.
‫4.2 2014‑02‑03 תיקנו באגים שונים.
‫4.1 2014‑01‑16
  • נוספה תמיכה ב-Ad Manager ובמודעות לרשת החיפוש באפליקציות לנייד.
  • ל-AdRequest.Builder יש עכשיו שיטה setLocation().
  • תוקן קראש שהתרחש אם נשלחה בקשה למודעת מעברון אבל AdActivity לא צוין במניפסט.
4.0 2013‑10‑31
  • ממשקי ה-API של Google Mobile Ads הם עכשיו חלק מ-Google Play Services.
  • עדכונים עתידיים בממשקי ה-API של Google Mobile Ads נדחפים אוטומטית למכשירים דרך Google Play Services.
  • עדיין אין תמיכה ב-Ad Manager ובמודעות לקידום אפליקציות לנייד בחיפוש.