Getting Started

View original article on our GitHub

IMPORTANT: This is a mandatory step

Step 1, Adding the SDK to Your Project

Copy the StartAppInApp-x.x.x.jar file from the SDK zip to the “libs” directory of your project.

Step 2, Updating Your AndroidManifest.xml File


Under the main <manifest> element, add the following permissions.

Mandatory Permissions:

<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>

Optional Permissions (allow StartApp to show higher eCPM Geo-targeted ads):

<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

StartApp SDK doesn't request location updates proactively but only uses the last known location.


Under the <application> element, add the following activities:

<activity android:name=""
          android:theme="@android:style/Theme" />

<activity android:name=""
          android:configChanges="orientation|keyboardHidden|screenSize" />

<activity android:name=""
          android:configChanges="orientation|keyboardHidden|screenSize" />

Step 3, Initialization

In your main activity, go to the OnCreate method and before calling setContentView() call the static function:

StartAppSDK.init(this, "Your App ID", true);

Replace "Your App ID" with your own value provided in the publisher’s portal.

To find your application ID, click on the "Apps and Sites" tab on the left pane and choose the relevant ID from your app list:

The last true parameter enables "Return Ads". If you want to disable this feature, simply passfalse instead.

Please notice - if you initialize the SDK in a service, you must do it on the service's main thread.

Was this article helpful?
4 out of 4 found this helpful
Have more questions? Submit a request