Livestream-Prefetch

Mit dem IMA SDK können sowohl Livestreams als auch On-Demand-Videos monetarisiert werden. Bei Livestreams müssen Sie für jede Werbeunterbrechung eine neue Anzeigenanfrage stellen. Verteilen Sie diese Anfragen, damit nicht alle Betrachter gleichzeitig Anzeigen anfordern und die Ad-Server zum Stillstand bringen.

Das IMA SDK unterstützt Sie dabei mit der Property AdsRequest.liveStreamPrefetchSeconds. Diese Eigenschaft gibt die maximale Anzahl von Sekunden an, die das SDK warten soll, bevor es nach dem Aufruf von AdsLoader.requestAds() eine Anfrage an den Ad-Server schickt. Die tatsächliche Anfragezeit wird zufällig festgelegt. Wenn Sie beispielsweise AdsRequest.liveStreamPrefetchSeconds auf 30 setzen, wartet das SDK nach dem Aufruf von AdsLoader.requestAds() 0 bis 30 Sekunden, um die Anfrage an den Server zu senden.

Livestream-Prefetch in der Praxis

Wir empfehlen, die nächste Werbeunterbrechung vorab abzurufen, sobald eine Werbeunterbrechung abgeschlossen ist. Dadurch wird die maximale Zeitdauer sichergestellt, die für Ihr Prefetch-Fenster verfügbar ist. Angenommen, du hast zwischen den Werbeunterbrechungen fünf Minuten Zeit. Wenn eine Werbeunterbrechung abgeschlossen ist, kannst du die nächste Werbeunterbrechung mit einem Prefetch-Fenster von 290 Sekunden (5 Minuten minus 10 Sekunden) anfordern, damit die Anfragen, die am Ende des Prefetch-Fensters gesendet werden, genügend Zeit zum Verarbeiten haben:

// 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 "Get Started" guide in the prerequisites above.
  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>, google.ima.ViewMode.NORMAL);
  adsManager.start();
}