Melhorar o tempo de carregamento do IMA
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
O SDK do IMA carrega dependências para solicitar anúncios, medir a visibilidade e
relatar impressões de anúncios. Ao inicializar o IMA antes de fazer uma solicitação de anúncio, você
maximiza o tempo para carregar as dependências do IMA antes da reprodução do anúncio. Esta página aborda
como gerenciar os tempos de carregamento do IMA no app.
Ligar para ImaSdkFactory.initialize()
O método
ImaSdkFactory.initialize()
começa a carregar previamente os recursos do SDK antes da primeira solicitação de anúncio. Para
usar initialize()
, você precisa da IMA versão 3.35.1 ou mais recente.
Chame ImaSdkFactory.initialize()
na inicialização do app ou o mais cedo possível no
ciclo de vida do app, conforme permitido pela estrutura do app. A chamada initialize()
usa os seguintes parâmetros:
context
: usa o contexto do aplicativo, que está sempre disponível durante
o ciclo de vida do aplicativo.
settings
: transmita um objeto
ImaSdkSettings
com os valores definidos. As configurações do IMA usadas na chamada initialize()
precisam ser iguais aos valores de configuração usados na chamada
createAdsLoader()
. O SDK do IMA usa essas configurações, principalmente a configuração de idioma,
para a chave de cache. Não recomendamos o uso de valores de teste ou falsos para as configurações
usadas na chamada do método initialize()
, porque podem ocorrer falhas de cache e
aumentar o tempo de carregamento do anúncio.
Reutilizar a instância AdsLoader
Para melhorar o tempo de carregamento do IMA, recomendamos reutilizar a mesma
instância
AdsLoader
. A interface AdsLoader
pode processar várias solicitações de anúncios ou de streaming.
Evite criar uma nova instância de AdsLoader
para cada solicitação. A criação de uma nova
instância AdsLoader
exige um tempo de carregamento e usa mais recursos do dispositivo.
Solicitar anúncios antes da reprodução
Se você tiver acesso à instância AdsLoader
antes de iniciar a reprodução do anúncio,
também poderá chamar o método
AdsLoader.requestAds()
antes do tempo. Essa chamada inicia o carregamento dos anúncios precedentes. Quando o usuário
estiver pronto para iniciar a reprodução de conteúdo, chame o método
AdsManager.init()
e aguarde o evento LOADED
para exibir anúncios.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-31 UTC.
[null,null,["Última atualização 2025-08-31 UTC."],[],[],null,["# Improve IMA load time\n\nThe IMA SDK loads dependencies to request ads, measure viewability and\nreport ad impressions. By initializing IMA before you make an ad request, you\nmaximize the time to load IMA dependencies before ad playback. This page covers\nhow to handling IMA load times in your app.\n\nCall `ImaSdkFactory.initialize()`\n---------------------------------\n\nThe\n[`ImaSdkFactory.initialize()`](/interactive-media-ads/docs/sdks/android/client-side/api/reference/com/google/ads/interactivemedia/v3/api/ImaSdkFactory#initialize(android.content.Context,com.google.ads.interactivemedia.v3.api.ImaSdkSettings))\nmethod starts to preload SDK resources in advance of the first ad request. To\nuse `initialize()`, you need IMA version 3.35.1 or higher.\n\nCall `ImaSdkFactory.initialize()` on application startup, or as early in the\napplication's lifecycle as your app structure allows. The `initialize()` call\ntakes the following parameters:\n\n- **`context`**: Uses the application context, which is always available during the lifecycle of the application.\n- **`settings`** : Pass the an [`ImaSdkSettings`](/interactive-media-ads/docs/sdks/android/client-side/api/reference/com/google/ads/interactivemedia/v3/api/ImaSdkSettings) object with its values set. The IMA settings used in the `initialize()` call must be the same as the settings values used in the `createAdsLoader()` call. The IMA SDK utilizes these settings, particularly the language setting, for cache key. We don't recommend using test or fake values for the settings used in the `initialize()` method call, as cache misses might occur and increase ad load time.\n\nReuse the `AdsLoader` instance\n------------------------------\n\nTo improve IMA load time, we recommend you reuse the same\n[`AdsLoader`](/interactive-media-ads/docs/sdks/android/client-side/api/reference/com/google/ads/interactivemedia/v3/api/AdsLoader)\ninstance. The `AdsLoader` interface can handle multiple ad or stream requests.\nAvoid creating a new `AdsLoader` instance for each request. Creating a new\n`AdsLoader` instance requires a load time, and uses additional device resources.\n\nRequest ads in advance of playback\n----------------------------------\n\nIf you have access to the `AdsLoader` instance prior to starting ad playback,\nyou can also call the\n[`AdsLoader.requestAds()`](/interactive-media-ads/docs/sdks/android/client-side/api/reference/com/google/ads/interactivemedia/v3/api/AdsLoader#requestAds(com.google.ads.interactivemedia.v3.api.AdsRequest))\nmethod early. Making this call starts loading pre-roll ads. When the user\nis ready to start content playback, call the\n[`AdsManager.init()`](/interactive-media-ads/docs/sdks/android/client-side/api/reference/com/google/ads/interactivemedia/v3/api/BaseManager#init())\nmethod and wait for the `LOADED` event to play ads."]]