Pre-Roll-Anzeigen für Livestreams laden

Plattform auswählen: HTML5 Android iOS tvOS

Mit dem IMA SDK können Sie sowohl Livestreams als auch Video-on-Demand-Inhalte monetarisieren. 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 Anzeigenserver überlasten.

Dazu bietet das IMA SDK die Eigenschaft AdsRequest.liveStreamPrefetchSeconds. Diese Eigenschaft gibt die maximale Anzahl von Sekunden an, die das SDK warten soll, bevor es den Anzeigenserver kontaktiert, 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, um die Anfrage an den Server zu senden.

Prefetch für 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 Prefetch-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 Prefetch-Fenster von 290 Sekunden anfordern (5 Minuten minus 10 Sekunden, damit die Anfragen, die am Ende des Prefetch-Fensters gesendet werden, genügend Zeit haben, verarbeitet zu werden):

Wichtiger Hinweis: In der Anleitung Erste Schritte und im einfachen Beispiel wird die ExoPlayer-IMA-Erweiterung implementiert, die die Einrichtung des AdsManager übernimmt. Daher können diese Ressourcen nicht als Ausgangspunkt für diese Anleitung verwendet werden. Wir empfehlen, das erweiterte Beispiel als Ausgangspunkt für das Prefetch für Livestreams zu verwenden.

In diesen Code-Snippets wird gezeigt, wie Sie das Prefetch für Livestreams zum erweiterten Beispiel hinzufügen. Der Ansatz kann aber 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 through 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);
}