טעינת מודעות לפני סרטון (pre-roll) לשידור חי

‫Google Interactive Media Ads (IMA) SDK ל-iOS.

אפשר להשתמש ב-IMA SDK כדי לייצר הכנסות משידורים חיים ומסרטונים על פי דרישה (VOD). בשידורים חיים, צריך לשלוח בקשה חדשה להצגת מודעה בכל הפסקה מסחרית. כדי למנוע מצב שבו כל הצופים שולחים בקשות להצגת מודעות באותו הזמן וגורמים לעומס על שרת או שרתים של מודעות, כדאי לשלוח את הבקשות האלה בזמנים שונים.

כדי לעזור בכך, ב-IMA SDK יש את המאפיין AdsRequest.liveStreamPrefetchSeconds. המאפיין הזה מציין את מספר השניות המקסימלי שערכת ה-SDK צריכה להמתין לפני שהיא פונה לשרת המודעות אחרי שקוראים ל-AdsLoader.requestAds(). זמן הבקשה בפועל יהיה אקראי. לדוגמה, אם מגדירים את AdsRequest.liveStreamPrefetchSeconds ל-30, ה-SDK ממתין בין 0 ל-30 שניות אחרי שקוראים ל-AdsLoader.requestAds() כדי לשלוח את הבקשה לשרת.

טעינה מראש של שידור חי בפועל

מומלץ לבצע אחזור מראש של הפסקת הפרסומות הבאה מיד אחרי סיום הפסקת הפרסומות הנוכחית. כך אפשר להבטיח שחלון האחזור מראש יהיה ארוך ככל האפשר. נניח שהגדרתם 5 דקות בין הפסקות הפרסום. כשמסיימים הפסקה למודעה, אפשר לשלוח בקשה להפסקה הבאה למודעה עם חלון טרום-אחזור של 290 שניות (5 דקות פחות 10 שניות, כדי לוודא שהבקשות שנשלחות בסוף חלון הטרום-אחזור יטופלו בזמן):

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

    ...
  }
}