Stay organized with collections
Save and categorize content based on your preferences.
class AdLoader
An object for requesting ads.
Summary
Public functions
fun isLoading
(): Boolean
Returns true
if the ad is loading. If multiple ads are requested, returns true
until all ads finish loading.
@ RequiresPermission
(value = Manifest.permission.INTERNET)
fun loadAds
(adRequest: AdRequest
!, maxNumberOfAds: Int
): Unit
Sends a request for maxNumberOfAds
ads. The AdLoader will send up to maxNumberOfAds
callbacks in response, which may include any combination of the following:
Publishers should call isLoading
inside their implementations of these methods to determine whether the AdLoader has completely finished loading ads.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License
, and code samples are licensed under the Apache 2.0 License
. For details, see the Google Developers Site Policies
. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-20 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-20 UTC."],[],[],null,["# AdLoader\n========\n\nKotlin \\|[Java](/admob/android/reference/com/google/android/gms/ads/AdLoader \"View this page in Java\") \n\n\n```\nclass AdLoader\n```\n\n\u003cbr /\u003e\n\n*** ** * ** ***\n\nAn object for requesting ads.\n\nSummary\n-------\n\n| ### Nested types |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `class `[AdLoader.Builder](/admob/android/reference/kotlin/com/google/android/gms/ads/AdLoader.Builder) Builder for a [AdLoader](/admob/android/reference/kotlin/com/google/android/gms/ads/AdLoader). |\n\n| ### Public functions |\n|------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html) | [isLoading](/admob/android/reference/kotlin/com/google/android/gms/ads/AdLoader#isLoading())`()` Returns `true` if the ad is loading. |\n| [Unit](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html) | [loadAd](/admob/android/reference/kotlin/com/google/android/gms/ads/AdLoader#loadAd(com.google.android.gms.ads.admanager.AdManagerAdRequest))`(adManagerAdRequest: `[AdManagerAdRequest](/admob/android/reference/kotlin/com/google/android/gms/ads/admanager/AdManagerAdRequest)`!)` Loads an ad. |\n| [Unit](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html) | `@`[RequiresPermission](https://developer.android.com/reference/androidx/annotation/RequiresPermission.html)`(value = Manifest.permission.INTERNET)` [loadAd](/admob/android/reference/kotlin/com/google/android/gms/ads/AdLoader#loadAd(com.google.android.gms.ads.AdRequest))`(adRequest: `[AdRequest](/admob/android/reference/kotlin/com/google/android/gms/ads/AdRequest)`!)` Loads an ad. |\n| [Unit](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html) | `@`[RequiresPermission](https://developer.android.com/reference/androidx/annotation/RequiresPermission.html)`(value = Manifest.permission.INTERNET)` [loadAds](/admob/android/reference/kotlin/com/google/android/gms/ads/AdLoader#loadAds(com.google.android.gms.ads.AdRequest,int))`(adRequest: `[AdRequest](/admob/android/reference/kotlin/com/google/android/gms/ads/AdRequest)`!, maxNumberOfAds: `[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)`)` Sends a request for `maxNumberOfAds` ads. |\n\nPublic functions\n----------------\n\n### isLoading\n\n```\nfun isLoading(): Boolean\n```\n\nReturns `true` if the ad is loading. If multiple ads are requested, returns `true` until all ads finish loading. \n\n### loadAd\n\n```\nfun loadAd(adManagerAdRequest: AdManagerAdRequest!): Unit\n```\n\nLoads an ad. \n\n| Parameters |\n|----------------------------------------------------------------------------------------------------------------------------------------|---------------------------|\n| `adManagerAdRequest: `[AdManagerAdRequest](/admob/android/reference/kotlin/com/google/android/gms/ads/admanager/AdManagerAdRequest)`!` | An Ad Manager ad request. |\n\n### loadAd\n\n```\n@RequiresPermission(value = Manifest.permission.INTERNET)\nfun loadAd(adRequest: AdRequest!): Unit\n```\n\nLoads an ad. \n\n| Parameters |\n|---------------------------------------------------------------------------------------------------|------------------------------------------------------|\n| `adRequest: `[AdRequest](/admob/android/reference/kotlin/com/google/android/gms/ads/AdRequest)`!` | An object containing all of the request information. |\n\n### loadAds\n\n```\n@RequiresPermission(value = Manifest.permission.INTERNET)\nfun loadAds(adRequest: AdRequest!, maxNumberOfAds: Int): Unit\n```\n\nSends a request for `maxNumberOfAds` ads. The AdLoader will send up to `\nmaxNumberOfAds` callbacks in response, which may include any combination of the following:\n\n- [onCustomFormatAdLoaded](/admob/android/reference/kotlin/com/google/android/gms/ads/nativead/NativeCustomFormatAd.OnCustomFormatAdLoadedListener#onCustomFormatAdLoaded(com.google.android.gms.ads.nativead.NativeCustomFormatAd))\n- [onCustomTemplateAdLoaded](/admob/android/reference/kotlin/com/google/android/gms/ads/formats/NativeCustomTemplateAd.OnCustomTemplateAdLoadedListener#onCustomTemplateAdLoaded(com.google.android.gms.ads.formats.NativeCustomTemplateAd))\n- [onNativeAdLoaded](/admob/android/reference/kotlin/com/google/android/gms/ads/nativead/NativeAd.OnNativeAdLoadedListener#onNativeAdLoaded(com.google.android.gms.ads.nativead.NativeAd))\n- [onUnifiedNativeAdLoaded](/admob/android/reference/kotlin/com/google/android/gms/ads/formats/UnifiedNativeAd.OnUnifiedNativeAdLoadedListener#onUnifiedNativeAdLoaded(com.google.android.gms.ads.formats.UnifiedNativeAd))\n- [onAdFailedToLoad](/admob/android/reference/kotlin/com/google/android/gms/ads/AdListener#onAdFailedToLoad(com.google.android.gms.ads.LoadAdError))\n\nPublishers should call [isLoading](/admob/android/reference/kotlin/com/google/android/gms/ads/AdLoader#isLoading()) inside their implementations of these methods to determine whether the AdLoader has completely finished loading ads. \n\n| Parameters |\n|---------------------------------------------------------------------------------------------------|--------------------------------------------------------|\n| `adRequest: `[AdRequest](/admob/android/reference/kotlin/com/google/android/gms/ads/AdRequest)`!` | An object containing all of the request information. |\n| `maxNumberOfAds: `[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html) | An integer denoting the maximum number of ads to load. |"]]
