重要

iOS 14.0 以降、Apple はアプリで共有する位置情報の精度レベルをユーザーが選択できるようにしました。そのため、ユーザーが正確な位置情報を無効にしている場合、リージョンモニタリング(ジオフェンス機能)は動作しません。詳細については、リンクを参照してください。
リージョンモニタリングは Always authorization(常に許可) の場合にのみサポートされます。When-in-use authorization(使用中のみ許可)ではこの機能はサポートされません。詳細については、リンクを参照してください。
Dwell トリガーは iOS ではサポートされていないため、SDK は Enter トリガーと Exit トリガーのみをサポートします。

位置情報トリガーを有効にする方法

必要な権限:

リージョンモニタリング(ジオフェンス)が動作するには、Always Authorization と正確な位置情報の精度が有効になっている必要があります。そのため、アプリがこれらの権限を取得するように構成されていることを確認してください。また、これらの権限が必要となる状況をユーザーに伝えることは良い習慣であり、ユーザーが権限を許可するきっかけにもなります。

SDK のインストール

Swift Package Manager を使用したインストール

MoEngageGeofence は SDK バージョン 4.2.0 から SPM でサポートされています。統合するには、SDK バージョン 9.23.0 以上の場合は GitHub URL https://github.com/moengage/apple-sdk.git を、それ以外の SDK バージョンの場合は https://github.com/moengage/MoEngage-iOS-SDK.git を使用し、ブランチを master または必要なバージョンに設定します。

CocoaPod を使用したインストール

情報CocoaPods は非推奨になりつつあります。MoEngage では、すべての新規統合に Swift Package Manager を使用することを推奨しています。CocoaPods の詳細については、CocoaPods 統合ガイドを参照してください。

以下のように podfile に依存関係を追加して、MoEngageGeofence フレームワークを統合します。

pod 'MoEngage-iOS-SDK/GeoFence',

次に pod install を実行してフレームワークをインストールします。

手動統合

MoEngageGeofence SDK をプロジェクトに手動で統合するには、こちらのドキュメントに従ってください。

注意バージョン 4.2.0 から MOGeofence は MoEngageGeofence に名前が変更されました。podfile と import 文を適宜更新してください。

ジオフェンスモニタリングの開始:

MoEngageGeofence モジュールを統合した後、startGeofenceMonitoring() メソッドを呼び出してジオフェンスモジュールを開始します。これにより、ユーザーの現在地周辺のジオフェンスが取得されます。

MoEngageSDKGeofence.sharedInstance.startGeofenceMonitoring()

[[MoEngageSDKGeofence sharedInstance] startGeofenceMonitoring];

Geofence Handler には didEnterRegion と didExitRegion のコールバックもあります。これらは MoEngageSDKGeofence.sharedInstance.setGeofenceDelegate(self) のように準拠することで取得できます。

extension GeofenceViewController: MoEngageGeofenceDelegate {
    func geofenceEnterTriggered(withLocationManager locationManager: CLLocationManager?, andRegion region: CLRegion?, forAccountMeta accountMeta: MoEngageAccountMeta) {
        print("Geofence Entered")
    }
    
    func geofenceExitTriggered(withLocationManager locationManager: CLLocationManager?, andRegion region: CLRegion?, forAccountMeta accountMeta: MoEngageAccountMeta) {
        print("Geofence Exited")
    }
}

@interface MyViewController ()<MoEngageGeofenceDelegate>
---
- (void)geofenceEnterTriggeredWithLocationManager:(CLLocationManager *)locationManager andRegion:(CLRegion *)region forAccountMeta:(MoEngageAccountMeta *)accountMeta {
    NSLog(@"Geofence Entered");
}

- (void)geofenceExitTriggeredWithLocationManager:(CLLocationManager *)locationManager andRegion:(CLRegion *)region forAccountMeta:(MoEngageAccountMeta *)accountMeta {
    NSLog(@"Geofence Exited");
}

ジオフェンスモニタリングの停止:

バージョン 9.3.0 以降、ジオフェンスのモニタリングを停止する機能をサポートしています。ジオフェンスモニタリングを停止するには、stopGeofenceMonitoring() メソッドを呼び出します。

MoEngageSDKGeofence.sharedInstance.stopGeofenceMonitoring()

[[MoEngageSDKGeofence sharedInstance] stopGeofenceMonitoring];

ジオフェンスのテスト

まず、MoEngage ダッシュボードでジオフェンスキャンペーンを作成します。ジオフェンスは以下の方法でテストできます。

シミュレーターの場合:
- 以下のように位置情報をシミュレートできます。
- ダッシュボードでキャンペーンを作成した位置をシミュレートします。対応するコールバック(MoEngageGeofenceHandler のデリゲートメソッド)を受け取れば問題ありません。シミュレーターではプッシュ通知は受信されません。
デバイスの場合:
- 以下のように、コンソール上部のバーから実機の位置情報をシミュレートできます。
- 位置情報を設定した gpx ファイルを追加できます。サンプルの gpx ファイルは以下のとおりです。
  <?xml version=“1.0”?> <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>

デバイスでは、リージョンへの進入または退出のデリゲートコールバックを受け取ると、デバイスに通知が送信されます。これは即座に行われますが、通知の到着には最大 10 分かかる場合があります。

ジオ通知

通知を受信した後、ジオ通知を識別するには、以下のように app_extra パラメーター内にカスタムパラメーター “cType” = “geo” があります。

{
    "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";
        };
}

​位置情報トリガーを有効にする方法

​必要な権限:

​SDK のインストール

​Swift Package Manager を使用したインストール

​CocoaPod を使用したインストール

​手動統合

​ジオフェンスモニタリングの開始:

​ジオフェンスモニタリングの停止:

​ジオフェンスのテスト

​ジオ通知

位置情報トリガーを有効にする方法

必要な権限:

SDK のインストール

Swift Package Manager を使用したインストール

CocoaPod を使用したインストール

手動統合

ジオフェンスモニタリングの開始:

ジオフェンスモニタリングの停止:

ジオフェンスのテスト

ジオ通知