Geofence & Location

Location Overview

By default, Netmera SDK does not collect location information from the device. To use features like geofence messaging and location-based user targeting, you must enable location tracking.

Step 1: Enable Location History

To use location-based targeting, enable Location History in the Netmera web panel: Developers > App Info > App Config > Location History Enabled

Step 2: Configure Location Permissions

Add the necessary authorization keys to your Info.plist file:

1. For Geofence Messaging (iOS 10 and earlier)

• Set NSLocationAlwaysUsageDescription with a description explaining why the app uses region monitoring.

• This allows the SDK to monitor region entry/exit actions for geofence regions configured in the Netmera Dashboard.

1. For Geofence Messaging (iOS 11 and later)

• Set NSLocationAlwaysAndWhenInUseUsageDescription with a description explaining why the app uses region monitoring.

• This allows the SDK to monitor region entry/exit actions for geofence regions configured in the Netmera Dashboard.

1. For Occasional Location Updates

• Set NSLocationWhenInUseUsageDescription with a description.

• This sends the most recent location once per session.

Step 3: Request Location Authorization

Calling these methods immediately prompts the location permission dialog. Make sure to inform users beforehand about how your application will use their location.

Swift

// Request location authorization
Netmera.requestLocationAuthorization()

Objective-C

// Request location authorization
[Netmera requestLocationAuthorization];

Step 4: Configure Geofence Region Limits

To set the maximum number of active geofence regions, use:

Swift

Netmera.setNetmeraMaxActiveRegions(20) // Default is 20

Objective-C

[Netmera setNetmeraMaxActiveRegions:20]; // Default is 20

If the value is set greater than 20 or less than 0, it will be automatically reset to 20.