Medien vorab laden

Plattform auswählen: HTML5 Android

Das IMA SDK unterstützt das Vorabladen von Videoanzeigen-Assets. Sie können diese Funktion in Ihre SDK-Integration einbinden, um einen nahtloseren Übergang zwischen Anzeigen und Content zu ermöglichen. In diesem Leitfaden werden die technischen Details der Implementierung des Vorabladens von Medien mit dem IMA SDK erläutert.

Vorabladen aktivieren

Wenn Sie das Vorabladen aktivieren möchten, legen Sie für AdsRenderingSettings.enablePreloading den Wert „true“ fest. Dies muss als Ergebnis des Ereignisses ADS_MANAGER_LOADED erfolgen:

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

Timing

In der folgenden Tabelle werden die Änderungen beim Timing des Ladens von Anzeigen zusammengefasst, wenn das Vorabladen aktiviert ist:

Ereignis Mit Vorabladen Ohne Vorabladen
VAST-Anzeige angefordert AdsLoader.requestAds() AdsLoader.requestAds()
Pre-Roll geladen (einzelne Anzeige) AdsManager.init() AdsManager.start()
Pre-Roll geladen (VMAP/Anzeigenregeln) AdsManager.init() AdsManager.init()
Mid-Roll oder Post-Roll geladen Bei der ersten Anzeige in einer Werbeunterbrechung: 8 Sekunden vor dem Start der Anzeige. Bei nachfolgenden Anzeigen: Wenn die vorherige Anzeige abgespielt wird. Zum Start der Anzeige.

Beschränkungen

Für das Vorabladen gelten die folgenden Beschränkungen:

  • Das Vorabladen von Medien ist im mobilen Web auf iOS-Geräten oder bei Verwendung des IMA SDK für HTML5 auf verbundenen Smart-TVs nicht verfügbar.
  • VPAID wird vorab geladen, aber keine der Abhängigkeiten der Anzeige, einschließlich der von dieser Anzeige abgespielten Medien, werden geladen, bis die Anzeige ausgeführt wird.
  • Die automatische Wiedergabe muss aktiviert sein, damit VMAP-Anzeigen vorab geladen werden können. Achten Sie darauf, dass settings.isAutoPlayAdBreaks() auf true gesetzt ist. Das ist der Standardwert.
  • Post-Rolls werden nach dem letzten Mid-Roll oder 8 Sekunden vor dem Ende des Contents vorab geladen, wenn AdsRequest.contentDuration zur Festlegung der Dauer verwendet wird.

FAQ

Wird beim Vorabladen von Medien das gesamte Creative geladen?
Nein. Das Creative wird in der Regel nicht vollständig geladen, wenn die Anzeigenwiedergabe beginnt. Das Vorabladen soll die Nutzerfreundlichkeit verbessern, indem die Zeit verkürzt wird, die zum Laden der Anzeige benötigt wird. Es ist nicht für die Auslieferung von Anzeigen im Offlinemodus vorgesehen. Das IMA SDK lädt so viele Medien, wie der Browser zulässt. Dabei wird die Internetverbindung des Nutzers und die Größe des Creatives berücksichtigt.
Muss das Vorabladen von Medien sowohl für die VAST-Datei der Anzeige als auch für die Medien aktiviert werden?
Nein. Das SDK lädt die VAST-Datei der Anzeige immer vorab, unabhängig von dieser Einstellung.