Wstępnie wczytaj multimedia

Wybierz platformę: HTML5 Android

Pakiet IMA SDK obsługuje wstępne wczytywanie komponentów reklamy wideo. Możesz włączyć tę funkcję w integracji pakietu SDK, aby zapewnić płynniejsze przejście między reklamami a treściami. Ten przewodnik zawiera szczegóły techniczne dotyczące implementacji wstępnego wczytywania multimediów za pomocą pakietu IMA SDK.

Włącz wstępne ładowanie

Aby włączyć wstępne wczytywanie, ustaw wartość AdsRenderingSettings.enablePreloading na true. Musi to nastąpić w wyniku zdarzenia ADS_MANAGER_LOADED:

function onAdsManagerLoaded(adsManagerLoadedEvent) {
  var adsRenderingSettings = new google.ima.AdsRenderingSettings();
  adsRenderingSettings.enablePreloading = true;
  ...
  var adsManager = adsManagerLoadedEvent.getAdsManager(
      videoContent, adsRenderingSettings);
}

Czas

Tabela poniżej zawiera podsumowanie zmian w czasie wczytywania reklam po włączeniu wstępnego wczytywania:

Zdarzenie Z wczytywaniem z wyprzedzeniem Bez wstępnego wczytywania
Wysłano żądanie reklamy VAST AdsLoader.requestAds() AdsLoader.requestAds()
Reklama przed filmem została załadowana (pojedyncza reklama) AdsManager.init() AdsManager.start()
Reklama przed filmem została załadowana (VMAP/reguły reklamowe) AdsManager.init() AdsManager.init()
Reklama w trakcie filmu lub po filmie została wczytana W przypadku pierwszej reklamy w przerwie na reklamę: 8 sekund przed rozpoczęciem wyświetlania reklamy. W przypadku kolejnych reklam – gdy zacznie się odtwarzać poprzednia reklama. W momencie rozpoczęcia wyświetlania reklamy.

Ograniczenia

Wstępne wczytywanie podlega tym ograniczeniom:

  • Wstępne wczytywanie multimediów nie jest dostępne w przeglądarce mobilnej na urządzeniach z iOS ani podczas korzystania z pakietu HTML5 IMA SDK na telewizorach smart TV.
  • VPAID jest wstępnie wczytywany, ale żadne zależności reklamy, w tym media odtwarzane przez tę reklamę, nie są wczytywane, dopóki reklama nie zostanie wykonana.
  • Aby wstępnie wczytywać reklamy VMAP, musisz włączyć automatyczne odtwarzanie. Sprawdź, czy wartość settings.isAutoPlayAdBreaks() jest ustawiona na true, czyli wartość domyślną.
  • Reklamy po filmie są wstępnie wczytywane po ostatniej reklamie w trakcie filmu lub 8 sekund przed końcem treści, jeśli do ustawienia czasu trwania użyto parametru AdsRequest.contentDuration.

Najczęstsze pytania

Czy wstępne wczytywanie multimediów powoduje załadowanie pełnej kreacji?
Nie, kreacja zwykle nie jest w pełni wczytana, gdy rozpoczyna się odtwarzanie reklamy. Wstępne wczytywanie ma na celu poprawę wygody użytkowników przez skrócenie czasu wczytywania reklamy. Nie jest przeznaczony do obsługi wyświetlania reklam offline. Pakiet IMA SDK wczytuje tyle mediów, na ile pozwala przeglądarka, w zależności od połączenia internetowego użytkownika i rozmiaru kreacji.
Czy wstępne wczytywanie multimediów musi być włączone zarówno w przypadku VAST reklamy, jak i multimediów?
Nie. Pakiet SDK zawsze wstępnie wczytuje VAST reklamy, niezależnie od tego ustawienia wstępnego wczytywania.