تحميل فواصل إعلانية مسبقًا لأحداث البث

اختيار النظام الأساسي: HTML5 Android iOS tvOS

يمكن استخدام حزمة تطوير البرامج لإعلانات الوسائط التفاعلية لتحقيق الربح من البث المباشر والفيديوهات عند الطلب. بالنسبة إلى البث المباشر، عليك تقديم طلب عرض إعلان جديد لكل فاصل إعلاني. يمكنك توزيع هذه الطلبات لضمان عدم طلب جميع المشاهدين للإعلانات في الوقت نفسه، ما يؤدي إلى إبطاء خادم الإعلانات أو الخوادم.

للمساعدة في ذلك، تتضمّن حزمة تطوير البرامج لإعلانات الوسائط التفاعلية السمة AdsRequest.liveStreamPrefetchSeconds. تحدّد هذه السمة الحد الأقصى لعدد الثواني التي يجب أن تنتظرها حزمة تطوير البرامج قبل التواصل مع خادم الإعلانات بعد طلب AdsLoader.requestAds(). سيتم اختيار وقت الطلب عشوائيًا. على سبيل المثال، إذا ضبطت AdsRequest.liveStreamPrefetchSeconds على 30، تنتظر حزمة تطوير البرامج من 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

    ...
  }
}