Locations & Geofences
Geofences are only available in select Braze packages. For access please create a support ticket or speak with your Braze Customer Success Manager. Learn more in the Braze Academy.
To support geofences for iOS:
Your integration must support background push notifications.
Braze location collection must not be disabled.
On iOS, we are not strictly enforcing the Braze request processing policy for geofences. When geofences are enabled, the requests will automatically be sent up even if the processing policy is manual processing.
Step 1: Enable Background Push
To fully utilize our geofence syncing strategy you must have Background Push enabled in addition to completing the standard push integration.
Step 2: Check for Braze Background Push
Braze syncs geofences to devices using background push notifications. Follow the instructions here to ensure that your application does not take any unwanted actions upon receiving Braze’s geofence sync notifications.
Step 3: Add NSLocationAlwaysUsageDescription to your Info.plist
Add the key
NSLocationAlwaysAndWhenInUseUsageDescription to your
info.plist with a
String value that has a description of why your application needs to track location. Both keys are required by iOS 11.
This description will be shown when the system location prompt requests authorization and should clearly explain the benefits of location tracking to your users.
Step 4: Request authorization from the user
The Braze iOS SDK can automatically request authorization from the user at app start if configured in our dashboard.
Otherwise, you can request authorization yourself and our SDK will wait until it has permission to start registering geofences.
Step 5: Enable Geofences on the Dashboard
iOS only allows up to 20 geofences to be stored for a given app. Braze’s Locations product will use up some of these 20 available geofence slots. To prevent accidental or unwanted disruption to other geofence-related functionality in your app, location geofences must be enabled for individual Apps on the Dashboard.
For Braze’s Locations product to work correctly, you should also ensure that your App is not using all available geofence spots.
Enable geofences from the Locations page:
Enable geofences from the App Settings page: