Wstępnie wczytaj multimedia

Wybierz platformę: HTML5 Android

Pakiet IMA SDK obsługuje wstępne wczytywanie zasobów reklam wideo. Możesz włączyć tę funkcję w integracji pakietu SDK, aby zapewnić płynniejsze przejście między reklamami a treścią. Z tego przewodnika dowiesz się, jak wdrożyć wstępne wczytywanie multimediów za pomocą pakietu IMA SDK.

Włączanie wczytywania z wyprzedzeniem

Aby włączyć wstępne wczytywanie, ustaw AdsRenderingSettings.enablePreloading na true. Musisz to zrobić w wyniku zdarzenia ADS_MANAGER_LOADED:

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

Kod czasowy

Poniższa tabela zawiera podsumowanie zmian w czasie wczytywania reklam, gdy włączone jest wstępne wczytywanie:

Zdarzenie Z wczytywaniem z wyprzedzeniem Bez wstępnego wczytywania
Żądanie VAST reklamy AdsLoader.requestAds() AdsLoader.requestAds()
Wczytana reklama przed filmem (jedna reklama) AdsManager.init() AdsManager.start()
Wczytana reklama przed filmem (VMAP/reguły reklamowe) AdsManager.init() AdsManager.init()
Wczytana reklama w trakcie filmu lub po filmie W przypadku pierwszej reklamy w przerwie na reklamę – 8 sekund przed czasem rozpoczęcia wyświetlania reklamy. W przypadku kolejnych reklam – gdy zacznie się odtwarzać poprzednia reklama. W czasie rozpoczęcia wyświetlania reklamy.

Ograniczenia

Wstępne wczytywanie podlega tym ograniczeniom:

  • Wczytywanie multimediów z wyprzedzeniem nie jest dostępne w internecie mobilnym na urządzeniach z iOS ani w przypadku korzystania z pakietu IMA HTML5 SDK na połączonych telewizorach Smart TV.
  • VPAID jest wczytywany z wyprzedzeniem, ale żadne zależności reklamy, w tym media odtwarzane przez tę reklamę, nie są wczytywane, dopóki reklama nie zostanie wykonana.
  • Aby wczytywać reklamy VMAP z wyprzedzeniem, musisz włączyć autoodtwarzanie. Upewnij się, że wartość settings.isAutoPlayAdBreaks() jest ustawiona na true (jest to wartość domyślna).
  • Reklamy po filmie są wczytywane z wyprzedzeniem po ostatniej reklamie w trakcie filmu lub 8 sekund przed końcem treści, jeśli AdsRequest.contentDuration jest używany do ustawienia czasu trwania.

Najczęstsze pytania

Czy wczytywanie multimediów z wyprzedzeniem wczytuje całą kreację?
Nie. Zwykle kreacja nie jest w pełni wczytana, gdy rozpoczyna się odtwarzanie reklamy. Wstępne wczytywanie ma na celu poprawę wygody użytkowników przez zminimalizowanie czasu wczytywania reklamy. Nie jest przeznaczone do obsługi wyświetlania reklam offline. Pakiet IMA SDK wczytuje tyle multimediów, 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 wczytuje VAST reklamy z wyprzedzeniem, niezależnie od tego ustawienia.