Wstępne wczytywanie multimediów

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

Włączanie pre-load

Aby włączyć wstępne wczytywanie, ustaw parametr AdsRenderingSettings.enablePreloading na wartość Prawda. 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 reklamy po włączeniu jej wstępnego wczytania:

Zdarzenie Z wczytywaniem z wyprzedzeniem Bez wstępnego wczytywania
Żądana reklama VAST AdsLoader.requestAds() AdsLoader.requestAds()
Załadowana reklama przed filmem (pojedyncza reklama) AdsManager.init() AdsManager.start()
Reklama przed filmem została załadowana (VMAP/Reguły reklamowe) AdsManager.init() AdsManager.init()
Załadowana reklama w trakcie filmu lub po nim W przypadku pierwszej reklamy w przerwie na reklamę 8 sekund przed jej rozpoczęciem. W przypadku kolejnych reklam – gdy rozpoczyna się odtwarzanie poprzedniej reklamy. W momencie rozpoczęcia wyświetlania reklamy.

Ograniczenia

Wstępne wczytywanie podlega tym ograniczeniom:

  • W przypadku urządzeń z systemem iOS i pakietu HTML5 IMA SDK w przypadku połączonych telewizorów smart TV w przeglądarce mobilnej wstępne wczytywanie multimediów jest niedostępne.
  • VPAID jest wstępnie wczytany, ale żadne z zależnych od niego elementów, w tym media odtwarzane przez reklamę, nie są wczytywane, dopóki reklama nie zostanie wykonana.
  • Aby wczytywać reklamy VMAP, musisz włączyć automatyczne odtwarzanie. Upewnij się, że parametr settings.isAutoPlayAdBreaks() ma wartość true, która jest wartością domyślną.
  • Reklamy po filmie są wstępnie wczytywane po ostatniej reklamie w trakcie filmu lub 8 sekund przed końcem filmu, jeśli do ustawienia czasu trwania służy parametr AdsRequest.contentDuration.

Najczęstsze pytania

Czy wstępne wczytywanie kreacji wczytuje pełną kreację?
Nie. Kreacja zwykle nie jest w pełni wczytywana po rozpoczęciu odtwarzania reklamy. Wstępne pobieranie ma na celu zwiększenie wygody użytkowników przez skrócenie czasu wczytywania reklamy. Nie obsługuje ona wyświetlania reklam offline. IMA SDK wczytuje tyle multimediów, na ile pozwala przeglądarka, z ograniczeniem ze względu na połączenie internetowe użytkownika i rozmiar kreacji.
Czy w przypadku reklamy VAST i multimediów musi być włączone wstępne wczytywanie multimediów?
Nie. Pakiet SDK zawsze wstępnie wczytuje plik VAST reklamy niezależnie od tego ustawienia.