הערות מוצר

גרסה תאריך פרסום הערות
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
  • מעכשיו אפשר להטמיע מתאמי גישור של מודעות מותאמות NativeAdMapper.destroy() כדי לקבל התראה כשמודעה מותאמת נמחקת.
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.
    • ה-SDK כבר לא מעביר פרמטרים נוספים שעוברים דרך addNetworkExtrasBundle() אל Ad Manager כפרמטרים של טירגוט בהתאמה אישית. כדי להגדיר טירגוט מותאם אישית, צריך להשתמש ב- addCustomTargeting(). מידע נוסף זמין במאמר בנושא טירגוט בהתאמה אישית.
    • הסרנו את כל ממשקי ה-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 במעקב אחר מחסנית הקריאות של הכשל. היומנים של מעקב אחר מחסנית (stack trace) מתעדים את ההודעה הזו כשגיאה, אבל לא מציינים קריסה. כדי להבין כשלים נפוצים בטעינת מודעות, אפשר לעיין במאמר בנושא ניפוי באגים בהודעות נפוצות של רישום שגיאות. אם מופיעה שגיאה חוזרת שקשורה להצגת מודעות ולא מתועדת, צריך לשתף את מעקב המחסנית עם התמיכה של 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 ושל גרסת הבטא של Topics ממשקי API לשמירה על הפרטיות. מידע נוסף זמין במדריך בנושא ארגז החול לפרטיות ב-Android ב-Ad Manager.
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
‫19.4.0 ‫2020‑09‑10
  • הוספנו תמיכה במכשירי Android 11 לאפליקציות שמטרגטות API 30.
  • מודעות בפתיחת אפליקציה: שינינו את הפורמט AppOpenAd כך שיפעל יותר כמו פורמט מסך מלא ולא כמו תצוגת באנר. נוספו השיטות getResponseInfo() ו-show() ל-AppOpenAd. הוצאו משימוש הכיתות AppOpenAdView ו-AppOpenAdPresentationCallback.
  • תהליך בחירת הרשת (Mediation): מעכשיו אפשר לדווח על סטטוס תהליך בחירת הרשת. משתמשים ב-‎ ResponseInfo.getAdapterResponses() כדי לקבל מידע על התגובה של כל רשת מודעות שהשתתפה בבקשה להצגת מודעה.
  • מודעות מתגמלות מדור קודם: הוצאו משימוש RewardedVideoAd.
  • הוספנו את הפורמט RewardedInterstitialAd, בתוכנית בטא פרטית.
  • תוקן באג שבו MobileAds.initialize() מפעיל את handler ההשלמה רק פעם אחת. כל שיחה אל MobileAds.initialize() מפעילה עכשיו את קריאת החזרה של ההשלמה.
19.3.0 ‫2020‑07‑20
  • נוספו השיטות getDomain() ו-getCause() ל-AdError.
  • נוספו קריאות חוזרות (callbacks) חדשות לכל פורמטי המודעות, שמחזירות את הערך LoadAdError. למשל: onAdFailedToLoad(LoadAdError).
  • קריאות חוזרות (callbacks) לטיפול בכשלים בטעינה שהוצאו משימוש ומחזירות מספר שלם. לדוגמה: onAdFailedToLoad(int).
  • מודעות מתגמלות: נוסף onRewardedAdFailedToShow(AdError) והוצא משימוש onRewardedAdFailedToShow(int).
  • תהליך בחירת הרשת (Mediation) של מודעות מתגמלות: נוסף קוד השגיאה MEDIATION_SHOW_ERROR presentation. כל שגיאות ההצגה שקשורות למודעות שמוצגות באמצעות תיווך מחזירות עכשיו MEDIATION_SHOW_ERROR עבור AdError.getCode() ו-AdError.getCause() NonNull שמייצג את שגיאת התיווך הבסיסית.
19.2.0 ‫2020‑06‑18
  • מודעות מותאמות: הוספנו ממשק משתמש של מאמת מודעות מותאמות לבקשות בדיקה, כדי לעזור לכם לזהות ולתקן הפרות מדיניות במודעות מותאמות.
  • נוספה השיטה 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().
  • מודעות מותאמות: נוספו שיטות getDuration() ו-getCurrentTime() ל-MediaContent.
  • גישור מקורי: נוספו שיטות 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) למודעות מתגמלות: תוקן באג שגרם לכך שאם כמה מודעות מתגמלות שעוברות תהליך בחירת רשתות נשמרות במטמון, רק אחת מהן מוצגת.
  • נוספה השיטה 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
  • השקה רשמית של תמיכה במדידת אפליקציות.
  • נוספה שיטת אתחול חדשה, 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 למודעות שאינן מודעות וידאו.
  • מודעות מותאמות: נוספו ממשקי API כדי לאפשר תמיכה במדידה פתוחה בפורמטים מותאמים של מודעות מותאמות שאינן מודעות וידאו.
  • תהליך בחירת הרשת (Mediation) של מודעות מותאמות: עכשיו מתאמים יכולים לספק יחס רוחב-גובה באמצעות UnifiedNativeAdMapper.setMediaContentAspectRatio().
  • הוסר המחלקה Correlator וממשקי ה-API המשויכים אליה. התכונה הזו לא פעלה בעבר.
  • נוספו יחסי תלות ב-play-services-measurement וב-play-services-measurement-sdk. אין יותר צורך להוסיף את התלויות האלה באופן מפורש לאפליקציות.
18.0.0 2019‑06‑17
  • העברה מספריית התמיכה של Android אל Jetpack ‏ (AndroidX) Libraries. מידע נוסף זמין בהערות הגרסה של 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) הובילה לשגיאת קומפיילר duplicate entry. בעלי תוכן דיגיטלי שמשתמשים ב-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 Ad Manager נדרשים לציין תג <meta-data> עם מפתח com.google.android.gms.ads.AD_MANAGER_APP ב-AndroidManifest.xml. פרטים נוספים זמינים במדריך לתחילת העבודה.
  • מודעות מותאמות: הוצאנו משימוש את NativeAppInstallAd, NativeContentAd ואת ממשקי ה-API המשויכים, לטובת UnifiedNativeAd. הוראות נוספות לשימוש בממשקי ה-API החדשים מופיעות במאמר מודעות מותאמות מתקדמות ומאוחדות.
  • מודעות מותאמות: נוספה התכונה 'השתקת המודעה הזו'.
  • מודעות מותאמות: יומן האזהרות הבא, שלא מצביע על בעיה: "UnconfirmedClickListener must not be null while ClickConfirmingView is set." הוסר.
  • מודעות מתגמלות: נוספה השיטה setAdMetadataListener ב-RewardedVideoAd כדי להאזין לשינויים במטא-נתונים של המודעות.
  • מודעות מתגמלות: קריאה ל-destroy() תאפס את listener.
  • הוצאנו משימוש את השיטות הבאות ב-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 ואת השיטות שקשורות אליה ב-NativeAppInstallAd וב-NativeContentAd.
  • הוצא משימוש AdLoader.getMediationAdapterClassName (בעלי אפליקציות צריכים להשתמש במקום זאת בשיטות עם אותו שם ב-NativeAppInstallAd וב-NativeContentAd).
  • עכשיו מודעות בדיקה מציגות תווית בחלק העליון של המודעה. פרטים נוספים זמינים במדריך לבדיקות.
11.4.0 ‫2017‑09‑19
  • נוספו getMediationAdapterClassName() שיטות למחלקות NativeAppInstallAd ו-NativeContentAd. השיטה עם אותו השם ב-AdLoader תצא משימוש.
  • נוספה שיטה onVideoEnd() למחלקת MediationNativeListener, שיטות hasVideoContent(),‏ setHasVideoContent() ו-setMediaView() למחלקה NativeAdMapper, ושיטות getAdVolume() ו-isAdMuted() למחלקה NativeMediationAdRequest כדי לתמוך בתיווך מקורי של סרטונים.
  • הסרנו את הכיתה SearchAdRequest.
11.2.2 2017‑09‑05
  • נוספה שיטה חדשה 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
  • נוספו השיטות onAdClicked() ו-onAdImpression() למחלקה AdListener. השיטות האלה מופעלות רק במודעות מותאמות להתקנת אפליקציות ובמודעות מותאמות באתרי תוכן.
  • הוסרו ה-methods‏ getInAppPurchaseListener() ו-setInAppPurchaseListener() מהמחלקות AdView,‏ InterstitialAd ו-NativeExpressAdView. הסרנו גם שיעורים שקשורים לרכישות מתוך האפליקציה.
  • נוספו המתודות OnVideoMute(),‏ OnVideoPause(),‏ OnVideoPlay() ו-OnVideoStart() למחלקה VideoController.VideoLifecycleCallbacks.
  • נוספה האפשרות להפעיל מצב של מסך מלא במודעות במסך מלא באמצעות הוספת השיטה setImmersiveMode() למחלקות PublisherInterstitialAd ו-RewardedVideoAd.
  • נוספו הממשק OnPublisherAdViewLoadedListener, המחלקה PublisherAdViewOptions והמחלקה PublisherAdViewOptions.Builder לשימוש עם AdLoader לבקשות של מודעות מותאמות + באנר.
  • נוסף הממשק האופציונלי OnImmersiveModeUpdatedListener שמתאמי גישור יכולים להטמיע כדי לקבל עדכונים על מצב ההפעלה של מצב המלאי.
  • הוספתי את השיטה 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.
  • נוספה תמיכה בנכסי וידאו עבור תוכן מתקדם מותאם ומודעות עם תבניות בהתאמה אישית.
  • הוספנו את השיטות getVideoController(),‏ setVideoOptions() ו-getVideoOptions() למחלקה PublisherAdView.
  • הוספתי את הכיתה AdChoicesView.
  • נוספו השיטות 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. עכשיו מפרסמי אפליקציות יכולים להשתמש ב-method הזה כדי לציין את המיקום של 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 כדי לבדוק אם בקשה להצגת מודעה נמצאת בתהליך.
  • הוספנו את השיטה 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
  • נוספו השיטות addCustomTargeting() ו-addCategoryExclusion() ל-PublisherAdRequest.Builder.
  • תוקנה בעיה שגרמה לרישום של חשיפות מרובות ב-Ad Manager כשמשתמשים בספירה ידנית של חשיפות.PublisherAdView.recordManualImpression()
  • תוקנה בעיה שגרמה להצגה שגויה של מודעות כשנעשה שימוש במאפיין android:largestWidthLimitDp בתג <supports-screens>.
  • הוספנו את השיטה 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 ובמודעות לקידום אפליקציות לנייד בחיפוש.