Locations quick start guide

Our mobile SDKs allow customers to enable location services. These allow you to gather data on when users enter or exit geofences and iBeacon-fenced areas that in turn can be used to trigger campaigns or to segment users in relation to whether they have visited one of your locations. Read more on collecting location data.

📘

Locations is an additional feature. If you wish to use this feature and to discuss pricing please get in touch with your account manager.

Prerequisites: SDK integration

Location services require you to configure your mobile applications in your Xtremepush project and that you complete the integration of the Xtremepush SDK. See details on how to achieve this in our dedicated guides for Android and iOS.

Enable location services in your app

Once you have integrated the SDK with your mobile apps, you will need to enable location services for your Android and iOS apps.

Create locations in your project

At this stage, you would need to create the geofences or iBeacons in your project. Review our dedicated guide on how to do so for more details.

Testing tips

👍

Testing...

Running tests is encouraged before deploying locations to real customers. You'll find details on how to test below.

If you have set a location in your project but location-triggered campaigns aren't working as expected, the first thing to check is that you have a test build of your app where you have notification and location permissions. On iOS you would have had to accept notification and location permissions, you may also be asked for location permissions on Android since Android 6.0 and to accept notifications since Android 13.

Next, check that you have location services switched on globally on your test device, and then check the Triggering limits settings in the Locations tab of your campaign.

Defaults for location-based campaigns are shown below (1 trigger per day and per location and 0 number of prior enters before trigger):

In general, most live campaigns will use the system defaults as you will not want to send users too many messages. In fact, you may often limit messages to a number per campaign. However, when testing initially, you may want to increase this limit on your campaigns so you can do more than one test in a day on a campaign.

Also, review the number of prior enters before trigger setting. This message doesn't require any prior entry on a given day so the message will trigger the first time you enter the location on a given day. If you change this setting to '1', you would need to enter the location, exit it and then re-enter to get your first notification.

You can review our dedicated guide on the Locations tab for more details.

Finally, after adding a geofence on the platform your app will not be aware of it until you have made a significant movement (travelled a few hundred metres) or until the next time you open the app. So if you have just added the geofence you are using in your campaign be sure to open and close your app or that you have a distance to travel to get to the geofence you are testing with.