applovin.show()

Type Function
Return value none
Revision Release 2025.3721
Keywords ads, advertising, AppLovin, show
See also applovin.init()
applovin.load()
applovin.isLoaded()
applovin.*

Overview

Shows a AppLovin ad which was previously loaded via applovin.load().

Syntax

applovin.show( adType [, placement] )
adType (required)

String. One of the following values:

  • "banner"
  • "interstitial"
  • "rewardedVideo"
params (optiional)

Table. Table containing AppLovin ad loading options.

Parameter Reference

The params table includes parameters for the AppLovin ad loading.

placement (optional)

String. The placement to be used. This must be identical to one of the placements defined for the app in the AppLovin developer portal.

y (optional)

String. Only applicable for banner ads. Valid values: "top", "center" and "bottom". Default is "top".

Notes

  • When you use "interstitial", both static interstitial ads and video interstitial ads may be shown. 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.

Example

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 )

    elseif ( event.phase == "displayed" or event.phase == "playbackBegan" ) then  -- The ad was displayed/played
        print( event.type )

    elseif ( event.phase == "hidden" or event.phase == "playbackEnded" ) then  -- The ad was closed/hidden
        print( event.type )

    elseif ( event.phase == "clicked" ) then  -- The ad was clicked/tapped
        print( event.type )
    end
end

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

-- Sometime later, show the ad
local isAdLoaded = applovin.isLoaded( "interstitial" )
if ( isAdLoaded == true ) then
    applovin.show( "interstitial" )
end