IMA SDK는 실시간 스트림 및 VOD로 수익을 창출하는 데 사용할 수 있습니다.
라이브 스트림의 경우 각 광고 시점에 대해 새로운 광고 요청을 해야 합니다.
모든 시청자가 요청하지 않도록 시차를 두고 요청을 보내세요.
광고를 동시에 게재하며 광고 서버를 지연시킬 수 있습니다.
이를 위해 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 buffervarAD_INTERVAL=290;functiononAdEvent(adEvent){varad=adEvent.getAd();switch(adEvent.type){casegoogle.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.}}functionrequestAds(){// 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-startedif(adsLoader){// Reset the IMA SDK.adsLoader.contentComplete();}varadsRequest=newgoogle.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);}functionplayAds(){adsManager.init(<linear_width>,<linear_height>);adsManager.start();}
[null,null,["최종 업데이트: 2025-08-01(UTC)"],[[["\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 }"]]