تحميل إعلانات ما قبل التشغيل للبث المباشر
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يمكن استخدام حزمة تطوير البرامج لإعلانات الوسائط التفاعلية لتحقيق الربح من أحداث البث المباشر والفيديوهات عند الطلب.
بالنسبة إلى أحداث البث المباشر، عليك تقديم طلب إعلان جديد لكل فاصل إعلاني.
نظِّم هذه الطلبات للتأكّد من أنّ كلّ المشاهدين لا يطلبون المساعدة.
الإعلانات في الوقت نفسه وعرقلة خادم(خوادم) الإعلانات.
للمساعدة في هذا الأمر، تحتوي حزمة تطوير البرامج لإعلانات الوسائط التفاعلية على 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
...
}
}
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-01 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-01 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe IMA SDK allows for monetization of both live streams and video-on-demand content through ad integration.\u003c/p\u003e\n"],["\u003cp\u003eFor live streams, stagger ad requests using the \u003ccode\u003eAdsRequest.liveStreamPrefetchSeconds\u003c/code\u003e property to prevent ad server overload.\u003c/p\u003e\n"],["\u003cp\u003eSetting \u003ccode\u003eAdsRequest.liveStreamPrefetchSeconds\u003c/code\u003e introduces a randomized delay (within the specified range) before the SDK requests ads, helping distribute the load.\u003c/p\u003e\n"],["\u003cp\u003eIt's recommended to pre-fetch the next ad break immediately after the current one finishes, maximizing the pre-fetch window and ensuring smoother transitions.\u003c/p\u003e\n"],["\u003cp\u003eExample code snippets (Objective-C and Swift) demonstrate how to implement live stream pre-fetching and manage ad breaks effectively.\u003c/p\u003e\n"]]],[],null,["# Load pre-roll ads for livestream\n\nThe IMA SDK can be used to monetize live streams as well as video-on-demand.\nFor live streams, you need to make a new ad request for each ad break.\nStagger these requests to ensure that all of your viewers aren't requesting\nads at the same time and bogging down the ad server(s).\n\nTo help with this, the IMA SDK has the `AdsRequest.liveStreamPrefetchSeconds`\nproperty. This property specifies the maximum number of seconds the SDK\nshould wait before reaching out to the ad server after you call\n`AdsLoader.requestAds()`. The actual request time will be randomized. For\nexample, if you set `AdsRequest.liveStreamPrefetchSeconds` to 30, the SDK\nwaits 0 to 30 seconds after you call `AdsLoader.requestAds()` to actually\nmake the request to the server.\n\nLive stream pre-fetch in practice\n---------------------------------\n\nWe recommend pre-fetching your next ad break as soon as an ad break completes.\nThis ensures the maximum length of time is available for your pre-fetch window.\nSuppose you have 5 minutes between ad breaks. When an ad break completes,\nyou can request your next ad break with a pre-fetch window of 290 seconds\n(5 minutes minus 10 seconds, to make sure the requests sent at the end of\nthe pre-fetch window have enough time to resolve): \n\n### Objective-C\n\n\n - (void)adsManager:(IMAAdsManager *)adsManager didReceiveAdEvent:(IMAAdEvent *)event {\n\n ...\n\n switch (event.type) {\n\n ...\n\n case kIMAAdEvent_ALL_ADS_COMPLETED:\n\n IMAAdsRequest *request = [[IMAAdsRequest alloc]\n initWithAdTagUrl: self.adTagUrl\n adDisplayContainer: self.adDisplayContainer\n avPlayerVideoDisplay: self.avPlayerVideoDisplay\n pictureInPictureProxy: self.pictureInPictureProxy\n userContext: nil];\n\n // set a delay between the end of the last ad\n // in the last request, and the first ad from\n // the new request\n Float64 adGap = 30;\n // make sure the request occurs at least five\n // seconds before starting the new set of ads\n request.liveStreamPrefetchSeconds = adGap - 5;\n [self.adsLoader requestAdsWithRequest:request];\n // start new ads after adGap seconds have elapsed\n dispatch_after(dispatch_time(DISPATCH_TIME_NOW, adGap * NSEC_PER_SEC), dispatch_get_main_queue(), ^{\n [adsManager start];\n });\n\n break;\n\n ...\n\n }\n\n ...\n\n }\n\n### Swift\n\n func adsManager(_ adsManager: IMAAdsManager!, didReceive event: IMAAdEvent!) {\n switch event.type {\n\n ...\n\n case IMAAdEventType.ALL_ADS_COMPLETED:\n\n let request = IMAAdsRequest(\n adTagUrl: AdTagUrl,\n adDisplayContainer: adDisplayContainer,\n contentPlayhead: contentPlayhead,\n userContext: nil)\n\n // set a delay between the end of the last ad\n // in the last request, and the first ad from\n // the new request\n let adGap = 30\n // make sure the request occurs at least five\n // seconds before starting the new set of ads\n request.liveStreamPrefetchSeconds = adGap - 5\n adsLoader.requestAds(with: request)\n // start new ads after adGap seconds have elapsed\n DispatchQueue.main.asyncAfter(deadline: .now() + adGap) {\n adsManager.start()\n }\n\n break\n\n ...\n }\n }"]]