Wstępnie wczytaj multimedia

Wybierz platformę: HTML5 Android

Pakiet IMA SDK obsługuje wczytywanie zasobów reklam wideo z wyprzedzeniem. 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ć wczytywanie multimediów z wyprzedzeniem za pomocą pakietu IMA SDK.

Włączanie wczytywania z wyprzedzeniem

Aby włączyć wczytywanie z wyprzedzeniem, 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

Tabela poniżej zawiera podsumowanie zmian w czasie wczytywania reklam, gdy włączone jest wczytywanie z wyprzedzeniem:

Zdarzenie Z wczytywaniem z wyprzedzeniem Bez wczytywania z wyprzedzeniem
Żądanie VAST reklamy AdsLoader.requestAds() AdsLoader.requestAds()
Reklama przed filmem wczytana (jedna reklama) AdsManager.init() AdsManager.start()
Reklama przed filmem wczytana (VMAP/reguły reklamowe) AdsManager.init() AdsManager.init()
Reklama w trakcie filmu lub po filmie wczytana 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

Wczytywanie z wyprzedzeniem 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. Sprawdź, czy 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, kreacja zwykle nie jest w pełni wczytana, gdy rozpoczyna się odtwarzanie reklamy. Wczytywanie z wyprzedzeniem ma na celu poprawę wygody użytkowników przez zminimalizowanie czasu wczytywania reklamy. Nie jest ono 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 wczytywanie multimediów z wyprzedzeniem 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.