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.

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):

Wichtiger Hinweis: Die Funktion Startleitfaden und die Einfaches Beispiel die beide das Exoplayer-IMA-Erweiterung der die Einrichtung des AdsManagers übernimmt. Aus diesem Grund sind diese Ressourcen können als Ausgangspunkt für diesen Leitfaden dienen. Wir empfehlen die Verwendung des Erweitertes Beispiel als Ausgangspunkt für den Vorabruf von Livestreams.

Diese Code-Snippets zeigen, wie Sie einen Livestream-Vorabruf zum Erweitertes Beispiel , diese Vorgehensweise kann jedoch auch auf andere IMA-Implementierungen angewendet werden.

VideoPlayerController.java

/** Ads logic for handling the IMA SDK integration code and events. */
public class VideoPlayerController {

  // 5 minutes == 300 seconds. Include a 10 second buffer
  private float AD_INTERVAL = 290;
  private double AD_TIMEOUT = 300;

...

  adsManager.addAdEventListener(
    new AdEvent.AdEventListener() {
      /** Responds to AdEvents. */
      @Override
      public void onAdEvent(AdEvent adEvent) {

      ...

      case ALL_ADS_COMPLETED:
        if (adsManager != null) {
          adsManager.destroy();
          adsManager = null;
        }

        // When pre-fetching for live streams, be sure to destroy the current AdsManager,
        // in case the tag you requested previously contains post-rolls
        // (you don't want to play those now).

        // Pre-fetch the next ad break.
        // Play those ads in ~5 minutes. In a real-world implementation,
        // this will likely be done as the result of a message from your
        // streaming server, not a via the playAdsAfterThisTime parameter
        // of requestAndPlayAds().
        requestAndPlayAds(AD_TIMEOUT);
        break;
      default:
        break;
      }
  }

...

public void requestAndPlayAds(double playAdsAfterThisTime) {
  if (currentAdTagUrl == null || currentAdTagUrl == "") {
    log("No VAST ad tag URL specified");
    resumeContent();
    return;
  }

  // Since you're switching to a new video, tell the SDK the previous video is finished.
  if (adsManager != null) {
    adsManager.destroy();
  }

  playButton.setVisibility(View.GONE);

  // Create the ads request.
  AdsRequest request = sdkFactory.createAdsRequest();
  request.setAdTagUrl(currentAdTagUrl);
  request.setContentProgressProvider(videoPlayerWithAdPlayback.getContentProgressProvider());
  request.setLiveStreamPrefetchSeconds(AD_INTERVAL);

  playAdsAfterTime = playAdsAfterThisTime;

  // Request the ad. After the ad is loaded, onAdsManagerLoaded() will be called.
  adsLoader.requestAds(request);
}