iBeacons Setup

iBeacons are small, simple devices which broadcast a unique identifier via a low-powered Bluetooth (Bluetooth Low Energy) signal. These signals are then available to devices/apps to present contextual information to users based on their proximity to a specific beacon.

iBeacons allow the gathering of valuable location-based user activity and overlays that information with the rest of your data within Kochava. The setup is simple and the Kochava SDK handles all the heavy-lifting.

The applications for Beacons are broad, ranging from special offers and location-based conversion tracking to offering the user information contextual to their physical location.

How iBeacons Work

iBeacons must be registered by UUID within a given app so that the app can be “listening” for specific beacon UUIDs. An app can only be aware of up to 20 UUIDs at once.

Kochava manages the process of ensuring that your app is aware of the nearest 20 iBeacons at any given time. You enter all your iBeacons into the Kochava dashboard and Kochava handles the rest. The Kochava SDK uses Apple’s Significant-Change Location Service (as long as location services are enabled for your app) to determine the device’s location often enough to be relevant, but without adding unnecessary drain on the user’s battery. Based on the location retrieved, Kochava ensures that the app is listening for the UUIDs of the most location-relevant iBeacons.


NOTE: If location services are not enabled for your app, the Kochava SDK WILL NOT prompt the user to enable. Thus, all location-based functionality will be disabled, including iBeacon awareness.

Enable iBeacons

  1. Log in to Kochava.
  2. Select Account Options>Apps.


  4. Locate the desired app and Select App Tools>Edit App.


  6. Click the Advanced expand button.
  7. Toggle iBeacons to ON.

    NOTE: If iBeacons is already in the ON position, no further action is required. Proceed to the iBeacons User Interface section.



    A. Toggle iBeacons to ON.


  9. Click Save.

iBeacons User Interface

  1. Select Account Options>iBeacons.



  3. Click on Add an iBeacon.
  4. Enter a Unique iBeacon Name.
  5. Enter the iBeacon UUID.
  6. Select the Target App.
  7. Enter the Latitude of the iBeacon.
  8. Enter the Longitude of the iBeacon.

    NOTE: A tool such as LatLong.net can be used to locate the Latitude and Longitude.


  10. Enter the Major version segmentation information. (optional)
  11. Enter the Minor version segmentation information. (optional)

    NOTE: The Major and Minor values are settings that can be utilized to connect to specific iBeacons or to connect to multiple iBeacons at the same time. In venues that use multiple iBeacons, the same UUID is used and the Major and Minor values are used to distinguish subspaces within the venue.  For example, the Major values of all of the iBeacons within a specific venue can be set to the same value and the Minor values can be utilized to identify each specific iBeacon within the venue.

    NOTE: The Major and Minor values can be updated, but the method of updating these values depends on the  manufacturer of the iBeacon. If the Major and Minor values need to be changed, consult the support documentation or website of the manufacturer.


  13. Click Save.


NOTE: The Kochava SDK reports iBeacon entry and exit. Ranging is not supported and must be implemented by the advertiser, if desired. For more information about ranging, refer to Apple’s Region Monitoring and iBeacon support documentation.




Last Modified: Oct 9, 2017 at 1:41 pm