Sprawdzanie obsługi i zgodności pakietu SDK

Na tej stronie znajdziesz ogólne informacje o obsłudze i zgodności IMA DAI z przeglądarkami, formatami wideo i platformami.

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ępuje 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 mogą być rejestrowane w natywnych odtwarzaczach pełnoekranowych na urządzeniach z Androidem, iOS lub komputerach, ale mogą być rejestrowane przez element śledzenia kliknięć na stronie po zamknięciu filmu. Jeśli jednak element wideo używa 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 przez wszystkie przeglądarki.

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

• mute, unmute

  Tylko urządzenia z iOS i Androidem 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 otrzymuje powiadomień o zmianach. Poniżej znajdziesz listę wersji przeglądarek, które obsługują mute i unmute:

  • 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ń reklamy 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 przerw na reklamy 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 Android (Android na telefony i tablety), Safari i Chrome (iOS)
iOS	iOS 10.0 lub nowszy
Android	Android 4.4 lub nowszy
Google Cast	Wszystkie urządzenia przesyłające
tvOS	tvOS 14 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 wideo w usłudze Ad Manager	Pomoc
Reklamy linearne
Reklamy nielinearne (nakładki)
Elementy towarzyszące	4
Alternatywne zasoby reklamy towarzyszącej VAST 3
Widoczność w Widoku aktywnym
Przekierowania VAST
Wypełnianie reklamą towarzyszącą za pomocą żądania reklamy displayowej
Zgodność z tagiem wydawcy Google (GPT)
Świadomość treści
Reguły reklam
Blok reklam
Bumpery
Raportowanie śledzenia wielu zdarzeń (MET)
Możliwe do pominięcia (rezerwacja / inne niż TrueView)	5
Funkcje AdSense dla wideo 7	Pomoc
TrueView InStream	6
In-Stream Select
Standardowa reklama In-Stream
Pełny przedział
Elementy towarzyszące	4
Uzupełnianie banerów towarzyszących
Nakładki
Funkcje Ad Exchange w usłudze Ad Manager	Pomoc
TrueView InStream	6
In-Stream Select
Standardowa reklama In-Stream
Pełny przedział
Elementy towarzyszące	4
Uzupełnianie banerów towarzyszących
Nakładki
Widoczność w Widoku aktywnym
Dlaczego ta reklama?	8

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

• VAST 4.2
  • Obsługa standardu 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:

• Element towarzyszący adSlotId
• Opcje wyświetlania kreacji towarzyszących
• Ikony

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

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

⁴ Obsługiwane są tylko banery graficzne. Reklamy towarzyszące w formie obrazu wymagają niestandardowej implementacji w celu wypełniania reklam. Reklamy towarzyszące nie są obsługiwane w systemie tvOS.

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

⁶ Reklamy TrueView możliwe do pominięcia są obsługiwane tylko w pakietach IMA DAI SDK dla HTML5, iOS 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.

Ostrzeżenia 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, o ile zostanie zainicjowany po zakończeniu przenoszenia elementów DOM przez platformę. W szczególności element HTML5 przekazany jako argument adUiElement podczas tworzenia obiektu StreamManager nie powinien być przenoszony po utworzeniu instancji.

Obsługa Apple AirPlay

Pakiet IMA SDK nie obsługuje Apple AirPlay. Wyłącz AirPlay lub wyłącz żądania reklam, gdy wykryjesz AirPlay.