Skip to main content

Overview

Splash Ads are advertisements displayed on the splash screen when the app launches. The ad is shown alongside your app’s logo, providing a natural user experience.

Features

  • Natural ad exposure at app launch
  • Maintains brand image with app logo
  • 360dp × 270dp ad area, 288dp × 288dp logo area
  • Image ad support
  • Android 12+ system splash screen support
Use the test unit ID during development: PUBLIC_TEST_UNIT_ID_SPLASH

Caching Behavior

Splash ads are prefetched and cached on the device so the creative can appear instantly at launch, before any network request completes. On the next launch the cached creative is shown first, and a fresh ad request runs in the background to refresh the cache for subsequent launches.
Because of this prefetch model, a creative that is paused in Ad Control Console may still be shown from the device cache until the next refresh cycle completes on each user’s device. Plan creative pauses and replacements with a buffer for the cache to roll over across the install base.

Ad and Logo Sizes

Splash ads use predefined areas:
  • Logo area: 288dp × 288dp (center of screen)
  • Ad area: 360dp × 270dp (bottom of screen)
  • The ad is displayed at the bottom of the screen, with the app logo positioned at the top

Implementation Methods

Splash ads can be implemented in two ways depending on your app’s requirements:
  1. Using AdropSplashAd - Integrates with system splash screen (Android 12+)
  2. Using AdropSplashAdView - Custom splash screen configuration

Method 1: Using AdropSplashAd (System Splash Integration)

This method integrates with the system splash screen on Android 12 (API 31) and above. AdropSplashAdActivity automatically manages the splash screen.

Step 1: Configure strings.xml

Add the following settings to app/src/main/res/values/strings.xml.
res/values/strings.xml
Use PUBLIC_TEST_UNIT_ID_SPLASH instead of YOUR_SPLASH_UNIT_ID for testing.

Step 2: Add Splash Logo Image

Add your app logo to the res/drawable/ folder.
Recommended size: 288dp × 288dp (@2x: 576px, @3x: 864px)

Step 3: Configure AndroidManifest.xml

Set AdropSplashAdActivity as the launcher activity.
AndroidManifest.xml
android:exported="true" is required for AdropSplashAdActivity.

Step 4: Configure Splash Theme

Add the splash theme to res/values/themes.xml.
res/values/themes.xml
On devices below Android 12, the system splash is not displayed and AdropSplashAdActivity is shown directly.

Step 5: Customize Layout (Optional)

If you want to use a custom layout instead of the default, create activity_adrop_splash_ad.xml in your app’s res/layout/ folder.
res/layout/activity_adrop_splash_ad.xml
An ImageView with android:id="@+id/adrop_splash_ad_image" is required. The ad will be displayed in this view.

Step 6: Initialize SDK in Application

MyApplication.kt

Step 7: Implement AdropSplashAd Listener (Optional)

To receive splash ad events, set up a listener in your Application class.

AdropSplashAd Properties

AdropSplashAd Methods

shouldSkip Callback

Use the shouldSkip callback in the AdropSplashAd constructor to skip splash ads under certain conditions.
When shouldSkip returns true, the splash ad is immediately closed and navigates to the next screen.

Configure Splash Display Duration (Optional)

To change the default display duration (2 seconds), create res/values/integers.xml file and configure it.
res/values/integers.xml
The configurable range is 500ms to 3000ms. Values outside this range are automatically corrected.
You can configure to skip splash ads when the app is launched via push notification with a deep link.
res/values/bools.xml

Method 2: Using AdropSplashAdView (Custom Splash)

Use this when you want to configure a custom splash screen yourself. Create your own splash Activity and place AdropSplashAdView.

Step 1: Create Layout

activity_splash.xml

Step 2: Implement SplashActivity

Step 3: Configure AndroidManifest.xml

AndroidManifest.xml

AdropSplashAdView Properties

AdropSplashAdView Methods


Listeners

AdropSplashAdListener

Listener for when using AdropSplashAd.

AdropSplashAdViewListener

Listener for when using AdropSplashAdView.
When using AdropSplashAdView, you must implement the onAdClose method to handle the transition to the main screen.

impressed Parameter

The impressed parameter in onAdClose(ad, impressed) indicates whether the ad was actually displayed.

Cases When impressed is false

  • Ad load failure
  • Network error
  • User skipped before viewing ad
  • Insufficient ad inventory

Best Practices

1. Set Appropriate Timers

Splash ads should not be displayed too short or too long.

2. Optimize Logo Image

Prepare your app logo in appropriate sizes to minimize loading time.

3. Handle Failures

Ensure the app starts normally even when ad loading fails.

4. Distinguish Test Environment

Distinguish between development and production environments for testing.

5. Prevent Memory Leaks

Clean up listeners when Activity is destroyed.

Testing

Test Unit ID

Use the test unit ID during development.
Be sure to use the actual unit ID created in the Adrop console for production deployment. Deploying with test unit IDs will not generate ad revenue.

Debugging

Check ad events with logs.

Troubleshooting

  • Verify that AdropSplashAdActivity or custom SplashActivity is set as LAUNCHER in AndroidManifest.xml
  • Check android:exported="true" setting
  • Verify SDK initialization is complete (Application class)
  • Check that adrop_service.json file is in the assets folder
  • Check network connection status
  • Verify the unit ID is correct (strings.xml or code)
  • Verify production = false setting in test environment
  • Check onAdFailedToReceive error code
  • Verify adrop_service.json file content is correct
  • Verify adrop_splash_ad_next_activity setting is correct (full package path)
  • Check onAdClose implementation when using AdropSplashAdView
  • Verify Activity’s full qualified name (e.g., com.myapp.MainActivity)
  • Verify filename is exactly activity_adrop_splash_ad.xml
  • Check that an ImageView with android:id="@+id/adrop_splash_ad_image" ID exists
  • Clean build and re-run the app (Build > Clean Project > Rebuild Project)
This is normal. The system splash screen is not supported on devices below Android 12, and AdropSplashAdActivity is displayed directly.

Next Steps

Interstitial Ads

Display full-screen ads during screen transitions

Banner Ads

Implement banner ads

Native Ads

Custom design native ads

Rewarded Ads

Provide user rewards