Livestream-Prefetch

Mit dem IMA SDK lassen sich sowohl Livestreams als auch Video-on-Demand monetarisieren. Bei Livestreams müssen Sie für jede Werbeunterbrechung eine neue Anzeigenanfrage stellen. Die Anfragen aufteilen, damit nicht alle Zuschauer Anzeigen schalten, was den Ad-Server bzw. die Ad-Server verzögert.

Um dies zu unterstützen, verfügt das IMA SDK über die AdsRequest.liveStreamPrefetchSeconds Property. Dieses Attribut gibt die maximale Anzahl von Sekunden an, die das SDK sollte warten, bevor Sie nach dem Aufruf AdsLoader.requestAds() Die tatsächliche Anfragezeit wird zufällig ausgewählt. Für Wenn Sie beispielsweise AdsRequest.liveStreamPrefetchSeconds auf 30 festlegen, nachdem Sie AdsLoader.requestAds() aufgerufen haben, die Anfrage an den Server senden.

Hinweis :Ein Beispiel für ein abgeschlossenes Prefetch-Beispiel für einen Livestream findest du in unserer GitHub-Beispiel.

Vorabruf von Livestreams in der Praxis

Wir empfehlen, die nächste Werbeunterbrechung vorab abzurufen, sobald eine Werbeunterbrechung abgeschlossen ist. Dadurch wird sichergestellt, dass die maximale Zeit für das Prefetch-Fenster zur Verfügung steht. Angenommen, du hast zwischen Werbeunterbrechungen 5 Minuten Zeit. Wenn eine Werbeunterbrechung abgeschlossen ist, können Sie die nächste Werbeunterbrechung mit einem Prefetch-Fenster von 290 Sekunden (5 Minuten minus 10 Sekunden, um sicherzustellen, dass die Anfragen am Ende der im Prefetch-Fenster genügend Zeit zur Behebung 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();
}