Type Function Return value none Revision Release 2024.3703 Keywords ads, advertising, AppLovin, show See also applovin.init() applovin.load() applovin.isLoaded() applovin.*
Shows a AppLovin ad which was previously loaded via applovin.load().
applovin.show( adType [, placement] )
Table. Table containing AppLovin ad loading options.
The params
table includes parameters for the AppLovin ad loading.
String. The placement to be used. This must be identical to one of the placements defined for the app in the AppLovin developer portal.
String. Only applicable for banner ads. Valid values: "top"
, "center"
and "bottom"
. Default is "top"
.
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.
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