تبلیغات پیش از پخش را برای پخش زنده بارگیری کنید
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
از IMA SDK میتوان برای کسب درآمد از جریانهای زنده و همچنین ویدیوهای درخواستی استفاده کرد. برای پخش جریانی زنده، باید برای هر وقفه تبلیغاتی یک درخواست آگهی جدید ارائه دهید. این درخواستها را تکان دهید تا مطمئن شوید که همه بینندگان شما به طور همزمان درخواست تبلیغات نمیکنند و سرور(های) تبلیغات را دچار مشکل نمیکنند.
برای کمک به این امر، IMA SDK دارای ویژگی AdsRequest.liveStreamPrefetchSeconds
است. این ویژگی حداکثر ثانیهای را مشخص میکند که SDK باید قبل از تماس با سرور آگهی پس از فراخوانی AdsLoader.requestAds()
منتظر بماند. زمان واقعی درخواست تصادفی خواهد شد. به عنوان مثال، اگر AdsRequest.liveStreamPrefetchSeconds
را روی 30 تنظیم کنید، SDK پس از فراخوانی AdsLoader.requestAds()
0 تا 30 ثانیه منتظر می ماند تا در واقع درخواست را به سرور ارسال کند.
پخش زنده از پیش واکشی در عمل
توصیه می کنیم به محض اتمام وقفه آگهی، وقفه آگهی بعدی خود را از قبل واکشی کنید. این تضمین می کند که حداکثر مدت زمان برای پنجره پیش واکشی شما در دسترس است. فرض کنید بین وقفه های تبلیغاتی 5 دقیقه فرصت دارید. وقتی یک وقفه تبلیغاتی کامل شد، میتوانید وقفه آگهی بعدی خود را با یک پنجره پیش واکشی 290 ثانیهای (5 دقیقه منهای 10 ثانیه، برای اطمینان از اینکه درخواستهای ارسالشده در انتهای پنجره پیش واکشی زمان کافی برای حل کردن دارند) درخواست کنید. :
این تکههای کد نشان میدهند که چگونه میتوان پیش واکشی جریان زنده را به مثال پیشرفته اضافه کرد، اما این رویکرد میتواند برای سایر پیادهسازیهای 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 via 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);
}
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-01 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-01 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThe IMA SDK supports monetizing live streams and video-on-demand content through ad integration.\u003c/p\u003e\n"],["\u003cp\u003eFor live streams, stagger ad requests to avoid overloading ad servers by utilizing the \u003ccode\u003eAdsRequest.liveStreamPrefetchSeconds\u003c/code\u003e property for pre-fetching.\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 for smoother ad transitions.\u003c/p\u003e\n"],["\u003cp\u003eThe provided code snippets demonstrate how to implement live stream pre-fetching within the Advanced Example, showcasing the integration with the IMA SDK.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eAdsRequest.liveStreamPrefetchSeconds\u003c/code\u003e property randomizes the actual request time within the specified maximum duration to further optimize ad delivery.\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| **Key Point:** The [Getting started guide](/interactive-media-ads/docs/sdks/android/client-side) and the [Basic Example](//github.com/googleads/googleads-ima-android/tree/main/basicexample) both implement the [Exoplayer-IMA extension](//github.com/google/ExoPlayer/tree/release-v2/extensions/ima) which handles the setup of the AdsManager. Because of this, these resources are not able to be used as a starting point for this guide. We recommend using the [Advanced Example](//github.com/googleads/googleads-ima-android/tree/main/AdvancedExample) as a starting point for live stream pre-fetch.\n\nThese code snippets show how to add live stream pre-fetch to the\n[Advanced Example](//github.com/googleads/googleads-ima-android/tree/main/AdvancedExample)\n, but the approach can applied to other IMA implementations.\n\n**VideoPlayerController.java** \n\n```gdscript\n/** Ads logic for handling the IMA SDK integration code and events. */\npublic class VideoPlayerController {\n\n // 5 minutes == 300 seconds. Include a 10 second buffer\n private float AD_INTERVAL = 290;\n private double AD_TIMEOUT = 300;\n\n...\n\n adsManager.addAdEventListener(\n new AdEvent.AdEventListener() {\n /** Responds to AdEvents. */\n @Override\n public void onAdEvent(AdEvent adEvent) {\n\n ...\n\n case ALL_ADS_COMPLETED:\n if (adsManager != null) {\n adsManager.destroy();\n adsManager = null;\n }\n\n // When pre-fetching for live streams, be sure to destroy the current AdsManager,\n // in case the tag you requested previously contains post-rolls\n // (you don't want to play those now).\n\n // Pre-fetch the next ad break.\n // Play those ads in ~5 minutes. In a real-world implementation,\n // this will likely be done as the result of a message from your\n // streaming server, not a via the playAdsAfterThisTime parameter\n // of requestAndPlayAds().\n requestAndPlayAds(AD_TIMEOUT);\n break;\n default:\n break;\n }\n }\n\n...\n\npublic void requestAndPlayAds(double playAdsAfterThisTime) {\n if (currentAdTagUrl == null || currentAdTagUrl == \"\") {\n log(\"No VAST ad tag URL specified\");\n resumeContent();\n return;\n }\n\n // Since you're switching to a new video, tell the SDK the previous video is finished.\n if (adsManager != null) {\n adsManager.destroy();\n }\n\n playButton.setVisibility(View.GONE);\n\n // Create the ads request.\n AdsRequest request = sdkFactory.createAdsRequest();\n request.setAdTagUrl(currentAdTagUrl);\n request.setContentProgressProvider(videoPlayerWithAdPlayback.getContentProgressProvider());\n request.setLiveStreamPrefetchSeconds(AD_INTERVAL);\n\n playAdsAfterTime = playAdsAfterThisTime;\n\n // Request the ad. After the ad is loaded, onAdsManagerLoaded() will be called.\n adsLoader.requestAds(request);\n}\n```"]]