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

בחירת פלטפורמה: HTML5 Android iOS tvOS

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

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

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

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

נקודה חשובה: גם מדריך תחילת העבודה וגם הדוגמה הבסיסית מיישמים את התוסף Exoplayer-IMA, שמטפל בהגדרה של AdsManager. לכן, אי אפשר להשתמש במשאבים האלה כנקודת התחלה למדריך הזה. מומלץ להשתמש בדוגמה המתקדמת כנקודת התחלה לאחזור מראש של שידורים חיים.

קטעי הקוד האלה מראים איך להוסיף אחזור מראש של שידור חי לדוגמה המתקדמת, אבל אפשר להשתמש בגישה הזו גם בהטמעות אחרות של IMA.

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);
}