Splash Ads

2. Load a Splash Ad

💡Please call this function in advance to reduce user waiting time.

ATSplashAd splashAd = new ATSplashAd(context, "your placement id", new ATSplashAdEZListener() {

    @Override
    public void onAdLoaded() {
        if (inForeBackground) {
            // Show the ad only when the current Activity is in the foreground
        }
    }

    @Override
    public void onNoAdError(AdError adError) {
        // If loading fails, directly enter the app's homepage
        ...
    }

    @Override
    public void onAdShow(ATAdInfo entity) { }

    @Override
    public void onAdClick(ATAdInfo entity) { }

    @Override
    public void onAdDismiss(ATAdInfo entity, ATSplashAdExtraInfo splashAdExtraInfo) {
        // After the ad display is closed, enter the app's homepage
        ...
    }
});
splashAd.loadAd();

3. Show a Splash Ad

💡Tips:

• Before displaying the ad,  callSplashAd#isAdReady(). If the returned value is true, then show the ad; if the value is false, load the ad in real-time and wait for it to be fully loaded before displaying.
• Before displaying splash ads, you need to ensure that the current Activity is in the foreground.
• The container in which the splash ad is displayed must occupy at least 75% of the screen.

if (splashAd.isAdReady()) {
    ATShowConfig showConfig = new ATShowConfig.Builder()
                .scenarioId("your scenario id")
                .build();
    //The container size should occupy at least 75% of the screen
    splashAd.show(activity, container, null, showConfig);
}else{
    //Reload
    splashAd.load();
}

4. Ad Scenario Statistics

Track the scene arrival rates, which are presented in the TopOn dashboard under Report -> Funnel Report -> Scenario.

• First, call entryAdScenario()
• Then, call isAdReady()
• Finally, call show() to display the ad

ATSplashAd.entryAdScenario("your placement id", "your scenario id");
if (splashAd.isAdReady()) {
   ATShowConfig showConfig = new ATShowConfig.Builder()
                .scenarioId("your scenario id")
                .build();
    splashAd.show(activity，showConfig);
} else {
   splashAd.load();
}

5. Advanced

Preset strategy : By configuring preset strategies, you can improve the ad loading performance during the app's initial cold start.

Customized splash ads : Native ad source mixed with splash placement. Refer here to obtain more information about AD Format Mixed.

6. Note

● AdMob

1. The splash ads of AdMob do not require a container for display
2. They can only be presented in full-screen mode
3. After the ad is shown, there is no countdown, and it will not skip automatically