[IDEs, Libraries, & Programming Tools] illuminatic:
How to integrate the SDK

1. Download the SDK from the download link above. Extract the zip file.

2. Zip file contains 2 files

(i) GetBackOnTrack.jar (The SDK)

(ii) GetBackOnTrackAdmin.apk (The Admin control pannel)

3. Now the 1st thing you do is install the apk on your phone(it uses only Internet permission).

- Start the app and register with your email id and password (please remember the password, coz i am yet to implement the forgot password functionality :P).

- Now there will be 2 buttons 1. Add app 2. Refresh.

- Press "Add app" button > Enter your app packagename (be careful, the packagename should be same as your application packagename otherwise it will not work) > press save

- If there are no errors your new app will be registered and you will get back to the "Registered Apps" screen.

Press Refresh, you will see your new app in the list.

- your app is now activated and the SDK is ready to be integrated in your application.

4. Now copy the SDK in your app's libs folder.

- open your AndroidManifest.xml

- Add the Internet permisson

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

- copy these lines inside your <application></application> tag.

<activity
android:name="com.lib.getbackontrack.AlertActivity "
android:theme="@android:style/Theme.Black.NoTitleBar.Fullscreen" />
<activity
android:name="com.lib.getbackontrack.AdActivity"
android:theme="@android:style/Theme.Black.NoTitleBar.Fullscreen" />

- open your MainActivity(the first activity of your app) and copy the line below inside your onCreate().

GetBackOnTrack.initialize("YOUREMAILID@somesite.co m", "PASSWORD", getApplicationContext());

- That's it

- The above line initializes the SDK and checks if your app is suspended or not from the server, if it is suspended than a pop over is shown with your custom message and new packagename else it will show a house ad(if available) once a day.

- If you display ads on app launch as well than with the above code use a listener as well and implement your ad display code inside it coz if your app is suspended then you will only want to show the pop over for your new app and not your ad (if your fine with displaying pop over as well as ad then you don't have to implement it ;D).

copy the listener code below and paste it below "GetBackOnTrack.initialize("YOUREMAILID@somesite.c om", "PASSWORD", getApplicationContext());" method

GetBackOnTrack.setPostLibraryListener(new PostLibraryInitialization() {

@Override
public void onNoAlertDisplayed()
{
// TODO Add your ad display code here..

}
});

- We are done

5. Now if your app got suspended than publish your new app again with different packagename(obviously) and open your GetBackOnTrackAdmin app

- Login with your registered Email ID and Password.

- You will see your registered app packagename(which is suspended now).

- Select your app > you will be taken to "App Details" screen

- Now fill in the details like - 1. Your new package name 2. Small heading for your new app (like App Moved!!) 3. Sub heading (like Get the updated version now!!) 4. Press the seekbar so that your App Status shows : "App Active : NO" and finally save.

- That's it, whenever your users open your previous app they will receive a pop over with your custom message.

- Users will click on download button and will be redirected to your new google play app page.

This is it.

Feel free to ask any question and i'll help you out.

And please give your valuable suggestions

Thank You