Pre-Roll-Anzeigen für Livestreams 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. Staffel diese Anfragen, damit nicht alle Zuschauer gleichzeitig Anzeigen anfordern und die Ad-Server überlasten.

Das IMA SDK bietet hierfür das Attribut AdsRequest.liveStreamPrefetchSeconds. Mit dieser Eigenschaft wird die maximale Anzahl von Sekunden angegeben, die das SDK warten soll, bevor es den Ad-Server kontaktiert, nachdem Sie AdsLoader.requestAds() aufgerufen haben. Die tatsächliche Anfragezeit wird zufällig festgelegt. Wenn Sie AdsRequest.liveStreamPrefetchSeconds beispielsweise auf 30 festlegen, wartet das SDK nach dem Aufrufen von AdsLoader.requestAds() zwischen 0 und 30 Sekunden, bevor die Anfrage an den Server gesendet wird.

Prefetching von Livestreams in der Praxis

Wir empfehlen, den nächsten Werbeunterbrechung so bald wie möglich nach Abschluss einer Werbeunterbrechung vorab abzurufen. So ist die maximale Zeit für das Prefetch-Fenster verfügbar. Angenommen, zwischen den Werbeunterbrechungen liegen 5 Minuten. Wenn eine Werbeunterbrechung abgeschlossen ist, können Sie die nächste Werbeunterbrechung mit einem Vorabruffenster von 290 Sekunden anfordern (5 Minuten minus 10 Sekunden, damit die am Ende des Vorabruffensters gesendeten Anfragen genügend Zeit für die Auflösung haben):

Wichtiger Hinweis :Im Leitfaden für den Einstieg> 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 Vorabrufen von Livestreams zu verwenden.

Diese Code-Snippets zeigen, wie du das Vorabrufen von Livestreams zum erweiterten Beispiel hinzufügen kannst. 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);
}