הערות מוצר

גרסה	תאריך יציאה לאקרנים	הערות
23.2.0	2024-06-27	השדה AdView.isCollapsible() נוסף כדי לציין אם ניתן לכווץ את מודעת הבאנר האחרונה שנטען.
23.1.0	09-05-2024	נדרש compileSdkVersion מינימום של 34. מתאמים של תהליך בחירת הרשת (Mediation) מותאם: הוצאו משימוש loadNativeAd ו-loadRtbNativeAd() לטובת loadNativeAdMapper() ו-loadRtbNativeAdMapper(). המתאמים צריכים לעבור לשימוש בשיטות הטעינה החדשות ובאובייקטים שקשורים אליהן.
23.0.0	07-03-2024	הגרסה הזו היא עדכון גרסה ראשי עם מספר שינויי תוכנה שעלולים לגרום לכשל. מידע נוסף על אופן ההעברה זמין במאמר העברה ל-SDK v23. שינויי תוכנה שעלולים לגרום לכשלים: העלאת רמת ה-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	06-12-2023	הוצאנו משימוש את MobileAds.setSameAppKeyEnabled() ושינינו את השם של ה-method ל-MobileAds.putPublisherFirstPartyIdEnabled(). הוצא משימוש AdFormat.UNKNOWN ללא החלפה. אפליקציות שמשתמשות ב-QueryInfo.generate() חייבות להעביר פורמט מודעה.
22.5.0	2023-10-30	התלות ב-User Messaging Platform SDK עודכנה לגרסה 2.1.0. נוספה השיטה setPublisherPrivacyPersonalizationState() ל- Publisher Privacy Treatment API (בטא).
22.4.0	2023-09-13	נדרש מינימום compileSdkVersion של 33. הכלי לבדיקת מודעות: נוספה תמיכה ב-SDK לבקשה להצגת מודעות ולהצגה שלהן דרך ממשק המשתמש של הכלי לבדיקת מודעות. נוספה שיטה QueryInfo.generate() חדשה שלוקחת מזהה של יחידת מודעות. הפעלת בדיקה ראשונית של ממשקי ה-API לשמירה על פרטיות בגרסת הבטא של Attribution Reporting ובגרסת Topics Beta. מידע נוסף זמין במדריך של Ad Manager ארגז החול לפרטיות ב-Android.
22.3.0	22-2023-08-2023	נוספה תמיכה ביצירת גדלים מותאמים אישית באמצעות שימוש ברוחב AdSize.FULL_WIDTH. בעבר, גדלים של מודעות שנוצרו באמצעות AdSize.FULL_WIDTH נחשבים לAdSize.SMART_BANNER.
22.2.0	05-07-2023	אירועים מותאמים אישית: הוצא משימוש AdRequest.Builder.addCustomEventExtrasBundle(). להגדיל את המתאם ולבצע פעולות עם הפרמטרים הנוספים דרך AdRequest.Builder.addNetworkExtrasBundle() במקום זאת. הוצא משימוש AdRequest.getCustomEventExtrasBundle(). להגדיל את המתאם ולבצע פעולות עם הפרמטרים הנוספים דרך AdRequest.getNetworkExtrasBundle() במקום זאת.
22.1.0	2023‐05‐18	הכלי לבדיקת מודעות: הופעלה האפשרות להפעיל בקשות להצגת מודעות מממשק המשתמש של הכלי לבדיקת מודעות במכשירים שלא כוללים את Google Play Services.
22.0.0	2023-03-29	הגרסה הזו היא עדכון גרסה ראשי עם מספר שינויי תוכנה שעלולים לגרום לכשל. מידע נוסף על אופן ההעברה זמין במאמר העברה ל-SDK v22. שינויי תוכנה שעלולים לגרום לכשלים: הוסרו 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	31-01-2023	מודעות בפתיחת האפליקציה: שיטות שהוצאו משימוש 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	הכלי לבדיקת מודעות: נוספה תמיכה ב-SDK לבקשה להצגת מודעות ולהצגה שלהן דרך ממשק המשתמש של הכלי לבדיקת מודעות. מודעות מותאמות: הוספת את getMediaContent() אל MediaView. מודעות מותאמות בהתאמה אישית: הוספת את getMediaContent() אל NativeCustomFormatAd. הוצא משימוש getVideoMediaView(). אפשר ליצור MediaView משלך ולהשתמש במקום זאת ב-NativeCustomFormatAd.getMediaContent(). הוצא משימוש getVideoController(). במקומה צריך להשתמש במדיניות NativeCustomFormatAd.getMediaContent().getVideoController().
21.2.0	06-09-2022	הכלי לבדיקת מודעות: נוספה תמיכה ב-SDK לייצוא יומנים של בקשות להצגת מודעות דרך Android Sharesheet.
21.1.0	2022-07-14	נוספה תמיכה במונטיזציה של מודעות ב-WebView. פרטים נוספים זמינים במאמר שילוב ה-API של WebView ל-Google Ads. הוספת getResponseExtras() אל ResponseInfo שעשוי להחזיר מידע נוסף על התגובה למודעה. בטא: ה-API של getResponseExtras() נמצא בגרסת בטא. הערך המוחזר עשוי להשתנות ללא גרסת SDK.
21.0.0	2022-05-25	הגרסה הזו היא עדכון גרסה ראשי עם מספר שינויי תוכנה שעלולים לגרום לכשל. למידע נוסף על ההעברה, אפשר לעיין במדריך העברה ל-SDK v21. שינויי תוכנה שעלולים לגרום לכשלים: כדי להפעיל את Google Mobile Ads SDK, כל האפליקציות צריכות להיות ברמה 19 ומעלה של Android API. נוספו הערות @NonNull בכל שיטה שקודם לכן לא הגדירו במפורש יכולת null. השיטה AdRequest.Builder.addNetworkExtras() הוסרה. במקום זאת, אתם צריכים להשתמש ב-AdRequest.Builder.addNetworkExtrasBundle(). הסרתם את שיטות המיקום הבאות: setLocation() בתאריך AdRequest.Builder ‫getLocation() ל-AdRequest getLocation() בתאריך MediationAdConfiguration הוספנו דגלי מניפסט כדי לבצע אופטימיזציה לאתחול וטעינת מודעות. לפרטים נוספים, ראו המדריך לאופטימיזציה לאתחול וטעינת מודעות. הוצא משימוש MobileAds.getVersionString(). במקום זאת, אתם צריכים להשתמש ב-MobileAds.getVersion(). נוספה ה-method getLoadedAdapterResponseInfo() ב-ResponseInfo. נוספו השיטות הבאות ב- AdapterResponseInfo: getAdSourceName() getAdSourceId() getAdSourceInstanceName() getAdSourceInstanceId() בטא: ממשקי ה-API האלה נמצאים בגרסת בטא. הערכים המוחזרים עשויים להשתנות ללא גרסת SDK. נוספה תמיכה באירועים מותאמים אישית בכלי לבדיקת מודעות.
20.6.0	2022-02-22	הוצאו משימוש את כל הממשקים של אירועים בהתאמה אישית. במקום זאת, משתמשים במחלקה Adapter ובממשק MediationAdLoadCallback. נוספה תמיכה ב-gad_has_consent_for_cookies של SharedPreferences. Google Mobile Ads SDK יפעיל מודעות מוגבלות (LTD) כשההעדפה של gad_has_consent_for_cookies מוגדרת ל-0. פרטים נוספים זמינים במאמר הגדרת הסכמה לשימוש בקובצי Cookie. Google Mobile Ads SDK ישבית את ההעברה של מזהה הפרסום ב-Android (AAID) כאשר תתבצע קריאה ל-RequestConfiguration.Builder.setTagForChildDirectedTreatment() באמצעות TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE (למידע נוסף הגדרת תוכן לילדים), או RequestConfiguration.Builder.setTagForUnderAgeOfConsent() תופעל עם TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE (מידע נוסף על ההגדרה של משתמשים מתחת לגיל ההסכמה).
20.5.0	2021-11-18	נוספה תמיכה במכשירי Android 12 לאפליקציות שמטרגטות את API 31. נוספה תמיכה במזהה קבוצת אפליקציות לתרחישים לדוגמה כמו דיווח ומניעת הונאות.
20.4.0	22-2021-09-09	בגרסה הזו ובכל הגרסאות הקודמות נדרשת תלות מפורשת ב-androidx.work:work-runtime:2.7.0 כדי לתקן באג שגורם לקריסות של האפליקציה ב-Android S באמצעות דוח הקריסות הבא: Fatal Exception: java.lang.IllegalArgumentException: com.mycompany.myapp: Targeting S+ (version 10000 and above) requires that one of FLAG_IMMUTABLE or FLAG_MUTABLE be specified when creating a PendingIntent. Strongly consider using FLAG_IMMUTABLE, only use FLAG_MUTABLE if some functionality depends on the PendingIntent being mutable, e.g. if it needs to be used with inline replies or bubbles. at android.app.PendingIntent.checkFlags(PendingIntent.java:386) at android.app.PendingIntent.getBroadcastAsUser(PendingIntent.java:657) at android.app.PendingIntent.getBroadcast(PendingIntent.java:644) at androidx.work.impl.utils.ForceStopRunnable.getPendingIntent(ForceStopRunnable.java:174) at androidx.work.impl.utils.ForceStopRunnable.isForceStopped(ForceStopRunnable.java:108) at androidx.work.impl.utils.ForceStopRunnable.run(ForceStopRunnable.java:86) at androidx.work.impl.utils.SerialExecutor$Task.run(SerialExecutor.java:75) at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1167) at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:641) at java.lang.Thread.run(Thread.java:920) כדי לתקן את הבאג, צריך להוסיף את יחסי התלות הבאים של Google Mobile Ads SDK לקובץ Gradle ברמת האפליקציה של המודול: dependencies { implementation 'com.google.android.gms:play-services-ads:20.4.0' // For apps targeting Android 12, add WorkManager dependency. constraints { implementation('androidx.work:work-runtime:2.7.0') { because '''androidx.work:work-runtime:2.1.0 pulled from play-services-ads has a bug using PendingIntent without FLAG_IMMUTABLE or FLAG_MUTABLE and will fail in Apps targeting S+.''' } } } החל מגרסה 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	הוצאנו משימוש את השיטה AdRequest.Builder.addNetworkExtras() . במקום זאת, צריך להשתמש ב- AdRequest.Builder.addNetworkExtrasBundle() . מודעות מותאמות: AdLoader.Builder.forCustomFormatAd() מקבל עכשיו OnCustomClickListener עם ערך null. מתאמים של תהליך בחירת הרשת (Mediation): תוקנה הערת null לפרמטר mediationExtras בכל הקריאות לטעינת מתאמים של תהליך בחירת הרשת.
20.2.0	08-06-2021	נוספה תמיכה בכלי לבדיקת מודעות (בטא) לבעלי תוכן דיגיטלי ב-Google Ad Manager.
20.1.0	2021-04-29	מודעת באנר מותאמת: נוספה AdSize.getInlineAdaptiveBannerAdSize() כדי לבקש מודעות באנר מותאמות שמוצגות בתוך הטקסט, עם גובה מקסימלי. הוספנו את AdError.toString() לרישום ביומן בקלות רבה יותר.
20.0.0	2021-04-05	הגרסה הזו היא עדכון גרסה ראשי עם מספר שינויי תוכנה שעלולים לגרום לכשל. למידע נוסף על אופן ההעברה, אפשר לעיין במדריך הכנה ל-SDK v20. שינויי תוכנה שעלולים לגרום לכשלים: ממשק ה-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	15-03-2021	נוספה תלות ב- User Messaging Platform SDK. הקריאה החוזרת של onAdImpression() נוספה אל FullScreenContentCallback. הפורמט InstreamAd הוצא משימוש. מתאמים לתהליך בחירת הרשת (Mediation): הוצאו משימוש MediationBannerAdapter, MediationInterstitialAdapter ו-MediationNativeAdapter. מתאמים חדשים צריכים להטמיע את המחלקה Adapter כדי לטעון את הפורמטים האלה. הערה: סוגי המתאם של תהליך בחירת הרשת שהוצאו משימוש לא יוסרו בגרסה 20.0.0 כדי לתת למתאמים בתהליך בחירת הרשת זמן לעבור ל-API החדש. מתאמים לבידינג יכולים עכשיו להטמיע שיטות טעינה ייחודיות במחלקה Adapter לפורמטים ספציפיים ל-RTB.
19.7.0	2021-01-20	שינויים משמעותיים: InterstitialAd RewardedAd NativeAd AppOpenAd הוצא משימוש CustomRenderedAd. מחלקות וחבילות עם הקידומת Publisher הוצאו משימוש והוחלפו בקידומת AdManager. המהדורה המשנית האחרונה לפני גרסה 20.0.0. כל ממשקי ה-API שמסומנים כממשקי API שהוצאו משימוש בגרסה הזו ובגרסאות הקודמות יוסרו בגרסה 20.0.0. מידע נוסף מופיע במדריך להעברה לגרסה 20.0.0.
19.6.0	04-12-2020	ה-method onAdLeftApplication() AdListener הוצאה משימוש. תוקן באג שגרם למשתמשים במכשירי Android 11 לבחור דפדפן כשהם לוחצים על מודעה.
19.5.0	2020-10-20	מודעות באנר: השיטה onAdImpression() AdListener נקראת עכשיו מודעות באנר. נוספה השיטה setHttpTimeoutMillis() כדי להתאים אישית את הזמן הקצוב לתפוגה של קריאות HTTPS שבוצעו על ידי Google Mobile Ads SDK. הוספת את setNeighboringContentUrls() ואת getNeighboringContentUrls() אל PublisherAdRequest.
19.4.0	2020-09-10	נוספה תמיכה במכשירי Android 11 לאפליקציות שמטרגטות ל-API 30. מודעות בפתיחת האפליקציה: הפורמט AppOpenAd השתנה כך שיפעל יותר כמו פורמט של מסך מלא מאשר תצוגת באנר. נוספו methods getResponseInfo() ו-show() ל-AppOpenAd. מחלקות AppOpenAdView ו-AppOpenAdPresentationCallback שהוצאו משימוש. תהליך בחירת הרשת: דיווח על סטטוס תהליך בחירת הרשת זמין עכשיו. אפשר להשתמש במאפיין ResponseInfo.getAdapterResponses() כדי לקבל מידע על תגובות לגבי כל רשת מודעות שהשתתפה בבקשה להצגת מודעה. מודעות מתגמלות מדור קודם: הוצאו משימוש RewardedVideoAd. נוסף הפורמט RewardedInterstitialAd, כרגע בגרסת בטא פרטית. תוקן באג שגרם ל-MobileAds.initialize() להפעיל חזרה את ה-handler של ההשלמה האוטומטית רק פעם אחת. כל שיחה ל-MobileAds.initialize() מפעילה עכשיו את הקריאה החוזרת להשלמה.
19.3.0	2020-07-20	זהירות: גרסאות SDK 19.3.0 ומטה לא תומכות ב-Android 11 (API 30). מומלץ להשתמש ב-SDK בגרסה 19.4.0 ואילך אם מתכננים להגדיר את targetSdkVersion ל-API 30. נוספו השיטות getDomain() ו-getCause() אל AdError. נוספו קריאות חוזרות חדשות לגבי כשל בטעינה לכל הפורמטים של מודעות שמחזירים LoadAdError. למשל: onAdFailedToLoad(LoadAdError). קריאות חוזרות (callback) של כשל בטעינה שהוצאו משימוש ומחזירות ערך פנימי. למשל, onAdFailedToLoad(int). מודעות מתגמלות: נוספו onRewardedAdFailedToShow(AdError) ויצאו משימוש onRewardedAdFailedToShow(int). תהליך בחירת רשת מתגמלת: נוסף קוד השגיאה במצגת MEDIATION_SHOW_ERROR. כל השגיאות במצגת שקשורות למודעות בתהליך בחירת הרשת יחזירו עכשיו את הערך MEDIATION_SHOW_ERROR עבור AdError.getCode(), ואת הערך AdError.getCause() שאינו Null שמייצג את השגיאה הבסיסית בתהליך בחירת הרשת.
19.2.0	2020-06-18	מודעות מותאמות: הוספנו ממשק משתמש של Native Validator לבקשות בדיקה כדי לעזור לך לזהות ולתקן הפרות מדיניות מותאמות. השיטה MobileAds.disableMediationAdapterInitialization() נוספה. כדאי לקרוא לשיטה הזו לפני שמפעילים את Google Mobile Ads SDK כדי להשבית את ההפעלה של המתאם לתהליך בחירת הרשת. אזהרה: הפעלת השיטה הזו עלולה לפגוע בביצועים של תהליך בחירת הרשת ב-Google. צריך לקרוא לשיטה הזו רק אם כוללים באפליקציה מתאמים לתהליך בחירת הרשת (Mediation) של Google, אבל לא משמשים בתהליך בחירת הרשת (Mediation) ב-Google במהלך סשן מסוים באפליקציה (למשל, הפעלה של בדיקת A/B של תהליך בחירת הרשת).
19.1.0	2020-04-16	הוצא משימוש MobileAds.initialize(Context, String) לטובת MobileAds.initialize(Context, OnInitializationCompleteListener). AdRequest.isTestDevice() מחזירה עכשיו את הערך true למכשירי בדיקה שהוגדרו דרך MobileAds.setRequestConfiguration(). תוקנה קריסה ב-NullPointerחריגה ב-MobileAds.initialize() שאירעה במכשירים מסוימים באפליקציות שמשתמשות ב-Lite SDK.
19.0.1	2020-03-18	מודעות מותאמות: תוקנה דליפת זיכרון שהתרחשה במהלך השימוש ב-NativeCustomTemplateAd.
19.0.0	02-03-2020	הגרסה הזו היא עדכון גרסה ראשי עם שינויי התוכנה הבאים: הגרסה המינימלית של Android SDK עודכנה ל-API 16 בהתאם למדיניות ההפצה של שירותי Google Play. מודעות מותאמות: MediaContent הועבר לחבילה com.google.android.gms.ads. נוספה תמיכה בקריאת פרמטרים של הסכמה מ-TCF גרסה 2.0 של IAB וממחרוזת 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(). תהליך בחירת הרשת (Mediation): ב-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). תהליך בחירת הרשת (Mediation): חריגים במתאם, שבהם דוחות הקריסות כוללים את Google Mobile Ads SDK, מזוהים ומטפלים עכשיו ב-Google Mobile Ads SDK.
18.1.0	2019-07-09	גרסה רשמית לתמיכה במדידת אפליקציות. נוספה שיטת אתחול חדשה, MobileAds.initialize(Context, OnInitializationCompleteListener), שתיידע אותך כש-Google Mobile Ads SDK וכל המתאמים שמוגדרים לתהליך בחירת הרשת (Mediation) הושלמו. הוספת את MobileAds.getInitializationStatus() כדי לספק סטטוס האתחול של כל רשתות המודעות שהוגדרו לאפליקציה שלך. הוספת את MobileAds.getRequestConfiguration(). פרמטרים של טירגוט שהוגדרו באובייקט ההגדרה הזה משמשים לכל הבקשות להצגת מודעות. מודעות מותאמות: הוספנו את השיטה NativeAdOptions.Builder.setMediaAspectRatio() כדי לבקש יחס גובה-רוחב ספציפי לנכס מדיה של מודעה מותאמת. האפשרות הזו מקבלת עדיפות על פני השיטה 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). מידע נוסף זמין ב נתוני הגרסה של 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 מתגמלים (אפשר לקרוא על החבילה מתגמלת) שמאפשרים לטעון כמה מודעות מתגמלות בו-זמנית. תהליך בחירת הרשת (Mediation): נוספה קבוצה חדשה של ממשקי API של מתאמים לתהליך בחירת הרשת שתומכים באתחול. מתאמים שמטמיעים את ה-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	הוספנו את השיטות setMaxAdContentRating() ו-setTagForUnderAgeOfConsent() ל-AdRequest.Builder. הוספנו את הקבועים הבאים לשימוש עם AdRequest.Builder.setMaxAdContentRating() ו-AdRequest.Builder.setTagForUnderAgeOfConsent(): MAX_AD_CONTENT_RATING_G MAX_AD_CONTENT_RATING_PG MAX_AD_CONTENT_RATING_T MAX_AD_CONTENT_RATING_MA TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED
17.0.0	2018-10-05	בעלי התוכן הדיגיטלי Ad Manager ב-Google נדרשים לציין את התג <meta-data> עם המפתח com.google.android.gms.ads.AD_MANAGER_APP ב-AndroidManifest.xml. מידע נוסף מופיע במדריך לתחילת העבודה. מודעות מותאמות: NativeAppInstallAd, NativeContentAd וממשקי ה-API המשויכים הוצאו משימוש לטובת UnifiedNativeAd. עיינו במאמר מודעות מותאמות מסוג Advanced Unified לקבלת הוראות נוספות לשימוש בממשקי ה-API החדשים. מודעות מותאמות: נוספה התכונה 'השתקת המודעה הזו'. מודעות מותאמות: יומן האזהרה הלא מזיק: "UnconfirmedClickListener לא יכול להיות null כאשר ClickConfirmingView מוגדר" הוסר. מודעות מתגמלות: נוספה השיטה setAdMetadataListener ל-RewardedVideoAd כדי להאזין לשינויים במטא-נתונים של מודעות. מודעות מתגמלות: קריאה אל destroy() תבטל את ההאזנה. השיטות הבאות הוצאו משימוש בתאריך AdRequest.Builder. setGender() setBirthday() setIsDesignedForFamiles() תוקן באג שגרם לכך ש-onRewardedVideoCompleted() לא הופעל באמולטורים.
16.0.0	2018-10-02	לא מתבצעים שינויים במודעות. מידע נוסף זמין בנתוני הגרסה של Google Play Services.
15.0.0	2018-04‐12	גרסת בטא של MRAID 3. מודעות מותאמות: הוספנו את Unified Native Ad API. כך אנחנו משלבים את NativeAppInstallAds ו-NativeContentAds לסוג חדש אחד: UnifiedNativeAd. הערה: כשמשתמשים במודעות מותאמות, מופיעה אזהרה לא תקינה שמוצגת ביומנים כאשר לוחצים על המודעה המותאמת: "UnconfirmedClickListener לא יכול להיות null כאשר ClickConfirmingView מוגדר באמצעות". אפשר להתעלם מהאזהרה הזו, והיא תוסר בגרסה הבאה.
12.0.1	2018-03-28	לא מתבצעים שינויים במודעות. לפרטים נוספים, ראו נתוני גרסה של Google Play Services.
12.0.0	2018-03-20	סרטון מתגמל: נוספה שיטת הקריאה החוזרת onRewardedVideoCompleted() ל-RewardedVideoAdListener. כדי להימנע משגיאת הידור כשמעדכנים לגרסה 12.0.0, אפליקציות צריכות לבטל את הקריאה החוזרת (callback) הזו בהטמעה של 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	נוספו methods getMediationAdapterClassName() למחלקות NativeAppInstallAd ו-NativeContentAd. השיטה עם אותו שם ב-AdLoader תוצא משימוש. הוספנו method 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. השיטות האלה מופעלות רק במודעות מותאמות להתקנת אפליקציה ובמודעות תוכן מותאמות. הסרנו את השיטות getInAppPurchaseListener() ו-setInAppPurchaseListener() מהמחלקות AdView, InterstitialAd ו-NativeExpressAdView. הוסרו גם סיווגי רכישות קשורים מתוך האפליקציה. הוספנו את השיטות OnVideoMute(), OnVideoPause(), OnVideoPlay() ו-OnVideoStart() למחלקה VideoController.VideoLifecycleCallbacks. נוספה האפשרות להפעיל מצב של צפייה היקפית במודעות במסך מלא על ידי הוספת השיטה setImmersiveMode() למחלקות PublisherInterstitialAd ו-RewardedVideoAd. נוספו הממשק OnPublisherAdViewLoadedListener, הכיתה PublisherAdViewOptions והמחלקה PublisherAdViewOptions.Builder לשימוש עם AdLoader לבקשות של מודעות מותאמות ומודעות באנר. נוסף הממשק האופציונלי OnImmersiveModeUpdatedListener שהמתאמים לתהליך בחירת הרשת (Mediation) יכולים להטמיע כדי לקבל עדכונים על עדכונים במצב עשיר. השיטה 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 Developers. נוספה תמיכה בנכסי וידאו בתוכן מסוג Native Advanced (במודעות מותאמות מסוג Advanced) ובמודעות תבנית בהתאמה אישית. נוספו ה-methods getVideoController(), setVideoOptions() ו-getVideoOptions() למחלקה PublisherAdView. הכיתה AdChoicesView נוספה. נוספו ה-methods getAdChoicesContent() ו-setAdChoicesContent() למחלקה NativeAdMapper. נוסף הממשק InitializableMediationRewardedVideoAdAdapter למתאמים לתהליך בחירת הרשת (Mediation) של מודעות וידאו מתגמלות, שרוצים להביע הסכמה להפעלה מוקדמת לפני שליחת בקשה להצגת מודעה. נוספה תמיכה בתצוגה מקדימה בתוך האפליקציה ובפתרון בעיות ב-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	22-2016-09-22	נוסף הכיתה MediaView למודעות וידאו מותאמות מסוג Advanced. נוספה השיטה openDebugMenu() לכיתה MobileAds לתצוגה מקדימה של קריאייטיב ופתרון בעיות ביחידות המודעות של Ad Manager. הוספנו תמיכה באירועים מותאמים אישית של מודעות וידאו מתגמלות.
9.4.0	2016-08-01	תיקוני באגים ושיפורים כלליים.
9.2.0	2016-06-27	נוספה השיטה 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	נוספה אכלוס אוטומטי של פרטי המיקום לאפליקציות שקיבלו באופן מפורש את הרשאת המיקום. נוספה תמיכה באירועים מותאמים אישית של תהליך בחירת הרשת (Mediation) של מודעות וידאו מתגמלות. נוספו אפשרויות סרטון למודעות מותאמות מסוג 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(), כדי לעדכן את 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	נוספו השיטות addCustomTargeting() ו-addCategoryExclusion() ל-PublisherAdRequest.Builder. תוקנה בעיה שגרמה ל-PublisherAdView.recordManualImpression() לתעד מספר חשיפות ב-Ad Manager במהלך שימוש בספירת חשיפות ידנית. תוקנה בעיה שגרמה להצגת מודעות באופן שגוי כשמשתמשים במאפיין android:largestWidthLimitDp בתג <supports-screens>. הוספנו את ה-method setRequestAgent() ל-AdRequest.Builder ול-PublisherAdRequest.Builder. צריך להשתמש בשיטה הזו כדי לציין מקורות של בקשות להצגת מודעות על ידי צדדים שלישיים שמגשרים על ה-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 כדי לקבל את שם הכיתה של מתאם רשת המודעות שמציג כרגע מודעה.
5.0	2014-06-25	נוספו ממשקי API חדשים כדי להטמיע אירועים בהתאמה אישית. נוסף תהליך רכישה המוגדר כברירת מחדל עבור 'רכישה מתוך האפליקציה', באמצעות Google Play Billing API.
4.4	2014-05-07	נוספו ממשקי API חדשים של Mediation Adapter. נוסף פורמט מודעה חדש בגודל LARGE_BANNER בגודל 320x100 גם לטלפונים וגם לטאבלטים. נוסף פורמט מעברון חדש לרכישה מתוך האפליקציה. צריך להגדיר 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 יש עכשיו method setLocation(). תוקנה קריסה שאירעה כשנשלחה בקשה למודעת מעברון, אבל AdActivity לא צוינה במניפסט.
4.0	2013-10-31	ממשקי ה-API של מודעות Google לנייד הם עכשיו חלק מ-Google Play Services. עדכונים עתידיים של Google Mobile Ads API יועברו באופן אוטומטי למכשירים דרך Google Play Services. עדיין אין תמיכה ב-Ad Manager ובמודעות לרשת החיפוש לאפליקציות לנייד.