Home

Banner Ads

Banner is a rectangle filled with an advertising content, displayed on the screen without interrupting the flow of your app.

// Toggle banner ad

if(isBannerAdVisible) {
    isBannerAdVisible = false;
    Enhance.hideBannerAd();
}

var callback = function(result) {
    if(!result) {
        app.writeLog('Banner ad is not ready');
        return;
    }

    isBannerAdVisible = true;
    Enhance.showBannerAdWithPosition(Enhance.Position.BOTTOM);
};

Enhance.isBannerAdReady(callback);

Methods

Enhance.isBannerAdReady

void Enhance.isBannerAdReady(
    Function resultCallback,
    optional String placement = "default"
)

Check if an ad from any of the included SDK providers is ready to be shown.

Parameters:

Function  resultCallback - Specifices the callback function.

optional String  placement - Specifies the internal placement of the ad (from the Enhance mediation editor).

Return Value:

Returns true to the callback function if any ad is ready, false otherwise. When app is not Enhanced, always returns true.

Enhance.showBannerAdWithPosition

void Enhance.showBannerAdWithPosition(
    String position,
    optional String placement = "default"
)

Display an ad if any is currently available. The ad provider is selected based on your app's mediation settings.

Parameters:

String  position - Specifies the position of this ad on the screen. See the Properties section for the values you can use.

optional String  placement - Specifies the internal placement of the ad (from the Enhance mediation editor).

Enhance.hideBannerAd

void Enhance.hideBannerAd()

Hide the banner ad which is currently visible, if any.

Properties

String Enhance.Position.TOP

Indicates that the banner will be shown on the top of the screen.


String Enhance.Position.BOTTOM

Indicates that the banner will be shown on the bottom of the screen.