Historia wersji pakietu Google IMA Android SDK

Wersja Data wydania Uwagi
3.39.0 2026-01-22
  • Dodaje do klasy AdMediaInfo metody getAudioMimeType() i getVideoMimeType().
  • Dodaje adnotację @Nullable do metod interfejsu pakietu SDK.
  • Dodaje metodę ImaSdkFactory.release() do czyszczenia komponentów IMA, jeśli nie ma utworzonego interfejsu AdsLoader.
  • Usuwa te wycofane metody interfejsu AdsRequest:
    • setExtraParameter()
    • getExtraParameter()
    • getExtraParameters()
  • Usuwa wycofane metody AdDisplayContainer.setPlayer() i StreamDisplayContainer.setVideoStreamPlayer().
  • Usuwa te wycofane metody interfejsu BaseDisplayContainer:
    • setAdContainer()
    • registerVideoControlsOverlay()
    • unregisterAllVideoControlsOverlays()
  • Usuwa te wycofane metody interfejsu CuePoint:
    • getStartTime()
    • getEndTime()
  • Rozwiązuje problem z wyciekiem pamięci podczas niszczenia instancji BaseManager powiązanej z komunikatem Attempted to send bridge message after cleanup w logcat.
3.38.0 2025-10-07
  • Wymagania (minSdkVersion) 23.
  • Dodaje interfejs AdSlot i aktualizuje interfejs CompanionAdSlot, aby rozszerzyć interfejs AdSlot.
  • Rozwiązuje problem z błędem ANR, który występuje podczas pobierania głośności urządzenia z wątku głównego.
  • Wersja 3.38.0 pakietu IMA SDK zostanie wycofana 22 stycznia 2027 r. Więcej informacji znajdziesz w harmonogramie wycofywania.
3.37.0 2025-07-15
  • Dodaje odcukrzanie aplikacji jako wymaganie w przypadku aplikacji integrujących pakiet IMA SDK. Aplikacje, w których nie włączono desugaryzacji, nie będą działać z obecnymi ani przyszłymi wersjami IMA. Aby włączyć usuwanie cukru z aplikacji, zapoznaj się z artykułem Dodawanie pakietu SDK IMA do projektu.
  • Aktualizuje wymagania dotyczące minimalnej wersji AndroidacompileSdk do wersji 35 i wtyczki Androida do obsługi Gradle do wersji 8.6.0.
  • Dodaje interfejs AdPeriodInfo, do którego można uzyskać dostęp za pomocą metody AdEvent#getAdPeriodInfo() w zdarzeniu AD_PERIOD_STARTED.
  • Dodaje interfejs PlaybackMeasurementCollector do oceny wydajności pakietu SDK i planowania reklam w aplikacjach ExoPlayer.
  • Aktualizuje pakiet IMA, aby zgłaszał wyjątek, jeśli wyślesz żądanie reklamy lub strumienia z nieprawidłowymi parametrami.
  • Dodaje typ błędu AdError.WEB_VIEW_ERROR, który występuje, gdy moduł renderujący WebView ulegnie awarii. Ten nowy typ błędu rozwiązuje problem, w którym WebView awarie renderera powodują awarię aplikacji.
  • Optymalizuje funkcję ImaSdkFactory.initialize(), przenosząc części inicjowania WebView do wątku w tle. Ta zmiana zmniejsza prawdopodobieństwo wystąpienia błędów ANR podczas wywołania ImaSdkFactory.initialize().
  • Rozwiązuje błąd NullPointerException spowodowany zainicjowaniem nowej prośby o reklamy podczas wywoływania funkcji AdsLoader.release().
  • Rozwiązuje problem z awarią WebViewCompat.addWebMessageListener, która występuje na starszych urządzeniach CTV.
  • Rozwiązaliśmy problem, który powodował, że pakiet IMA SDK nie oznaczał elementu getPreviousCuePointForStreamTimeMs() jako nullable.
  • Rozwiązuje problem, który powodował awarię pakietu SDK, gdy nie był zainstalowany żaden widok WebView. Uwaga: WebView to kluczowy komponent pakietu SDK. Jeśli nie jest zainstalowany żaden komponent WebView, pakiet SDK nie może działać prawidłowo.
  • Aktualizuje zależności webkit do najnowszych wersji stabilnych.
  • Pakiet IMA Android SDK planuje zaktualizować minimalny wymagany poziom interfejsu API (minSdkVersion) do wersji 23, aby był zgodny z bibliotekami Android Jetpack (AndroidX). Więcej informacji znajdziesz w wymaganiach dotyczących wersji Jetpacka.
  • Usuwa te wycofane metody:
    • Ad.getUniversalAdIdValue()
    • Ad.getUniversalAdIdRegistry()
    • AdsManager.requestNextAdBreak()
    • BaseManager.isCustomPlaybackUsed()
    • ImaSdkFactory.createAdDisplayContainer()
    • ImaSdkFactory.createAudioAdDisplayContainer(Context)
    • ImaSdkFactory.createStreamDisplayContainer()
    • StreamManager.getStreamTimeForContentTime(double contentTime)
    • StreamManager.getContentTimeForStreamTime(double streamTime)
    • StreamManager.getPreviousCuePointForStreamTime(double streamTime)
    • VideoProgressUpdate.getCurrentTime()
    • VideoProgressUpdate.getDuration()
  • Pakiet IMA SDK w wersji 3.37.0 zostanie wycofany 7 października 2026 r. Więcej informacji znajdziesz w harmonogramie wycofywania.
3.36.0 2024-11-07
  • W tej wersji występuje znany problem dotyczący aplikacji błyskawicznych . Jeśli zintegrujesz IMA z aplikacjami natychmiastowymi, nie zalecamy aktualizowania aplikacji do wersji 3.36.0 IMA. Poprawka tego problemu zostanie uwzględniona w kolejnej wersji pakietu SDK.
  • Dodaje nowe metody żądania strumienia, które zawierają parametr NetworkCode. Nowe metody to:ImaSdkFactory.createLiveStreamRequest()ImaSdkFactory.createVodStreamRequest() Zastępuje podobne interfejsy API, które nie zawierają parametru networkCode.
  • Umieszcza kreacje towarzyszące w układzie ramki pasującym do rozmiaru boksu zadeklarowanego za pomocą parametru CompanionAdSlot.setSize().
  • Pakiet IMA SDK w wersji 3.36.0 zostanie wycofany 15 lipca 2026 r. Więcej informacji znajdziesz w harmonogramie wycofywania.
3.35.1 2024-09-24
  • Rozwiązuje problem, który powodował, że Open Measurement nie działało podczas korzystania z interfejsu ImaSdkFactory.initialize() API.
  • Zwiększa liczbę minSdkVersion obsługiwanych przez IMA do 21.
  • Dodaje ImaSdkFactory.initialize() , aby pobrać i zainicjować zasoby IMA przed pierwszym żądaniem reklamy. Wywołanie funkcji initialize() przydziela pamięć wymaganą do przyszłego odtwarzania reklam i skraca czas oczekiwania na pierwszą reklamę. Więcej informacji znajdziesz w artykule Skracanie czasu wczytywania IMA.
  • Rozwiązuje problem z nieprawidłowym docelowym adresem URL reklamy.
  • Naprawia awarię wprowadzoną w pakiecie IMA w wersji 3.34.0, która dotyczy aplikacji, które nie korzystają z odcukrzania w języku Java 8 w przypadku interfejsów API Androida w wersji 25 i starszych.
  • Dodaje optymalizacje czasu uruchamiania IMA na starszych urządzeniach CTV.
  • Poprawia stabilność otwierania linków na urządzeniach bez zainstalowanej przeglądarki.
  • Pakiet IMA SDK w wersji 3.35.1 zostanie wycofany 7 listopada 2025 r. Więcej informacji znajdziesz w harmonogramie wycofywania.
Wycofano w wersji 3.35.0 2024-08-28
  • W tej wersji występuje znany problem, który powoduje, że pomiar OMID nie działa, gdy używany jest interfejs API ImaSdkFactory.initialize(). Zamiast tego użyj pakietu IMA SDK na Androida w wersji 3.35.1.
  • Wersja 3.35.0 została wycofana, dlatego jej informacje o wersji zostały przeniesione do sekcji dotyczącej wersji 3.35.1.
3.34.0 2024-06-13
3.33.0 2024-03-28
Wycofano w wersji 3.32.0 2024-01-30
  • Ta wersja ma problem z urządzeniami z Androidem na poziomie API 25 lub niższym. Zamiast tego użyj pakietu IMA SDK na Androida w wersji 3.33.0.
  • Dodaje obsługę strumieni VOD innych firm w przypadku wyświetlania reklam w podcastach. Więcej informacji znajdziesz w przewodniku po wyświetlaniu reklam w podach na Androidzie. Ta zmiana obejmuje dodanie tych interfejsów API:
  • Zwiększa liczbę minSdkVersion obsługiwanych przez IMA do 19.
  • Rozwiązuje problem polegający na tym, że kliknięcia reklam za pomocą przycisku Więcej informacji nie otwierały nowej strony w przypadku Androida w wersji API 30 lub nowszej. Problem nadal występuje w wersjach pakietu IMA SDK od 3.31.0 do 3.29.0, w których do prawidłowego działania kliknięć reklam wymagane jest obejście.
  • Naprawiono błąd, który powodował, że użycie AdsLoader.addAdsLoadedListener() mogło wywołać wyjątek ArrayIndexOutOfBoundsException.
  • Dodaje błąd reklamy VAST_NO_ADS_AFTER_WRAPPER.
3.31.0 2023-08-31
  • W przypadku wersji pakietu IMA SDK od 3.31.0 do 3.29.0 z interfejsem Android API w wersji 30 lub nowszej występuje problem, który powoduje, że kliknięcia reklam za pomocą przycisku Więcej informacji nie otwierają nowej strony. Aby obejść ten problem w przypadku wersji, których dotyczy, dodaj do manifestu aplikacji deklaracje intencji otwierania linków internetowych w aplikacji w ten sposób: 
              <?xml version="1.0" encoding="utf-8"?>
          <manifest xmlns:android="http://schemas.android.com/apk/res/android"
              package="com.example.project_name">
              ...
              </application>
              <queries>
                  <intent>
                      <action android:name="android.intent.action.VIEW" />
                      <data android:scheme="https" />
                  </intent>
                  <intent>
                      <action android:name="android.intent.action.VIEW" />
                      <data android:scheme="http" />
                  </intent>
              </queries>
          </manifest>
  • Aktualizuje zależność IMA od pakietu OM SDK do wersji 1.4.8, która zawiera nowe sygnały z telewizorów Smart TV.
  • Wycofuje te interfejsy API AdsRequest:
    • getExtraParameter()
    • getExtraParameters()
    • setExtraParameter()
  • Pakiet IMA SDK w wersji 3.31.0 zostanie wycofany 28 marca 2025 r. Więcej informacji znajdziesz w harmonogramie wycofywania.
3.30.3 2023-08-03
  • Aktualizuje wewnętrzne zależności bibliotek, aby skrócić czas oczekiwania na uruchomienie.
  • Pakiet IMA SDK w wersji 3.30.3 zostanie wycofany 31 sierpnia 2024 r. Więcej informacji znajdziesz w harmonogramie wycofywania.
3.30.2 2023-07-28
  • Poprawia nieoczekiwane błędy NullPointerException, które pojawiły się w wersji 3.30.1.
  • Rozwiązuje problem z proguardingiem, który powodował, że niektóre zdarzenia nie były emitowane z pakietu SDK. Ta poprawka dotyczy rozszerzenia ExoPlayer dla pakietu IMA DAI SDK.
  • Dodaje obsługę Gradle w wersji 8 lub nowszej. W przypadku starszych wersji pakietu Android IMA SDK należy ustawić android.enableR8.fullMode=false w pliku gradle.properties. Więcej informacji znajdziesz w artykule o trybie pełnym R8.
  • Wersja 3.30.2 pakietu IMA SDK zostanie wycofana 3 sierpnia 2024 r. Więcej informacji znajdziesz w harmonogramie wycofywania.
3.30.1 Wycofano 2023-04-18
  • Ta wersja ma problem z nieoczekiwanymi NullPointerException błędami. Używaj starszej wersji pakietu IMA SDK na Androida 3.29.0 do czasu opublikowania nowszej, działającej wersji.
  • Rozwiązuje problem, który powodował, że aplikacje korzystające z wersji 3.30.0 ulegały awarii na urządzeniach innych niż Android TV.
Wycofano wersję 3.30.0 2023-03-29
3.29.0 2022-10-14
  • Zmienia nazwę klasy EspVersion na VersionInfo.
  • Zmieniono nazwy interfejsów API zaszyfrowanych sygnałów dla wydawców (ESP) na interfejsy API bezpiecznych sygnałów.
  • Dodaje interfejsy API flag funkcji. Za pomocą interfejsów API flagi funkcji możesz włączać i wyłączać określone funkcje w IMA. Użyj ImaSdkSettings.getFeatureFlags() i ImaSdkSettings.setFeatureFlags() , aby pobierać i ustawiać flagi funkcji.
  • Rozwiązuje problem, który powodował, że niektóre zdarzenia IMA nie były wysyłane.
  • Dodaje androidx.webkit:webkit jako zależność pakietu IMA SDK
  • Pakiet IMA SDK w wersji 3.29.0 zostanie wycofany 29 marca 2024 r. Więcej informacji znajdziesz w harmonogramie wycofywania.
3.28.2 2022-09-14
  • Aktualizuje zależności pakietu SDK, aby używać AndroidX.
  • Pakiet IMA SDK w wersji 3.28.2 zostanie wycofany 14 października 2023 r. Więcej informacji znajdziesz w harmonogramie wycofywania.
3.28.1 Wycofane 2022-08-03
3.27.1 2022-05-27
  • Wersja serwisowa, bez nowych funkcji.
  • Pakiet IMA SDK w wersji 3.27.1 zostanie wycofany 3 sierpnia 2023 r. Więcej informacji znajdziesz w harmonogramie wycofywania.
3.27.0 2022-03-01
  • Dodaje obsługę boksów reklam towarzyszących o elastycznych rozmiarach, ustawiając szerokość i wysokość reklamy towarzyszącej na stałą wartość IMA FLUID_SIZE .
  • Pakiet IMA SDK w wersji 3.27.0 zostanie wycofany 27 maja 2023 r. Więcej informacji znajdziesz w harmonogramie wycofywania.
3.26.0 2022-01-12
  • Dodaje interfejsy API zaszyfrowanych sygnałów dla wydawców (ESP) (w pakiecie IMA SDK w wersji 3.29.0 zmieniono ich nazwę na bezpieczne sygnały). Umożliwia to wydawcom włączanie funkcji Network Bidders i platform tożsamości.
  • Wersja 3.26.0 pakietu IMA SDK zostanie wycofana 1 marca 2023 r. Więcej informacji znajdziesz w harmonogramie wycofywania.
3.25.1 2021-11-08
3.24.0 2021-06-03
3.23.0 2021-04-07
  • Dodaje metody ImaSdkSettings.setSessionId() i ImaSdkSettings.getSessionId() do pobierania i ustawiania identyfikatora sesji. Jest to tymczasowy losowy identyfikator używany wyłącznie do ograniczania liczby wyświetleń.
  • Rozwiązuje błąd NullPointerException związany z reklamami towarzyszącymi.
  • Wyłącza JavaScript w reklamach towarzyszących na urządzeniach z Androidem w wersji starszej niż 21, aby rozwiązać problem z lukami w zabezpieczeniach.
  • Pakiet IMA SDK w wersji 3.23.0 zostanie wycofany 3 czerwca 2022 r. Więcej informacji znajdziesz w harmonogramie wycofywania.
3.22.3 2021-03-16
  • Rozwiązuje błąd NullPointerException związany z zwalnianiem AdsLoader podczas wczytywania reklamy.
  • Dodaje błąd 1206 w przypadku UNEXPECTED_ADS_LOADED_EVENT, gdy nieoczekiwanie zostanie wysłane zdarzenie ads loaded (reklamy załadowane).
  • Pakiet IMA SDK w wersji 3.22.3 zostanie wycofany 7 kwietnia 2022 r. Więcej informacji znajdziesz w harmonogramie wycofywania.
3.22.2 2021-02-26
  • Pakiet IMA SDK jest teraz zależny od tych bibliotek:
    • com.google.android.gms:play-services-base
    • com.google.android.gms:play-services-basement
    • androidx.preference:preference
  • Rozwiązuje problem z komunikatem o błędzie, który pojawiał się, gdy AdsLoader otrzymywał błąd bez prawidłowego identyfikatora sesji.
  • Pakiet IMA SDK w wersji 3.22.2 zostanie wycofany 16 marca 2022 r. Więcej informacji znajdziesz w harmonogramie wycofywania.
3.22.0 2021-01-11
  • Dodaje wyświetlanie bloków reklamowych w przypadku strumieni DAI. W przypadku wyświetlania bloków reklamowych Ad Manager odpowiada tylko za wyświetlanie reklam. Wydawcy odpowiadają za treść i tworzenie pliku manifestu, który będzie wskazywać Ad Managera. Użyj ImaSdkFactory.createPodStreamRequest(), aby utworzyć żądanie strumienia do wyświetlania zasobników. Jeśli używasz tej metody, musisz załadować strumień na stronie streamInit().
  • Naprawia wyciek pamięci spowodowany nieprawidłowym czyszczeniem monitora cyklu życia aplikacji.
  • Pakiet IMA SDK w wersji 3.22.0 zostanie wycofany 26 lutego 2022 r. Więcej informacji znajdziesz w harmonogramie wycofywania.
3.21.4 2020-12-09
  • Usuwa nieszkodliwy komunikat ostrzegawczy związany z wywoływaniem funkcji adsLoader.release() po zamknięciu widoku WebView.
  • Pakiet IMA SDK w wersji 3.21.4 zostanie wycofany 8 stycznia 2022 r. Więcej informacji znajdziesz w harmonogramie wycofywania.
3.21.2 2020-11-20
  • Rozwiązuje nieoczekiwane problemy związane z bezpieczeństwem wątków, które były spowodowane wysyłaniem aktualizacji wiadomości z pustej kolejki.
  • Aktualizuje dokumentację AdsLoader.release().
  • Pakiet IMA SDK w wersji 3.21.2 zostanie wycofany 9 grudnia 2021 r. Więcej informacji znajdziesz w harmonogramie wycofywania.
3.21.1 2020-11-17
  • Rozwiązuje problem, który czasami powodował awarie aplikacji podczas wywoływania zdarzeń.
  • Pakiet IMA SDK w wersji 3.21.1 zostanie wycofany 20 listopada 2021 r. Więcej informacji znajdziesz w harmonogramie wycofywania.
3.21.0 2020-10-23
  • Dodaje obsługę reklam SIMID w pakiecie DAI Android SDK.
  • Dodaje metodę AdsLoader.release() i oznacza metodę BaseDisplayContainer.destroy() jako wycofaną. Ta zmiana rozwiązuje problem z wyciekiem pamięci, który występował podczas zwalniania pamięciBaseDisplayContainer w trakcie harmonogramu reklam VMAP. AdsLoader.release() to nowa zalecana metoda usuwania obiektów pakietu IMA SDK zamiast BaseDisplayContainer.destroy().
  • Pakiet IMA SDK w wersji 3.21.0 zostanie wycofany 17 listopada 2021 r. Więcej informacji znajdziesz w harmonogramie wycofywania.
3.20.1 2020-10-12
3.20.0 2020-08-18
  • Wersja 3.20.0 to pierwsza wersja, na którą wpłyną zmiany w zachowaniu IMA podczas wstrzymywania. Jeśli używasz tej lub dowolnej przyszłej wersji pakietu SDK, zalecamy przeczytanie tego posta na blogu i wprowadzenie zmian w zachowaniu wstrzymywania w swojej aplikacji. Wydawcy mogą przetestować wdrożenie tych zmian za pomocą tagu reklamy testowej.
  • Dodaje wywołania zwrotne onPause() i onResume() dla klasy DAI VideoStreamPlayer.
  • Dodaje metodę adPeriodDuration() do klasy AdProgressInfo.
  • Dodaje obsługę obrazów zastępczych kliknięcia ikony na urządzeniach z Androidem TV.
  • Dodaje zdarzenie ICON_FALLBACK_IMAGE_CLOSED, które ma być obsługiwane, gdy na urządzeniach z Androidem TV zostanie zamknięty obraz zastępczy ikony.
  • Usuwa przestarzałą metodę focusSkipButton() z AdsManager na rzecz metody focus().
  • W przypadku urządzeń CTV reklamy są teraz automatycznie ustawiane jako aktywne, gdy zostanie uruchomione zdarzenie AdEvent.AdEventType STARTED. Aby wyłączyć automatyczne ustawianie ostrości w przypadku reklam, użyj metody adsRenderingSettings.setFocusSkipButtonWhenAvailable(false), a potem metody focus() zgodnie z niestandardowymi wymaganiami.
  • Dodaje do klasy VideoProgressUpdate() metody getCurrentTimeMs() i getDurationMs.
  • Wycofuje metody getCurrentTime i getDuration na rzecz nowych metod getCurrentTimeMs i getDurationMs.
  • Rozwiązuje problem z transmisjami na żywo DASH, w przypadku których zdarzenia reklamowe nie były prawidłowo raportowane.
  • Pakiet IMA SDK w wersji 3.20.0 zostanie wycofany 12 października 2021 r. Więcej informacji znajdziesz w harmonogramie wycofywania.
3.19.4 2020-07-08
  • Rozwiązaliśmy problem, który uniemożliwiał prawidłowe aktualizowanie limitu czasu oczekiwania przez setLoadVideoTimeout.
  • 18 sierpnia 2021 r. wycofamy pakiet IMA SDK w wersji 3.19.4. Więcej informacji znajdziesz w harmonogramie wycofywania.
3.19.3 2020-06-29
  • Rozwiązuje problem z integracją z zasadami IAB dotyczącymi przejrzystości i uzyskiwania zgody na przetwarzanie danych w ramach RODO, który powodował awarie odtwarzaczy zintegrowanych z pakietami SDK platform do zarządzania zgodą użytkowników.
  • Pakiet IMA SDK w wersji 3.19.3 zostanie wycofany 8 lipca 2021 r. Więcej informacji znajdziesz w harmonogramie wycofywania.
3.19.2 2020-06-22
3.19.0 2020-05-12
3.18.1 2020-03-25
  • Dodaje skalowanie reklam towarzyszących na urządzeniach o dużej gęstości pikseli.
  • Dodaje obsługę reklam SIMID po stronie klienta.
  • 12 maja 2021 r. wycofamy pakiet IMA SDK w wersji 3.18.1. Więcej informacji znajdziesz w harmonogramie wycofywania.
3.18.0 2020-03-04
  • Dodaje metody pause() i resume() do interfejsu VideoStreamPlayer. Muszą być one zaimplementowane w przypadku wersji 3.18.0 i nowszych.
  • 25 marca 2021 r. wycofamy pakiet IMA SDK w wersji 3.18.0. Więcej informacji znajdziesz w harmonogramie wycofywania.
3.17.0 2020-02-07
3.16.5 2020-01-22
  • Poprawiono obsługę parametru contentUrl w przypadku OMID 1.3 z wartościami AdsRequest.setContentUrl i  StreamRequest.setContentUrl .
  • Poprawki obsługi przyjaznych dla OMID 1.3 przeszkód z  FriendlyObstruction .
  • Wycofuje metody BaseDisplayContainer.registerVideoControlsOverlay i BaseDisplayContainer.unregisterAllVideoControlsOverlay na rzecz metody FriendlyObstruction .
  • Rozwiązuje problem z występowaniem znaku NullPointerException po wywołaniu funkcji clear() na urządzeniu CompanionAdSlots.
  • Rozwiązuje problem, który potencjalnie powodował wycieki pamięci podczas wywoływania funkcji destroy() w trakcie odtwarzania reklam.
  • Pakiet IMA SDK w wersji 3.16.5 zostanie wycofany 7 lutego 2021 r. Więcej informacji znajdziesz w harmonogramie wycofywania.
3.16.2 2019-12-05
  • Dodaje obsługę automatycznego uwzględniania parametrów zgody z zasad TCF IAB w wersji 2 i CCPA.
  • Korzystanie z ustawień Androida wymaga teraz pakietu androidx.
  • Pakiet IMA SDK w wersji 3.16.2 zostanie wycofany 22 stycznia 2021 r. Więcej informacji znajdziesz w harmonogramie wycofywania.
3.16.1 2019-11-08
3.16.0 2019-10-23
  • Dodaje metodę replaceAdTagParameters do interfejsu StreamManager, która umożliwia zastąpienie wszystkich parametrów tagu reklamy podczas transmisji na żywo.
  • Usuwa obsługę tych wycofanych metod:
    • AdsRequest.getAdDisplayContainer()
    • AdsRequest.setAdDisplayContainer(AdDisplayContainer adDisplayContainer)
    • ImaSdkFactory.createAdsLoader(Context context)
    • ImaSdkFactory.createAdsLoader(Context context, ImaSdkSettings settings)
    • ImaSdkFactory.createLiveStreamRequest(String assetKey, String apiKey, StreamDisplayContainer streamDisplayContainer)
    • ImaSdkFactory.createVodStreamRequest(String contentSourceId, String videoId, String apiKey, StreamDisplayContainer streamDisplayContainer)
    • StreamRequest.getStreamDisplayContainer()
  • Pakiet IMA SDK w wersji 3.16.0 zostanie wycofany 8 listopada 2020 r. Więcej informacji znajdziesz w harmonogramie wycofywania.
3.14.0 2019-09-11
  • Wersja serwisowa, bez nowych funkcji.
  • Pakiet IMA SDK w wersji 3.14.0 zostanie wycofany 23 października 2020 r. Więcej informacji znajdziesz w harmonogramie wycofywania.
3.13.1 2019-09-03
  • Dodaje możliwość ustawienia kontekstu ciągłego odtwarzania w przypadku żądania reklamy. Więcej informacji znajdziesz w setContinuousPlayback().
  • Dodaje do klasy Ad metodę getUniversalAdIds().
  • Dodaje wywołania setAuthToken, getAuthToken, setFormat, getFormat i wyliczenie StreamFormat.
  • Rozwiązuje błąd na urządzeniach Nexus 5, który występuje, gdy kontener zostanie usunięty przed otrzymaniem odpowiedzi reklamy.
  • Rozwiązaliśmy problem, w którym reklamy towarzyszące były renderowane tylko raz.
  • Rozwiązaliśmy problem, który powodował, że nieobsługiwane typy reklam (reklamy nieliniowe, VPAID) nie były prawidłowo odrzucane.
  • Wersja 3.13.1 pakietu IMA SDK zostanie wycofana 11 września 2020 r. Więcej informacji znajdziesz w harmonogramie wycofywania.
3.11.3 2019-06-11
  • Naprawia błąd ustawienia is_lat na urządzeniach z AOSP.
  • Pakiet IMA SDK w wersji 3.11.3 zostanie wycofany 3 września 2020 r. Więcej informacji znajdziesz w harmonogramie wycofywania.
3.11.2 2019-04-16
  • Naprawia ten błąd:java.lang.ClassNotFoundException: Didn't find class "j$.util.concurrent.ConcurrentHashMap"
  • Wersja 3.11.0 pakietu IMA SDK zostanie wycofana 11 czerwca 2020 r. Więcej informacji znajdziesz w harmonogramie wycofywania.
Wycofano w wersji 3.11.0 2019-03-22
3.10.9 2019-03-13
  • Naprawiliśmy błąd związany z wyścigiem, który powodował, że interfejs reklam czasami nie renderował się w przypadku kolejnych reklam po pominięciu pierwszej reklamy.
  • Rozwiązaliśmy problem z awarią, która występowała podczas wywoływania interfejsu API getCompanionAds().
  • Pakiet IMA SDK w wersji 3.10.7 zostanie wycofany 22 marca 2020 r. Więcej informacji znajdziesz w harmonogramie wycofywania.
3.10.7 2019-02-19
3.10.6 2019-01-23
  • Dodaje metodę seek() do interfejsu odtwarzacza strumieniowego.
  • Dodano obsługę wywołań zwrotnych zdarzeń reklam AD_BUFFERING.
  • Kontenery nie mogą już być przekazywane w żądaniu reklamy. Nowy przepływ pracy wymaga przekazania kontenera przez konstruktor AdsLoader.
  • Dodaje metodę BaseDisplayContainer.destroy().
  • Naprawia wyciek pamięci, który występował po zakończeniu odtwarzania filmu.
  • Wycofuje requestNextAdBreak. Ten interfejs API zostanie usunięty w przyszłej wersji. Następnie reklamy będą automatycznie pobierane 4 sekundy przed czasem przerwy na reklamę.
  • Pakiet IMA SDK w wersji 3.10.2 zostanie wycofany 19 lutego 2020 r. Więcej informacji znajdziesz w harmonogramie wycofywania.
3.10.2 2018-11-13
  • Rozwiązuje problem z wyścigiem, który powoduje, że druga reklama w bloku reklamowym zgłasza błąd VAST 402.
  • Dodaje do pakietu SDK DAI na Androida ograniczenie liczby wyświetleń i wykluczenia konkurencji.
  • Przenosi element getAdProgressInfo() z StreamManager do BaseManager.
  • Dodaje użytkowników getVastMediaHeight(), getVastMediaWidth() i getVastMediaBitrate() do albumu Ad.
  • Pakiet IMA SDK w wersji 3.9.4 zostanie wycofany 23 stycznia 2020 r. Więcej informacji znajdziesz w harmonogramie wycofywania.
3.9.4 2018-08-01
  • Dodaje getCompanionAds() do Ad. Zwraca reklamy towarzyszące tylko podczas korzystania z dynamicznego wstawiania reklam.
  • Dodaje nową klasę CompanionAd.
  • Dodaje nowe zdarzenie SKIPPABLE_STATE_CHANGED do AdEvent.
  • Rozwiązanie problemu polegającego na tym, że w niektórych przypadkach nie było uwzględniane ustawienie domyślne dla focusSkipButtonWhenAvailable.
  • Pakiet IMA SDK w wersji 3.9.0 zostanie wycofany 1 sierpnia 2019 r. Więcej informacji znajdziesz w harmonogramie wycofywania.
3.9.0 2018-07-09
  • Android TV jest teraz obsługiwany.
  • Dodaje focusSkipButton() do AdsManager. Działa to tylko na Androidzie TV.
  • Dodaje getFocusSkipButtonWhenAvailable() do AdsRenderingSettings, domyślnie true. Działa to tylko na Androidzie TV.
  • Dodaje setFocusSkipButtonWhenAvailable() do AdsRenderingSettings. Działa to tylko na Androidzie TV.
  • VideoAdPlayer rozszerza teraz interfejs VolumeProvider. Wdrożenie tego interfejsu jest teraz wymagane w przypadku odtwarzania niestandardowego.
  • 9 lipca 2019 r. wycofamy pakiet IMA SDK w wersji 3.8.7. Więcej informacji znajdziesz w harmonogramie wycofywania.
3.8.7 2018-05-23
  • Umożliwia animację w reklamach towarzyszących HTML.
  • 23 maja 2019 r. wycofamy pakiet IMA SDK w wersji 3.8.5. Więcej informacji znajdziesz w harmonogramie wycofywania.
3.8.5 2018-04-09
  • Rozwiązuje problem z ignorowaniem znaku ImaSdkSettings.
  • Rozwiązuje problem, który powodował konflikty kompilacji z plikami wersji com.android.support.
  • Dodaje setAdWillPlayMuted do AdsRequest.
  • Dodaje setLoadVideoTimeout do AdsRenderingSettings.
  • Pakiet IMA SDK w wersji 3.8.2 zostanie wycofany 9 kwietnia 2019 r. Więcej informacji znajdziesz w harmonogramie wycofywania.
3.8.2 2018-01-24
  • Dodaje setLiveStreamPrefetchSeconds do AdsRequest.
  • Różne poprawki w dokumentacji.
  • 24 stycznia 2019 r. wycofamy pakiet IMA SDK w wersji 3.7.4. Więcej informacji znajdziesz w harmonogramie wycofywania.
3.7.4 2017-06-29
  • Dodaje setVastLoadTimeout do AdsRequest.
  • Dodaje getSkipTimeOffset do Ad.
  • Pakiet IMA SDK w wersji 3.7.2 zostanie wycofany 29 czerwca 2018 r. Więcej informacji znajdziesz w harmonogramie wycofywania.
3.7.2 2017-05-25
  • Dodaje setDebugMode do ImaSdkSettings.
  • 25 maja 2018 r. wycofamy pakiet IMA SDK w wersji 3.7.1. Więcej informacji znajdziesz w harmonogramie wycofywania.
3.7.1 2017-03-24
  • Rozwiązuje konflikt przestrzeni nazw podczas korzystania z Proguard.
  • Rozmiar pliku JAR został zmniejszony o około 30 KB.
  • Pakiet IMA SDK w wersji 3.7.0 zostanie wycofany 24 marca 2018 r. Więcej informacji znajdziesz w harmonogramie wycofywania.
3.7.0 2017-03-13
  • Rozwiązuje problem, który powodował, że niektóre klasy IMA były nieumyślnie scalane z pakietem a.a.a.a ProGuard.
  • Wersja 3.6.0 pakietu IMA SDK zostanie wycofana 13 marca 2018 r. Więcej informacji znajdziesz w harmonogramie wycofywania.
3.6.0 2017-02-16
  • Dodaje do pokoju „Ad” te elementy:
    • getAdWrapperCreativeIds()
    • getAdvertiserName()
    • getCreativeAdId()
    • getCreativeId()
    • getDealId()
    • getSurveyUrl()
    • getUniversalAdIdRegistry()
    • getUniversalAdIdValue()
  • Dodaje AdsManager.requestNextAdBreak().
  • Dodaje do pokoju „AdsRenderingSettings” te elementy:
    • setEnablePreloading()
    • getEnablePreloading()
  • Dodaje do pokoju „AdsRequest” te elementy:
    • setContentDuration()
    • setContentKeywords()
    • setContentTitle()
  • Pakiet IMA SDK w wersji 3.5.2 zostanie wycofany 16 lutego 2018 r. Więcej informacji znajdziesz w harmonogramie wycofywania.
3.5.2 2016-11-14
  • Dodaje odtwarzacz wideo należący do pakietu SDK, który opcjonalnie obsługuje odtwarzanie reklam.
  • Dodaje CompanionAdSlot.ClickListener oraz metody dodawania i usuwania słuchacza.
  • Rozwiązuje problem z nieprawidłowymi dziennikami błędów getViewability().
  • Rozwiązuje problem z zachowaniem ikon po kliknięciu i nieprawidłowym renderowaniem.
  • Wersja 3.4.0 pakietu IMA SDK zostanie wycofana 14 listopada 2017 r. Więcej informacji znajdziesz w harmonogramie wycofywania.
3.4.0 2016-09-12
  • Rozwiązuje błąd dotyczący zduplikowanych plików podczas korzystania z Usług Google Play w wersji 9.0.0 lub nowszej.
3.3.2 2016-07-11
3.3.0 2016-05-31
3.2.1 2016-04-07
  • Wersja serwisowa, bez nowych funkcji.
3.1.3 2015-12-16
3.b13.3 (beta) 2015-09-10
  • Wersja serwisowa, bez nowych funkcji.
3.b12.1 (beta) 2015-07-20
3.b11.4 (beta) 2015-05-21
  • Dodaje do interfejsu API te elementy:
    • AdError.AdErrorCode.VAST_EMPTY_RESPONSE
    • AdError.getErrorNumber()
    • AdsRequest.setAdWillAutoPlay(Boolean)
    • CompanionAdSlot.isFilled()
    • ImaSdkSettings.setPlayerType(String)
    • ImaSdkSettings.setPlayerVersion(String)
3.b10.3 (beta) 2015-03-24
  • Dodano: ImaSdkSettings.getMaxRedirects i ImaSdkSettings.setMaxRedirects.
  • Klasy interfejsu IMA API są teraz final.
  • Numery wersji pakietu SDK mają teraz format 3.bX.Y, gdzie b oznacza wersję beta pakietu SDK.
  • Usunęliśmy te wartości AdError.AdErrorCode:
    • API_ERROR – zamiast tego użyj UNKNOWN_AD_RESPONSE.
    • PLAYLIST_MALFORMED_RESPONSE – zamiast tego użyj UNKNOWN_AD_RESPONSE.
    • REQUIRED_LISTENERS_NOT_ADDED – nie była zgłaszana przez pakiet SDK.
    • VAST_INVALID_URL – zamiast tego użyj VAST_LOAD_TIMEOUT.
Beta v9 2014-10-17
  • Dodaje interfejsy API reklam getTitle, getDescription i getContentType.
  • Dodaje do interfejsu reklamy informacje o pozycji w bloku reklamowym, np. „Reklama 1 z 4: (0:13)”.
  • Nie powinieneś już bezpośrednio sterować wstrzymywaniem, odtwarzaniem i wznawianiem reklam za pomocą odtwarzacza wideo. Zamiast tego użyj AdsManager.pause() i AdsManager.resume().
Beta v8 2014-06-12
  • Rozwiązuje problem z interfejsem reklam, który nie znika w przypadku reklam możliwych do pominięcia.
  • Dokumentuje kod błędu związany z przekroczeniem limitu czasu wczytywania pliku multimedialnego.
Beta v7 2014-05-27
Beta v6 2014-04-14
  • Dodaje obsługę VAST 3.
  • Dodaje częściową obsługę VMAP (równoważną obecnym regułom reklam w usłudze Ad Manager).
  • Dodaje do interfejsu API te elementy:
    • AdError.AdErrorCode.ADS_REQUEST_NETWORK_ERROR
    • AdEvent.AdEventType.LOG
    • AdEvent.getAdData()
    • AdPodInfo.getMaximumDuration()
    • AdPodInfo.getPodIndex()
    • AdPodInfo.getTimeOffset()
  • Naprawiono błąd, w którym reklamy w trakcie filmu w zoptymalizowanym bloku reklamowym z elementem opakowującym powodowały pomijanie wszystkich innych reklam w bloku.
  • Obiekt AdsRenderingSettings przekazywany do obiektu AdsManager nie będzie już ignorowany.
  • Usunęliśmy kilka błędów, aby zwiększyć stabilność.
Beta v5 2013-12-12
  • Rozwiązuje problem z reklamami, które można pominąć, na playlistach.
Beta v4 2013-10-15
  • Dodaliśmy możliwość resetowania wartości korelatora przez wywołanie metody contentComplete w obiekcie AdsLoader.
Beta v3 2013-09-05
  • Wersja serwisowa, bez nowych funkcji.
Beta v2 2013-07-07
  • Publiczna wersja beta pakietu SDK.
Zamknięte testy beta w wersji 2 2013-06-24
  • Dodano interfejs API do ustawiania języka interfejsu na obiekcie ImaSdkSettings. Pamiętaj, że to ustawienie służy do określania języka interfejsu, a nie języka reklamy.
  • Naprawiliśmy konflikt, który występował, gdy aplikacja zawierała biblioteki pakietów IMA SDK i AdMob SDK.
  • Dodaliśmy rejestrowanie różnych wewnętrznych danych o skuteczności.
Zamknięte testy beta w wersji 1 2013-04-02

  • Pierwsza wersja beta. W wersji beta występują te znane problemy:

    Związane z pakietem SDK

    Te AdEvents dostępne w pakiecie HTML5 IMA SDK nie są obsługiwane w pakiecie Android v3 IMA SDK:IMPRESSION,LOG,SKIPPABLE_STATE_CHANGED,STOPPED,VOLUME_CHANGED,VOLUME_MUTED

    Przykładowa aplikacja

    1. Występuje sporadyczny problem polegający na tym, że odtwarzacz reklam nie wznawia prawidłowo odtwarzania po kliknięciu reklamy przez użytkownika. Na przykład czasami, gdy po kliknięciu reklamy wrócisz do aplikacji, wznowienie odtwarzania tej reklamy spowoduje, że zostanie ona pominięta do końca i zakończona, zamiast wznowić odtwarzanie w miejscu, w którym została przerwana przed kliknięciem.
    2. Reklamy zwracane przez tag reklamy „Instream 2” są niezgodne z pakietem IMA Android SDK w wersji 3.
    3. Przykładowy odtwarzacz nie wyłącza automatycznie przewijania podczas odtwarzania reklam. Pamiętaj, aby wyłączyć przewijanie w odtwarzaczu wideo podczas wyświetlania reklam.