Werbeunterbrechungen für Streams vorab laden

Plattform auswählen: HTML5 Android iOS tvOS

Das IMA SDK kann sowohl zur Monetarisierung von Livestreams als auch von Video-on-Demand-Inhalten verwendet werden. Bei Livestreams müssen Sie für jede Werbeunterbrechung eine neue Anzeigenanfrage stellen. Staffeln Sie diese Anfragen, damit nicht alle Zuschauer gleichzeitig Anzeigen anfordern und die Ad-Server überlasten.

Dazu können Sie die Eigenschaft AdsRequest.liveStreamPrefetchSeconds des IMA SDK verwenden. Diese Eigenschaft gibt die maximale Anzahl von Sekunden an, die das SDK warten soll, bevor es sich an den Ad-Server wendet, nachdem Sie AdsLoader.requestAds() aufgerufen haben. Die tatsächliche Anfragezeit wird zufällig festgelegt. Wenn Sie beispielsweise AdsRequest.liveStreamPrefetchSeconds auf 30 festlegen, wartet das SDK 0 bis 30 Sekunden, nachdem Sie AdsLoader.requestAds() aufgerufen haben, bevor es die Anfrage an den Server sendet.

**Hinweis** :Ein vollständiges Beispiel für das Prefetching von Livestreams finden Sie in unserem GitHub-Beispiel.

Prefetching von Livestreams in der Praxis

Wir empfehlen, die nächste Werbeunterbrechung vorab abzurufen, sobald eine Werbeunterbrechung beendet ist. So steht die maximale Zeit für das Prefetching-Fenster zur Verfügung. Angenommen, zwischen den Werbeunterbrechungen liegen 5 Minuten. Wenn eine Werbeunterbrechung beendet ist, können Sie die nächste Werbeunterbrechung mit einem Prefetching-Fenster von 290 Sekunden anfordern (5 Minuten minus 10 Sekunden, damit die Anfragen, die am Ende des Prefetching-Fensters gesendet werden, genügend Zeit haben, um verarbeitet zu werden):

// 5 minutes == 300 seconds. Include a 10 second buffer
var AD_INTERVAL = 290;

function onAdEvent(adEvent) {
  var ad = adEvent.getAd();
  switch(adEvent.type) {
    case google.ima.AdEvent.Type.ALL_ADS_COMPLETED:
      // Pre-fetch our next ad break.
      requestAds();
      // Play those ads in 5 minutes. In a real-world implementation,
      // this is likely done as the result of a message from your
      // streaming server, not a timeout.
      setTimeout(playAds, AD_INTERVAL * 1000);// Convert to ms.
  }
}

function requestAds() {
  // Destroy the current AdsManager, in case the tag you requested previously
  // contains post-rolls (don't play those now).
  if (adsManager) {
    adsManager.destroy();
  }
  // Your AdsLoader will be set up on page-load. You should re-use the same
  // AdsLoader for every request. For more info on setting up the AdsLoader,
  // see the IMA HTML5 client-side "Set up the IMA SDK" guide:
  // https://developers.google.com/interactive-media-ads/docs/sdks/html5/client-side/get-started
  if (adsLoader) {
    // Reset the IMA SDK.
    adsLoader.contentComplete();
  }
  var adsRequest = new google.ima.AdsRequest();
  adsRequest.adTagUrl = '...';
  adsRequest.linearAdSlotWidth = <linear_width>;
  adsRequest.linearAdSlotHeight = <linear_height>;
  adsRequest.nonLinearAdSlotWidth = <nonlinear_width>;
  adsRequest.nonLinearAdSlotHeight = <nonlinear_height>;
  adsRequest.liveStreamPrefechSeconds = AD_INTERVAL;
  adsLoader.requestAds(adsRequest);
}

function playAds() {
  adsManager.init(<linear_width>,  <linear_height>);
  adsManager.start();
}