NOTE:
From MoEngage-iOS-SDK
version 4.3.0Geofence module is separated from the SDK to a separate moduleMOGeofenceand hence has to be added separately.Region monitoring (Geofence feature) is only supported with Always authorization. When-in-use authorization doesn't support this feature. Refer link for more info.
Dwell trigger is not supported in iOS, hence the SDK supports only Enter and Exit triggers.
First, include the MOGeofence in the pod file and run pod install
pod 'MOGeofence'After integrating the MOGeofence module call this method to initiate the geofence module.
[[MOGeofenceHandler sharedInstance] startGeofenceWithManager:locationManager andLocation:locationCoordinates];MOGeofenceHandler.sharedInstance().startGeofence(with: locationManager, andLocation: locationCoordinates)This will fetch the geofences around the location passed or the current location.
If you have the location manager and the location, please pass them so we don’t create another location manager. If you don’t have your own location manager instance, just pass nil. The location manager will be available under MOGeofenceHandler class.
[MOGeofenceHandler sharedInstance].locationManagerMOGeofenceHandler.sharedInstance().locationManagerGeofence Handler also has callback for didEnterRegion and didExitRegion. You can get these by confirming to the MOGeoDelegate.
@interface MyViewController ()<MOGeoDelegate>
---
-(void)locManager:(CLLocationManager *)locationManager didEnterRegion:(CLRegion *)region{
NSLog(@"GeoFence Entered");
}
-(void)locManager:(CLLocationManager *)locationManager didExitRegion:(CLRegion *)region{
NSLog(@"GeoFence Exit");
} class ViewController: UIViewController, MOGeoDelegate
----
----
func locManager(_ locationManager: CLLocationManager!, didEnter region: CLRegion!) {
print("GeoFence Entered")
}
func locManager(_ locationManager: CLLocationManager!, didExitRegion region: CLRegion!) {
print("GeoFence Exit")
}First, create a geofencing campaign on your MoEngage dashboard. You can test geofencing in the following ways:
- On the simulator:
a). You can simulate location as shown below.
b). Simulate the location which for which you have created the campaign on the dashboard.
If you get the respective call back (the delegate methods in MOGeofenceHandler), you are good to go. On simulator you will not receive push notifications.
- On the device:
a). You can simulate location for real device from the bar above the console as shown below.
b). You can add a gpx file with the locations configured. A sample gpx file looks like this:
<gpx version=“1.0”>
<wpt lat=“12.9719” lon=“77.6412”><name>CustomName</name></wpt>
<wpt lat=“12.9619” lon=“77.6312”></wpt>
<wpt lat=“12.9519” lon=“77.6112”></wpt>
</gpx>On the device, once you get the delegate callback for enter or exit in a region, a notification will be sent to the device. This happens instantly, but the notification might take upto 10 minutes.
Once you have received the notification, to identify geo notifications, there is a custom param “cType” = “geo” in the param app_extra, as shown below:
{
"app_extra" = {
cType = geo;
screenData = {
"" = "";
};
screenName = "";
};
aps = {
alert = "exit london- single fence";
badge = 1;
};
moengage = {
cid = "55a628bcf4c4073bb66a368b_GEO:55a628bcf4c4073bb66a368c_ABab1:2015-07-15_14:11:33.704706";
};
}What's Next
| In-App NATIV |