تبلیغات پیش از پخش را برای پخش زنده بارگیری کنید

پلتفرم مورد نظر را انتخاب کنید: HTML5 اندروید iOS tvOS

IMA SDK می‌تواند برای کسب درآمد از پخش زنده و همچنین ویدیوی درخواستی استفاده شود. برای پخش زنده، باید برای هر وقفه تبلیغاتی، درخواست تبلیغ جدیدی ارسال کنید. این درخواست‌ها را به صورت متناوب ارسال کنید تا مطمئن شوید که همه بینندگان شما همزمان درخواست تبلیغات نمی‌کنند و سرور(های) تبلیغاتی را با مشکل مواجه نمی‌کنند.

برای کمک به این امر، IMA SDK دارای ویژگی AdsRequest.liveStreamPrefetchSeconds است. این ویژگی حداکثر تعداد ثانیه‌هایی را که SDK باید قبل از تماس با سرور تبلیغ پس از فراخوانی AdsLoader.requestAds() منتظر بماند، مشخص می‌کند. زمان درخواست واقعی تصادفی خواهد بود. برای مثال، اگر AdsRequest.liveStreamPrefetchSeconds روی 30 تنظیم کنید، SDK پس از فراخوانی AdsLoader.requestAds() برای ارسال درخواست به سرور، 0 تا 30 ثانیه منتظر می‌ماند.

پیش‌دریافت پخش زنده در عمل

توصیه می‌کنیم به محض اتمام یک تبلیغ، پیش‌دریافت (prefetch) تبلیغ بعدی خود را انجام دهید. این کار تضمین می‌کند که حداکثر مدت زمان موجود برای پنجره پیش‌دریافت شما وجود دارد. فرض کنید ۵ دقیقه بین هر تبلیغ فاصله دارید. وقتی یک تبلیغ کامل شد، می‌توانید تبلیغ بعدی خود را با یک پنجره پیش‌دریافت ۲۹۰ ثانیه‌ای (۵ دقیقه منهای ۱۰ ثانیه، برای اطمینان از اینکه درخواست‌های ارسالی در انتهای پنجره پیش‌دریافت، زمان کافی برای حل و فصل دارند) درخواست کنید:

// 5 minutes == 300 seconds. Include a 10 second buffer
var AD_INTERVAL = 290;

function onAdEvent(adEvent) {
  var ad = adEvent.getAd();
  switch(adEvent.type) {
    case google.ima.AdEvent.Type.ALL_ADS_COMPLETED:
      // Pre-fetch our next ad break.
      requestAds();
      // Play those ads in 5 minutes. In a real-world implementation,
      // this is likely done as the result of a message from your
      // streaming server, not a timeout.
      setTimeout(playAds, AD_INTERVAL * 1000);// Convert to ms.
  }
}

function requestAds() {
  // Destroy the current AdsManager, in case the tag you requested previously
  // contains post-rolls (don't play those now).
  if (adsManager) {
    adsManager.destroy();
  }
  // Your AdsLoader will be set up on page-load. You should re-use the same
  // AdsLoader for every request. For more info on setting up the AdsLoader,
  // see the IMA HTML5 client-side "Set up the IMA SDK" guide:
  // https://developers.google.com/interactive-media-ads/docs/sdks/html5/client-side/get-started
  if (adsLoader) {
    // Reset the IMA SDK.
    adsLoader.contentComplete();
  }
  var adsRequest = new google.ima.AdsRequest();
  adsRequest.adTagUrl = '...';
  adsRequest.linearAdSlotWidth = <linear_width>;
  adsRequest.linearAdSlotHeight = <linear_height>;
  adsRequest.nonLinearAdSlotWidth = <nonlinear_width>;
  adsRequest.nonLinearAdSlotHeight = <nonlinear_height>;
  adsRequest.liveStreamPrefechSeconds = AD_INTERVAL;
  adsLoader.requestAds(adsRequest);
}

function playAds() {
  adsManager.init(<linear_width>,  <linear_height>);
  adsManager.start();
}