Na tej stronie znajdziesz ogólne informacje o obsłudze i zgodności pakietu IMA SDK HTML5 po stronie klienta w przypadku przeglądarek, formatów wideo i platform.
Obsługiwane formaty wideo i przeglądarki
Obsługa różnych funkcji różni się w zależności od przeglądarki, a żaden format wideo nie jest domyślnie obsługiwany przez wszystkie główne 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, w tym tag HTML<video>. Listę znanych odtwarzaczy wideo obsługujących pakiet IMA SDK znajdziesz w programie partnerskim w zakresie technologii wideo.
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
clickZdarzenie
Clickjest 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 SDK obsługuje symulowany tryb pełnoekranowy, w którym film zajmuje całe okno przeglądarki. Uważamy, że film jest w trybie pełnoekranowym, gdy jego
offsetWidthioffsetHeightsą co najmniej tak duże jak treść dokumentu. Ten tryb jest obsługiwany przez wszystkie przeglądarki. Aby zobaczyć przykład symulowanego pełnego ekranu, pobierz próbkę.Na iPhonie i platformach Android starszych niż 3.0 film będzie zawsze odtwarzany w trybie pełnoekranowym.
mute,unmuteTylko urządzenia z iOS i Androidem mają natywną kontrolę głośności. W związku z tym pakiet IMA SDK nie może określić głośności ani stanu wyciszenia, a my nie otrzymujemy powiadomień o zmianach. Poniżej znajdziesz listę wersji przeglądarek, które obsługują
muteiunmute:- 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.
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 zakłócać działanie IMA, ponieważ IMA oczekuje, że DOM będzie statyczny po zainicjowaniu pakietu SDK. Pakiet IMA 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 containerElement podczas tworzenia obiektu AdDisplayContainer
nie powinien być przenoszony po utworzeniu instancji.
Obsługa Apple AirPlay
Pakiet IMA SDK nie obsługuje obecnie Apple AirPlay. Wyłącz AirPlay lub wyłącz żądania reklam, gdy wykryjesz 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: Chrome/przeglądarka Android (Android na telefony i tablety), Safari i Chrome (iOS) |
reklamy linearne, nielinearne i towarzyszące, rozwiązania wideo Ad Managera, reklamy wideo Ad Exchange i reklamy AFV; |
| iOS | iOS 10.0 lub nowszy | Reklamy liniowe i towarzyszące, reklamy wideo Ad Managera, reklamy wideo Ad Exchange i reklamy AFV |
| Android | Android 4.4 lub nowszy | Reklamy liniowe i towarzyszące, reklamy wideo Ad Managera, reklamy wideo Ad Exchange i reklamy AFV |
| tvOS | tvOS 14 lub nowszy | Reklamy linearne, wideo w usłudze Ad Manager i wideo w Ad Exchange |
Funkcje wideo i wersje pakietu SDK
Więcej informacji o tych funkcjach znajdziesz w omówieniu reklam wideo.
| HTML5 w wersji 3 | iOS v3 | Android w wersji 3 | tvOS | |
|---|---|---|---|---|
| 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 Ad Managera dotyczące filmów | ||||
| Reklamy linearne | |
|
|
|
| Zasoby hostowane w YouTube | 4 |
|
|
|
| Reklamy nielinearne (nakładki) | 5 |
|
|
|
| Elementy towarzyszące | |
|
|
|
| Alternatywne zasoby reklamy towarzyszącej VAST 3 | |
|
|
|
| Widoczność w Widoku aktywnym | |
|
|
|
| Reklamy audio | |
|
|
|
| Przekierowania VAST | |
|
|
|
| Wypełnianie reklamą towarzyszącą za pomocą żądania reklamy displayowej | |
|
|
|
| Zgodność z tagiem wydawcy Google (GPT) | |
|
|
|
| Świadomość treści | |
|
|
|
| Reguły reklam | 3 |
|
|
|
| Ręczne przerwy na reklamę w regułach reklamowych |
|
|
|
|
| Ograniczenia liczby wyświetleń 6 | |
|
|
|
| Wykluczenia konkurencji (strumień) | |
|
|
|
| Wykluczenia konkurencji (blok reklamowy) | |
|
|
|
| Wykluczenia konkurencji (cała strona) | |
|
|
|
| Blok reklam | 3 |
|
|
|
| Bumpery | |
|
|
|
| Raportowanie śledzenia wielu zdarzeń (MET) | |
|
|
|
| Alokacja dynamiczna (AdSense dla wideo, Ad Manager Ad Exchange) | |
|
|
|
| Możliwe do pominięcia (inne niż TrueView)8 | 5 |
|
|
|
| In-Stream Select | |
|
|
|
| Wstępne ładowanie komponentów | 7 |
|
|
|
| Funkcje AdSense dla wideo | ||||
| TrueView InStream | 5 |
|
|
|
| In-Stream Select | |
|
|
|
| Standardowa reklama In-Stream | |
|
|
|
| Pełny przedział | |
|
|
|
| Elementy towarzyszące | |
|
|
|
| Uzupełnianie banerów towarzyszących | |
|
|
|
| Nakładki | 5 |
|
|
|
| Wstępne ładowanie komponentów | 7 |
|
|
|
| Funkcje Ad Exchange w usłudze Ad Manager | ||||
| TrueView InStream | 5 |
|
|
|
| In-Stream Select | |
|
|
|
| Standardowa reklama In-Stream | |
|
|
|
| Pełny przedział | |
|
|
|
| Elementy towarzyszące | |
|
|
|
| Uzupełnianie banerów towarzyszących | |
|
|
|
| Nakładki | 5 |
|
|
|
| Widoczność w Widoku aktywnym | |
|
|
|
| Wstępne ładowanie komponentów | 7 |
|
|
|
| Dlaczego ta reklama? | |
|
|
|
1 Te funkcje VAST 3.0 nie są jeszcze obsługiwane w pakietach SDK innych niż HTML5:
- Element towarzyszący
adSlotId - Opcje wyświetlania kreacji towarzyszących
- Ikony
2 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 repeatAfteratrybut
3 Obsługa VMAP i reguł reklamowych na iPhonie wymaga niestandardowego odtwarzania reklam.
4 Kreacje hostowane w YouTube są obsługiwane na komputerach, ale nie w mobilnej wersji internetu.
5. Reklamy nieliniowe (nakładki), reklamy możliwe do pominięcia (inne niż TrueView) i reklamy TrueView In-Stream są obsługiwane w mobilnej wersji HTML5 w systemie iOS 10 lub nowszym, gdy używany jest element
playsinline
.
6 Limity wyświetleń na użytkownika i wykluczenia konkurencji w regułach reklamowych wymagają plików cookie lub identyfikatora PPID.
7 Wstępne wczytywanie komponentów natywnych nie działa w przypadku:
- Internet mobilny na urządzeniach z iOS
- Internet mobilny na Androidzie w wersji starszej niż 4.0
- reklamy hostowane w YouTube, w tym formaty TrueView;
-
Funkcja ręcznego odtwarzania przerw w IMA (dowolna implementacja, która opiera się na zdarzeniu
AD_BREAK_READY)
8 Pakiet SDK nie obsługuje reklam możliwych do pominięcia, które trwają krócej niż 8 sekund. Gdy odtwarzane są reklamy krótsze niż minimalna długość, przycisk Pomiń nie jest wyświetlany.
9 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
AdVerifications– pomoc
Wycofane pakiety SDK
| Flash w wersji 2 | HTML5 v1 | iOS w wersji 1 | Android w wersji 1 | Google Cast w wersji 2 | |
|---|---|---|---|---|---|
| Funkcje Ad Managera dotyczące filmów | |||||
| Reklamy linearne | |
|
|
|
|
| Reklamy nielinearne | |
|
|
|
|
| Reklamy interaktywne (VPAID 1.0) | |
|
|
|
|
| Przekierowania (VAST 2.0) | |
|
|
|
|
| Reklamy towarzyszące zapasowe (AdSense dla wideo, Ad Manager Ad Exchange) | |
|
|
|
|
| Reklamy audio | |
|
|
|
|
| Zgodność z tagiem wydawcy Google (GPT) | |
|
|
|
|
| Ograniczenia liczby wyświetleń | |
|
|
|
|
| Wykluczenia konkurencji (strumień) | |
|
|
|
|
| Wykluczenia konkurencji (blok reklamowy) | |
|
|
|
|
| Wykluczenia konkurencji (cała strona) | |
|
|
|
|
| Świadomość treści | |
|
|
|
|
| Reguły reklamowe i ręczne przerwy na reklamę w regułach reklamowych | |
|
|
|
|
| Blok reklam | |
|
|
|
|
| Bumpery | |
|
|
|
|
| Śledzenie wielu zdarzeń na potrzeby raportowania | |
|
|
|
|
| Alokacja dynamiczna | |
|
|
|
|
| Możliwe do pominięcia | |
|
|
|
|
| In-Stream Select | |
|
|
|
|
| Funkcje AdSense dla wideo | |||||
| Reklamy tekstowe | |
|
|
|
|
| AdSense VAST InStream | |
|
|
|
|
| Nakładka AdSense | |
|
|
|
|
| Możliwe do pominięcia | |
|
|
|
|
| In-Stream Select | |
|
|
|
|
| Wybór użytkownika (YouTube) | |
|
|
|
|
| Reklamy F2F w usłudze Ad Manager | |
|
|
|
|
| Funkcje Ad Exchange w usłudze Ad Manager | |||||
| Reklamy linearne | |
|
|
|
|