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. 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 sich an den Anzeigenserver wendet, 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, um verarbeitet zu werden):

Objective-C


- (void)adsManager:(IMAAdsManager *)adsManager didReceiveAdEvent:(IMAAdEvent *)event {

  ...

  switch (event.type) {

    ...

    case kIMAAdEvent_ALL_ADS_COMPLETED:

      IMAAdsRequest *request = [[IMAAdsRequest alloc]
             initWithAdTagUrl: self.adTagUrl
           adDisplayContainer: self.adDisplayContainer
         avPlayerVideoDisplay: self.avPlayerVideoDisplay
        pictureInPictureProxy: self.pictureInPictureProxy
                  userContext: nil];

      // set a delay between the end of the last ad
      // in the last request, and the first ad from
      // the new request
      Float64 adGap = 30;
      // make sure the request occurs at least five
      // seconds before starting the new set of ads
      request.liveStreamPrefetchSeconds = adGap - 5;
      [self.adsLoader requestAdsWithRequest:request];
      // start new ads after adGap seconds have elapsed
      dispatch_after(dispatch_time(DISPATCH_TIME_NOW, adGap * NSEC_PER_SEC), dispatch_get_main_queue(), ^{
        [adsManager start];
      });

      break;

    ...

  }

  ...

}

Swift

func adsManager(_ adsManager: IMAAdsManager!, didReceive event: IMAAdEvent!) {
  switch event.type {

    ...

    case IMAAdEventType.ALL_ADS_COMPLETED:

      let request = IMAAdsRequest(
        adTagUrl: AdTagUrl,
        adDisplayContainer: adDisplayContainer,
        contentPlayhead: contentPlayhead,
        userContext: nil)

      // set a delay between the end of the last ad
      // in the last request, and the first ad from
      // the new request
      let adGap = 30
      // make sure the request occurs at least five
      // seconds before starting the new set of ads
      request.liveStreamPrefetchSeconds = adGap - 5
      adsLoader.requestAds(with: request)
      // start new ads after adGap seconds have elapsed
      DispatchQueue.main.asyncAfter(deadline: .now() + adGap) {
        adsManager.start()
      }

      break

    ...
  }
}