Informacje o wersjach

Wersja	Data wydania	Uwagi
25.1.0	2026‑03‑16	Naprawiliśmy błąd w Inspektorze reklam, który mógł powodować błąd podczas wysyłania żądania reklamy testowej poza kontekstem z pustym adresem URL treści.
25.0.0	2026‑02‑17	Zmiany powodujące niezgodność: Usunięto klasę VersionInfo z pakietu com.google.android.gms.ads.mediation. Usunęliśmy przestarzałą metodę getConfiguration() z klasy RtbSignalData. Usunęliśmy wycofane metody onFailure(String) i onAdFailedToShow(String) w tych klasach: SignalCallbacks MediationAdLoadCallback MediationInterstitialAdCallback MediationRewardedAdCallback Usunięto zajęcia NativeAdViewHolder z pakietu com.google.android.gms.ads.nativead. Usunęliśmy symbole MIN_WIDTH_RATIO i MIN_HEIGHT_RATIO z MediationUtils, aby obsługiwać bardziej elastyczne progi dopasowywania rozmiarów reklam w przypadku rozmiarów reklam w mediacji. Zaktualizowano zależność pakietu SDK platformy do personalizowania wiadomości wyświetlanych użytkownikom do wersji 4.0.0. Dodano nowe interfejsy API AdSize, które umożliwiają obliczanie zoptymalizowanej wysokości dużych zakotwiczonych banerów adaptacyjnych: getLargePortraitAnchoredAdaptiveBannerAdSize() getLargeLandscapeAnchoredAdaptiveBannerAdSize() getLargeAnchoredAdaptiveBannerAdSize() Poniższe metody w klasie AdSize zostały wycofane na rzecz nowych metod obsługi dużych adaptacyjnych banerów kotwiczonych: getCurrentOrientationAnchoredAdaptiveBannerAdSize(Context, int) getLandscapeAnchoredAdaptiveBannerAdSize(Context, int) getPortraitAnchoredAdaptiveBannerAdSize(Context, int)
24.9.0	2025‑12‑11	Poprawki błędów i ulepszenie działania aplikacji.
24.8.0	2025‑11‑20	Rozwiązanie problemu z brakującymi tłumaczeniami zasobów SDK w wersjach 24.6.0 i 24.7.0. Wycofano NativeAdViewHolder. Zamiast tego używaj NativeAdView do renderowania reklam natywnych. Metody AdPreloader.getConfigurations() i AdPreloader.getConfiguration(preloadId) zostały oznaczone jako przestarzałe. Nie ma zamienników tych metod.
24.7.0	2025‑10‑09	Poprawiono brakującą adnotację dopuszczającą wartość null w przypadku zwracanego typu funkcji NativeCustomFormatAd.getDisplayOpenMeasurement(). Funkcjonalność pozostaje bez zmian, ponieważ możliwość zwracania wartości null przez tę metodę była już wcześniej oczekiwana. Obniżono wersję zależności androidx.webkit:webkit z 1.14.0 do 1.12.1, aby zachować zgodność z wtyczką Androida do obsługi Gradle w wersji 7.3.1.
24.6.0	2025‑09‑08	Adaptery do zapośredniczenia w przypadku reklam natywnych mogą teraz implementować NativeAdMapper.destroy(), aby otrzymywać powiadomienia o usunięciu reklamy natywnej.
24.5.0	2025‑07‑24	Wydawcy, którzy mają dostęp do tej funkcji, mogą teraz korzystać z identyfikatorów miejsc docelowych w przypadku wszystkich formatów reklam. Naprawiliśmy błąd powodujący awarię z komunikatem Fatal Exception: java.util.ConcurrentModificationException.
24.4.0	2025‑06‑09	Dodaliśmy kilka nowych interfejsów API do wstępnego wczytywania reklam i wycofaliśmy dotychczasowe. Wstępne wczytywanie reklam pozostaje funkcją alfa o ograniczonym dostępie.
24.3.0	2025‑05‑19	Zaktualizowano zależność pakietu SDK platformy do personalizowania wiadomości wyświetlanych użytkownikom do wersji 3.2.0.
24.2.0	2025‑04‑07	Poprawki błędów i ulepszenie działania aplikacji.
24.1.0	2025‑03‑12	Minimalna wersja języka Kotlin to teraz 2.1.0. Poprawki błędów i ulepszenie działania aplikacji. play-services-ads-lite jest przenoszony na rzadsze wydania i nie jest dystrybuowany w tej wersji. Więcej informacji znajdziesz w dokumentacji pakietu Lite SDK.
24.0.0	24 lutego 2025 r.	Zmiany powodujące niezgodność: Zwiększyliśmy minimalny poziom interfejsu Android API do 23. Pakiet SDK nie przekazuje już do Ad Managera dodatkowych parametrów przekazywanych przez addNetworkExtrasBundle() jako parametrów kierowania niestandardowego. Aby ustawić kierowanie niestandardowe, użyj zamiast niej kolumny addCustomTargeting(). Więcej informacji znajdziesz w sekcji Kierowanie niestandardowe. Usunęliśmy wszystkie interfejsy API związane z formatem reklamy w przewijaniu. Usunięto wycofane interfejsy API AppOpenAd dotyczące orientacji. Usunięto zajęcia SearchAdView i DynamicHeightSearchAdRequest. Zaktualizowano zależność pakietu SDK platformy do personalizowania wiadomości wyświetlanych użytkownikom do wersji 3.1.0. Optymalizacja inicjowania i wczytywania reklam jest teraz ogólnie dostępna i domyślnie włączona. Dodano MediationRewardedAdCallback.onUserEarnedReward() i wycofano MediationRewardedAdCallback.onUserEarnedReward(RewardItem). Adaptery do zapośredniczenia powinny zostać zaktualizowane, aby korzystać z nowej metody. 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 konkretnych interfejsów API.
23.6.0	2024‑12‑03	Wycofaliśmy wszystkie interfejsy API związane z formatem reklamy w przewijaniu. Na przykład:AdSize.getCurrentOrientationInterscrollerAdSize().
23.5.0	2024‑10‑29	Zaktualizowano komunikaty logcat o błędach wczytywania reklam wprowadzone w wersji 23.4.0 z poziomu błędu na poziom informacji. lepsza monetyzacja reklam spersonalizowanych w niestandardowych kartach w komponencie WebView API for Ads;
23.4.0	2024‑09‑30	Błędy wczytywania reklam powodują teraz wywołanie komunikatu Logcat, który w zrzucie stosu błędu zawiera informację ad failed to load. Ślad stosu rejestruje ten komunikat jako błąd, ale nie oznacza to awarii. Aby interpretować typowe błędy wczytywania reklam, zapoznaj się z artykułem Debugowanie typowych komunikatów o błędach rejestrowanych w logach. Jeśli widzisz powtarzający się błąd związany z wyświetlaniem reklam, który nie jest udokumentowany, udostępnij zrzut stosu Google Mobile Ads SDKzespołowi pomocy. Dodano addCustomTargeting() metody do AdRequest.
23.3.0	2024‑08‑12	Zaktualizowano zależność pakietu SDK platformy do personalizowania wiadomości wyświetlanych użytkownikom do wersji 3.0.0.
23.2.0	27 czerwca 2024 r.	Dodano AdView.isCollapsible() , aby wskazać, czy ostatni wczytany baner jest zwijany.
23.1.0	2024‑05‑09	Wymaga co najmniej compileSdkVersion 34. Adaptery do zapośredniczenia reklam natywnych: wycofane loadNativeAd i loadRtbNativeAd() na rzecz loadNativeAdMapper() i loadRtbNativeAdMapper(). Adaptery powinny przejść na te nowe metody wczytywania i powiązane z nimi obiekty.
23.0.0	2024‑03‑07	Zmiany powodujące niezgodność: Zwiększyliśmy minimalny poziom interfejsu Android API do 21. Aby nadal zbierać dane o użytkownikach w AdMob, połącz aplikację w AdMob z Firebase i zintegruj z nią pakiet SDK Google Analytics dla Firebase. Usunęliśmy wycofany interfejs API MobileAds.enableSameAppKey() i zaktualizowaliśmy alternatywną metodę MobileAds.putPublisherFirstPartyIdEnabled(), aby zwracała wartość logiczną określającą, czy utrwalanie ustawień kontroli zakończyło się powodzeniem. Native Ads: Użytkownik AdLoader.forUnifiedNativeAd() został usunięty. Zamiast niej używaj zasady AdLoader.forNativeAd(). Użytkownik AdLoader.forCustomTemplateAd() został usunięty. Zamiast niej używaj zasady AdLoader.forCustomFormatAd(). Usunięto element AdFormat.UNKNOWN bez zastąpienia. Aplikacje korzystające z QueryInfo.generate() muszą przekazywać format reklamy. Metody AdManagerAdRequest.Builder odziedziczone po elemencie nadrzędnym można teraz łączyć w łańcuchy, aby utworzyć obiekt za pomocą jednego wywołania. Wymagało to zmiany struktury dziedziczenia, tak aby AdManagerAdRequest.Builder nie dziedziczył już po AdRequest.Builder. Dodaje wywołanie funkcji MobileAds.registerCustomTabsSession(), aby zwiększyć zarabianie na reklamach na kartach niestandardowych. Więcej informacji znajdziesz w artykule Optymalizacja kart niestandardowych. Zaktualizowano zależność pakietu SDK platformy do personalizowania wiadomości wyświetlanych użytkownikom do wersji 2.2.0.
22.6.0	2023‑12‑06	Wycofano metodę MobileAds.setSameAppKeyEnabled() i zmieniono jej nazwę na MobileAds.putPublisherFirstPartyIdEnabled(). Wycofana AdFormat.UNKNOWN bez zamiennika. Aplikacje korzystające z QueryInfo.generate() muszą przekazywać format reklamy.
22.5.0	2023‑10‑30	Zaktualizowano zależność pakietu SDK platformy do personalizowania wiadomości wyświetlanych użytkownikom do wersji 2.1.0. Dodano metodę setPublisherPrivacyPersonalizationState() do interfejsu Publisher Privacy Treatment API (wersja beta).
22.4.0	2023‑09‑13	Wymaga co najmniej compileSdkVersion 33. Inspektor reklam: dodano obsługę pakietu SDK w zakresie wysyłania żądań reklam i wyświetlania reklam wysyłanych za pomocą interfejsu inspektora reklam. Dodano nową metodę QueryInfo.generate(), która przyjmuje identyfikator jednostki reklamowej. Umożliwia wstępne testowanie chroniących prywatność interfejsów API w wersji beta: Attribution Reporting Beta i Topics Beta. Więcej informacji znajdziesz w przewodniku Ad Managera na temat Piaskownicy prywatności na Androidzie.
22.3.0	22 sierpnia 2023 r.	Dodaliśmy obsługę tworzenia rozmiarów adaptacyjnych z użyciem AdSize.FULL_WIDTH jako szerokości. Wcześniej rozmiary reklam utworzone za pomocą AdSize.FULL_WIDTH były traktowane jako AdSize.SMART_BANNER.
22.2.0	2023‑07‑05	Zdarzenia niestandardowe: Wycofany:AdRequest.Builder.addCustomEventExtrasBundle() Rozszerz klasę Adapter i wchodź w interakcje z dodatkowymi parametrami za pomocą klasy AdRequest.Builder.addNetworkExtrasBundle(). Wycofano AdRequest.getCustomEventExtrasBundle(). Rozszerz klasę Adapter i wchodź w interakcje z dodatkowymi parametrami za pomocą klasy AdRequest.getNetworkExtrasBundle().
22.1.0	2023‑05‑18	Inspektor reklam: włączono możliwość wywoływania żądań reklam z interfejsu inspektora reklam na urządzeniach, które nie mają Usług Google Play.
22.0.0	29 marca 2023 r.	Zmiany powodujące niezgodność: Usunięto NativeCustomFormatAd.getVideoController() i NativeCustomFormatAd.getVideoMediaView() na rzecz NativeCustomFormatAd.getMediaContent(). Usunięto MobileAds.getVersionString() na rzecz MobileAds.getVersion(). Usunięto AdRequest.Builder.setAdInfo() na rzecz AdRequest.Builder.setAdString(). AdManager.Builder.setAdString() zwraca teraz typ AdRequest.Builder. Usunięto interfejs MediationRewardedVideoAdAdapter i powiązane z nim interfejsy API na rzecz interfejsu Adapter. Dodano: AdRequest.getRequestAgent(). Mediacja: wartość zwracana w przypadku Adapter.getVersionInfo() i Adapter.getSDKVersionInfo() zmieniła się z typu com.google.android.gms.ads.mediation.VersionInfo na com.google.android.gms.ads.VersionInfo. Zalecamy, aby adaptery zwracały nowy typ, ponieważ com.google.android.gms.ads.mediation.VersionInfo jest wycofany.
21.5.0	2023‑01‑31	Reklamy otwierające aplikację: wycofaliśmy metody AppOpenAd.load() akceptujące parametr wejściowy orientacji i dodaliśmy nowe metody, które nie przyjmują parametru wejściowego orientacji. Nowe metody określają orientację w momencie wysłania żądania, co jest zgodne z zachowaniem innych formatów pełnoekranowych. Zapośredniczenie: dodaliśmy obsługę zapośredniczenia w przypadku reklam wyświetlanych przy otwarciu aplikacji. Usunięto uprawnienie RECEIVE_BOOT_COMPLETED z zależności androidx.work:work-runtime. Jeśli używasz Gradle w wersji starszej niż 7.2.0 i wymagasz uprawnień dla aplikacji, może być konieczne wyraźne zadeklarowanie uprawnień w pliku manifestu Androida.
21.4.0	14 grudnia 2022 r.	Identyfikator aplikacji w usłudze Ad Manager jest teraz wymagany w przypadku wszystkich aplikacji w usłudze Ad Manager i musi mieć format ca-app-pub-################~##########. Więcej informacji znajdziesz w artykule Konfigurowanie aplikacji. Inspektor reklam: rozszerzyliśmy obsługę pakietu SDK o wyświetlanie banerów reklamowych i reklam natywnych wywoływanych w interfejsie inspektora reklam. Dodaliśmy obsługę własnego identyfikatora wydawcy (dawniej Same App Key), aby pomagać Ci wyświetlać trafniejsze i bardziej spersonalizowane reklamy na podstawie danych zbieranych w Twoich aplikacjach. Oficjalna wersja do publikacji dla generacji QueryInfo.
21.3.0	2022‑10‑10	Inspektor reklam: dodaliśmy obsługę pakietu SDK w zakresie wysyłania żądań reklam i ich wyświetlania za pomocą interfejsu inspektora reklam. Reklamy natywne: Dodano getMediaContent() do MediaView. Niestandardowe reklamy natywne: Dodano getMediaContent() do NativeCustomFormatAd. Wycofano getVideoMediaView(). Utwórz własną zasadę MediaView i zamiast niej użyj zasady NativeCustomFormatAd.getMediaContent(). Wycofano getVideoController(). Użyj w zamian zasady NativeCustomFormatAd.getMediaContent().getVideoController().
21.2.0	2022‑09‑06	Inspektor reklam: dodaliśmy obsługę pakietu SDK do eksportowania dzienników żądań reklam za pomocą arkusza udostępniania w Androidzie.
21.1.0	2022‑07‑14	Dodaliśmy obsługę zarabiania na reklamach w WebView. Więcej informacji znajdziesz w artykule Integrowanie interfejsu WebView API for Ads. Dodano getResponseExtras() do ResponseInfo co może zwracać dodatkowe informacje o odpowiedzi na żądanie reklamy.
21.0.0	2022‑05‑25	Zmiany powodujące niezgodność: Google Mobile Ads SDK wymaga teraz, aby wszystkie aplikacje działały na minimalnym poziomie API Androida 19. Dodaliśmy adnotacje @NonNull do każdej metody, która wcześniej nie definiowała w sposób jednoznaczny dopuszczalności wartości null. Usunęliśmy metodę AdRequest.Builder.addNetworkExtras(). Zamiast niej użyj zasady AdRequest.Builder.addNetworkExtrasBundle(). Usunięto te metody określania lokalizacji: setLocation() na AdRequest.Builder getLocation() w: AdRequest getLocation() na MediationAdConfiguration Dodano flagi pliku manifestu, aby zoptymalizować inicjowanie i wczytywanie reklam. Więcej informacji znajdziesz w przewodniku po optymalizacji inicjowania i wczytywania reklam. Wycofano MobileAds.getVersionString(). Zamiast niej używaj zasady MobileAds.getVersion(). Dodaliśmy metodę getLoadedAdapterResponseInfo() w ResponseInfo. Dodaliśmy te metody w  AdapterResponseInfo: getAdSourceName() getAdSourceId() getAdSourceInstanceName() getAdSourceInstanceId() Dodano obsługę zdarzeń niestandardowych w inspektorze reklam.
20.6.0	2022‑02‑22	Wycofaliśmy wszystkie interfejsy zdarzeń niestandardowych. Zamiast niej użyj klasy Adapter i interfejsu MediationAdLoadCallback. Dodaliśmy obsługę SharedPreferences gad_has_consent_for_cookies. Google Mobile Ads SDK włączy ograniczone wyświetlanie reklam (LTD) , gdy gad_has_consent_for_cookies ma wartość 0. Więcej informacji znajdziesz w artykule ustawianie zgody na stosowanie plików cookie. Google Mobile Ads SDK wyłączy przekazywanie identyfikatora wyświetlania reklam na urządzeniach z Androidem (AAID), gdy funkcja RequestConfiguration.Builder.setTagForChildDirectedTreatment() zostanie wywołana z parametrem TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE (patrz ustawienie dotyczące treści skierowanych do dzieci) lub gdy funkcja RequestConfiguration.Builder.setTagForUnderAgeOfConsent() zostanie wywołana z parametrem TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE (patrz ustawienie dotyczące użytkowników, którzy nie osiągnęli wieku świadomego wyrażenia zgody).
20.5.0	2021‑11‑18	Dodano obsługę urządzeń z Androidem 12 w przypadku aplikacji kierowanych na API 31. Dodaliśmy obsługę identyfikatora zestawu aplikacji w przypadkach użycia takich jak raportowanie i zapobieganie oszustwom.
20.4.0	2021‑09‑22	Od wersji 20.4.0 pakiet Google Mobile Ads SDK zawiera uprawnienie com.google.android.gms.permission.AD_ID w pliku manifestu pakietu SDK, który jest automatycznie łączony z plikiem manifestu aplikacji przez narzędzia Android Build Tools. Więcej informacji o AD_IDdeklarowaniu uprawnień, w tym o tym, jak je wyłączyć, znajdziesz w  tym artykule w Centrum pomocy Konsoli Play. Dodano wywołanie zwrotne onAdClicked() do FullScreenContentCallback. Włączono wywołanie zwrotne w  onAdClicked() klasie AdListener w przypadku formatu reklam natywnych.
20.3.0	2021‑08‑23	Wycofaliśmy metodę AdRequest.Builder.addNetworkExtras() . Użyj w zamian: AdRequest.Builder.addNetworkExtrasBundle() . Reklamy natywne: AdLoader.Builder.forCustomFormatAd() akceptuje teraz wartość null OnCustomClickListener. Adaptery zapośredniczenia: poprawiono adnotację o dopuszczalności wartości null dla parametru mediationExtras we wszystkich wywołaniach funkcji load adaptera zapośredniczenia.
20.2.0	2021‑06‑08	Dodaliśmy obsługę inspektora reklam (w wersji beta) dla wydawców korzystających z Google Ad Managera.
20.1.0	2021‑04‑29	Baner adaptacyjny: dodano AdSize.getInlineAdaptiveBannerAdSize() do żądania śródtekstowych banerów adaptacyjnych o maksymalnej wysokości. Dodano AdError.toString(), aby ułatwić logowanie.
20.0.0	2021‑04‑05	Zmiany powodujące niezgodność: Usunięto starszy interfejs API Interstitial. Usunięto starszy interfejs API RewardedVideoAd. Usunięto zajęcia z prefiksem Publisher (np. PublisherAdView). Użytkownik CustomRenderedAd został usunięty. Użytkownik InstreamAd został usunięty. Użytkownik SearchAdRequest został usunięty. Użytkownik AdListener.onAdLeftApplication() został usunięty. Usunięto: NativeAppInstallAd, NativeContentAd i UnifiedNativeAd. Obecnie jest 1 format reklamy natywnej o nazwie NativeAd. RewardedAd jest teraz klasą abstrakcyjną. Aby wczytać reklamę z nagrodą, użyj metody statycznej RewardedAd.load(). Wycofane AdSize.SMART_BANNER na rzecz adaptacyjnych banerów reklamowych. Dodano jawne adnotacje o dopuszczalności wartości null we wszystkich publicznych interfejsach API.
19.8.0	2021‑03‑15	Dodano zależność od pakietu SDK platformy do personalizowania wiadomości wyświetlanych użytkownikom. Dodano wywołanie zwrotne onAdImpression() do funkcji FullScreenContentCallback. Wycofaliśmy format InstreamAd. Adaptery zapośredniczenia: Wycofano atrybuty MediationBannerAdapter, MediationInterstitialAdapter i MediationNativeAdapter. Nowe adaptery powinny implementować klasę Adapter, aby wczytywać te formaty. Adaptery ustalania stawek mogą teraz implementować różne metody wczytywania w klasie Adapter w przypadku formatów RTB.
19.7.0	2021‑01‑20	Najważniejsze zmiany w: InterstitialAd RewardedAd NativeAd AppOpenAd Wycofano CustomRenderedAd. Klasy i pakiety z prefiksem Publisher zostały wycofane i zastąpione prefiksem AdManager. Ostatnia wersja podrzędna przed wersją 20.0.0. Wszystkie interfejsy API oznaczone jako wycofane w tej i poprzednich wersjach zostaną usunięte w wersji 20.0.0. Więcej informacji znajdziesz w przewodniku po migracji do wersji 20.0.0.
19.6.0	2020‑12‑04	Metoda onAdLeftApplication() AdListener została oznaczona jako przestarzała. Rozwiązaliśmy problem, który powodował, że użytkownicy urządzeń z Androidem 11 byli proszeni o wybranie przeglądarki po kliknięciu reklamy.
19.5.0	2020‑10‑20	Banery reklamowe: w przypadku banerów reklamowych wywoływana jest teraz metoda onAdImpression() AdListener. Dodano metodę setHttpTimeoutMillis() , która umożliwia dostosowanie limitu czasu połączeń HTTPS wykonywanych przez pakiet SDK do reklam mobilnych Google. Dodano: setNeighboringContentUrls() i getNeighboringContentUrls() do PublisherAdRequest.
19.4.0	2020‑09‑10	Dodano obsługę urządzeń z Androidem 11 w przypadku aplikacji kierowanych na interfejs API 30. Reklamy wyświetlane przy otwarciu aplikacji: zmieniliśmy format AppOpenAd, aby działał bardziej jak format pełnoekranowy niż widok banera. Dodano metody getResponseInfo() i show() do klasy AppOpenAd. Wycofane klasy AppOpenAdView i AppOpenAdPresentationCallback. Zapośredniczenie: udostępniamy raportowanie stanu zapośredniczenia. Użyj ResponseInfo.getAdapterResponses() , aby uzyskać informacje o odpowiedziach każdej sieci reklamowej, która brała udział w żądaniu reklamy. Starsze reklamy z nagrodą: wycofane RewardedVideoAd. Dodaliśmy format RewardedInterstitialAd w ramach prywatnych testów beta. Usunęliśmy błąd polegający na tym, że funkcja MobileAds.initialize() wywołuje moduł obsługi zakończenia tylko raz. Każde wywołanie funkcji MobileAds.initialize() powoduje teraz wywołanie zwrotne po zakończeniu.
19.3.0	2020‑07‑20	Dodano metody getDomain() i getCause() do AdError. Dodaliśmy nowe wywołania zwrotne błędu wczytywania do wszystkich formatów reklam, które zwracają wartość LoadAdError. Np. onAdFailedToLoad(LoadAdError). Wywołania zwrotne błędu wczytywania, które zwracają liczbę całkowitą, zostały wycofane. Przykład: onAdFailedToLoad(int). Reklamy z nagrodą: dodano onRewardedAdFailedToShow(AdError) i wycofano onRewardedAdFailedToShow(int). Zapośredniczenie reklam z nagrodą: dodano kod błędu MEDIATION_SHOW_ERROR. Wszystkie błędy prezentacji związane z reklamami wyświetlanymi przez sieć zapośredniczającą zwracają teraz wartość MEDIATION_SHOW_ERROR w przypadku AdError.getCode() i wartość NonNull AdError.getCause() reprezentującą podstawowy błąd zapośredniczenia.
19.2.0	2020‑06‑18	Reklamy natywne: dodaliśmy interfejs walidatora reklam natywnych w żądaniach testowych, aby ułatwić wykrywanie i naprawianie naruszeń zasad dotyczących reklam natywnych. Dodaliśmy metodę MobileAds.disableMediationAdapterInitialization(). Wywołaj tę metodę przed zainicjowaniem Google Mobile Ads SDK, aby wyłączyć inicjowanie adaptera do zapośredniczenia.
19.1.0	2020‑04‑16	Wycofano MobileAds.initialize(Context, String) na rzecz MobileAds.initialize(Context, OnInitializationCompleteListener). AdRequest.isTestDevice() zwraca teraz wartość true w przypadku urządzeń testowych skonfigurowanych za pomocą MobileAds.setRequestConfiguration(). Naprawiliśmy błąd NullPointerException w MobileAds.initialize(), który występował na niektórych urządzeniach w aplikacjach korzystających z pakietu SDK w wersji Lite.
19.0.1	2020‑03‑18	Reklamy natywne: naprawiono wyciek pamięci, który występował podczas korzystania z funkcji NativeCustomTemplateAd.
19.0.0	2020‑03‑02	Dodano obsługę odczytywania parametrów zgody z zasad TCF IAB w wersji 2.0 i ciągu tekstowego IAB us_privacy. Dodano użytkowników setNeighboringContentUrls() i getNeighboringContentUrls() do listy AdRequest. Dodano klasę ResponseInfo, która zawiera informacje o wczytanej reklamie. W przypadku wszystkich formatów reklam wycofaliśmy getMediationAdapterClassName() na rzecz getResponseInfo(). Reklamy natywne: dodano metody getDuration() i getCurrentTime() do klasy MediaContent. Native Mediation: dodano metody getDuration() i getCurrentTime() do UnifiedNativeAdMapper, aby adaptery mogły je wdrażać. Wycofano: AdRequest.Builder.addTestDevice(). Użyj w zamian kodu RequestConfiguration.Builder.setTestDeviceIds().
18.3.0	2019‑11‑05	Dodano interfejsy API dla formatu reklamy InstreamAd. Ta funkcja jest dostępna w ramach prywatnych testów beta. Aby uzyskać dostęp, skontaktuj się z menedżerem konta. Baner adaptacyjny: zmieniliśmy metody tworzenia banerów adaptacyjnych w klasie AdSize. Na przykład zmieniono nazwę AdSize.getCurrentOrientationBannerAdSizeWithWidth() na AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(). Zapośredniczenie: Google Mobile Ads SDK teraz wychwytuje wyjątki zgłaszane przez adaptery zapośredniczenia. Mediacja reklam z nagrodą: naprawiono błąd, który powodował, że jeśli w pamięci podręcznej było zapisanych kilka reklam z nagrodą wyświetlanych w ramach mediacji, wyświetlała się tylko jedna z nich. Dodaliśmy metodę setTestDeviceIds(), która umożliwia jednorazowe ustawienie urządzeń testowych dla wszystkich żądań reklamy.
18.2.0	2019‑08‑29	Dodano interfejsy API dla formatu AppOpenAd. Ta funkcja jest dostępna w ramach prywatnych testów beta. Aby uzyskać dostęp, skontaktuj się z menedżerem konta.
18.1.1	2019‑07‑23	Zapośredniczenie: adaptery są teraz inicjowane, gdy aplikacje wywołują MobileAds.initialize(Context, OnInitializationCompleteListener). Mediacja: wyjątki adaptera, których zrzuty stosu zawierają Google Mobile Ads SDK, są teraz przechwytywane i obsługiwane przez Google Mobile Ads SDK.
18.1.0	2019‑07‑09	Oficjalna wersja obsługi pomiarów w aplikacjach. Dodaliśmy nową metodę inicjowania: MobileAds.initialize(Context, OnInitializationCompleteListener), która powiadamia Cię, gdy Google Mobile Ads SDK i wszystkie skonfigurowane adaptery zapośredniczenia zakończą inicjowanie. Dodano MobileAds.getInitializationStatus() , aby podawać stan inicjowania wszystkich sieci reklamowych skonfigurowanych w aplikacji. Dodano MobileAds.getRequestConfiguration(). Parametry kierowania ustawione w tym obiekcie konfiguracji są używane we wszystkich żądaniach reklamy. Reklamy natywne: dodano metodę NativeAdOptions.Builder.setMediaAspectRatio(), która umożliwia żądanie określonego współczynnika proporcji komponentu multimedialnego reklamy natywnej. Ta opcja ma pierwszeństwo przed wycofaną już metodą setImageOrientation(). Reklamy natywne: w przypadku reklam innych niż wideo typ skalowania obrazu w obiekcie MediaView można teraz ustawić za pomocą kodu MediaView.setImageScaleType(). Reklamy natywne: dodano UnifiedNativeAd.getMediaContent(). Wydawcy, którzy wczytują obrazy tylko za pomocą adresów URL, mogą teraz pobierać treści multimedialne reklamy, dostarczać do niej obraz i wywoływać funkcję MediaView.setMediaContent(), aby wypełniać dane obrazu za pomocą funkcji MediaView w przypadku reklam innych niż wideo. Reklamy natywne: dodano interfejsy API, aby włączyć obsługę otwartego pomiaru w przypadku niestandardowych formatów reklam natywnych innych niż wideo. Zapośredniczenie reklam natywnych: adaptery mogą teraz podawać współczynnik proporcji za pomocą kodu UnifiedNativeAdMapper.setMediaContentAspectRatio(). Usunięto klasę Correlator i powiązane z nią interfejsy API. Ta funkcja była wcześniej niedostępna. Dodano zależności od play-services-measurement i play-services-measurement-sdk. Aplikacje nie muszą już wyraźnie dodawać tych zależności.
18.0.0	2019‑06‑17	Migracja z bibliotek pomocy Androida do bibliotek Jetpack (AndroidX). Więcej informacji znajdziesz w  informacjach o wersji usług Google Play. Aby uniknąć awarii, która występuje przy pierwszym uruchomieniu po zainstalowaniu aplikacji ze Sklepu Play, ta wersja wymaga od wydawców zadeklarowania dodatkowych zależności w pliku 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	Rozwiązanie problemu z błędem ANR pochodzącym z android.media.AudioManager.getStreamVolume.
17.2.0	2019‑03‑11	Reklamy wideo z nagrodą: dodaliśmy nowy zestaw interfejsów API reklam z nagrodą (patrz pakiet rewarded), który umożliwia jednoczesne wczytywanie wielu reklam z nagrodą. Zapośredniczenie: dodaliśmy nowy zestaw interfejsów API adaptera zapośredniczenia, które obsługują inicjowanie. Adaptery implementujące nowy interfejs API implementują klasę Adapter. Wydawcy korzystający z firebase-analytics w połączeniu z wersją 17.2.0 dowolnej biblioteki reklam (np. com.google.android.gms:play-services-ads:17.2.0) muszą używać com.google.firebase:firebase-analytics:16.3.0.
17.1.3	2019‑01‑31	Wydawcy korzystający z firebase-analytics w połączeniu z wersją 17.1.3 dowolnej biblioteki reklam (np. com.google.android.gms:play-services-ads:17.1.3) muszą używać com.google.firebase:firebase-analytics:16.3.0.
17.1.2	2018‑12‑03	Wydawcy korzystający z firebase-analytics w połączeniu z wersją 17.1.2 dowolnej biblioteki reklam (np. com.google.android.gms:play-services-ads:17.1.2) muszą używać com.google.firebase:firebase-analytics:16.0.6.
17.1.1	2018‑11‑12	Usunęliśmy błąd, który powodował, że niektóre kombinacje play-services-ads i firebase-analytics (np. ads:17.1.0 i analytics:16.0.5) powodowały błąd kompilatora duplicate entry. Wydawcy korzystający z firebase-analytics w połączeniu z wersją 17.1.1 dowolnej biblioteki reklam (np. com.google.android.gms:play-services-ads:17.1.1) muszą używać com.google.firebase:firebase-analytics:16.0.5.
17.1.0	2018‑11‑02	Dodaliśmy metody setMaxAdContentRating() i setTagForUnderAgeOfConsent() do klasy AdRequest.Builder. Dodaliśmy te stałe do użycia z funkcjami AdRequest.Builder.setMaxAdContentRating() i 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	Wydawcy korzystający z Google Ad Managera muszą w pliku AndroidManifest.xml określić tag <meta-data> z kluczem com.google.android.gms.ads.AD_MANAGER_APP. Więcej informacji znajdziesz w przewodniku dla początkujących. Reklamy natywne: NativeAppInstallAd, NativeContentAd i powiązane interfejsy API zostały wycofane na rzecz UnifiedNativeAd. Więcej informacji o korzystaniu z nowych interfejsów API znajdziesz w sekcji Zaawansowane ujednolicone reklamy natywne. Reklamy natywne: dodaliśmy funkcję „Wyłącz tę reklamę”. Reklamy natywne: Usunięto nieszkodliwy dziennik ostrzeżeń: „UnconfirmedClickListener must not be null while ClickConfirmingView is set.” Reklamy z nagrodą: dodaliśmy metodę setAdMetadataListener w RewardedVideoAd, aby nasłuchiwać zmian metadanych reklamy. Reklamy z nagrodą: wywołanie destroy() spowoduje wyzerowanie detektora. Wycofano te metody w przypadku AdRequest.Builder. setGender() setBirthday() setIsDesignedForFamiles() Usunęliśmy błąd, który powodował, że onRewardedVideoCompleted() nie uruchamiało się na emulatorach.
16.0.0	2018‑10‑02	Bez zmian w reklamach. Więcej informacji znajdziesz w informacjach o wersji Usług Google Play.
15.0.0	2018‑04‑12	wersja beta MRAID 3, Reklamy natywne: dodano interfejs Unified Native Ad API. Łączy on typy NativeAppInstallAds i NativeContentAds w jeden nowy typ: UnifiedNativeAd. Uwaga: podczas korzystania z reklam natywnych w dziennikach pojawia się nieszkodliwe ostrzeżenie, gdy klikniesz reklamę natywną: „UnconfirmedClickListener must not be null while ClickConfirmingView is set.” Możesz zignorować to ostrzeżenie. Zostanie ono usunięte w kolejnej wersji.
12.0.1	2018‑03‑28	Bez zmian w reklamach. Więcej informacji znajdziesz w informacjach o wersji Usług Google Play.
12.0.0	2018‑03‑20	Reklamy wideo z nagrodą: dodaliśmy metodę wywołania zwrotnego onRewardedVideoCompleted() do RewardedVideoAdListener. Mediacja natywna: dodaliśmy metodę trackViews() do NativeAdMapper, dzięki czemu adaptery mają dostęp do obiektów View odpowiadających poszczególnym komponentom reklamy natywnej. Wycofano trackView() na rzecz trackViews().
11.8.0	2017‑12‑18	Poprawki błędów i ogólne ulepszenia.
11.6.0	2017‑11‑07	Dodaliśmy klasę NativeAdViewHolder i powiązane z nią metody w NativeAppInstallAd i NativeContentAd. Wycofane AdLoader.getMediationAdapterClassName (wydawcy powinni zamiast tego używać metod o tej samej nazwie w NativeAppInstallAd i NativeContentAd). Reklamy testowe wyświetlają teraz etykietę u góry reklamy. Więcej informacji znajdziesz w przewodniku po testowaniu.
11.4.0	2017‑09‑19	Dodano metody getMediationAdapterClassName() do klas NativeAppInstallAd i NativeContentAd. Metoda o tej samej nazwie w AdLoader zostanie wycofana. Dodano metodę onVideoEnd() do klasy MediationNativeListener, metody hasVideoContent(), setHasVideoContent() i setMediaView() do klasy NativeAdMapper oraz metody getAdVolume() i isAdMuted() do klasy NativeMediationAdRequest, aby obsługiwać zapośredniczenie natywnych kreacji wideo. Usunięto zajęcia SearchAdRequest.
11.2.2	2017‑09‑05	Dodaliśmy nową metodę loadAd(), która przyjmuje obiekt PublisherAdRequest do klasy RewardedVideoAd.
11.2.0	2017‑08‑14	Dodaliśmy metodę loadAds() do klasy AdLoader, która umożliwia aplikacjom wczytywanie wielu unikalnych reklam w ramach jednego żądania. Jeśli zaktualizujesz aplikację do wersji 11.2.0 lub nowszej pakietu SDK do reklam mobilnych Google, musisz też zaktualizować build.gradle aplikacji, aby określać compileSdkVersion o wartości co najmniej 26 (Android O). Nie zmienia to sposobu działania aplikacji. Nie musisz aktualizować aplikacji targetSdkVersion. Od wersji 11.2.0 Google Mobile Ads SDK jest dostępny w repozytorium Maven Google. Więcej informacji znajdziesz w informacjach o wersji Usług Google Play.
11.0.0	2017‑06‑07	Dodano metody onAdClicked() i onAdImpression() do klasy AdListener. Te metody są wywoływane tylko w przypadku kreacji natywnych promujących instalację aplikacji i reklam natywnych z treścią. Usunęliśmy metody getInAppPurchaseListener() i setInAppPurchaseListener() z klas AdView, InterstitialAd i NativeExpressAdView. Usunęliśmy też powiązane klasy zakupów w aplikacji. Dodano metody OnVideoMute(), OnVideoPause(), OnVideoPlay() i OnVideoStart() do klasy VideoController.VideoLifecycleCallbacks. Dodaliśmy możliwość włączania trybu immersyjnego w reklamach pełnoekranowych przez dodanie metody setImmersiveMode() do klas PublisherInterstitialAd i RewardedVideoAd. Dodano interfejs OnPublisherAdViewLoadedListener, klasę PublisherAdViewOptions i klasę PublisherAdViewOptions.Builder do użycia z AdLoader w przypadku żądań reklam natywnych z banerem. Dodaliśmy opcjonalny interfejs OnImmersiveModeUpdatedListener, który adaptery zapośredniczenia mogą implementować, aby otrzymywać informacje o aktualizacjach trybu immersyjnego. Dodaliśmy do klasy RewardedVideoAd metodę getMediationAdapterClassName(). Dodano keep reguły, które automatycznie zachowują nazwy klas adaptera zapośredniczenia podczas korzystania z ProGuard.
10.2.0	2017‑2‑15	Usługi Google Play w wersji 10.2.x to pierwsza wersja, która nie obejmuje już pełnej obsługi Androida w wersji 2.3.x (Gingerbread). Aplikacje opracowane przy użyciu pakietu SDK w wersji 10.2.x lub nowszej wymagają minimalnego poziomu interfejsu Android API 14 i nie można ich zainstalować na urządzeniach z poziomem interfejsu API niższym niż 14. Więcej informacji o dostępnych opcjach, w tym o tworzeniu wielu plików APK w celu rozszerzenia obsługi Androida Gingerbread, znajdziesz na blogu dla programistów aplikacji na Androida. Dodaliśmy obsługę zasobów wideo w przypadku zaawansowanych reklam natywnych z treścią i reklam z szablonem niestandardowym. Dodano metody getVideoController(), setVideoOptions() i getVideoOptions() do klasy PublisherAdView. Dodano klasę AdChoicesView. Dodano metody getAdChoicesContent() i setAdChoicesContent() do klasy NativeAdMapper. Dodano interfejs InitializableMediationRewardedVideoAdAdapter dla adapterów do mediacji reklam wideo z nagrodą, które chcą wcześniej zainicjować się przed wysłaniem żądania reklamy. Dodaliśmy obsługę podglądu w aplikacji i rozwiązywania problemów w usłudze Google Ad Manager.
10.0.1	2016‑11‑21	Poprawki błędów i ogólne ulepszenia.
9.8.0	2016‑10‑24	MobileAds.Initialize(Context) nie jest już wycofane. Wydawcy korzystający z Google Ad Managera powinni wywoływać tę metodę podczas inicjowania aplikacji. Wydawcy korzystający z AdMob powinni nadal używać parametru MobileAds.Initialize(Context, String) i przekazywać kod aplikacji.
9.6.0	2016‑09‑22	Dodano klasę MediaView na potrzeby reklam wideo w ramach zaawansowanych reklam natywnych. Dodano metodę openDebugMenu() do klasy MobileAds na potrzeby podglądu kreacji i rozwiązywania problemów z jednostkami reklamowymi Ad Managera. Dodaliśmy obsługę zdarzeń niestandardowych w przypadku reklam wideo z nagrodą.
9.4.0	2016‑08‑01	Poprawki błędów i ogólne ulepszenia.
9.2.0	2016‑06‑27	Dodaliśmy do klasy NativeAdOptions.Builder metodę setAdChoicesPlacement(), której wydawcy aplikacji mogą teraz używać do określania lokalizacji elementu AdChoices w reklamach natywnych. Poprawiliśmy odtwarzanie reklam wideo, wprowadzając kilka poprawek błędów.
9.0.1	2016‑05‑26	Rozwiązuje problem z ProGuardem wprowadzony w wersji 9.0.0. Wydawcy nie potrzebują już opcji keep w przypadku com.google.android.gms.common.util.DynamiteApi.
9.0.0	2016‑05‑18	Dodano automatyczne wypełnianie informacji o lokalizacji w przypadku aplikacji, które wyraźnie przyznają dostęp do lokalizacji. Dodaliśmy obsługę zdarzeń niestandardowych zapośredniczenia reklam wideo z nagrodą. Dodano opcje wideo w przypadku reklam natywnych Express. Zaktualizowano interfejs API reklam w wyszukiwarce niestandardowej. Dodaliśmy metodę setAppMuted(). Metoda MobileAds.initialize(android.content.Context, java.lang.String) nie jest już wycofana. Metoda MobileAds.initialize(android.content.Context) została wycofana. Dodaliśmy metodę MediationNativeListener.onAdImpression() do raportowania wyświetleń w adapterach zapośredniczenia. Tylko w przypadku tej wersji aplikacje, które używają ProGuard do przetwarzania końcowego, muszą dodać do pliku konfiguracyjnego ProGuard tę opcję:keep-keep public @com.google.android.gms.common.util.DynamiteApi class * { *; }
8.4.0	2015‑12‑18	Dodano metodę publiczną MobileAds.setAppVolume(), aby informować Google Mobile Ads SDK o bieżącym poziomie głośności aplikacji. Wprowadziliśmy poprawki błędów i ulepszenia.
8.3.0	2015‑11‑6	Dodaliśmy obsługę reklam wideo z nagrodą. Dodano metodę isLoading() do PublisherAdView i PublisherInterstitialAd, aby sprawdzić, czy żądanie reklamy jest w trakcie realizacji. Dodaliśmy metodę setIsDesignedForFamilies() do AdRequest.Builder i PublisherAdRequest.Builder. Dodaliśmy metodę destroy() do NativeAdView.
8.1.0	2015‑09‑24	Naprawiono różne błędy.
7.8.0	2015‑08‑13	Oficjalna wersja do publikacji MRAID v2. Dodano metodę isLoading() do klas AdLoader, AdView i InterstitialAd, aby sprawdzać, czy żądanie reklamy jest w toku. Wycofano PublisherAdRequest.Builder#setManualImpressionsEnabled(). Użyj w zamian zasady PublisherAdView#setManualImpressionsEnabled().
7.5.0	2015‑05‑28	Dodaliśmy obsługę formatów reklam natywnych promujących instalacje aplikacji i reklam natywnych z treścią w AdMob i Ad Managerze. Dodaliśmy obsługę niestandardowych formatów reklam natywnych, które są dostępne w przypadku rezerwacji w Ad Managerze.
7.3.0	2015‑04‑28	Naprawiono różne błędy.
7.0.0	2015‑03‑19	Dodano metody addCustomTargeting() i addCategoryExclusion() do klasy PublisherAdRequest.Builder. Rozwiązaliśmy problem, który powodował PublisherAdView.recordManualImpression() rejestrowanie wielu wyświetleń w usłudze Ad Manager podczas korzystania z ręcznego zliczania wyświetleń. Rozwiązaliśmy problem, który powodował nieprawidłowe renderowanie reklam podczas używania atrybutu android:largestWidthLimitDp w tagu <supports-screens>. Dodaliśmy metodę setRequestAgent() do klas AdRequest.Builder i PublisherAdRequest.Builder. Ta metoda powinna być używana do oznaczania pochodzenia żądań reklam przez podmioty zewnętrzne, które zapośredniczają w Google Mobile Ads SDK.
6.5.87	2014‑12‑08	Wprowadzono architekturę podzielonych plików JAR – deweloperzy Androida Studio mogą teraz uwzględniać tylko część usług Google Play związaną z reklamami, korzystając z com.google.android.gms:play‑services‑ads:6.+. Uwaga: aplikacje, które tworzą reklamy banerowe w formacie XML, muszą nadal odwoływać się do całej biblioteki com.google.android.gms:play‑services:6.+. Naprawiono różne błędy.
6.1	2014‑10‑08	Dodaliśmy metodę getLocation() do klasy com.google.android.gms.ads.MediationAdRequest. Dodano opis treści do przycisku zamykania reklamy pełnoekranowej, aby zwiększyć dostępność. Usunięto rejestrowanie komunikatu „Nie znaleziono zasobów Google Play”, gdy projekt biblioteki jest prawidłowo połączony. Dodano getMediationAdapterClassName() do AdView aby uzyskać nazwę klasy adaptera zapośredniczenia sieci reklamowych wyświetlającego reklamę.
17.0.0	2018‑10‑05	Dodaliśmy nowe interfejsy API do wdrażania zdarzeń niestandardowych. Dodano domyślny proces zakupu w aplikacji z użyciem interfejsu Google Play Billing API.
4.4	2014‑05‑07	Dodano nowe interfejsy API adaptera do zapośredniczenia. Dodano nowy format reklamy 320x100 LARGE_BANNER na telefony i tablety. Dodano nowy format pełnoekranowy dla zakupów w aplikacji. Ustaw wartość InAppPurchaseListener w polu InterstitialAd, aby nasłuchiwać zdarzeń zakupu w aplikacji. Poprawka błędu powodującego awarię SecurityException z powodu odczytywania gservices bez uprawnień.
4,3	2014‑03‑17	InterstitialAd działa teraz, jeśli przekazano kontekst aplikacji. Dodaliśmy metodę setContentUrl() do PublisherAdRequest.Builder. Poprawka wyjątku, gdy usługa nie jest zarejestrowana.
4.2	2014‑02‑03	Naprawiono różne błędy.
4.1	2014‑01‑16	Dodaliśmy obsługę Ad Managera i reklam w wyszukiwarce w aplikacjach mobilnych. AdRequest.Builder ma teraz metodę setLocation(). Naprawiliśmy błąd, który występował, gdy żądano reklamy pełnoekranowej, ale w pliku manifestu nie określono parametru AdActivity.
4.0	2013‑10‑31	Interfejsy API reklam mobilnych Google są teraz częścią Usług Google Play. Przyszłe aktualizacje interfejsów API mobilnych reklam Google są automatycznie przesyłane na urządzenia za pomocą Usług Google Play. Ad Manager i reklamy w wyszukiwarce w aplikacjach mobilnych nie są jeszcze obsługiwane.