Guides

Location Services

This service is available in all plans, except for Rich Push. It is also active by default but you can still configure a couple of things in these settings pages. Location Services will allow your apps to collect user location and information about visits in all the regions you are monitoring for using GPS signals. You can also easily add support for Bluetooth Low Energy devices (a.k.a. iBeacons) to your app. All this functionality will allow you to automate segmentation based on location behaviour or create engaging and contextual messages whenever users are in the vicinity of your stores or venues.

Please note that we do not sell BTLE beacons and those devices must be acquired via 3rd party suppliers. We support Apple's iBeacon format, which is a standard, so any brand with support for that format will simply work in our platform.

To access these pages, expand the Settings menu and click in Services like shown below:

Services menu 6b8daebef3

Then you should click the Configure button in the Location Services box:

Location services box 7f8363c163

To enable beacons you'll need to provide the Proximity UUID, this will make it possible to add beacons in any of the geo-zones you'll create. You will obtain this UUID from your beacon supplier, in most cases, all the beacons you'll acquire come with the same UUID, but if that's not the case you'll need to adjust that, so all the beacons you'll use in your app share the same UUID. Go ahead and paste the UUID in the Proximity UUID field like shown below:

Location services proximity uuid 0b4555b796

If you don't have any beacons yet but you would like to test this functionality (our native iOS and Android apps can advertise as beacon for testing purposes) you can simply generate one by clicking in the Generate button like shown below:

Location services generate uuid ebacbeda03

After this point, in the Location area of your dashboard you can already start adding beacons to your regions. Learn more about beacons here.

Another setting you can customize for your app, is the Location Lifetime. By default this value is set to 7 days. This means that we will consider as valid, any location that was collected no longer than 7 days ago. For most apps this is OK, but you might want to decrease this value to make sure you only send geo-targeted messages to devices with location data more recent than that. To change that provide a number in the field Location Lifetime like shown below:

Location services location ttl eef150a018

If you've enabled beacons by providing a Proximity UUID or have generated one, you'll then see that you can provide API/Account access for our preferred BTLE suppliers, kontakt.io and Estimote. This suppliers already provide you with utility apps that you can use to manage your BTLE devices, but additionally you can provide us with access to you account which will enable us to also allow you to manage those devices via our native iOS and Android apps. This might come in hand while setting up beacons in our platform and you find the need to change the device's advertising data, like the Major and Minor directly from our apps.

If you have beacons bought through kontakt.io, please provide the API Key for your account. More information can be found in kontakt.io's website located here.

Location services kontakt api key 56005fec2f

If you have beacons bought through Estimote, please provide the App ID and App Token. More information can be found in Estimote's website located here.

Location services estimote app id and token d44557af78

After this setup you are now ready to transform your user's location into relevant interactions.