ジオフェンス

前提条件

この機能を使う前に、Swift Braze SDKを統合する必要がある。

ジオフェンスの設定

ステップ 1: イネーブルメント in Braze

次のいずれかの場所で、アプリのジオフェンスs を有効にできます。

• locations
• app settings

ステップ 2:アプリの位置情報サービスをイネーブルメントにする。

デフォルトでは、Brazeロケーションサービスは有効になっていない。アプリでイネーブルメントを有効にするには、以下のステップを完了する。ステップバイステップのチュートリアルについては、チュートリアルを参照のこと：Brazeの位置とジオフェンス.

ステップ 2.1: BrazeLocation モジュールを追加する。

XcodeでGeneralタブを開封する。フレームワーク、ライブラリー、組み込みコンテンツ」の下に、BrazeLocation モジュールを追加する。

ステップ 2.2:Info.plist を更新する

info.plist で、アプリケーションが位置情報の追跡を必要とする理由を説明する、以下のキーの1つにString 値を割り当てる。この文字列は、ユーザーが位置情報サービスのプロンプトを表示したときに表示されるので、アプリでこの機能をイネーブルメントにする価値を明確に説明すること。

• NSLocationAlwaysAndWhenInUseUsageDescription
• NSLocationWhenInUseUsageDescription

ステップ 3:コードでジオフェンスをイネーブルメントにする

アプリのコードで、インスタンスを初期化するconfiguration オブジェクトのlocation.geofencesEnabled をtrue に設定して、ジオフェンスをイネーブルメントにする。 Brazeインスタンスを初期化する。その他のlocation 設定オプションについては、Braze Swift SDKリファレンスを参照のこと。

• swift
• objective-c

1
2
3
4
5
6
7
8
9
10
11
12
13
let configuration = Braze.Configuration(
  apiKey: "<BRAZE_API_KEY>",
  endpoint: "<BRAZE_ENDPOINT>"
)
configuration.location.brazeLocationProvider = BrazeLocationProvider()
configuration.location.automaticLocationCollection = true
configuration.location.geofencesEnabled = true
configuration.location.automaticGeofenceRequests = true

// Additional configuration customization...

let braze = Braze(configuration: configuration)
AppDelegate.braze = braze

1
2
3
4
5
6
7
8
9
10
11
12
13
BRZConfiguration *configuration =
    [[BRZConfiguration alloc] initWithApiKey:brazeApiKey
                                    endpoint:brazeEndpoint];
configuration.logger.level = BRZLoggerLevelInfo;
configuration.location.brazeLocationProvider = [[BrazeLocationProvider alloc] init];
configuration.location.automaticLocationCollection = YES;
configuration.location.geofencesEnabled = YES;
configuration.location.automaticGeofenceRequests = YES;

// Additional configuration customization...

Braze *braze = [[Braze alloc] initWithConfiguration:configuration];
AppDelegate.braze = braze;

ステップ 3.1:バックグラウンドレポートを有効にする（オプション）

デフォルトでは、ジオフェンス・イベントは、アプリがフォアグラウンドにあるか、Always 、すべてのアプリケーションの状態を監視する認可がある場合にのみ監視される。

しかし、アプリがバックグラウンドにある場合や、When In Use 認証がある場合は、ジオフェンス・イベントを監視することもできる。

これらの追加ジオフェンス・イベントをモニターするには、Xcodeプロジェクトを開封し、Signing& Capabilitiesに行く。バックグラウンドモード]で[位置情報の更新]をチェックする。

次に、アプリのコードでallowBackgroundGeofenceUpdates 。これによりBrazeは、位置情報の更新を継続的に監視することで、アプリの「使用中」ステータスを拡張することができる。この設定は、アプリがバックグラウンドにあるときにのみ機能する。アプリが再び開封されると、既存のバックグラウンド・プロセスはすべて一時停止され、代わりにフォアグラウンド・プロセスが優先される。

• swift
• objective-c

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
let configuration = Braze.Configuration(
  apiKey: "<BRAZE_API_KEY>",
  endpoint: "<BRAZE_ENDPOINT>"
)

// Additional configuration customization...

// Enable background geofence reporting with `When In Use` authorization.
configuration.location.allowBackgroundGeofenceUpdates = true

// Determines the number of meters required to trigger a new location update.
configuration.location.distanceFilter = 8000

let braze = Braze(configuration: configuration)
AppDelegate.braze = braze

1
2
3
4
5
6
7
8
9
10
11
12
13
14
BRZConfiguration *configuration =
    [[BRZConfiguration alloc] initWithApiKey:brazeApiKey
                                    endpoint:brazeEndpoint];

// Additional configuration customization...

// Enable background geofence reporting with `When In Use` authorization.
configuration.location.allowBackgroundGeofenceUpdates = YES;

// Determines the number of meters required to trigger a new location update.
configuration.location.distanceFilter = 8000;

Braze *braze = [[Braze alloc] initWithConfiguration:configuration];
AppDelegate.braze = braze;

ステップ 4: 認可を要請する

ユーザーに認可を要求する場合、When In Use またはAlways のいずれかの認可を要求する。

• when in use
• always

1
2
var locationManager = CLLocationManager()
locationManager.requestWhenInUseAuthorization()

1
2
CLLocationManager *locationManager = [[CLLocationManager alloc] init];
[locationManager requestWhenInUseAuthorization];

1
2
var locationManager = CLLocationManager()
locationManager.requestAlwaysAuthorization()

1
2
CLLocationManager *locationManager = [[CLLocationManager alloc] init];
[locationManager requestAlwaysAuthorization];

ステップ 5: バックグラウンドプッシュを確認する

Braze では、バックグラウンドプッシュ通知を使用してジオフェンスがデバイスと同期されます。以下の手順に従って、サーバーからのジオフェンス更新が適切に処理されるように、サイレントプッシュ通知を設定する。

ジオフェンスを手動でリクエストする

Braze SDKは、バックエンドからジオフェンスをリクエストすると、ユーザーのCurrentsをレポートし、レポートされたロケーションに基づいて最適に関連すると判断されたジオフェンスを受信する。

最も関連性の高いジオフェンスを受信する目的でSDKがレポートする位置をコントロールするには、希望する座標を提供してジオフェンスを手動でリクエストすることができる。

ステップ 1: automaticGeofenceRequests を false に設定します

init(configuration) に渡される configuration オブジェクトで、自動ジオフェンスリクエストを無効にできます。automaticGeofenceRequests を false に設定します。

• swift
• objective-c

1
2
3
4
5
6
7
let configuration = Braze.Configuration(
  apiKey: "{BRAZE_API_KEY}",
  endpoint: "{BRAZE_ENDPOINT}"
)
configuration.automaticGeofencesRequest = false
let braze = Braze(configuration: configuration)
AppDelegate.braze = braze

1
2
3
4
5
6
BRZConfiguration *configuration =
  [[BRZConfiguration alloc] initWithApiKey:{BRAZE_API_KEY}
                                  endpoint:{BRAZE_ENDPOINT}];
configuration.automaticGeofencesRequest = NO;
Braze *braze = [[Braze alloc] initWithConfiguration:configuration];
AppDelegate.braze = braze;

ステップ 2:requestGeofences に手動で電話をかける。

コードの中で、適切な緯度と経度を持つジオフェンスをリクエストする。

• swift
• objective-c

1
AppDelegate.braze?.requestGeofences(latitude: latitude, longitude: longitude)

1
2
[AppDelegate.braze requestGeofencesWithLatitude:latitude
                                      longitude:longitude];

よくある質問 (FAQ)

私のデバイスでジオフェンスが受信できないのはなぜか？

ジオフェンスがデバイスで受信されているかどうかを確認するには、まずSDK Debuggerツールを使ってSDKのログをチェックする。そして、ジオフェンスがサーバーから正常に受信されているかどうか、また目立ったエラーがないかどうかを確認することができる。

以下は、お使いのデバイスでジオフェンスが受信されない場合に考えられるその他の理由である：

iOSオペレーティングシステムの制限

iOSのオペレーティングシステムでは、1つのアプリに保存できるジオフェンスは20個までとなっている。ジオフェンスを有効にすると、Braze ではこれら20個の利用可能スロットの一部が使用されます。

アプリ内の他のジオフェンス関連機能が誤って、または望まない形で中断されるのを防ぐため、ダッシュボードで個々のアプリの位置情報ジオフェンスをイネーブルメントにする必要がある。位置情報サービスが正しく動作するには、アプリで利用可能なジオフェンススポットがすべて使用されていないことを確認してください。

レート制限

Brazeでは、不要なリクエストを避けるため、ジオフェンスの更新は1セッションにつき1回に制限されている。

Brazeと非Brazeの両方のジオフェンス機能を使用している場合、どのように機能するのか？

前述の通り、iOSでは1つのアプリに最大20個のジオフェンスを保存できる。このストレージは、BrazeとBraze以外のジオフェンスの両方で共有され、CLLocationManagerによって管理される。

例えば、アプリに20の非Brazeジオフェンスが含まれている場合、Brazeジオフェンスをトラッキング追跡するストレージはない（逆も同様）。新しいジオフェンスを受信するには、アップルの位置情報APIを使用して、デバイス上の既存のジオフェンスの一部の監視を停止する必要がある。

ジオフェンス機能は、デバイスがオフラインの状態でも使用できるのか？

デバイスは、リフレッシュが発生したときだけインターネットに接続する必要がある。サーバーからのジオフェンス受信に成功すれば、デバイスがオフラインの状態でも、ジオフェンスのエントリやエグジットを記録することができる。これは、デバイスの位置情報がインターネット接続とは別に動作するためだ。

例えば、あるデバイスがセッション開始時にジオフェンスの受信と登録に成功し、オフラインになったとする。登録されたジオフェンスのいずれかに入ると、Brazeキャンペーンをトリガーすることができる。

アプリがバックグラウンド/終了すると、ジオフェンスが監視されないのはなぜか？

Always 、アップルはアプリが使用されていない間、位置情報サービスの実行を制限する。これはオペレーティングシステムによって強制され、Braze SDKのコントロール外である。Brazeは、アプリがバックグラウンドにある間にサービスを実行するための個別の設定を提供しているが、ユーザーからの明示的な承認を受けずに終了したアプリについては、これらの制限を回避する方法はない。