Informacje o wersjach

Wersja	Data wydania	Uwagi
1.5.0	2026-09-24	Dodano interfejsy API generowania i renderowania sygnałów w formacie SwipeableInterstitialAd. Ta funkcja jest w prywatnej wersji beta. Zamów dostęp do niego u menedżera konta. Dodaliśmy do żądań reklam z ikonami interfejs excludedAppIds API, który umożliwia wydawcom opcjonalne wykluczanie z odpowiedzi na żądania reklam z ikonami listy identyfikatorów aplikacji.
1.4.0	2026-08-20	Dodaliśmy obsługę formatu PictureInPictureAd. Reklamy typu obraz w obrazie są dostępne w otwartej wersji beta. Dodano onInitializationFailed(AdError) i wycofano onInitializationFailed(String) w InitializationCompleteCallback. Adaptery do zapośredniczenia mogą teraz zgłaszać do pakietu SDK błędy inicjowania pakietu SDK innej firmy, podając kod błędu, domenę błędu i komunikat o błędzie.
1.3.1	2026-07-29	Poprawki błędów i ulepszenia działania funkcji o ograniczonym dostępie.
1.3.0	2026-07-21	Zmieniono AdView.loadAd(), aby wstrzymać automatyczne ponawianie nieudanych żądań reklamy, gdy automatyczne odświeżanie jest wyłączone w przypadku jednostki reklamowej. Gdy żądanie reklamy obejmujące wiele reklam natywnych lub reklam z ikonami nie przynosi żadnych dostępnych reklam, pakiet SDK zwraca teraz błąd NO_FILL zamiast błędu INTERNAL_ERROR. Dodaliśmy flagę pliku manifestu, która umożliwia wyłączenie inspektora reklam. Dodaliśmy metodę Ad.getAdUnitId(), która umożliwia identyfikowanie identyfikatora jednostki reklamowej użytego do wysłania żądania reklamy. Dodaliśmy metodę InitializationConfig.Builder.disableSdkCrashReporting(), która umożliwia ręczne wyłączenie domyślnego modułu obsługi awarii w GMA Next-Gen SDK. Domyślnie pakiet SDK nadal przekazuje informacje o awariach do innych zarejestrowanych modułów obsługi (np. Crashlytics). W przypadku zapośredniczenia ze źródłami reklam zdarzeń niestandardowych funkcja ResponseInfo.getAdapterClassName() zwraca teraz nazwę klasy zdarzenia niestandardowego zamiast com.google.ads.mediation.customevent.CustomEventAdapter.
1.2.1	2026-06-15	W przypadku aplikacji korzystających z interfejsu WebView API for Ads rozwiązaliśmy problem, który uniemożliwiał pakietowi SDK przekazywanie sygnałów do obsługiwanych tagów reklamowych (kodu AdSense, tagu wydawcy Google, IMA dla HTML5). Ten problem był spowodowany nieprawidłowym wywoływaniem metod Webkit w wątku w tle.
1.2.0	2026-06-11	Naprawiliśmy błąd powodujący java.lang.NullPointerException w androidx.webkit.internal.PrefetchOperationCallbackAdapter. Dodano format SwipeableInterstitialAd. Ta funkcja jest w prywatnej wersji beta. Zamów dostęp do niego u menedżera konta. W przypadku aplikacji, które wysyłają żądania dotyczące wielu reklam z ikoną, dodano IconAd.load(IconAdRequest, int, IconAdLoadCallback) i wycofano IconAd.load(IconAdRequest, int, AdLoadCallback<IconAd>). IconAdLoadCallback zawiera metodę onAdLoadingCompleted(), która sygnalizuje zakończenie wczytywania wszystkich reklam. Adaptery do mediacji: Dodaliśmy metodę RequestConfiguration.getAgeRestrictedTreatment() , która umożliwia adapterom odczytywanie ustawień traktowania treści z uwzględnieniem wieku. Zmieniono untrackView() na akceptowanie View zamiast View?, aby zachować zgodność z adapterami zbudowanymi na podstawie Google Mobile Ads SDK (Legacy).
1.1.1	2026-05-27	Rozwiązaliśmy problem, który powodował, że bloki reklam z nagrodą mogły się zawieszać podczas przejść, uniemożliwiając użytkownikom zamknięcie reklamy.
1.1.0	2026-05-18	Dodano RequestConfiguration.Builder.setAgeRestrictedTreatment() i wycofano te metody: RequestConfiguration.Builder.setTagForChildDirectedTreatment() RequestConfiguration.Builder.setTagForUnderAgeOfConsent() Dodano klasy destroyAll() i peekAdResponseInfo() do klas wstępnego wczytywania reklam. Dodano metody load() do IconAd, które obsługują wczytywanie wielu reklam z ikonami.
1.0.1	2026-04-30	Rozwiązaliśmy problem, który powodował, że reklamy korzystające z symbolu window.open() lub linki z symbolem target="_blank" nie otwierały stron docelowych.
1.0.0	2026-04-14	Zmiany powodujące niezgodność: Usunęliśmy wycofaną metodę AdPreloader.numAdsAvailable(). Zamiast niej używaj AdPreloader.getNumAdsAvailable(). Zaktualizowano org.chromium.net:cronet-api do wersji 143.7445.0, aby zapobiec naruszeniom unikalnej przestrzeni nazw. Naprawiliśmy błąd, który powodował, że funkcje MediaContent.currentTime i NativeAdMapper.getCurrentTime() zawsze zwracały wartość 0.
0.25.0-beta01	2026-03-24	Rozwiązaliśmy problem polegający na tym, że funkcja Ad.getResponseInfo() nie zwracała zaktualizowanych metadanych ResponseInfo po odświeżeniu banera reklamowego.
0.24.0-beta03	2026-03-07	Rozwiązaliśmy problem, który powodował, że AdView.destroy() nie zatrzymywał ponownych prób załadowania reklamy po nieudanym załadowaniu. Dodano konstruktory bezargumentowe do klas NativeAdMapper i UnifiedNativeAdMapper, aby poprawić zgodność z Kotlinem. Dodaliśmy właściwość packageName do interfejsu IconAd. Dodaliśmy opcję wymuszania używania przez pakiet SDK biblioteki Cronet zamiast OkHttp do operacji sieciowych. Aby rozwiązać błędy środowiska wykonawczego w projektach, które korzystają z OkHttp 5, zalecamy wymuszenie używania Croneta do operacji sieciowych. Aby wymusić użycie Croneta, ustaw wartość force_use_cronet dodatkowego parametru na true w InitializationConfig.Builder podczas wywoływania MobileAds.initialize(): val config = InitializationConfig.Builder() .setExtras(bundleOf("force_use_cronet" to true)) .build() MobileAds.initialize(this, config) Dodaliśmy obsługę Javy 11. Aby używać Javy 11, dodaj ten kod do bloku android w pliku build.gradle: android { compileOptions { sourceCompatibility JavaVersion.VERSION_11 targetCompatibility JavaVersion.VERSION_11 } kotlinOptions { jvmTarget = '11' } }
0.24.0-beta02	2026-03-03	Rozwiązano problem z ładowaniem klasy zależności firmy zewnętrznej, który wpływał na generowanie sygnałów żądania reklamy między serwerami.
0.24.0-beta01	2026-02-13	Dodaliśmy obsługę dużych zakotwiczonych banerów adaptacyjnych. Duże zakotwiczone banery adaptacyjne mają na celu zwiększenie zaangażowania i przychodów. Wysyłaj żądania dotyczące dużych zakotwiczonych banerów adaptacyjnych za pomocą tych metod w klasie AdSize: getLargePortraitAnchoredAdaptiveBannerAdSize() getLargeLandscapeAnchoredAdaptiveBannerAdSize() getLargeAnchoredAdaptiveBannerAdSize() Wycofane zostały te metody w klasie AdSize: getCurrentOrientationAnchoredAdaptiveBannerAdSize() getLandscapeAnchoredAdaptiveBannerAdSize() getPortraitAnchoredAdaptiveBannerAdSize() Naprawiono błąd, który powodował, że reklamy banerowe mogły przestać się odświeżać, jeśli platforma wywoływała funkcje onViewAttachedToWindow() i onViewDetachedFromWindow() w nieprawidłowej kolejności podczas wyświetlania nowej reklamy.
0.23.0-beta01	2026-01-26	Zaktualizowano minimalną wymaganą wersję wtyczki Androida do obsługi Gradle (AGP) do 8.3.0. Naprawiliśmy błąd, w którym konstruktor AdView zgłaszał wyjątek java.lang.NoSuchMethodError, gdy był wywoływany z poziomu języka Kotlin. Rozwiązaliśmy problem polegający na tym, że podczas wykonywania kaskady nie były wywoływane adaptery zdarzeń niestandardowych. Zaktualizowano RtbSignalData, aby w miarę możliwości przekazywać kontekst aktywności do RtbAdapter.collectSignals(). Zaktualizowano zależność androidx.webkit do wersji 1.15.0. Zaktualizowano zależność pakietu SDK platformy do personalizowania wiadomości wyświetlanych użytkownikom do wersji 4.0.0. Cofnięto wycofanie funkcji AdPreloader.getConfiguration() i AdPreloader.getConfigurations().
0.22.0-beta04	2025-12-04	Rozwiązaliśmy problem w pakiecie SDK w wersji 0.22.0-beta02, który powodował, że metadane wersji Java 17 preview były nieprawidłowo uwzględniane w plikach klas.
0.22.0-beta03	2025-11-25	Naprawiliśmy błąd, który powodował, że w żądaniach reklamy między serwerami używających elementu NativeSignalRequest.Builder.setAdSize() nie był prawidłowo ustawiany żądany rozmiar reklamy.
0.22.0-beta02	2025-11-24	Rozwiązaliśmy błąd ładowania w usłudze Ad Manager, który powodował, że żądania reklamy serwer-serwer wykorzystujące NativeSignalRequest nie były renderowane, jeśli odpowiedź na żądanie reklamy była typu NativeAd.NativeAdType.BANNER.
0.22.0-beta01	2025-11-20	Zaktualizuj API banerów reklamowych: Dodano klasę AdView. Wycofane w BannerAd.load() i BannerAd.loadFromAdResponse(). Aby wczytać pojedynczy baner reklamowy, użyj zamiast tego poleceń AdView.loadAd() i AdView.loadFromAdResponse(). Wycofano BannerAd.getView(). Aby wyrenderować BannerAd wczytany za pomocą BannerAdPreloader, utwórz instancję AdView i użyj AdView.registerBannerAd(). Naprawiliśmy błąd w reklamach wyświetlanych w ramach zapośredniczenia, który powodował, że nie był uwzględniany znak NativeAdRequest.Builder.setAdChoicesPlacement(), co skutkowało nieprawidłowym umieszczeniem ikony Wybory reklam. Obniżyliśmy minimalną wymaganą wersję wtyczki Androida do obsługi Gradle (AGP) z 8.2.0 do 7.3.1. Wycofane: AdPreloader.getConfigurations() i AdPreloader.getConfiguration(preloadId). Nie ma zamiennika.
0.21.0-beta01	2025-10-08	Dodaliśmy metodę InitializationConfig.Builder.disableMediationAdapterInitialization(). Wywołaj tę metodę przed zainicjowaniem GMA Next-Gen SDK, aby wyłączyć inicjowanie adaptera do zapośredniczenia. Ulepszone wykorzystanie inicjowania WebView w celu zmniejszenia liczby błędów ANR. Zmieniono wersję zależności androidx.webkit z 1.13.0 na 1.12.1. Usunięto uprawnienie android.permission.RECEIVE_BOOT_COMPLETED używane przez pakiet androidx.work. Naprawiliśmy błędną nazwę pola w klasie NativeAdMapper.
0.20.0-beta01	2025-09-19	Naprawiliśmy błąd, który powodował, że niektóre natywne reklamy wideo nie odtwarzały się automatycznie.
0.19.0-beta01	2025-08-14	Wersje dwóch zależności zostały obniżone. androidx.work:work-runtime od 2.10.0 do 2.7.0. androidx.core:core and androidx.core:core-ktx od 1.15.0 do 1.12.0. Zmieniono nazwę usługi loadedAdSourceResponse w dniu ResponseInfo na loadedAdSourceResponseInfo. Naprawiliśmy błąd, który umożliwiał użytkownikom przedwczesne zamykanie niektórych reklam pełnoekranowych za pomocą przycisku Wstecz. Wydawcy, którzy mają dostęp do tej funkcji, mogą teraz korzystać z identyfikatorów miejsc docelowych w przypadku wszystkich formatów reklam. Dodaliśmy wywołanie zwrotne destroy() do NativeAdMapper w przypadku adapterów do zapośredniczenia reklam natywnych.
0.18.0-beta01	2025-07-17	Naprawiliśmy błąd zapośredniczenia natywnego, który powodował przerwanie wyświetlania reklam w przypadku adapterów odwołujących się do com.google.android.gms.ads.NativeAd.MediaView. Dodano adnotację MobileAds.registerCustomTabsSession() z użyciem @JvmStatic. Naprawiliśmy błąd, który powodował, że banery reklamowe wczytywane za pomocą kaskadowego określania stawek w sieci AdMob przestawały się odświeżać.
0.17.0-alpha02	2025-06-23	Naprawiliśmy błąd ustalania stawek w zapośredniczeniu reklam natywnych, który powodował, że adaptery implementujące ustalanie stawek, ale nie kaskadę (np. Meta Audience Network), zawsze nie renderowały reklam natywnych. Rozwiązaliśmy problem z awarią, która występowała, gdy adapter zapośredniczenia wywoływał wiele metod MediationAdLoadCallback w przypadku jednego żądania reklamy.
0.17.0-alpha01	2025-06-18	Wersja 0.17.0-alpha01 została wydana przez przypadek i nie zawiera planowanych nowych funkcji. Zamiast niej użyj wersji 0.17.0-alpha02.
0.16.0-alpha01	2025-05-23	Nie musisz już włączać obsługi odcukrzania interfejsu API Java 8+. Zaktualizowano zależność pakietu SDK platformy do personalizowania wiadomości wyświetlanych użytkownikom do wersji 3.2.0. Rozwiązaliśmy błąd zapośredniczenia reklam natywnych, który powodował awarie w adapterach odwołujących się do klasy com.google.android.gms.ads.formats.MediaView. Wstępne ładowanie reklam: dodano getNumAdsAvailable() i wycofano numAdsAvailable(). Usunęliśmy tag właściwości android.adservices.AD_SERVICES_CONFIG z pliku manifestu pakietu SDK, aby zapobiec konfliktom scalania w przypadku aplikacji, które konfigurują usługi reklamowe pod kątem interfejsu API.
0.15.1-alpha01	2025-04-28	Teraz musisz włączyć obsługę usuwania cukru syntaktycznego z interfejsu Java 8+ API. W przypadku aplikacji opracowanych w języku Kotlin zmniejszyliśmy minimalną wymaganą wersję tego języka z 2.1 do 1.9.
0.15.0-alpha01	2025-04-24	Reklamy natywne: dodano obsługę wczytywania wielu reklam natywnych. Dodano metodę NativeAdLoader.load(NativeAdRequest, numberOfAds, NativeAdLoaderCallback) umożliwiającą wysyłanie próśb o wiele reklam jednocześnie. Dodano wywołanie zwrotne NativeAdLoaderCallback.onAdLoadingCompleted() , które jest wywoływane, gdy wszystkie reklamy natywne zostaną wczytane. Aby obsługiwać asynchroniczne wczytywanie w Kotlinie, dodaliśmy metodę NativeAdLoader.load(NativeAdRequest, numberOfAds), która zwraca Flow<NativeAdLoadResult>. Zaktualizowano zależność kotlinx-coroutines-android z wersji 1.7.3 do 1.9.0.
0.14.0-alpha01	2025-03-20	Żądania reklam nie będą działać, jeśli zainicjujesz pakiet SDK za pomocą nieprawidłowego identyfikatora aplikacji. Metoda AdPreloader.start() nie wymaga już wywołania zwrotnego PreloadCallback. Właściwość bufferSize jest opcjonalna podczas tworzenia obiektu za pomocą klasy danych PreloadConfiguration. Aby umożliwić Google optymalizację rozmiaru bufora, nie ustawiaj właściwości bufferSize. Usunęliśmy właściwość maxAdsPerSession w PreloadConfigurationklasie danych. Dodano właściwości shouldRequestMultipleImages i shouldReturnUrlsForImageAssets do klasy NativeAdOptions.
0.13.0-alpha01	2025-02-26	Dodano MediationRewardedAdCallback.onUserEarnedReward() i wycofano MediationRewardedAdCallback.onUserEarnedReward(RewardItem). Dodano interfejsy API do wstępnego ładowania reklam.
0.12.0-alpha01	22.01.2025 r.	Usunięto błąd polegający na tym, że niektóre metody w AdRequest, AdRequest.Builder, SignalRequest i SignalRequest.Builder były zaciemnione. W przypadku użytkowników interfejsu WebView API for Ads, którzy nie mają identyfikatora aplikacji Ad Managera, dodaliśmy InitializationConfig.WEBVIEW_APIS_FOR_ADS_APPLICATION_ID, który można przekazać podczas inicjowania pakietu SDK. Dodaliśmy obsługę łączenia reklam natywnych i banerowych w żądaniach reklam w usłudze Ad Manager.
0.11.0-alpha01	12.12.2024 r.	Zaktualizowano zależność od pakietu SDK platformy do personalizowania wiadomości wyświetlanych użytkownikom do wersji 3.1.0. Dodaliśmy obsługę niestandardowych gestów kliknięcia w reklamach natywnych. Dodaliśmy obsługę ręcznego liczenia wyświetleń banerów reklamowych w rezerwacjach w usłudze Ad Manager.
0.10.0-alpha01	2024-11-08	Dodano funkcje DSL dla VideoOptions i RequestConfiguration, aby zapewnić lepszą obsługę języka Kotlin. Dodano obsługę interfejsu Publisher Privacy Treatment API z RequestConfiguration.setPublisherPrivacyPersonalizationState(). Dodano interfejsy API zawieszania w języku Kotlin do wczytywania reklam i generowania sygnałów. Usunięto IconAd.LoadAdResult i zastąpiono go tekstem AdLoadResult. Rozwiązaliśmy problem, który powodował, że w przypadku natywnych reklam wideo nie rozpoczynały się sesje OMID.
0.9.0-alpha01	2024-10-02	Usunięto zależność od interfejsów API Javy 8 i nowszych dostępnych za pomocą desugaryzacji w wersji 0.6.0-alpha01. Aplikacje, które używają minSdkVersion w wersji niższej niż 26, nie muszą już włączać obsługi odcukrzania interfejsu API Java 8 lub nowszego. Dodaliśmy obsługę inspektora reklam. Dodaliśmy obsługę filmów w przypadku niestandardowego formatu reklamy natywnej. Oficjalna wersja interfejsów API do zbierania i renderowania sygnałów.
0.8.0-alpha01	2024-08-22	Zaktualizowano zależność od pakietu SDK platformy do personalizowania wiadomości wyświetlanych użytkownikom do wersji 3.0.0. Reklamy natywne: Oficjalna wersja do publikacji formatu reklamy natywnej. Dodaliśmy obsługę wyświetlania filmów w komponencie MediaContent. Dodano wywołania zwrotne cyklu życia filmu. Dodano niestandardowe elementy sterujące odtwarzaniem wideo. Włączyliśmy otwarty pomiar w przypadku reklam natywnych i niestandardowych reklam natywnych. Pole signalType jest teraz wymagane podczas tworzenia SignalRequest.
0.6.0-alpha01	2024-06-20	Dodano kod, który korzysta z  interfejsów API Java 8+ dostępnych w ramach desugaryzacji. Aplikacje, które używają wersji minSdkVersion niższej niż 26, muszą włączyć obsługę usuwania cukru syntaktycznego z interfejsu API Java 8 lub nowszego. Dodano obsługę formatów reklam natywnych i niestandardowych reklam natywnych, które nie zawierają zasobów wideo. Dodaliśmy obsługę MRAID w wersji 3. Dodano zależność od pakietu SDK platformy do personalizowania wiadomości wyświetlanych użytkownikom w wersji 2.2.0. Zaktualizowano domenę błędu w przypadku błędów Google z com.google.android.gms.ads na com.google.android.libraries.ads.mobile.sdk. Dodano metodę MobileAds.isInitialized(), która sprawdza, czy pakiet SDK został już zainicjowany. Dodano BannerAd.isCollapsible(), aby sprawdzić, czy zwrócony baner reklamowy jest zwijalny. Dodano MobileAds.registerCustomTabsSession(), aby zwiększyć zarabianie na reklamach w kartach niestandardowych. Zmieniono nazwę OnInitializationCompleteListener na OnAdapterInitializationCompleteListener. Zmieniono nazwę AdapterResponseInfo na AdSourceResponseInfo. Zmieniono nazwę AdRequest.Builder.putAdNetworkExtrasBundle() na AdRequest.Builder.putAdSourceExtrasBundle(). Naprawiliśmy błąd, który powodował, że klasy adaptera ustalania stawek nie były prawidłowo tworzone.
0.3.0-alpha01	2024-03-20	Pierwsza wersja GMA Next-Gen SDK. Obsługuje banery, reklamy pełnoekranowe, reklamy z nagrodą, reklamy pełnoekranowe z nagrodą i reklamy wyświetlane przy otwarciu aplikacji. Obsługuje zapośredniczenie w przypadku wszystkich formatów reklam. Adaptery napisane dla obecnego pakietu SDK do reklam mobilnych są zgodne z GMA Next-Gen SDK. Dodano zależność od pakietu Open Measurement SDK w wersji 1.4.10.