מכתבי שחרור

גרסה תאריך פרסום הערות
23.5.0 2024‐10‐29
  • הודעות יומן לגבי כשל בטעינת מודעות עודכנו בגרסה 23.4.0, משגיאה לרמת המידע.
  • מונטיזציה משופרת של מודעות בהתאמה אישית בכרטיסיות מותאמות אישית עבור WebView API למודעות.
23.4.0 2024-09-30
  • כשלויות טעינה של מודעות גורמות עכשיו להצגת הודעה ב-logcat עם הכיתוב ad failed to load בניתוח המעקב אחר סטאק של הכשל. ההודעה הזו מתועדת ביומן של מעקב הסטאק כשגיאה, אבל היא לא מעידה על קריסה. כדי להבין כשלים נפוצים בטעינת מודעות, אפשר להיעזר במאמר ניפוי באגים להודעות נפוצות ברישום ביומן. אם מופיעה שגיאה חוזרת שקשורה להצגת מודעות ללא תיעוד, אפשר לשתף את דוח הקריסות עם התמיכה של 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 09-05-2024
  • נדרש compileSdkVersion מינימום של 34.
  • מתאמי תהליך בחירת הרשת (Mediation) מותאמים: הוצאנו משימוש את 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 30 באוקטובר 2023
22.4.0 2023‑09‑13
  • compileSdkVersion חייב להיות באורך 33 לפחות.
  • הכלי לבדיקת מודעות: נוספה תמיכה ב-SDK לשליחת בקשות להצגת מודעות ולצפייה במודעות שנשלחו דרך ממשק המשתמש של הכלי לבדיקת מודעות.
  • נוספה שיטה QueryInfo.generate() חדשה שלוקחת מזהה של יחידת מודעות.
  • הפעלת בדיקה ראשונית של ממשקי ה-API לשמירה על פרטיות בגרסת הבטא של Attribution Reporting ובגרסת Topics Beta. מידע נוסף זמין במדריך של AdMob ארגז החול לפרטיות ב-Android.
22.3.0 22-2023-08-2023
22.2.0 05-07-2023
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 31 בינואר 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 להצגת מודעות באנר ומודעות מותאמות שמוצגות בבקשה דרך ממשק המשתמש של הכלי לבדיקת מודעות.
  • הוספנו תמיכה במזהה מאינטראקציה ישירה (First-Party) של בעל האפליקציה (לשעבר מפתח אפליקציה זהה), כדי לעזור לכם להציג מודעות בהתאמה אישית שרלוונטיות יותר למשתמשים על סמך הנתונים שנאספו מהאפליקציות שלכם.
  • גרסת ההפצה הרשמית לדור QueryInfo.
21.3.0 2022‐10‐10
21.2.0 2022-09-06
  • הכלי לבדיקת מודעות: נוספה תמיכה ב-SDK לייצוא יומני בקשות להצגת מודעות דרך Android Sharesheet.
21.1.0 2022-07-14
  • נוספה תמיכה במונטיזציה של מודעות ב-WebView. פרטים נוספים זמינים במאמר שילוב ה-API של WebView ל-Google Ads.
  • הוספת getResponseExtras() אל ResponseInfo שעשוי להחזיר מידע נוסף על התגובה למודעה.
21.0.0 2022-05-25
  • שינויי תוכנה שעלולים לגרום לכשלים:
    • כדי להפעיל את 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().
  • הוספת השיטה 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 22-2021-09-09
  • החל מגרסה 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 23 באוגוסט 2021
20.2.0 08-06-2021
  • נוספה תמיכה בכלי לבדיקת מודעות (בטא) לבעלי תוכן דיגיטלי ב-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 הוא עכשיו כיתה מופשטת. משתמשים ב-method הסטטי RewardedAd.load() כדי לטעון מודעה מתגמלת.
  • נוסף הכלי לבדיקת מודעות (בטא).
  • הוחלפה את AdSize.SMART_BANNER במודעות באנר מותאמות.
  • נוספו הערות מפורשות לגבי יכולת null לכל ממשקי ה-API הציבוריים.
19.8.0 15-03-2021
  • נוספה תלות ב- User Messaging Platform SDK.
  • הקריאה החוזרת של onAdImpression() נוספה אל 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 שמסומנים כממשקי 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.
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() מפעילה עכשיו את קריאת החזרה (callback) להשלמה.
19.3.0 2020-07-20
  • נוספו השיטות getDomain() ו-getCause() ל-AdError.
  • נוספו קריאות חוזרות חדשות לגבי כשל בטעינה לכל הפורמטים של מודעות שמחזירים LoadAdError. למשל: onAdFailedToLoad(LoadAdError).
  • קריאות חוזרות (callback) של כשל בטעינה שהוצאו משימוש ומחזירות ערך פנימי. למשל, 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 02-03-2020
  • נוספה תמיכה בקריאת פרמטרים של הסכמה מ-IAB TCF גרסה 2.0 ומהמחרוזת us_privacy של IAB.
  • הוספת setNeighboringContentUrls() ו-getNeighboringContentUrls() ל-AdRequest.
  • נוספה מחלקה ResponseInfo שמספקת מידע על מודעה שנטענה.
  • בכל הפורמטים של המודעות, הוצאנו משימוש את getMediationAdapterClassName() לטובת getResponseInfo().
  • מודעות מותאמות: נוספו שיטות getDuration() ו-getCurrentTime() אל MediaContent.
  • תהליך בחירת הרשת המותאמת: נוספו שיטות getDuration() ו-getCurrentTime() ל-UnifiedNativeAdMapper כדי להטמיע מתאמים.
  • הוצא משימוש AdRequest.Builder.addTestDevice(). במקום זאת, אתם צריכים להשתמש ב-RequestConfiguration.Builder.setTestDeviceIds().
18.3.0 05 בנובמבר 2019
  • הוספנו ממשקי 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 23 ביולי 2019
  • תהליך בחירת הרשת (Mediation): המתאמים מופעלים עכשיו כשאפליקציות קוראות לפונקציה MobileAds.initialize(Context, OnInitializationCompleteListener).
  • תהליך בחירת הרשת: עכשיו, Google Mobile Ads SDK מזהה ומתמודד עם חריגות של מתאמים שבמעקב ה-stack שלהן מופיע Google Mobile Ads SDK.
18.1.0 2019‑07‑09
  • גרסה רשמית עם תמיכה במדידה של אפליקציות.
  • כברירת מחדל, מדידת אפליקציות מאתחלת את הנתונים ושולחת אותם כשהאפליקציה מופעלת. הוספנו אפשרות לדחות את המדידה של האפליקציה עד שמתבצעת קריאה מפורשת ל-Google Mobile Ads SDK.
  • נוספה שיטת אתחול חדשה, 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 במודעות שהן לא מודעות וידאו.
  • תהליך בחירת הרשת (Mediation) במודעות מותאמות: המתאמים יכולים עכשיו לספק יחס גובה-רוחב דרך 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) שמאפשרים לטעון כמה מודעות וידאו מתגמלות בו-זמנית.
  • בחירת רשת: נוספה קבוצה חדשה של ממשקי 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 31 בינואר 2019
  • בעלי תוכן דיגיטלי שמשתמשים בגרסה 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 03 בדצמבר 2018
  • בעלי תוכן דיגיטלי שמשתמשים בגרסה 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
  • בעלי התוכן הדיגיטלי AdMob ב-Google נדרשים לציין את התג <meta-data> עם המפתח com.google.android.gms.ads.APPLICATION_ID ב-AndroidManifest.xml. מידע נוסף מופיע במדריך לתחילת העבודה.
  • מודעות מותאמות: NativeAppInstallAd,‏ NativeContentAd וממשקי ה-API המשויכים הוצאו משימוש לטובת UnifiedNativeAd. עיינו במאמר מודעות מותאמות מסוג Advanced Unified לקבלת הוראות נוספות לשימוש בממשקי ה-API החדשים.
  • מודעות מותאמות: נוספה התכונה 'השתקת המודעה הזו'.
  • מודעות מותאמות: יומן האזהרה הלא מזיק: "UnconfirmedClickListener לא יכול להיות null כאשר ClickConfirmingView מוגדר" הוסר.
  • מודעות מתגמלות: נוספה השיטה setAdMetadataListener ב-RewardedVideoAd כדי להאזין לשינויים במטא-נתונים של מודעות.
  • מודעות מתגמלות: קריאה ל-destroy() תבטל את המאזין.
  • השיטות הבאות הוצאו משימוש בתאריך 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 לא יכול להיות null כאשר ClickConfirmingView מוגדר באמצעות". אפשר להתעלם מהאזהרה הזו, והיא תוסר במהדורה הבאה.
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 07 בנובמבר 2017
  • הוספנו את המחלקה NativeAdViewHolder ושיטות קשורות ב-NativeAppInstallAd וב-NativeContentAd.
  • AdLoader.getMediationAdapterClassName הוצא משימוש (בעלי תוכן דיגיטלי צריכים להשתמש במקום זאת בשיטות בעלות אותו שם ב-NativeAppInstallAd וב-NativeContentAd).
  • עכשיו מודעות בדיקה מוצגות עם תווית מעל המודעה. לפרטים נוספים אפשר לעיין במדריך הבדיקה.
11.4.0 19 בספטמבר 2017
  • נוספו 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
  • נוספו השיטות onAdClicked() ו-onAdImpression() לכיתה AdListener. השיטות האלה מופעלות רק במודעות מותאמות להתקנת אפליקציה ובמודעות תוכן מותאמות.
  • הסרנו את השיטות getInAppPurchaseListener() ו-setInAppPurchaseListener() מהמחלקות AdView, InterstitialAd ו-NativeExpressAdView. הוסרו גם סיווגי רכישות קשורים מתוך האפליקציה.
  • הוספנו את השיטות OnVideoMute(), OnVideoPause(), OnVideoPlay() ו-OnVideoStart() למחלקה VideoController.VideoLifecycleCallbacks.
  • הוספנו את היכולת להפעיל מצב immersive במודעות במסך מלא על ידי הוספת השיטה setImmersiveMode() לכיתות PublisherInterstitialAd ו-RewardedVideoAd.
  • נוספו הממשק OnPublisherAdViewLoadedListener, הכיתה PublisherAdViewOptions והמחלקה PublisherAdViewOptions.Builder לשימוש עם AdLoader לבקשות של מודעות מותאמות ומודעות באנר.
  • הוספנו את הממשק האופציונלי OnImmersiveModeUpdatedListener, שיכולים להטמיע מתאמי תהליך בחירת הרשת כדי לקבל עדכונים על מצב התצוגה המלאה.
  • הוספת השיטה getMediationAdapterClassName() לכיתה RewardedVideoAd.
  • נוספו כללי keep כדי לשמור באופן אוטומטי את שמות המחלקות של המתאם בתהליך בחירת הרשת כשמשתמשים ב-ProGuard.
10.2.0 2017‑2‑15
  • Google Play Services 10.2.x היא הגרסה הראשונה שלא כוללת יותר תמיכה מלאה ב-Android מגרסה 2.3.x (Gingerbread). אפליקציות שפותחו באמצעות גרסת SDK 10.2.x ואילך צריכות להיות ברמת API 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 24 באוקטובר 2016
  • 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) של מודעות וידאו מתגמלות.
  • הוספנו אפשרויות וידאו למודעות Native Express.
  • עדכנו את Custom Search Ads API.
  • השיטה setAppMuted() נוספה.
  • השיטה MobileAds.initialize(android.content.Context, java.lang.String) כבר לא הוצאה משימוש.
  • השיטה MobileAds.initialize(android.content.Context) הוצאה משימוש.
  • נוספה השיטה MediationNativeListener.onAdImpression() לדיווח על חשיפות במודולים של תהליך בחירת הרשת (Mediation).
  • לגרסה הזו בלבד, באפליקציות שמשתמשות ב-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>.
  • הוספנו את השיטה 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 כדי לקבל את שם הסיווג של מתאם תהליך בחירת הרשת (Mediation) של רשת המודעות שמציג מודעה כרגע.
5.0 2014-06-25
  • נוספו ממשקי API חדשים כדי להטמיע אירועים בהתאמה אישית.
  • נוסף תהליך רכישה המוגדר כברירת מחדל עבור 'רכישה מתוך האפליקציה', באמצעות Google Play Billing API.
4.4 2014-05-07
  • הוספנו ממשקי API חדשים של מתאמי תהליך בחירת הרשת (Mediation).
  • נוסף פורמט מודעה חדש בגודל 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 יש עכשיו שיטה מסוג setLocation().
  • תוקנה קריסה שהתרחשה אם נשלחה בקשה להצגת מודעת מעברון אבל הערך AdActivity לא צוין במניפסט.
4.0 31 באוקטובר 2013
  • ממשקי ה-API של מודעות Google לנייד הם עכשיו חלק מ-Google Play Services.
  • עדכונים עתידיים של Google Mobile Ads API יועברו באופן אוטומטי למכשירים דרך Google Play Services.
  • עדיין אין תמיכה ב-Ad Manager וב-Search Ads לקידום אפליקציות לנייד.