Insiteo V4 SDK for Android
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Insiteo Android SDK

Insiteo Proximity Interaction platform allows you to easily enable your Apps with:

  • user Notifications, even when the app is not running,
  • content delivery (webviews, media content...),
  • contextualization: use in-app deep linking to bring your user right to the valuable content,
  • IoT and local interactions: control in-building devices or systems,
  • any other value-added action you may be thinking of.

To get started with our SDK, follow the steps below.

For a broader solution overview, click here


Insiteo Android SDK is available for Android 5.0 Lollipop higher.

Insiteo Android SDK Class Reference

Insiteo Android SDK class latest reference is available here.


Insiteo Android SDK has been designed to work has a modular framework to make the installation easier. Each framework brings its own features as a submodule of the Core framework which includes API usage, analytics feature and basic location services detection.

  • Core - The Core framework provides common SDK features such as Insiteo API usage, analytics tracking and location services detection (iBeacon and geofencing).
  • Push - The Push framework brings interactivity to your app. According to user location and proximity detection, you will be able to trigger actions and notify your user with notifications, web views or other custom stuff


Project Setup

  1. Insiteo's API is provided as a single Android ARchive (.aar) file. Get it here
  2. In Android Studio you can easily import this archive by right clicking on your project -> new -> module
  3. Select 'Import JAR or AAR Package'.
  4. Make sure to add the module dependency afterward.


If you haven't already, add these dependencies in build.graddle:

    compile 'com.squareup.retrofit:retrofit:2.0.0-beta2'
    compile 'com.squareup.retrofit:adapter-rxjava:2.0.0-beta2'
    compile 'com.squareup.retrofit:converter-gson:2.0.0-beta2'

Permissions on Android M

Since Android M, Google requires you to ask user permission to use their location. You need to specify in your application Info.plist which location authorization is needed. Without any key, the SDK (and your application) will not have any access to location services.

  • Just add onRequestPermissionResult to you AppCompatActivity, library will handle the rest
public class MainActivityTab extends AppCompatActivity 
private boolean isPermissionGranted = true;

    public void onRequestPermissionsResult(int requestCode,
                                           String permissions[], int[] grantResults) {

        for (int i = 0; i < grantResults.length; i++) {
            if (grantResults[i] == -1) {
                isPermissionGranted = false;
                Log.d(TAG, permissions[i] + " refused");
            } else {

                Log.w(TAG, permissions[i] + " granted");
        if (isPermissionGranted) {
        else {
            //whatever you want

Code Snippets

  • Launch the Api
    Insiteo.initWithApiKey(ActivityContext, ApiKey);
  • Stop the Api
  • Update settings
    if(Insiteo.getManager() != null) {

Where To Go From Here?