Informacje o wersjach

Wersja Data wydania Uwagi
25.5.0 2026‑09‑17
  • Zwiększyliśmy minimalny poziom interfejsu Android API do 24.
  • Dodano onInitializationFailed() do: InitializationCompleteCallback. Adaptery zapośredniczenia zgłaszają teraz błędy inicjowania pakietu SDK firmy zewnętrznej do pakietu SDK do reklam mobilnych Google, podając kod błędu, domenę błędu i komunikat o błędzie.
  • Podczas korzystania z zapośredniczenia ze źródłami reklam zdarzeń niestandardowych ResponseInfo.getAdapterClassName() zwraca teraz nazwę klasy zdarzenia niestandardowego zamiast com.google.ads.mediation.customevent.CustomEventAdapter.
25.4.0 2026‑06‑17
  • Poprawki błędów i zmiany ulepszające działanie aplikacji.
25.3.0 2026‑05‑21
  • Dodaliśmy metodę setAgeRestrictedTreatment() w RequestConfiguration.Builder i wycofaliśmy metody setTagForChildDirectedTreatment() i setTagForUnderAgeOfConsent(). Użyj nowej metody, aby skonfigurować traktowanie z ograniczeniem wiekowym w przypadku dzieci i nastolatków.
25.2.0 2026‑04‑13
  • Poprawki błędów i zmiany ulepszające działanie aplikacji.
25.1.0 16 marca 2026 r.
  • Naprawiliśmy błąd w inspektorze reklam, który mógł powodować błąd podczas żądania reklamy testowej poza kontekstem z pustym adresem URL treści.
25.0.0 2026‑02‑17
24.9.0 11.12.2025
  • Poprawki błędów i zmiany ulepszające działanie aplikacji.
24.8.0 2025‑11‑20
  • Naprawiliśmy brakujące tłumaczenia zasobów pakietu SDK w wersjach 24.6.0 i 24.7.0.
  • Wycofano: NativeAdViewHolder. Zamiast tego do renderowania reklam natywnych używaj NativeAdView.
  • Wycofaliśmy metody AdPreloader.getConfigurations() i AdPreloader.getConfiguration(preloadId). Nie ma zamienników tych metod.
24.7.0 2025‑10‑09
  • Poprawiono brakującą adnotację o wartości null w zwracanym typie dla NativeCustomFormatAd.getDisplayOpenMeasurement(). Funkcjonalność nie uległa zmianie, ponieważ możliwość zwracania wartości null przez metodę była już oczekiwana.
  • Zmieniono wersję zależności androidx.webkit:webkit z 1.14.0 na 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 zapośredniczenia reklam natywnych mogą teraz implementować NativeAdMapper.destroy(), aby otrzymywać powiadomienia o zniszczeniu 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 we wszystkich formatach reklam.
  • Naprawiliśmy błąd powodujący awarię i wyświetlanie komunikatu o błędzie Fatal Exception: java.util.ConcurrentModificationException.
24.4.0 2025‑06‑09
  • Dodaliśmy kilka nowych interfejsów API do wstępnego ładowania reklam i wycofaliśmy dotychczasowe. Wstępne ładowanie reklam pozostaje funkcją w wersji alfa dla ograniczonej grupy wydawców.
24.3.0 19 maja 2025 r.
  • 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 zmiany ulepszające działanie aplikacji.
24.1.0 2025‑03‑12
  • Minimalna wersja Kotlina to teraz 2.1.0.
  • Poprawki błędów i zmiany ulepszające działanie aplikacji.
  • play-services-ads-lite przechodzi na rzadszy cykl wydawniczy i nie jest rozpowszechniany w tej wersji. Więcej informacji znajdziesz w dokumentacji pakietu SDK Lite.
24.0.0 2025‑02‑24
  • Zmiany powodujące niezgodność:
    • Zwiększyliśmy minimalny poziom interfejsu Android API do 23.
    • Usunięto wszystkie interfejsy API powiązane z formatem reklamy interscroller.
    • Usunęliśmy wycofane interfejsy API orientacji AppOpenAd.
    • 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.
  • Funkcja Optymalizuj inicjowanie i wczytywanie reklam jest teraz ogólnie dostępna i domyślnie włączona.
  • Dodano MediationRewardedAdCallback.onUserEarnedReward() i wycofano MediationRewardedAdCallback.onUserEarnedReward(RewardItem). Adaptery 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 dla konkretnego interfejsu API.
23.6.0 2024‑12‑03
  • Wycofano wszystkie interfejsy API powiązane z formatem reklamy interscroller. Na przykład: AdSize.getCurrentOrientationInterscrollerAdSize().
23.5.0 2024‑10‑29
  • Zaktualizowano komunikaty logcat o niepowodzeniu wczytywania reklamy wprowadzone w wersji 23.4.0 z poziomu błędu do poziomu informacji.
  • Ulepszone zarabianie na reklamach spersonalizowanych w kartach niestandardowych w przypadku interfejsu WebView API for Ads.
23.4.0 30 września 2024 r.
  • Niepowodzenia wczytywania reklam wywołują teraz komunikat logcat, który zawiera ad failed to load w zrzucie stosu błędu. Zrzut stosu rejestruje ten komunikat jako błąd, ale nie oznacza to awarii. Aby dowiedzieć się, jak interpretować typowe błędy wczytywania reklam, zapoznaj się z artykułem Debugowanie typowych komunikatów logu o błędach. Jeśli widzisz powtarzający się błąd związany z wyświetlaniem reklam, który nie jest udokumentowany, udostępnij zrzut stosu zespołowi pomocy Google Mobile Ads SDK (Legacy).
  • Dodano metody addCustomTargeting() 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 2024‑06‑27
23.1.0 2024‑05‑09
  • Wymagana jest minimalna wartość compileSdkVersion wynosząca 34.
  • Adaptery zapośredniczenia natywnego: wycofano loadNativeAd i loadRtbNativeAd() na rzecz loadNativeAdMapper() i loadRtbNativeAdMapper(). Adaptery powinny zostać przeniesione, aby korzystać z tych nowych metod wczytywania i powiązanych obiektów.
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 swoją 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 metodę alternatywną MobileAds.putPublisherFirstPartyIdEnabled(), aby zwracała wartość logiczną informującą o tym, czy trwałość elementu sterującego została zachowana.
    • Native Ads:
      • Użytkownik AdLoader.forUnifiedNativeAd() został usunięty. Użyj w zamian zasady AdLoader.forNativeAd().
      • Użytkownik AdLoader.forCustomTemplateAd() został usunięty. Użyj w zamian 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 obiekcie nadrzędnym można teraz łączyć, aby utworzyć obiekt za pomocą jednego wywołania. Wymagało to zmiany struktury dziedziczenia, tak aby AdManagerAdRequest.Builder nie dziedziczyło już z AdRequest.Builder.
  • Dodaliśmy metodę MobileAds.registerCustomTabsSession(), aby zwiększyć zarobki z reklam na kartach niestandardowych. Więcej informacji znajdziesz w artykule Optymalizowanie 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
22.5.0 30.10.2023
22.4.0 13.09.2023
  • Wymaga co najmniej compileSdkVersion 33.
  • Inspektor reklam: dodaliśmy obsługę pakietu SDK do wyświetlania reklam na potrzeby żądania i wyświetlania reklam żądanych 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 Attribution Reporting i Topics w wersji beta. Więcej informacji znajdziesz w przewodniku AdMob po Piaskownicy prywatności na Androida.
22.3.0 22 sierpnia 2023 r.
22.2.0 5 lipca 2023 r.
22.1.0 18 maja 2023 r.
  • Inspektor reklam: dodaliśmy możliwość wywoływania żądań reklam z interfejsu inspektora reklam na urządzeniach, które nie mają usług Google Play.
22.0.0 2023‑03‑29
  • Zmiany powodujące niezgodność:
  • Dodano: AdRequest.getRequestAgent().
  • thought Zapośredniczenie: wartość zwracana dla 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 31 stycznia 2023 r.
  • Reklamy wyświetlane przy otwarciu aplikacji: wycofano metody AppOpenAd.load(), które akceptują parametr wejściowy orientacji, i dodano nowe metody, które nie akceptują danych wejściowych orientacji. Nowe metody określają orientację w momencie wysyłania żądania, co odpowiada zachowaniu 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 potrzebujesz uprawnień dla aplikacji, być może musisz je wyraźnie zadeklarować w pliku manifestu Androida.
21.4.0 14.12.2022
  • 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, aby wyświetlać banery reklamowe i reklamy natywne, o które poproszono w interfejsie inspektora reklam.
  • Dodaliśmy obsługę własnego identyfikatora wydawcy (dawniej (funkcja) Same App Key), aby pomóc Ci wyświetlać trafniejsze i reklamy spersonalizowane na podstawie zbierania danych z aplikacji.
  • Oficjalna wersja do publikacji dla generacji QueryInfo.
21.3.0 10.10.2022
21.2.0 6 września 2022 r.
  • Inspektor reklam: dodaliśmy obsługę pakietu SDK do wyświetlania reklam na potrzeby eksportowania dzienników żądań reklam za pomocą arkusza udostępniania w Androidzie.
21.1.0 14 lipca 2022 r.
  • Dodaliśmy obsługę zarabiania na reklamach w WebView. Więcej informacji znajdziesz w artykule Integracja interfejsu WebView API for Ads.
  • Dodano getResponseExtras() do ResponseInfo, co może spowodować zwrócenie dodatkowych informacji o odpowiedzi na reklamę.
21.0.0 2022‑05‑25
  • Zmiany powodujące niezgodność:
    • Google Mobile Ads SDK (Legacy) wymaga teraz, aby wszystkie aplikacje były na poziomie interfejsu API Androida 19 lub wyższym.
    • Dodano adnotacje @NonNull we wszystkich metodach, które wcześniej nie definiowały wyraźnie dopuszczalności wartości null.
    • Usunęliśmy metodę AdRequest.Builder.addNetworkExtras(). Użyj w zamian zasady AdRequest.Builder.addNetworkExtrasBundle().
    • Usunęliśmy te metody lokalizacji:
      • setLocation() na AdRequest.Builder
      • getLocation() w: AdRequest
      • getLocation() na MediationAdConfiguration
  • Dodano flagi manifestu, aby zoptymalizować inicjowanie i wczytywanie reklam. Więcej informacji znajdziesz w przewodniku po optymalizacji inicjowania i wczytywania reklam.
  • Wycofano: MobileAds.getVersionString(). Zamiast tego użyj MobileAds.getVersion().
  • Dodaliśmy metodę getLoadedAdapterResponseInfo() w ResponseInfo.
  • Dodaliśmy te metody w AdapterResponseInfo:
    • getAdSourceName()
    • getAdSourceId()
    • getAdSourceInstanceName()
    • getAdSourceInstanceId()
  • Dodaliśmy obsługę zdarzeń niestandardowych w inspektorze reklam.
20.6.0 22 lutego 2022 r.
20.5.0 2021‑11‑18
  • Dodano obsługę urządzeń z Androidem 12 w przypadku aplikacji kierowanych na interfejs 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 (Legacy) zawiera uprawnienie com.google.android.gms.permission.AD_ID w pliku manifestu pakietu SDK, który jest automatycznie scalany z plikiem manifestu aplikacji przez narzędzia Android Build Tools. Więcej informacji o deklaracji uprawnień AD_ID, w tym o jej wyłączaniu, znajdziesz w tym artykule pomocy w Centrum pomocy Konsoli Play.
  • Dodano wywołanie zwrotne onAdClicked() do FullScreenContentCallback.
  • Włączono wywołanie zwrotne onAdClicked() w klasie AdListener w przypadku formatu reklam natywnych.
20.3.0 23 sierpnia 2021 r.
20.2.0 2021‑06‑08
  • Dodaliśmy obsługę inspektora reklam (beta) dla wydawców korzystających z Google Ad Managera.
20.1.0 2021‑04‑29
20.0.0 5 kwietnia 2021 r.
  • Zmiany powodujące niezgodność:
    • Usunięto starszą wersję interfejsu API Interstitial.
    • Usunięto starszą wersję interfejsu API RewardedVideoAd.
    • Usunięto klasy 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 istnieje 1 format reklamy natywnej o nazwie NativeAd.
    • RewardedAd jest teraz klasą abstrakcyjną. Aby wczytać reklamę z nagrodą, użyj metody statycznej RewardedAd.load().
  • Dodaliśmy inspektora reklam (beta).
  • 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 FullScreenContentCallback.
  • Wycofano format InstreamAd.
  • Adaptery zapośredniczenia:
    • Wycofano: MediationBannerAdapter, MediationInterstitialAdapter i MediationNativeAdapter. Nowe adaptery powinny implementować klasę Adapter, aby wczytywać te formaty.
    • Adaptery do określania 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:
    • 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 4 grudnia 2020 r.
  • Wycofaliśmy metodę onAdLeftApplication() AdListener.
  • Naprawiliśmy błąd, 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: metoda onAdImpression() AdListener jest teraz wywoływana w przypadku banerów reklamowych.
  • Dodaliśmy metodę setHttpTimeoutMillis(), która umożliwia dostosowywanie limitu czasu połączeń HTTPS wykonywanych przez pakiet SDK do reklam mobilnych Google.
19.4.0 10 września 2020 r.
  • Dodano obsługę urządzeń z Androidem 11 w przypadku aplikacji kierowanych na interfejs API na poziomie 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 AppOpenAd. Wycofane klasy AppOpenAdView i AppOpenAdPresentationCallback.
  • Zapośredniczenie: dostępne są teraz raporty o stanie zapośredniczenia. Użyj ResponseInfo.getAdapterResponses(), aby uzyskać informacje o odpowiedzi dla każdej sieci reklamowej, która uczestniczyła w żądaniu reklamy.
  • Starsze reklamy z nagrodą: wycofane RewardedVideoAd.
  • Naprawiliśmy błąd, który powodował, że MobileAds.initialize() wywoływał moduł obsługi zakończenia tylko raz. Każde wywołanie metody 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 do wszystkich formatów reklam nowe wywołania zwrotne błędu wczytywania, które zwracają obiekt LoadAdError. Np. onAdFailedToLoad(LoadAdError).
  • Wycofane wywołania zwrotne błędu wczytywania, które zwracają liczbę całkowitą, np. onAdFailedToLoad(int).
  • Reklamy z nagrodą: dodano onRewardedAdFailedToShow(AdError) i wycofano onRewardedAdFailedToShow(int).
  • Zapośredniczenie reklam z nagrodą: dodano kod błędu prezentacji MEDIATION_SHOW_ERROR. Wszystkie błędy prezentacji związane z reklamami zapośredniczonymi zwracają teraz MEDIATION_SHOW_ERROR dla AdError.getCode() i NonNull AdError.getCause() reprezentujący błąd zapośredniczenia.
19.2.0 2020‑06‑18
  • Dodano format RewardedInterstitialAd. Ta funkcja jest w prywatnej wersji beta. Aby poprosić o dostęp, skontaktuj się z menedżerem konta.
  • Reklamy natywne: dodaliśmy interfejs walidatora reklam natywnych w żądaniach testowych, aby ułatwić Ci wykrywanie i naprawianie naruszeń zasad dotyczących reklam natywnych.
  • Dodaliśmy metodę MobileAds.disableMediationAdapterInitialization(). Wywołaj tę metodę przed zainicjowaniem Google Mobile Ads SDK (Legacy), aby wyłączyć inicjowanie adaptera zapośredniczenia.
19.1.0 16 kwietnia 2020 r.
19.0.1 2020‑03‑18
  • Reklamy natywne: naprawiono wyciek pamięci, który występował podczas korzystania z NativeCustomTemplateAd.
19.0.0 2020‑03‑02
  • Dodano obsługę odczytywania parametrów zgody z Zasad IAB dotyczących przejrzystości i uzyskiwania zgody na przetwarzanie danych w wersji 2.0 oraz ciągu tekstowego IAB us_privacy.
  • Dodano setNeighboringContentUrls() i getNeighboringContentUrls() do albumu AdRequest.
  • Dodaliśmy klasę ResponseInfo, która dostarcza informacji o wczytanej reklamie.
  • W przypadku wszystkich formatów reklam wycofano getMediationAdapterClassName() na rzecz getResponseInfo().
  • Reklamy natywne: dodaliśmy metody getDuration() i getCurrentTime() do klasy MediaContent.
  • Zapośredniczenie reklam natywnych: dodaliśmy metody getDuration() i getCurrentTime() do klasy UnifiedNativeAdMapper, aby adaptery mogły je implementować.
  • Wycofano: AdRequest.Builder.addTestDevice(). Użyj w zamian zasady RequestConfiguration.Builder.setTestDeviceIds().
18.3.0 5 listopada 2019 r.
  • Dodano interfejsy API dla formatu reklamy InstreamAd. Ta funkcja jest w prywatnej wersji beta. Aby poprosić o dostęp, skontaktuj się z menedżerem konta.
  • Baner adaptacyjny: zmieniono metody tworzenia banerów adaptacyjnych w klasie AdSize. Na przykład zmieniono nazwę AdSize.getCurrentOrientationBannerAdSizeWithWidth() na AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize().
  • Zapośredniczenie: Google Mobile Ads SDK (Legacy) teraz wychwytuje wyjątki zgłaszane przez adaptery zapośredniczenia.
  • Zapośredniczenie reklam z nagrodą: naprawiliśmy błąd, który powodował, że jeśli w pamięci podręcznej było zapisanych kilka reklam z nagrodą objętych zapośredniczeniem, wyświetlała się tylko jedna z nich.
  • Dodano 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 w prywatnej wersji beta. Aby poprosić o dostęp, skontaktuj się z menedżerem konta.
18.1.1 23 lipca 2019 r.
  • Zapośredniczenie: adaptery są teraz inicjowane, gdy aplikacje wywołują metodę MobileAds.initialize(Context, OnInitializationCompleteListener).
  • Zapośredniczenie: wyjątki adaptera, których zrzuty stosu zawierają Google Mobile Ads SDK (Legacy), są teraz przechwytywane i obsługiwane przez Google Mobile Ads SDK (Legacy).
18.1.0 9 lipca 2019 r.
  • Oficjalna wersja obsługująca pomiar danych o korzystaniu z aplikacji.
  • Pomiar danych o korzystaniu z aplikacji jest domyślnie inicjowany i wysyła dane po uruchomieniu aplikacji. Dodaliśmy opcję opóźnienia pomiaru danych o korzystaniu z aplikacji do momentu jawnego wywołania metody Google Mobile Ads SDK (Legacy).
  • Dodano nową metodę inicjowania MobileAds.initialize(Context, OnInitializationCompleteListener), która powiadamia o zakończeniu inicjowania przez Google Mobile Ads SDK (Legacy) i wszystkie skonfigurowane adaptery zapośredniczenia.
  • Dodano MobileAds.getInitializationStatus(), aby podawać stan inicjowania wszystkich sieci reklamowych skonfigurowanych dla Twojej aplikacji.
  • Dodano: MobileAds.getRequestConfiguration(). Parametry kierowania ustawione w tym obiekcie konfiguracji są używane we wszystkich żądaniach reklamy.
  • Reklamy natywne: dodaliśmy metodę NativeAdOptions.Builder.setMediaAspectRatio(), która umożliwia żądanie określonego formatu obrazu zasobu multimedialnego reklamy natywnej. Ta opcja ma pierwszeństwo przed wycofaną metodą setImageOrientation().
  • Reklamy natywne: w przypadku reklam innych niż wideo typ skali obrazu MediaView można teraz ustawić za pomocą MediaView.setImageScaleType().
  • Reklamy natywne: dodano UnifiedNativeAd.getMediaContent(). Wydawcy, którzy wczytują obrazy tylko za pomocą adresów URL, mogą teraz pobierać zawartość multimedialną reklamy, dostarczać do niej obraz i wywoływać metodę MediaView.setMediaContent(), aby wypełniać dane obrazu za pomocą MediaView w przypadku reklam innych niż wideo.
  • Zapośredniczenie reklam natywnych: adaptery mogą teraz podawać format obrazu za pomocą metody UnifiedNativeAdMapper.setMediaContentAspectRatio().
  • Dodano zależności od play-services-measurement i play-services-measurement-sdk. Aplikacje nie muszą już dodawać tych zależności bezpośrednio.
18.0.0 17.06.2019
  • 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, w tej wersji wydawcy muszą zadeklarować dodatkowe 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 21 maja 2019 r.
  • Rozwiązanie problemu z błędem ANR, który występuje w android.media.AudioManager.getStreamVolume.
17.2.0 11 marca 2019 r.
  • Reklama wideo z nagrodą: dodaliśmy nowy zestaw interfejsów API reklam z nagrodą (zobacz pakiet rewarded), który umożliwia jednoczesne wczytywanie wielu reklam z nagrodą.
  • Zapośredniczenie: dodano 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 i wersji 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 i wersji 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 3 grudnia 2018 r.
  • Wydawcy korzystający z firebase-analytics i wersji 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 12.11.2018
  • Naprawiliś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 i wersji 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
17.0.0 2018‑10‑05
  • Wydawcy Google AdMob muszą określić tag <meta-data> z kluczem com.google.android.gms.ads.APPLICATION_ID w pliku AndroidManifest.xml. Więcej informacji znajdziesz w przewodniku dla początkujących.
  • Reklamy natywne: klasy NativeAppInstallAd, NativeContentAd i powiązane interfejsy API zostały wycofane na rzecz klasy UnifiedNativeAd. Więcej informacji o korzystaniu z nowych interfejsów API znajdziesz w artykule Zaawansowane reklamy natywne.
  • Reklamy natywne: dodano funkcję „Wyłącz tę reklamę”.
  • Reklamy natywne: usunęliśmy niegroźny wpis w dzienniku ostrzeżeń: „UnconfirmedClickListener must not be null while ClickConfirmingView is set”.
  • Reklamy z nagrodą: dodaliśmy metodę setAdMetadataListener w RewardedVideoAd, aby umożliwić wykrywanie zmian metadanych reklamy.
  • Reklamy z nagrodą: wywołanie metody destroy() spowoduje unieważnienie obiektu nasłuchującego.
  • Wycofano te metody w AdRequest.Builder:
  • Naprawiliśmy błąd, który powodował, że zdarzenie onRewardedVideoCompleted() nie było wywoływane w emulatorach.
16.0.0 2018‑10‑02
15.0.0 2018‑04‑12
  • MRAID v3 w wersji beta.
  • Reklamy natywne: dodaliśmy interfejs Unified Native Ad API. Łączy on NativeAppInstallAds i NativeContentAds w jeden nowy typ: UnifiedNativeAd.
  • Uwaga: gdy używasz reklam natywnych, po kliknięciu reklamy natywnej w dziennikach pojawia się nieszkodliwe ostrzeżenie: „UnconfirmedClickListener must not be null while ClickConfirmingView is set” (UnconfirmedClickListener nie może mieć wartości null, gdy ustawiono ClickConfirmingView). Możesz zignorować to ostrzeżenie. Zostanie ono usunięte w następnej wersji.
12.0.1 2018‑03‑28
12.0.0 2018‑03‑20
  • Reklama wideo z nagrodą: dodano metodę wywołania zwrotnego onRewardedVideoCompleted() do RewardedVideoAdListener.
  • Zapośredniczenie reklam natywnych: dodaliśmy metodę trackViews() do NativeAdMapper, aby umożliwić adapterom dostęp do obiektów View odpowiadających poszczególnym komponentom reklam natywnych. Wycofano trackView() na rzecz trackViews().
11.8.0 18.12.2017
  • Poprawki błędów i ogólne ulepszenia.
11.6.0 2017‑11‑07
  • Dodaliśmy klasę NativeAdViewHolder i powiązane metody w NativeAppInstallAd i NativeContentAd.
  • Wycofane w AdLoader.getMediationAdapterClassName (wydawcy powinni zamiast tego używać metod o tej samej nazwie w NativeAppInstallAd i NativeContentAd).
  • Reklamy testowe mają teraz etykietę u góry. 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.
  • Dodaliśmy metodę onVideoEnd() do klasy MediationNativeListener, metody hasVideoContent(), setHasVideoContent() i setMediaView() do klasy NativeAdMapper oraz metody getAdVolume() i isAdMuted() do klasy NativeMediationAdRequest, aby umożliwić zapośredniczenie natywnych reklam wideo.
  • Usunięto zajęcia SearchAdRequest.
11.2.2 2017‑09‑05
  • Dodaliśmy do klasy RewardedVideoAd nową metodę loadAd(), która przyjmuje obiekt PublisherAdRequest.
11.2.0 14.08.2017
  • Dodaliśmy metodę loadAds() do klasy AdLoader, która umożliwia aplikacjom wczytywanie wielu unikalnych reklam w jednym żądaniu.
  • Gdy zaktualizujesz aplikację do pakietu SDK do reklam mobilnych Google w wersji 11.2.0 lub nowszej, musisz też zaktualizować plik build.gradle aplikacji, aby określić compileSdkVersion o wartości co najmniej 26 (Android O). Nie zmienia to sposobu działania aplikacji. Nie musisz aktualizować targetSdkVersion.
  • Od wersji 11.2.0 pakiet Google Mobile Ads SDK (Legacy) 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
  • Dodaliśmy 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 imersji 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ń dotyczących reklam natywnych i banerów.
  • Dodano opcjonalny interfejs OnImmersiveModeUpdatedListener, który adaptery zapośredniczenia mogą implementować, aby otrzymywać informacje o aktualizacjach trybu imersji.
  • Dodaliśmy metodę getMediationAdapterClassName() do klasy RewardedVideoAd.
  • Dodano reguły keep, 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 pierwsze wydanie, które nie obejmuje już pełnej obsługi Androida w wersji 2.3.x (Gingerbread). Aplikacje utworzone przy użyciu pakietu SDK w wersji 10.2.x lub nowszej wymagają interfejsu Android API na poziomie co najmniej 14 i nie można ich instalować na urządzeniach z interfejsem API na poziomie niższym niż 14. Więcej informacji o dostępnych opcjach, w tym o tworzeniu wielu pakietów APK w celu rozszerzenia obsługi aplikacji na Androida Gingerbread, znajdziesz na blogu dla deweloperów aplikacji na Androida.
  • Dodaliśmy obsługę komponentów wideo w przypadku zaawansowanych reklam natywnych z treścią i reklam z szablonu niestandardowego.
  • Dodano metody getVideoController(), setVideoOptions() i getVideoOptions() do klasy PublisherAdView.
  • Dodano klasę AdChoicesView.
  • Dodano metody getAdChoicesContent() i setAdChoicesContent() do klasy NativeAdMapper.
  • Dodaliśmy interfejs InitializableMediationRewardedVideoAdAdapter dla adapterów zapośredniczenia reklam wideo z nagrodą, które chcą wyrazić zgodę na wczesną inicjalizację 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ż wycofany. Wydawcy korzystający z Google Ad Managera powinni wywoływać tę metodę podczas inicjowania aplikacji. Wydawcy AdMob powinni nadal używać MobileAds.Initialize(Context, String) i przekazywać kod aplikacji.
9.6.0 2016‑09‑22
  • Dodaliśmy klasę MediaView na potrzeby zaawansowanych natywnych reklam wideo.
  • Dodano metodę openDebugMenu() do klasy MobileAds na potrzeby Creative Preview i rozwiązywania problemów z jednostkami reklamowymi Ad Managera.
  • Dodaliśmy obsługę zdarzeń niestandardowych w reklamach 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 metodę setAdChoicesPlacement() do klasy NativeAdOptions.Builder, której wydawcy aplikacji mogą teraz używać do określania lokalizacji AdChoices w reklamach natywnych.
  • Poprawiliśmy odtwarzanie reklam wideo, eliminując kilka błędów.
9.0.1 2016‑05‑26
  • Rozwiązaliśmy problem z ProGuard, który pojawił się w wersji 9.0.0. Wydawcy nie potrzebują już opcji keep w przypadku com.google.android.gms.common.util.DynamiteApi.
9.0.0 18.05.2016
  • Dodaliśmy 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ą.
  • Dodaliśmy opcje wideo dla reklam ekspresywnych w formacie natywnym.
  • Zaktualizowaliśmy 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) jest teraz wycofana.
  • Dodano 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 konfiguracji ProGuard tę opcję keep:-keep public @com.google.android.gms.common.util.DynamiteApi class * { *; }
8.4.0 18 grudnia 2015 r.
  • Dodano metodę publiczną MobileAds.setAppVolume(), która informuje Google Mobile Ads SDK (Legacy) 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 sprawdzać, czy żądanie reklamy jest w toku.
  • Dodaliśmy metodę setIsDesignedForFamilies() do AdRequest.Builder i PublisherAdRequest.Builder.
  • Dodaliśmy metodę destroy() do NativeAdView.
8.1.0 2015‑09‑24 Poprawki dotyczące różnych błędów.
7.8.0 13 sierpnia 2015 r.
  • Oficjalna wersja do publikacji MRAID v2.
  • Dodano metodę isLoading() do interfejsów 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 usłudze Ad Manager.
  • Dodaliśmy obsługę niestandardowych formatów reklam natywnych, które są dostępne w przypadku rezerwacji w usłudze Ad Manager.
7.3.0 2015‑04‑28 Poprawki dotyczące różnych błędów.
7.0.0 2015‑03‑19
  • Dodano metody addCustomTargeting() i addCategoryExclusion() do PublisherAdRequest.Builder.
  • Rozwiązaliśmy problem, który powodował, że PublisherAdView.recordManualImpression() rejestrował wiele wyświetleń w usłudze Ad Manager, gdy używane było ręczne zliczanie wyświetleń.
  • Rozwiązaliśmy problem, który powodował nieprawidłowe renderowanie reklam, gdy w tagu <supports-screens> używany był atrybut android:largestWidthLimitDp.
  • Dodaliśmy metodę setRequestAgent() do AdRequest.Builder i PublisherAdRequest.Builder. Tej metody należy używać do oznaczania źródeł żądań reklamy przez firmy zewnętrzne, które korzystają z zapośredniczenia w Google Mobile Ads SDK (Legacy).
6.5.87 8 grudnia 2014 r.
  • Wprowadziliśmy architekturę podzielonego pliku JAR – deweloperzy korzystający z Android Studio mogą teraz dołączać 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ą banery reklamowe w formacie XML, muszą nadal odwoływać się do całej biblioteki com.google.android.gms:play‑services:6.+.
  • Poprawki dotyczące różnych błędów.
6.1 8 października 2014 r.
  • Dodaliśmy metodę getLocation() do com.google.android.gms.ads.MediationAdRequest.
  • Dodano opis zawartości przycisku zamykania reklamy pełnoekranowej, aby ułatwić dostęp.
  • Usunięto rejestrowanie błędu „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, który wyświetla reklamę.
17.0.0 2018‑10‑05
  • Dodaliśmy nowe interfejsy API do implementacji 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 zapośredniczenia.
  • Dodano nowy format reklamy 320 x 100 (LARGE_BANNER) na telefony i tablety.
  • Dodano nowy format reklamy pełnoekranowej dla zakupów w aplikacji. Ustaw InAppPurchaseListener na InterstitialAd, aby nasłuchiwać zdarzeń zakupu w aplikacji.
  • Poprawka błędu powodującego awarię aplikacji SecurityException z powodu odczytu gservices bez uprawnień.
4,3 2014‑03‑17
  • InterstitialAd działa teraz, gdy przekazywany jest kontekst aplikacji.
  • Dodaliśmy metodę setContentUrl() do PublisherAdRequest.Builder.
  • Naprawiono wyjątek, gdy usługa nie jest zarejestrowana.
4.2 2014‑02‑03 Poprawki dotyczące różnych błędów.
4.1 2014‑01‑16
  • Dodaliśmy obsługę Ad Managera i reklam w wyszukiwarce w aplikacjach mobilnych.
  • AdRequest.Builder ma teraz metodę setLocation().
  • Rozwiązaliśmy problem, który powodował awarię, gdy żądano reklamy pełnoekranowej, ale w pliku manifestu nie określono AdActivity.
4.0 2013‑10‑31
  • Interfejsy Google Mobile Ads API są teraz częścią usług Google Play.
  • Przyszłe aktualizacje interfejsów API do reklam mobilnych Google są automatycznie przekazywane na urządzenia przez Usługi Google Play.
  • Ad Manager i reklamy w wyszukiwarce w aplikacjach mobilnych nie są jeszcze obsługiwane.