Type Function
Return value none
Revision Release 2020.3619
Keywords ads, advertising, AppLovin, load
See also


Preloads a AppLovin ad. You can also call applovin.isLoaded() to verify that the ad has been loaded and to show it.


applovin.load( adType )
adType (required)

String. One of the following values:

  • "banner"
  • "interstitial"
  • "rewardedVideo"
  • When you use "interstitial", both static interstitial ads and video interstitial ads may be loaded. You configure the type of ads to be used in the AppLovin developer portal.

  • You must enable "Rewarded Video" in the AppLovin developer portal to receive rewarded videos in your app.

  • Rewarded video offers can be limited to a certain amount in a given day, defined under "frequency capping" in the AppLovin developer portal. If you are using frequency capping, we recommend that you check for an event.phase value of "validationExceededQuota" to determine if the limit has been reached. When this occurs, you may consider loading/showing an interstitial ad instead.

params (optiional)

Table. Table containing AppLovin ad loading options.

Parameter Reference

The params table includes parameters for the AppLovin ad loading.

bannerSize (optional)

String. Valid values: "standard" (typically 320 x 50), "leader" (typically 768 x 90) and "mrec" (typically 320 x 250). Default is "standard".


local applovin = require( "plugin.applovin" )

local function adListener( event )

    if ( event.phase == "init" ) then  -- Successful initialization
        print( event.isError )
        -- Load an AppLovin ad
        applovin.load( "interstitial" )

    elseif ( event.phase == "loaded" ) then  -- The ad was successfully loaded
        print( event.type )

    elseif ( event.phase == "failed" ) then  -- The ad failed to load
        print( event.type )
        print( event.isError )
        print( event.response )

-- Initialize the AppLovin plugin
applovin.init( adListener, { sdkKey="YOUR_SDK_KEY" } )