Skip to content

Unity Android Advanced Usage

StartApp edited this page Mar 28, 2018 · 27 revisions
This section describes advanced usage and personal customization options and is not mandatory for the integration.

Customizing your Banner

You can show a specific banner type, or hide the banner in a specific screen or during a specific scene.

Selecting Banner Type

There are 3 different types of banners:

Banner Type Description
Automatic Banner (Recommended) Automatic selects the most suitable banner of the two listed below
Standard (2D) Banner A standard (two dimensional) banner
3D Banner A three dimensional rotating banner

We highly recommend adding an Automatic banner, which automatically selects whether to display a standard banner or a 3D banner. The banner remains displayed throughout the entire activity life-cycle.

To add a banner to your application add the following code in the appropriate place:

1. Import the SDK namespace

using StartApp;

2. Display the banner

void Start () {


BannerType - type of banner. Can receive one of the following:

BannerPosition - position of the banner. Can receive one of the following:

Hiding the Banner

In order to hide an already displayed banner, use the removeBanner() method. Simply pass the position of the banner you want to hide.

For example:


In order to show the banner again, simply use the addBanner() method as described in "Showing Banners".

Back to top

Adding a callback when Ad has been loaded

StartAppWrapper.loadAd() can get an implementation of AdEventListener as a parameter. In case you want to get a callback for the ad load, pass the object which implements StartAppWrapper.AdEventListener as a parameter to the method. This object should implement the following methods:

public void onReceiveAd(){
public void onFailedToReceiveAd(){

Adding a callback when Ad has been displayed or clicked

StartAppWrapper.showAd() can get an implementation of AdDisplayListener as a parameter. In case you want to get a callback for the ad show, pass the object which implements StartAppWrapper.AdDisplayListener as a parameter of the method. This object should implement the following methods:

public void adHidden(){
public void adDisplayed(){
public void adClicked(){

Back to top

Customizing the Splash Screen

StartApp In-Ad provides a few pre-defined templates of splash screens in which you can place your own creatives, such as application name, logo and loading animation, as described below.

Customizing the Splash Screen

In the OnGUI() method of your script, call the following static function:


Apply the following parameters:

  • splashConfig: Optional object that can be used to customize some of your template's properties to suit your needs, such as your application name, logo and theme (see the example below). For a full description of the SplashConfig API, please refer to SplashConfig API.

Example: the following is an example of a custom template with an OCEAN theme, modified application name, logo and landscape orientation:

StartAppWrapper.showSplash(new StartAppWrapper.SplashConfig()
				.setAppName("Your Application Name")
				.setLogo("Your logo")

NOTE: for optimal appearance of your Splash screen on all device densities, provide a logo of 360x360px and place it in the Resources folder of your project. If you do not provide a logo, then StartApp In-App uses the default application icon (as declared in the Manifest) and stretches it to 360x360px.

Back to top

SplashConfig API

The following describes the methods that you can use for customizing the Splash screen displayed in a StartApp In-App Splash screen Ad.

► Set the Splash screen mode

public SplashConfig setTheme(StartAppWrapper.SplashConfig.Theme theme)

Sets the Splash theme. Use one of the options below to select a design theme for your splash screen.

SplashConfig.Theme.DEEP_BLUE (default)

► Set the application name

public SplashConfig setAppName(String appName)

Sets the application name to be used in the Template mode.

String (default is the application name from the manifest).

► Set the logo

public SplashConfig setLogo(String logo)

Sets the logo to be displayed in the Template mode.

logo the logo resource name under the Resources folder (default is the icon resource from the manifest).

NOTE: if you provide a custom logo, please follow these steps:

  1. Click your logo image in the Resources folder
  2. On the menu on the right, under 'Texture Type' choose 'Advanced'
  3. Check 'Read/Write Enabled'
  4. Under 'Format' choose "RGB 24 bit"
  5. Click "Apply"

► Set the orientation

public SplashConfig setOrientation(StartAppWrapper.SplashConfig.Orientation orientation)

Sets the orientation to be used.

StartAppWrapper.SplashConfig.Orientation.PORTRAIT (default)
StartAppWrapper.SplashConfig.Orientation.AUTO (use the device's orientation upon entering the application)

Back to top

You can’t perform that action at this time.