為直播載入片頭廣告
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
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();
}
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-08-01 (世界標準時間)。
[null,null,["上次更新時間: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 }"]]