AppLovin Unity Plugin 5.5.0 introduces App Open Ad format. App Open Ads are similar to interstitial ads but show when the user soft launches or cold starts the app:
- Cold start
- creating new session of the app on device
- the app is not in device memory
- splash/loading screen required
- Soft launch
- bringing the app from background to foreground, turning the phone on when the app is in foreground mode
- the app is suspended in memory
- splash/loading screen required
FireOS Applications are not supported.
Best Practices
- Use a splash/loading screen before the “app open” ad shows, regardless of the placement with the app.
- Include a call-out to the user that they will see an ad within the Splash/Loading screen.
- Example: “Watch an ad from their sponsor while the app loads.”
- The key is to ensure the user is not exposed to actual app content before the ad is shown. The sequence should be splash/loading screen ⇒ app open ad ⇒ app content.
- Include a call-out to the user that they will see an ad within the Splash/Loading screen.
- Ensure that AppLovin’s SDK is initialized before you load an app open ad.
- When an app open ad is not loaded (i.e. on cold start), load all other ad formats later to avoid parallel loading with the app open ad.
- Loading multiple ad formats in parallel is not good for the device’s resources or ad demand SDKs.
- To avoid over-exposure to App Open Ads, AppLovin suggests that you consider the following strategies:
- Use a frequency cap that you manage outside of AppLovin so that you have full control over when the ads will serve.
- Implement a cool down period (i.e. don’t show an ad on soft launch for some period of time before you show one again, or show on every other soft launch) based on app user behavior.
- Wait until new users open the app and use it a few times before you show the first App Open Ad.
Using an App Open Ad
To ensure your app open ad is ready when your application is brought to the foreground, you need to preload an app open ad. Implement a utility class to make ad requests before your ad needs to be shown. Create a method that shows an ad if ready, and call it when the app is brought to the foreground. Your app then attempts to show an ad on app open, or loads an ad if one is not not preloaded.
If you have a loading screen under the app open ad, and your loading screen completes loading before the ad is dismissed, you may want to dismiss your loading screen in the didHide
method.
Listen for App Foregrounding Events
To be notified of app foregrounding events, AppLovin recommends that you listen to the OnApplicationPause
event. By overriding the OnApplicationPause
method, your app will be alerted to app launch and foregrounding events and will be able to show the ad.
Cold Starts and Loading Screens
The delay between when you request an ad and receive an ad to show can cause the user to briefly see your app before being surprised by an out-of-context ad. You should avoid this, as it is a bad user experience. The preferred way to handle cold starts is to use a loading screen to precede any initial app content, and to show the ad from the loading screen. If the app shows any of your app content after the loading screen, do not show the ad. If you have a loading screen under the app open ad, and your loading screen completes loading before the ad is dismissed, you may want to dismiss your loading screen in the didHide
method.
Example
These code examples assume that app open ads are only shown on “soft lauch” when your app is suspended in memory, and do not include the splash/loading screen. The App Developer must handle the splash/loading screen—see Best Practices.
public class ExampleHomeScreen : MonoBehaviour { void Start() { MaxSdkCallbacks.OnSdkInitializedEvent += sdkConfiguration => { MaxSdkCallbacks.AppOpen.OnAdHiddenEvent += OnAppOpenDismissedEvent; AppOpenManager.Instance.ShowAdIfReady(); }; MaxSdk.SetSdkKey("sdk_key"); MaxSdk.InitializeSdk(); } public void OnAppOpenDismissedEvent(string adUnitId, MaxSdkBase.AdInfo adInfo) { MaxSdk.LoadAppOpenAd(AppOpenAdUnitId); } private void OnApplicationPause(bool pauseStatus) { if (!pauseStatus) { AppOpenManager.Instance.ShowAdIfReady(); } } } public class AppOpenManager {
#if UNITY_IOS private const string AppOpenAdUnitId = "ios_ad_unit_ID";
#else // UNITY_ANDROID
private const string AppOpenAdUnitId = "android_ad_unit_ID";
#endif public void ShowAdIfReady() { if (MaxSdk.IsAppOpenAdReady(AppOpenAdUnitId)) { MaxSdk.ShowAppOpenAd(AppOpenAdUnitId); } else { MaxSdk.LoadAppOpenAd(AppOpenAdUnitId); } } }
Supported Adapter Versions
Ad Network | Minimum Adapter Version |
---|---|
Google bidding and Google AdMob | 21.2.0.2 (Android), 9.11.0.1 (iOS) |
Mintegral | 7.2.3.0.1 (iOS) |
Pangle | 4.6.0.4.0 (Android), 4.6.2.2.1 (iOS) |
Vungle | 6.12.0.2 (Android), 6.12.0.3 (iOS) |