Carregar anúncios precedentes para a transmissão ao vivo
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
O SDK do IMA pode ser usado para gerar receita com transmissões ao vivo e vídeos sob demanda.
Nas transmissões ao vivo, você precisa fazer uma nova solicitação de anúncio para cada intervalo.
Dimensione essas solicitações para garantir que todos os espectadores não estejam fazendo
anúncios ao mesmo tempo e sobrecarregando os servidores de anúncios.
Para ajudar nisso, o SDK do IMA tem o AdsRequest.liveStreamPrefetchSeconds
. Esta propriedade especifica o número máximo de segundos que o SDK
deve aguardar antes de entrar em contato com o servidor de anúncios depois da chamada
AdsLoader.requestAds(): O horário real da solicitação será aleatório. Para
Por exemplo, se você definir AdsRequest.liveStreamPrefetchSeconds como 30, o SDK
aguarda de 0 a 30 segundos após você chamar AdsLoader.requestAds() para
fazer a solicitação ao servidor.
Pré-busca de transmissão ao vivo na prática
Recomendamos fazer a pré-busca do próximo intervalo de anúncio assim que ele for concluído.
Isso garante que o período máximo de tempo esteja disponível para sua janela de pré-busca.
Suponha que você tenha 5 minutos entre os intervalos de anúncio. Quando um intervalo de anúncio termina,
será possível solicitar o próximo intervalo de anúncio com uma janela de pré-busca de 290 segundos
(5 minutos menos 10 segundos, para garantir que as solicitações enviadas ao final do
se a janela de pré-busca tiver tempo suficiente para resolver):
// 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,["Última atualização 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 }"]]