ジオフェンス

前提条件

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

ジオフェンスの設定

ステップ 1: Brazeで有効にする

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

• locations
• app settings

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

デフォルトでは、Brazeの位置情報サービスのイネーブルメントは有効になっていない。アプリでそれらをイネーブルメントするには、次のステップを完了する。ステップごとのチュートリアルについては、チュートリアルを参照せよ。Brazeのロケーションとジオフェンス。

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

Xcodeで、一般タブを開け。フレームワーク、ライブラリー、および埋め込みコンテンツの下に、モジュBrazeLocationールを追加する。

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

アプリケーションで位置情報の追跡が必要である理由を説明するinfo.plist以下のキーのいずれかに値をString割り当てよ。この文字列は、ユーザーが位置情報サービスのイネーブルメントを求められる際に表示される。だから、この機能をイネーブルメントすることでアプリにどんな価値があるかを明確に説明するように。

• NSLocationAlwaysAndWhenInUseUsageDescription
• NSLocationWhenInUseUsageDescription

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

アプリコード内で、ジオフェンスを有効にするには、`Geofence`インスタンスBrazeを初期化するGeofenceオブジェクトconfigurationの`enabled`プロパティtrueをtruelocation.geofencesEnabledに設定する。その他の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プロジェクトを開封し、次に「署名」→&「機能」に移動する。バックグラウンドモードで、位置情報の更新にチェックを入れる。

次に、アプリのコードで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: 承認を要求する

ユーザーから権限を要求する際は、権限Alwaysか権限When In Useのいずれかを要求する。

• 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がバックエンドにジオフェンスを要求すると、ユーザーの現在位置をレポートし、レポートされた位置に基づいて最適に関連性が高いと判断されたジオフェンスを受け取る。

最も関連性の高いジオフェンスを受信するために、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デバッガーツールを使ってSDKのログを確認する。その後、サーバーからジオフェンスが正常に受信されているか、また顕著なエラーがあるかどうかを確認できる。

以下は、ジオフェンスが端末で受信されないその他の可能性のある理由だ：

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

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

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

レート制限

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

Brazeと非Brazeのジオフェンス機能を両方使っている場合、どう動作するのか？

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

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

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

デバイスは、更新が行われる時だけインターネットに接続する必要がある。サーバーからジオフェンスを正常に受信した後、デバイスがオフライン状態であっても、ジオフェンスのエントリや退場を記録することが可能である。これは、デバイスの位置情報はインターネット接続とは別個に動作するためだ。

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

アプリがバックグラウンド状態になったり終了したりすると、なぜジオフェンスが監視されなくなるのか？

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