Na tej stronie znajdziesz ogólne informacje o obsłudze i zgodności pakietu IMA 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 i nie ma jednego domyślnego formatu wideo obsługiwanego przez wszystkie najważniejsze 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
Większość funkcji IMA jest obsługiwana przez typowe odtwarzacze 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ść zdarzeń VAST
W tej sekcji znajdziesz listę zdarzeń VAST, które są automatycznie raportowane na serwerze na podstawie informacji zwracanych w odpowiedzi VAST.
Pełna obsługa
complete, creativeView, firstQuartile, impression, midpoint, pause, resume, rewind (wywoływane, gdy następuje znaczne przewinięcie 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 i iOS ani na komputerach, ale mogą być rejestrowane przez element śledzenia kliknięć na stronie, gdy film jest zamknięty. Jeśli jednak element wideo korzysta z natywnych elementów sterujących na iPadzie, kliknięcia nie mogą być rejestrowane.fullscreen
Pakiet IMA SDK obsługuje symulowany tryb pełnego ekranu, w którym film zajmuje całe okno przeglądarki. Uznajemy, że film jest w trybie pełnego ekranu, gdy jego
offsetWidthioffsetHeightsą co najmniej wielkości treści dokumentu. Ten tryb jest obsługiwany we wszystkich przeglądarkach. Aby zobaczyć przykład symulowanego pełnego ekranu, pobierz próbkę.Na iPhonie i platformach Androida starszych niż wersja 3.0 filmy zawsze będą odtwarzane w trybie pełnego ekranu.
mute,unmuteSystemy iOS i Android mają tylko natywną kontrolę głośności. Z tego powodu 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ą i nie obsługują
mute,unmute:- Obsługiwane przeglądarki: 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.
Uwagi 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. IMA obsługuje platformy JavaScript, o ile pakiet IMA jest inicjowany 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ługiwane platformy odtwarzaczy
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) |
Linearne reklamy wideo, linearne reklamy displayowe, nielinearne reklamy i reklamy towarzyszące, Ad Manager Video Solutions, reklamy wideo Ad Exchange i reklamy AFV |
| iOS | iOS 10.0 lub nowszy, | Reklamy linearne i towarzyszące, reklamy wideo Ad Managera, reklamy wideo Ad Exchange i reklamy AFV |
| Android | Android 4.4 lub nowszy, | Reklamy linearne i towarzyszące, reklamy wideo Ad Managera, reklamy wideo Ad Exchange i reklamy AFV |
| tvOS | tvOS 15 lub nowszy, | Reklamy linearne, reklamy wideo Ad Managera i reklamy wideo Ad Exchange |
Funkcje wideo i wersje pakietu SDK
Aby dowiedzieć się więcej o tych funkcjach, przeczytaj omówienie reklam wideo.
| HTML5 w wersji 3 | iOS v3 | Android v3 | 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 wideo w usłudze Ad Manager | ||||
| Reklamy linearne | |
|
|
|
| Linearne reklamy displayowe |
|
|
|
|
| Zasoby hostowane w YouTube | 4 |
|
|
|
| Reklamy nielinearne (nakładki) | 5 |
|
|
|
| Elementy towarzyszące | |
|
|
|
| Zasoby alternatywnych reklam towarzyszących w VAST 3 | |
|
|
|
| Widoczność w Widoku aktywnym | |
|
|
|
| Reklamy audio | |
|
|
|
| Przekierowania VAST | |
|
|
|
| Uzupełnianie reklam towarzyszących z żądaniem reklamy displayowej | |
|
|
|
| Zgodność z tagiem wydawcy Google (GPT) | |
|
|
|
| Świadomość treści | |
|
|
|
| Reguły reklam | 3 |
|
|
|
| Ręczne przerwy na reklamę w regułach reklamowych |
|
|
|
|
| Limity wyświetleń na użytkownika 6 | |
|
|
|
| Wykluczenia konkurencji (strumień) | |
|
|
|
| Wykluczenia konkurencji (blok reklamowy) | |
|
|
|
| Wykluczenia konkurencji (cała strona) | |
|
|
|
| Blok reklamowy | 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 z możliwością pominięcia | |
|
|
|
| Wstępne ładowanie zasobów | 7 |
|
|
|
| Funkcje AdSense dla wideo | ||||
| TrueView InStream | 5 |
|
|
|
| In-Stream z możliwością pominięcia | |
|
|
|
| Standardowa reklama In-Stream | |
|
|
|
| Pełny boks | |
|
|
|
| Elementy towarzyszące | |
|
|
|
| Uzupełnianie reklam towarzyszących | |
|
|
|
| Nakładki | 5 |
|
|
|
| Wstępne ładowanie zasobów | 7 |
|
|
|
| Funkcje Ad Exchange w usłudze Ad Manager | ||||
| TrueView InStream | 5 |
|
|
|
| In-Stream z możliwością pominięcia | |
|
|
|
| Standardowa reklama In-Stream | |
|
|
|
| Pełny boks | |
|
|
|
| Elementy towarzyszące | |
|
|
|
| Uzupełnianie reklam towarzyszących | |
|
|
|
| Nakładki | 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:
- Tryb towarzyszący
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 VMAP
- Nakładki reklamowe
- Przesunięcia czasu inne niż hh:mm:ss lub „start” i „end”
- Atrybut wyświetlania
breakType repeatAfteratrybut
3 Obsługa VMAP i reguł reklamowych na iPhonie wymaga niestandardowego odtwarzania reklam.
4 Kreacje hostowane na YouTube są obsługiwane na komputerach, ale nie w internecie mobilnym.
5 Reklamy nielinearne (nakładki), możliwe do pominięcia (inne niż TrueView) i TrueView In-Stream są obsługiwane w internecie mobilnym HTML5 na urządzeniach z systemem iOS 10 lub nowszym, gdy używany jest parametr
playsinline
.
6 Limity wyświetleń na użytkownika i wykluczenia konkurencji w regułach reklamowych wymagają plików cookie lub identyfikatorów PPID.
7 Wstępne wczytywanie zasobó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 oparta 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 Spośród 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).
- Zezwalanie na wiele węzłów
UniversalAdID
- VAST 4.0
- AdID
- Plik mezzanine
- Nowe kody błędów VAST
AdVerifications– pomoc
Wycofane pakiety SDK
| Flash v2 | HTML5 v1 | iOS v1 | Android – wersja 1 | Google Cast v2 | |
|---|---|---|---|---|---|
| Funkcje wideo w usłudze Ad Manager | |||||
| Reklamy linearne | |
|
|
|
|
| Reklamy nielinearne | |
|
|
|
|
| reklamy interaktywne (VPAID 1.0), | |
|
|
|
|
| Przekierowania (VAST 2.0) | |
|
|
|
|
| Reklamy towarzyszące (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 reklamowy | |
|
|
|
|
| Bumpery | |
|
|
|
|
| Śledzenie wielu zdarzeń (MET) na potrzeby raportowania | |
|
|
|
|
| Alokacja dynamiczna | |
|
|
|
|
| Możliwe do pominięcia | |
|
|
|
|
| In-Stream z możliwością pominięcia | |
|
|
|
|
| Funkcje AdSense dla wideo | |||||
| Reklamy tekstowe | |
|
|
|
|
| AdSense VAST InStream | |
|
|
|
|
| Nakładka AdSense | |
|
|
|
|
| Możliwe do pominięcia | |
|
|
|
|
| In-Stream z możliwością pominięcia | |
|
|
|
|
| Opcja wyboru (YouTube) | |
|
|
|
|
| Reklamy F2F w usłudze Ad Manager | |
|
|
|
|
| Funkcje Ad Exchange w usłudze Ad Manager | |||||
| Reklamy linearne | |
|
|
|
|