为直播加载前贴片广告
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
IMA SDK 可用于通过直播和视频点播创收。
对于直播,您需要为每个广告插播时间点发送新的广告请求。
错开这些请求,确保不会有观看者在请求
导致广告服务器出现卡顿。
为帮助解决这个问题,IMA SDK 提供了 AdsRequest.liveStreamPrefetchSeconds
属性。此属性用于指定 SDK 的秒数上限
在您调用
AdsLoader.requestAds()
。实际请求时间将随机分配。对于
例如,如果您将 AdsRequest.liveStreamPrefetchSeconds
设置为 30,则 SDK
在您调用 AdsLoader.requestAds()
后,系统将等待 0 到 30 秒,
向服务器发出请求。
直播预提取功能的实际运用
我们建议您在广告插播结束后立即预提取下一个广告插播时间点。
这样可以确保预提取期限的最长时间。
假设广告插播时间点有 5 分钟。广告插播结束后
您可以请求下一个广告插播时间点,预提取时间范围为 290 秒
(5 分钟减去 10 秒,以确保在末尾
预提取窗口有足够的时间解决):
// 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();
}
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-08-01。
[null,null,["最后更新时间 (UTC):2025-08-01。"],[[["\u003cp\u003eThe IMA SDK supports monetization for both live streams and video-on-demand content.\u003c/p\u003e\n"],["\u003cp\u003eFor live streams, use the \u003ccode\u003eAdsRequest.liveStreamPrefetchSeconds\u003c/code\u003e property to stagger ad requests and prevent ad server overload.\u003c/p\u003e\n"],["\u003cp\u003ePrefetch the next ad break as soon as the current one completes to maximize the pre-fetch window.\u003c/p\u003e\n"],["\u003cp\u003eImplement a mechanism, such as a timer or server message, to trigger the playback of pre-fetched ads at the desired interval during the live stream.\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| **Note:** To see a completed live stream pre-fetch sample, check out our [GitHub sample](//github.com/googleads/googleads-ima-html5/tree/master/live_stream_prefetch).\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 // 5 minutes == 300 seconds. Include a 10 second buffer\n var AD_INTERVAL = 290;\n\n function onAdEvent(adEvent) {\n var ad = adEvent.getAd();\n switch(adEvent.type) {\n case google.ima.AdEvent.Type.ALL_ADS_COMPLETED:\n // Pre-fetch our next ad break.\n requestAds();\n // Play those ads in 5 minutes. In a real-world implementation,\n // this is likely done as the result of a message from your\n // streaming server, not a timeout.\n setTimeout(playAds, AD_INTERVAL * 1000);// Convert to ms.\n }\n }\n\n function requestAds() {\n // Destroy the current AdsManager, in case the tag you requested previously\n // contains post-rolls (don't play those now).\n if (adsManager) {\n adsManager.destroy();\n }\n // Your AdsLoader will be set up on page-load. You should re-use the same\n // AdsLoader for every request. For more info on setting up the AdsLoader,\n // see the IMA HTML5 client-side \"Set up the IMA SDK\" guide:\n // https://developers.google.com/interactive-media-ads/docs/sdks/html5/client-side/get-started\n if (adsLoader) {\n // Reset the IMA SDK.\n adsLoader.contentComplete();\n }\n var adsRequest = new google.ima.AdsRequest();\n adsRequest.adTagUrl = '...';\n adsRequest.linearAdSlotWidth = \u003clinear_width\u003e;\n adsRequest.linearAdSlotHeight = \u003clinear_height\u003e;\n adsRequest.nonLinearAdSlotWidth = \u003cnonlinear_width\u003e;\n adsRequest.nonLinearAdSlotHeight = \u003cnonlinear_height\u003e;\n adsRequest.liveStreamPrefechSeconds = AD_INTERVAL;\n adsLoader.requestAds(adsRequest);\n }\n\n function playAds() {\n adsManager.init(\u003clinear_width\u003e, \u003clinear_height\u003e);\n adsManager.start();\n }"]]