Na tej stronie znajdziesz ogólne informacje o obsłudze HTML5 IMA po stronie klienta oraz zgodności z przeglądarkami, formatami wideo i platformami.
Obsługiwane formaty wideo i przeglądarki
Obsługa różnych funkcji różni się w zależności od przeglądarki, a nie ma jednego domyślnego formatu wideo obsługiwanego przez wszystkie popularne przeglądarki. Trzy główne formaty wideo używane w większości przeglądarek to H.264, WebM i Ogg Theora.
Obsługiwane odtwarzacze wideo
Większość funkcji IMA jest obsługiwana przez typowe odtwarzacze wideo HTML5, m.in. tag HTML <video>
. Listę znanych odtwarzaczy wideo obsługujących pakiet IMA SDK znajdziesz na stronie Programu partnerskiego ds. technologii wideo.
Zgodność zdarzeń VAST
W tej sekcji wymienione są zdarzenia VAST, które są automatycznie zgłaszane do serwera na podstawie informacji zwróconych w odpowiedzi VAST.
W pełni obsługiwane
complete
, creativeView
,
firstQuartile
, impression
, midpoint
,
pause
, resume
, rewind
(uruchomione, gdy występuje duże przewijanie w kierunku do tyłu), start
,
thirdQuartile
.
Częściowo obsługiwane
click
Zdarzenie
Click
jest wysyłane tylko w przypadku reklam wideo. Kliknięć nie można rejestrować w natywnych odtwarzaczach pełnoekranowych na urządzeniach z Androidem, iOS ani na komputerach, ale kliknięcia 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 są rejestrowane.fullscreen
Pakiet IMA SDK obsługuje symulowany tryb pełnoekranowy, w którym film zajmuje całe okno przeglądarki. Film jest uznawany za tryb pełnoekranowy, gdy jego pola
offsetWidth
ioffsetHeight
mają rozmiar co najmniej taki sam jak treść dokumentu. Ten tryb jest obsługiwany we wszystkich przeglądarkach. Jeśli chcesz zobaczyć przykład symulowanego pełnego ekranu, pobierz przykład.Na telefonach iPhone i urządzeniach z Androidem starszych niż 3.0 filmy zawsze będą odtwarzane w trybie pełnoekranowym.
mute
,unmute
iOS i Android mają tylko bezpośrednią kontrolę nad głośnością. Dlatego pakiet IMA SDK nie może określić stanu głośności ani wyciszenia, a my nie otrzymujemy powiadomień o zmianach. Poniżej znajdziesz listę wersji przeglądarek, które obsługują oraz nie obsługują
mute
,unmute
:- Obsługiwane: Firefox 3.5 i nowsze, Chrome 8 i nowsze, Safari 4 i nowsze
- Nieobsługiwane: iOS, Android
Więcej informacji o wyświetlaniu reklam VAST znajdziesz w wytycznych IAB.
Zastrzeżenia dotyczące platform JavaScript
W przypadku korzystania z pakietu SDK IMA HTML5 z wykorzystaniem platformy JavaScript, takiej jak React czy AngularJS, trzeba wziąć pod uwagę pewne kwestie. Platformy te często przenoszą elementy DOM, co może zakłócać działanie IMA, ponieważ IMA oczekuje, że DOM po zainicjowaniu pakietu SDK będzie statyczny. IMA obsługuje platformy JavaScript, o ile pakiet IMA jest inicjowany po zakończeniu przenoszenia elementów DOM przez platformę. W szczególności nie należy przenosić elementu HTML5 przekazanego jako argument containerElement podczas tworzenia instancji AdDisplayContainer
.
Obsługa Apple AirPlay
Pakiet IMA SDK obecnie nie obsługuje Apple AirPlay. Wyłącz AirPlay lub wyłącz żądania reklam w przypadku wykrycia AirPlay.
Obsługiwane platformy odtwarzaczy wideo
Pakiety Google IMA SDK są obsługiwane na tych platformach:
Platform | Wersja | Typ reklamy |
---|---|---|
HTML5 | Komputery: Chrome, Firefox, Safari, Edge, Opera Urządzenia mobilne: przeglądarka Chrome/Android (telefony i tablety) oraz Safari i Chrome (iOS) |
Reklamy linearne, nielinearne i towarzyszące, Ad Manager Video Solutions, reklamy wideo Ad Exchange i AFV |
iOS | iOS 10.0 lub nowszy | Reklamy linearne i towarzyszące, reklamy wideo Ad Managera, wideo Ad Exchange i AFV |
Android, | Androida 4.4 lub nowszego, | Reklamy linearne i towarzyszące, reklamy wideo Ad Managera, wideo Ad Exchange i AFV |
tvOS | tvOS w wersji 14 lub nowszej, | Reklamy linearne, wideo Ad Managera i wideo Ad Exchange |
Funkcje wideo i wersje pakietu SDK
Aby dowiedzieć się więcej o poniższych funkcjach, przeczytaj omówienie reklam wideo.
HTML5 wersja 3 | iOS v3 | Android v3 | tvOS | |
---|---|---|---|---|
Pakiet IAB Video Suite | ||||
VAST 4 | 9 | 9 | 9 | 9 |
VAST 3 | 1 | 1 | 1 | |
VAST 2 | ||||
SIMID 1.0 | ||||
VPAID 2 (HTML5) | ||||
VMAP 1.0.1 | 2 3 | 2 | 2 | 2 |
OM SDK 1.3 | ||||
Funkcje wideo Ad Managera | ||||
Reklamy linearne | ||||
Zasoby hostowane w YouTube | 4 | |||
Reklamy nielinearne (nakładki) | 5 | |||
Reklamy towarzyszące | ||||
Zasoby alternatywnych reklam towarzyszących VAST 3 | ||||
Widoczność w Widoku aktywnym | ||||
Reklamy audio | ||||
Przekierowania VAST | ||||
Reklama zapasowa towarzysząca żądania reklamy displayowej | ||||
Zgodność tagu wydawcy Google (GPT) | ||||
Znajomość treści | ||||
Reguły reklam | 3 | |||
Ręczne przerwy na reklamę w regułach reklamowych | ||||
Limity wyświetleń na użytkownika6 | ||||
Wykluczenia konkurencji (strumień) | ||||
Wykluczenia konkurencji (blok reklamowy) | ||||
Wykluczenia konkurencji (cała strona) | ||||
Blok reklamowy | 3 | |||
etui. | ||||
Raportowanie śledzenia wielu zdarzeń (MET) | ||||
Alokacja dynamiczna (AdSense dla wideo, Ad Manager – Ad Exchange) | ||||
Możliwa do pominięcia (inne niż TrueView)8 | 5 | |||
In-Stream z możliwością pominięcia | ||||
Wstępne ładowanie zasobów | 7 | |||
Funkcje AdSense dla wideo | ||||
TrueView In-Stream | 5 | |||
In-Stream z możliwością pominięcia | ||||
Standardowa In-Stream | ||||
Reklamy zajmujące cały boks reklamowy | ||||
Reklamy towarzyszące | ||||
Reklama zapasowa | ||||
Nakładki reklamowe | 5 | |||
Wstępne ładowanie zasobów | 7 | |||
Funkcje Ad Exchange w usłudze Ad Manager | ||||
TrueView In-Stream | 5 | |||
In-Stream z możliwością pominięcia | ||||
Standardowa In-Stream | ||||
Reklamy zajmujące cały boks reklamowy | ||||
Reklamy towarzyszące | ||||
Reklama zapasowa | ||||
Nakładki reklamowe | 5 | |||
Widoczność w Widoku aktywnym | ||||
Wstępne ładowanie zasobów | 7 | |||
Dlaczego ta reklama? |
1 Te funkcje VAST 3.0 nie są jeszcze obsługiwane w pakietach SDK innych niż HTML5:
- Reklama towarzysząca
adSlotId
- Opcje wyświetlania kreacji towarzyszących
- Ikony
2 Te funkcje VMAP nie są jeszcze obsługiwane:
- Zdarzenia śledzenia związane z VMAP
- Kody błędów dotyczące VMAP
- Nakładki reklamowe
- Przesunięcia czasu inne niż gg:mm:ss lub „start” i „end”
- Wyświetl atrybut
breakType
repeatAfter
atrybut
3 Obsługa VMAP i reguł reklamowych na iPhonie wymaga niestandardowego odtwarzania reklam.
4 Kreacje hostowane w YouTube działają na komputerach, ale nie w internecie mobilnym.
5 Reklamy nielinearne (nakładki), możliwe do pominięcia (inne niż TrueView) oraz reklamy TrueView In-Stream są obsługiwane w przeglądarce mobilnej HTML5 na urządzeniach z iOS w wersji 10 lub nowszej, jeśli
używasz elementu playsinline
.
6 Limity wyświetleń na użytkownika w regułach reklamowych i wykluczenia konkurencji wymagają plików cookie lub identyfikatora PPID.
7 Wstępne wczytywanie zasobów natywnych nie działa z tymi elementami:
- Internet mobilny na urządzeniach z iOS
- Internet mobilny na urządzeniach z Androidem w wersji starszej niż 4.0
- reklamy w YouTube, w tym formaty TrueView;
-
Funkcja ręcznego odtwarzania w standardzie IMA (dowolna implementacja, która korzysta ze zdarzenia
AD_BREAK_READY
)
8 Pakiet SDK nie obsługuje reklam możliwych do pominięcia, które są krótsze niż 8 sekund. W przypadku reklam krótszych niż minimalna długość odtwarzania przycisk Pomiń nie jest wyświetlany.
9 Spośród funkcji VAST 4 obsługiwanych przez Google Ad Managera IMA obsługuje te funkcje:
- VAST 4.2
- Obsługa standardu SIMID (Secure Interactive Media Interface Definition).
- Zezwolenie na wiele węzłów
UniversalAdID
- VAST 4.0
- AdID
- Plik mezzanine
- Nowe kody błędów VAST
AdVerifications
– pomoc