Pakiet IMA SDK obsługuje wstępne wczytywanie zasobów reklam wideo. Możesz włączyć tę funkcję w integracji z pakietem SDK, aby zapewnić płynniejsze przejście między reklamami a treściami. Ten przewodnik przedstawia techniczne szczegóły implementacji wstępnego wczytywania multimediów za pomocą pakietu IMA SDK.
Włącz wstępne wczytywanie
Aby włączyć wstępne wczytywanie, ustaw parametrAdsRenderingSettings.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
Gdy włączone jest wstępne wczytywanie, ta tabela zawiera podsumowanie zmian w czasie wczytywania reklam:
Zdarzenie | Z funkcją wstępnego wczytywania | Bez wstępnego wczytywania |
---|---|---|
Żądanie VAST reklamy | AdsLoader.requestAds() |
AdsLoader.requestAds() |
Wczytano reklamę przed filmem (pojedyncza reklama) | AdsManager.init() |
AdsManager.start() |
Wczytanie reklamy przed filmem (VMAP/reguły reklamowe) | AdsManager.init() |
AdsManager.init() |
Wczytano reklamę w trakcie filmu lub po filmie | Przy pierwszej reklamie w przerwie na reklamę, 8 sekund przed czasem rozpoczęcia wyświetlania. W przypadku kolejnych reklam, gdy rozpocznie się odtwarzanie poprzedniej reklamy. | W momencie rozpoczęcia wyświetlania reklamy. |
Ograniczenia
Wstępne wczytywanie podlega tym ograniczeniom:
- Wstępne ładowanie multimediów nie jest dostępne w przeglądarkach mobilnych na urządzeniach z iOS ani podczas korzystania z pakietu HTML5 IMA SDK na połączonych telewizorach smart TV.
- VPAID jest wstępnie wczytywany, ale żadne zależności reklamy – w tym multimedia odtwarzane przez tę reklamę – nie są wczytywane do momentu jej wykonania.
- Aby wstępnie wczytać reklamy VMAP, musisz włączyć autoodtwarzanie. Sprawdź, czy
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 wczytywanie ma na celu poprawę wrażeń użytkownika przez skrócenie czasu potrzebnego na wczytanie reklamy. Nie służy do wyświetlania reklam offline. Pakiet IMA SDK wczytuje tyle multimediów, na ile pozwala przeglądarka. Ograniczenia te są ograniczone przez połączenie internetowe użytkownika i rozmiar kreacji.
- Czy w przypadku VAST reklamy i multimediów trzeba włączyć wstępne ładowanie multimediów?
- Nie. SDK zawsze wstępnie wczytuje VAST reklamy, niezależnie od tego ustawienia wstępnego wczytywania.