Pre-Roll-Anzeigen für Livestreams laden

das Google Interactive Media Ads (IMA) SDK für iOS.

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 vorab abzurufen, nachdem eine Werbeunterbrechung beendet wurde. 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):

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

    ...
  }
}