This guide is for the Android plugin version 1.x. These steps aren’t needed for plugin version 2.x.

Since Plot Plugin v1.7.0 we support iBeacons on Android! This means that you can now receive notifications when your Android device is near an iBeacon. Please note that this is an entirely optional feature that requires some extra integration steps. Your app will still work on Android without integrating iBeacon support.

To integrate iBeacon support, there are just a few steps to get your app ready!

Step 1: Integrate Plot

Make sure you have integrated the Plot Plugin as described in our Android integration guide.

When the PlotBackgroundService has an android:process attribute, remove that attribute. This is only the case when you have upgraded from an older version of the Plot Plugin.

Step 2: Get AltBeacon Library

We have build our beacon support on top of the AltBeacon library. The library is in development since 2013 and is released under the Apache License 2.0. Get the AltBeacon library, the library can be found at
We have tested it with the 2.0 release version.

Step 3: Add AltBeacon to Project

You can either use Gradle to add it or add the library into your IDE as you normally would.

For Gradle based projects:

  • Add the library AAR as dependency (as shown in snippet). We’ve tested it with version 2.5.1.
dependencies {
  compile 'org.altbeacon:android-beacon-library:2.5.1'

More information at

For Ant based projects(for example, Eclipse):

  • Download the tar archive from the library download page.
  • Extract the library.
  • Import the contents as a project into your IDE.
  • Add the project as library to your Android app project.
  • Add to device capabilities that Bluetooth support is optional (as shown in the snippet below)
  • Add library services (as shown in snippet below)

To the manifest element:

     <uses-permission android:name="android.permission.BLUETOOTH"/>
     <uses-permission android:name="android.permission.BLUETOOTH_ADMIN"/>
     <uses-feature android:name="android.hardware.bluetooth" android:required="false" />
     <uses-feature android:name="android.hardware.bluetooth_le" android:required="false"/>

And to the application element:

   android:label="beacon" >
Step 4: Done!

You are done with integrating iBeacon support for your Android app! Test your app by triggering it near an iBeacon with an attached notification. These can be set at our dashboard.

For a general explanation about iBeacons see our documentation.

Appcelerator / Phonegap

For both Appcelerator Titanium Studio and Phonegap/Cordova we have created separate additional modules. To enable iBeacon support on Android just add the module to your app project. Make sure you are also adding the default Plot Plugin module.

If you are using Appcelerator Titanium Studio, you can find the iBeacon module soon in the marketplace. The core Plot module can be found here.

For Phonegap/Cordova, you can find the additional plugin here. The core Plot Plugin is available here.


This is still an experimental feature, meaning we are still testing it. We love to hear your feedback!
All features supported on iOS for iBeacons are also supported for Android, such as Analytics, Timespans, Notification Filter, and more.

Only works on Android devices with Android 4.3 or higher.

Only works on Android devices with Bluetooth LE.

When installed on a device without Android 4.3 or newer or without Bluetooth LE, then the Plot Plugin will only send geofencing notifications.