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 gerar relatórios de 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 processar tempos de carregamento do IMA no seu app.
Ligar para ImaSdkFactory.initialize()
O método
ImaSdkFactory.initialize()
começa a pré-carregar recursos do SDK antes da primeira solicitação de anúncio. Para
usar initialize()
, você precisa da versão 3.35.1 ou mais recente da IMA.
Chame ImaSdkFactory.initialize()
na inicialização do aplicativo ou o mais cedo possível no ciclo de vida do aplicativo, conforme a estrutura do app permitir. 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 da IMA usadas na chamada initialize()
precisam ser as mesmas usadas na chamada createAdsLoader()
. O SDK do IMA usa essas configurações, principalmente a 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 da IMA, recomendamos reutilizar a mesma instância
AdsLoader
. A interface AdsLoader
pode processar várias solicitações de anúncio ou stream.
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 recursos extras do dispositivo.
Solicitar anúncios antes da reprodução
Se você tiver acesso à instância AdsLoader
antes de iniciar a reprodução de anúncios,
também poderá chamar o método
AdsLoader.requestAds()
antecipadamente. Fazer essa chamada inicia o carregamento de 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 veicular 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-09-05 UTC.
[null,null,["Última atualização 2025-09-05 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."]]