Wstępne wczytywanie multimediów

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 przechodzenie między reklamami a treściami. W tym przewodniku omawiamy szczegóły techniczne implementacji wstępnego wczytywania multimediów za pomocą pakietu IMA SDK.

Włącz wstępne ładowanie

Aby włączyć wstępne wczytywanie, ustaw parametr AdsRenderingSettings.enablePreloading na wartość true. Jest to spowodowane zdarzeniem ADS_MANAGER_LOADED:

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

Czas

W tabeli poniżej znajdziesz podsumowanie zmian czasu wczytywania reklamy po włączeniu wstępnego wczytywania:

Zdarzenie Ze wstępnym wczytywaniem Bez wstępnego wczytywania
Żądanie VAST reklamy AdsLoader.requestAds() AdsLoader.requestAds()
Wczytywana reklama przed filmem (pojedyncza reklama) AdsManager.init() AdsManager.start()
Wczytano przed filmem (VMAP/reguły reklamowe) AdsManager.init() AdsManager.init()
Wczytano reklamę w trakcie filmu lub po filmie Pierwsza reklama w przerwie na reklamę – 8 sekund przed czasem rozpoczęcia. w przypadku kolejnych reklam – wtedy rozpoczyna się odtwarzanie poprzedniej reklamy; 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 w przypadku korzystania z pakietu HTML5 IMA SDK na urządzeniach CTV.
  • VPAID jest wstępnie wczytywany, ale do momentu wyświetlenia reklamy nie są wczytywane żadne zależności reklamy, w tym odtwarzane przez nią multimedia.
  • Aby wstępnie wczytywać reklamy VMAP, musisz włączyć autoodtwarzanie. Upewnij się, że settings.isAutoPlayAdBreaks() jest ustawiony na true, co jest wartością 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 określenia czasu trwania użyto parametru AdsRequest.contentDuration.

Najczęstsze pytania

Czy wstępne wczytywanie multimediów wczytuje całą kreację?
Nie. Kreacja zwykle nie wczytuje się w pełni na początku odtwarzania reklamy. Wstępne wczytywanie ma na celu poprawę wrażeń użytkowników, skracając czas potrzebny na wczytanie reklamy. Nie służy do wyświetlania reklam offline. Pakiet IMA SDK wczytuje tyle multimediów, na ile zezwala przeglądarka, i ogranicza połączenie z internetem użytkownika i rozmiar kreacji.
Czy na potrzeby reklam VAST oraz multimediów musi być włączone wstępne wczytywanie multimediów?
Nie, SDK zawsze wstępnie wczytuje tag VAST reklamy, niezależnie od tego ustawienia wstępnego wczytywania.