Pomoc i zgodność

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 i offsetHeight 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 Ostrzeżenie 9 Ostrzeżenie 9 Ostrzeżenie 9 Ostrzeżenie 9
VAST 3 Znacznik wyboru Ostrzeżenie 1 Ostrzeżenie 1 Ostrzeżenie 1
VAST 2 Znacznik wyboru Znacznik wyboru Znacznik wyboru Znacznik wyboru
SIMID 1.0 Znacznik wyboru Znacznik wyboru Znacznik wyboru Czerwony-X
VPAID 2 (HTML5) Znacznik wyboru Czerwony-X Czerwony-X Czerwony-X
VMAP 1.0.1 Ostrzeżenie 2 3 Ostrzeżenie 2 Ostrzeżenie 2 Ostrzeżenie 2
OM SDK 1.3 Znacznik wyboru Znacznik wyboru Znacznik wyboru Czerwony-X
Funkcje wideo Ad Managera
Reklamy linearne Znacznik wyboru Znacznik wyboru Znacznik wyboru Znacznik wyboru
Zasoby hostowane w YouTube Ostrzeżenie 4 Czerwony-X Czerwony-X Czerwony-X
Reklamy nielinearne (nakładki) Ostrzeżenie 5 Czerwony-X Czerwony-X Czerwony-X
Reklamy towarzyszące Znacznik wyboru Znacznik wyboru Znacznik wyboru Czerwony-X
Zasoby alternatywnych reklam towarzyszących VAST 3 Znacznik wyboru Znacznik wyboru Czerwony-X Czerwony-X
Widoczność w Widoku aktywnym Znacznik wyboru Znacznik wyboru Znacznik wyboru Czerwony-X
Reklamy audio Znacznik wyboru Znacznik wyboru Znacznik wyboru Znacznik wyboru
Przekierowania VAST Znacznik wyboru Znacznik wyboru Znacznik wyboru Znacznik wyboru
Reklama zapasowa towarzysząca żądania reklamy displayowej Znacznik wyboru Znacznik wyboru Znacznik wyboru Czerwony-X
Zgodność tagu wydawcy Google (GPT) Znacznik wyboru Czerwony-X Czerwony-X Czerwony-X
Znajomość treści Znacznik wyboru Znacznik wyboru Znacznik wyboru Znacznik wyboru
Reguły reklam Ostrzeżenie 3 Znacznik wyboru Znacznik wyboru Znacznik wyboru
Ręczne przerwy na reklamę w regułach reklamowych Znacznik wyboru Czerwony-X Czerwony-X Czerwony-X
Limity wyświetleń na użytkownika6 Znacznik wyboru Znacznik wyboru Znacznik wyboru Znacznik wyboru
Wykluczenia konkurencji (strumień) Znacznik wyboru Znacznik wyboru Znacznik wyboru Znacznik wyboru
Wykluczenia konkurencji (blok reklamowy) Znacznik wyboru Znacznik wyboru Znacznik wyboru Znacznik wyboru
Wykluczenia konkurencji (cała strona) Znacznik wyboru Czerwony-X Czerwony-X Czerwony-X
Blok reklamowy Ostrzeżenie 3 Znacznik wyboru Znacznik wyboru Znacznik wyboru
etui. Znacznik wyboru Znacznik wyboru Znacznik wyboru Znacznik wyboru
Raportowanie śledzenia wielu zdarzeń (MET) Znacznik wyboru Znacznik wyboru Znacznik wyboru Znacznik wyboru
Alokacja dynamiczna (AdSense dla wideo, Ad Manager – Ad Exchange) Znacznik wyboru Znacznik wyboru Znacznik wyboru Znacznik wyboru
Możliwa do pominięcia (inne niż TrueView)8 Ostrzeżenie 5 Znacznik wyboru Znacznik wyboru Znacznik wyboru
In-Stream z możliwością pominięcia Znacznik wyboru Czerwony-X Czerwony-X Czerwony-X
Wstępne ładowanie zasobów Ostrzeżenie 7 Czerwony-X Znacznik wyboru Czerwony-X
Funkcje AdSense dla wideo
TrueView In-Stream Ostrzeżenie 5 Znacznik wyboru Znacznik wyboru Czerwony-X
In-Stream z możliwością pominięcia Znacznik wyboru Znacznik wyboru Znacznik wyboru Czerwony-X
Standardowa In-Stream Znacznik wyboru Znacznik wyboru Znacznik wyboru Znacznik wyboru
Reklamy zajmujące cały boks reklamowy Znacznik wyboru Czerwony-X Czerwony-X Czerwony-X
Reklamy towarzyszące Znacznik wyboru Znacznik wyboru Znacznik wyboru Czerwony-X
Reklama zapasowa Czerwony-X Znacznik wyboru Znacznik wyboru Czerwony-X
Nakładki reklamowe Ostrzeżenie 5 Czerwony-X Czerwony-X Czerwony-X
Wstępne ładowanie zasobów Ostrzeżenie 7 Czerwony-X Znacznik wyboru Czerwony-X
Funkcje Ad Exchange w usłudze Ad Manager
TrueView In-Stream Ostrzeżenie 5 Znacznik wyboru Znacznik wyboru Czerwony-X
In-Stream z możliwością pominięcia Znacznik wyboru Znacznik wyboru Znacznik wyboru Czerwony-X
Standardowa In-Stream Znacznik wyboru Znacznik wyboru Znacznik wyboru Znacznik wyboru
Reklamy zajmujące cały boks reklamowy Znacznik wyboru Czerwony-X Czerwony-X Czerwony-X
Reklamy towarzyszące Znacznik wyboru Znacznik wyboru Znacznik wyboru Czerwony-X
Reklama zapasowa Czerwony-X Znacznik wyboru Znacznik wyboru Czerwony-X
Nakładki reklamowe Ostrzeżenie 5 Czerwony-X Czerwony-X Czerwony-X
Widoczność w Widoku aktywnym Znacznik wyboru Znacznik wyboru Znacznik wyboru Czerwony-X
Wstępne ładowanie zasobów Ostrzeżenie 7 Czerwony-X Znacznik wyboru Czerwony-X
Dlaczego ta reklama? Znacznik wyboru Znacznik wyboru Znacznik wyboru Znacznik wyboru

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: