Wstępnie wczytaj multimedia

Wybierz platformę: HTML5 Android

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

Włączanie wstępnego ładowania

Aby włączyć wstępne wczytywanie, ustaw parametr AdsRenderingSettings.enablePreloading na wartość „true”. Należy 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);
}

Czas

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

Zdarzenie Z wstępnym ładowaniem Bez wstępnego ładowania
Wysłano żądanie reklamy VAST AdsLoader.requestAds() AdsLoader.requestAds()
Załadowano reklamę przed filmem (pojedyncza reklama) AdsManager.init() AdsManager.start()
Załadowano reklamę przed filmem (VMAP/reguły reklamowe) AdsManager.init() AdsManager.init()
Wczytano reklamę w trakcie filmu lub po filmie W przypadku pierwszej reklamy w przerwie na reklamę – 8 sekund przed czasem rozpoczęcia reklamy. W przypadku reklam wyświetlanych jedna po drugiej – gdy zaczyna się odtwarzanie poprzedniej reklamy. W czasie rozpoczęcia wyświetlania reklamy.

Ograniczenia

Wstępne wczytywanie podlega tym ograniczeniom:

  • Wstępne wczytywanie multimediów jest niedostępne w internecie mobilnym na urządzeniach z iOS oraz w przypadku korzystania z pakietu IMA HTML5 SDK na telewizorach smart TV z dostępem do internetu.
  • VPAID jest wstępnie wczytywany, ale żadne zależności reklamy – w tym multimedia odtwarzane przez tę reklamę – nie są wczytywane, dopóki reklama nie zostanie uruchomiona.
  • Aby wstępnie wczytywać reklamy VMAP, musisz włączyć autoodtwarzanie. Sprawdź, czy właściwość 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 AdsRequest.contentDuration.

Najczęstsze pytania

Czy wstępne wczytywanie multimediów powoduje wczytanie całej kreacji?
Nie, kreacja zwykle nie jest w pełni wczytana, gdy rozpoczyna się odtwarzanie reklamy. Wstępne wczytywanie ma na celu poprawę wrażeń użytkowników przez skrócenie czasu potrzebnego na wczytanie reklamy. Nie służy do obsługi wyświetlania reklam offline. Pakiet IMA SDK wczytuje tyle multimediów, na ile pozwala przeglądarka, z uwzględnieniem ograniczeń związanych z połączeniem internetowym użytkownika i rozmiarem kreacji.
Czy wstępne wczytywanie multimediów musi być włączone zarówno w przypadku reklam VAST, jak i multimediów?
Nie, pakiet SDK zawsze wstępnie wczytuje plik VAST reklamy, niezależnie od tego ustawienia.