Sprawdzanie obsługi i zgodności pakietu SDK

Wybierz platformę: HTML5 Android iOS tvOS Cast Roku

Ta strona zawiera ogólne informacje o obsłudze i zgodności IMA DAI w przypadku przeglądarek, formatów wideo i platform.

Obsługiwane formaty wideo i przeglądarki

HTML5 to wciąż nowy i rozwijający się standard. W rezultacie obsługa różnych funkcji różni się w zależności od przeglądarki i nie ma jednego domyślnego formatu wideo obsługiwanego przez wszystkie główne przeglądarki. Trzy główne formaty wideo używane w większości przeglądarek to H.264, HLS i Dash.

Zgodność ze zdarzeniami VAST

W tej sekcji znajdziesz listę zdarzeń VAST, które są automatycznie zgłaszane na serwer na podstawie informacji zwracanych w odpowiedzi VAST.

Pełna obsługa

complete, creativeView, firstQuartile, impression, midpoint, pause, resume, rewind (wywoływane, gdy nastąpi znaczące przewijanie do tyłu), start, thirdQuartile.

Częściowo obsługiwane

• click

  Zdarzenie Click jest wysyłane tylko w przypadku reklam wideo. Kliknięcia nie są rejestrowane w natywnych odtwarzaczach pełnoekranowych na urządzeniach z Androidem, iOS lub na komputerach, ale mogą być rejestrowane przez element śledzenia kliknięć na stronie po zamknięciu filmu. Jeśli jednak element wideo korzysta z natywnych elementów sterujących na iPadzie, kliknięcia nie mogą być rejestrowane.

• fullscreen
  

  Pakiet IMA obsługuje symulowany tryb pełnoekranowy, w którym film zajmuje całe okno przeglądarki. IMA uznaje, że film jest w trybie pełnoekranowym, gdy jego offsetWidth i offsetHeight są co najmniej tak duże jak treść dokumentu. Ten tryb jest obsługiwany we wszystkich przeglądarkach.

  Na iPhonie i platformach Android w wersji starszej niż 3.0 film zawsze jest odtwarzany w trybie pełnoekranowym.

• mute, unmute

  Tylko urządzenia z systemem iOS i Android mają natywną kontrolę głośności. W związku z tym pakiet IMA nie może określić głośności ani stanu wyciszenia, a pakiet SDK nie jest powiadamiany o zmianach. Poniżej znajdziesz listę wersji przeglądarek, które obsługują mute, unmute i które nie obsługują tych funkcji:

  • Obsługiwane: Firefox 3.5+, Chrome 8+, Safari 4+
  • Nieobsługiwane: iOS, Android

Więcej informacji o wyświetlaniu reklam VAST znajdziesz w wytycznych IAB.

Zdarzenia związane z reklamami podczas ponownego oglądania przerw na reklamy

Pakiet IMA nie wywołuje zdarzeń reklamowych podczas ponownego oglądania reklam z tych powodów:

• Adresy URL zdarzeń powinny być aktywowane tylko raz, w przeciwnym razie może to zostać odczytane jako spam.
• Dzięki temu użytkownicy mogą przewijać reklamy, które już widzieli, co zwiększa komfort korzystania z tej funkcji.

Podczas ponownego oglądania bloków reklamowych wywoływane są tylko te zdarzenia:

• AD_PERIOD_STARTED
• AD_PERIOD_ENDED

Obsługiwane platformy odtwarzaczy wideo

Pakiety Google IMA SDK są obsługiwane na tych platformach:

Platforma	Wersja
HTML5.	Komputery: Chrome, Firefox, Safari, Edge, Opera Urządzenia mobilne: Chrome/przeglądarka Androida (Android na telefony i tablety), Safari i Chrome (iOS)
iOS	iOS 10.0 lub nowszy
Android	Android 4.4+
Google Cast	Wszystkie urządzenia przesyłające
tvOS	tvOS 15 lub nowszy
Roku	Wszystkie urządzenia, które nadal otrzymują aktualizacje oprogramowania od Roku

Obsługa formatu strumienia wideo

Pakiet IMA SDK obsługuje zarówno HLS, jak i DASH. W tej tabeli znajdziesz informacje o obsłudze poszczególnych platform pakietu SDK. Aby strumień był odtwarzany prawidłowo, odtwarzacz wideo musi obsługiwać używany typ strumienia.

Platforma IMA SDK	HLS	DASH
HTML5.
iOS
Android
Google Cast
tvOS
Roku

Funkcje wideo i wersje pakietu SDK

Więcej informacji o tych funkcjach znajdziesz w omówieniu reklam wideo.

IAB Video Suite	Pomoc
VAST 4	1
VAST 3	2
VAST 2
VPAID 2
VMAP 1.0.1	3
Funkcje Ad Managera Video	Pomoc
Reklamy linearne
Reklamy nielinearne (nakładki)
Elementy towarzyszące	4
Alternatywne zasoby reklam towarzyszących VAST 3
Widoczność w Widoku aktywnym
Przekierowania VAST
Wypełnianie miejsca reklamą towarzyszącą z żądaniem reklamy displayowej
Zgodność z tagiem wydawcy Google (GPT)
Świadomość treści
Reguły reklam
Podding
Bumpery
Raportowanie śledzenia wielu zdarzeń (MET)
Możliwa do pominięcia (rezerwacja / reklama inna niż TrueView)	5
Funkcje AdSense dla wideo 7	Pomoc
TrueView InStream	6
In-Stream Select
Standardowa In-Stream
Pełny przedział
Elementy towarzyszące	4
Uzupełnianie reklam towarzyszących
Nakładki
Funkcje Ad Exchange w usłudze Ad Manager	Pomoc
TrueView InStream	6
In-Stream Select
Standardowa In-Stream
Pełny przedział
Elementy towarzyszące	4
Uzupełnianie reklam towarzyszących
Nakładki
Widoczność w Widoku aktywnym
Dlaczego ta reklama?	8

¹ Z funkcji VAST 4 obsługiwanych przez Google Ad Managera IMA obsługuje te funkcje:

• VAST 4.2
  • Obsługa Secure Interactive Media Interface Definition (SIMID)
  • Zezwolenie na wiele węzłów UniversalAdID
• VAST 4.0
  • AdID
  • Plik mezzanine
  • Nowe kody błędów VAST
  • Nowe makra VAST
  • AdVerifications – pomoc

² Te funkcje VAST 3.0 nie są jeszcze obsługiwane:

• Urządzenie towarzyszące adSlotId
• Opcje wyświetlania elementu towarzyszącego
• Ikony

³ Te funkcje VMAP nie są jeszcze obsługiwane:

• Zdarzenia śledzenia specyficzne dla VMAP
• Kody błędów dotyczące VMAP
• Nakładki reklamowe
• Przesunięcia czasowe inne niż hh:mm:ss lub „start” i „end”
• Atrybut wyświetlania breakType
• repeatAfter atrybut

⁴ Obsługiwane są tylko kreacje towarzyszące w formie obrazu. Reklamy towarzyszące w formie obrazu wymagają niestandardowego wdrożenia w celu wypełniania reklam. Reklamy towarzyszące nie są obsługiwane w tvOS.

⁵ Tradycyjne reklamy możliwe do pominięcia są obsługiwane tylko w pakietach IMA DAI SDK na HTML5, iOS, tvOS, Roku i Androida (w tym Androida TV). W przypadku pakietu Cast SDK musisz zadeklarować możliwość pomijania za pomocą kodu StreamRequest.senderCanSkip, aby obsługiwać tradycyjne reklamy, które można pominąć.

⁶ Reklamy TrueView możliwe do pominięcia są obsługiwane w pakietach IMA DAI SDK na HTML5, iOS, tvOS, Roku i Androida (w tym Androida TV).

⁷ Funkcje AdSense nie są obsługiwane w pakiecie Cast SDK.

⁸ Dlaczego ta reklama? wymaga, aby podczas tworzenia StreamManager przekazywany był parametr adUiElement. Funkcja Dlaczego ta reklama? nie jest obsługiwana w pakiecie Cast SDK.

Ważne: korzystanie z pakietu IMA DAI SDK dla HTML5 w przypadku reklam możliwych do pominięcia lub funkcji Dlaczego ta reklama? wymaga przekazywania parametru adUiElement podczas tworzenia obiektu StreamManager.

Ograniczenia dotyczące platform JavaScript

W przypadku korzystania z platformy JavaScript, takiej jak React lub AngularJS, z pakietem IMA HTML5 SDK należy wziąć pod uwagę pewne kwestie. Te platformy często przenoszą elementy DOM, co może powodować nieprawidłowe działanie pakietu IMA SDK, ponieważ oczekuje on, że DOM będzie statyczny w momencie inicjowania. Pakiet IMA SDK obsługuje platformy JavaScript, jeśli zostanie zainicjowany po zakończeniu przenoszenia elementów DOM przez platformę. W szczególności element HTML5 przekazywany jako argument adUiElement podczas tworzenia instancji StreamManager nie powinien być przenoszony po utworzeniu instancji.