يمكن استخدام حزمة تطوير البرامج للإعلانات التفاعلية لتحقيق الربح من أحداث البث المباشر والفيديوهات عند الطلب. بالنسبة إلى أحداث البث المباشر، عليك إرسال طلب إعلان جديد لكل فاصل إعلاني. يجب ترتيب هذه الطلبات بشكل متسلسل لضمان عدم طلب جميع المشاهدين الإعلانات في الوقت نفسه، ما يؤدي إلى إبطاء خوادم الإعلانات.
للمساعدة في ذلك، تتضمّن حزمة تطوير البرامج لإعلانات الوسائط التفاعلية السمة 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
...
}
}