ジオフェンス

重要

iOS 14以降、おおよその位置情報の権限のみを選択したユーザーに対しては、ジオフェンスが確実に動作しません。

前提条件

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

ジオフェンスの設定

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

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

• locations
• app settings

ステップ 2: アプリの位置情報サービスを有効にする

デフォルトでは、Brazeの位置情報サービスは有効になっていません。アプリで有効にするには、以下のステップを完了してください。ステップごとのチュートリアルについては、チュートリアル: Brazeのロケーションとジオフェンスを参照してください。

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

Xcodeで、Generalタブを開きます。Frameworks, Libraries, and Embedded Contentの下に、BrazeLocationモジュールを追加します。

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

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

• NSLocationAlwaysAndWhenInUseUsageDescription
• NSLocationWhenInUseUsageDescription

重要

AppleはNSLocationAlwaysUsageDescriptionを非推奨にしました。詳細については、Appleの開発者ドキュメントを参照してください。

ステップ 3: コード内でジオフェンスを有効にする

アプリのコード内で、Brazeインスタンスを初期化するconfigurationオブジェクトのlocation.geofencesEnabledをtrueに設定してジオフェンスを有効にします。その他の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

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に移動します。Background Modesで、Location updatesにチェックを入れます。

次に、アプリのコードでallowBackgroundGeofenceUpdatesを有効にします。これにより、Brazeは位置情報の更新を継続的に監視することで、アプリの「When In Use」ステータスを延長できます。この設定は、アプリがバックグラウンドにある場合にのみ機能します。アプリが再度開かれると、既存のバックグラウンドプロセスはすべて一時停止され、代わりにフォアグラウンドプロセスが優先されます。

• swift
• objective-c

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

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;

重要

バッテリーの消耗とレート制限を防ぐため、アプリの特定のニーズに合った値にdistanceFilterを設定してください。distanceFilterをより高い値に設定すると、アプリがユーザーの位置情報を頻繁にリクエストしすぎるのを防ぐことができます。

ステップ 4: 承認をリクエストする

ユーザーから承認をリクエストする際は、When In UseまたはAlwaysのいずれかの承認をリクエストします。

• when in use
• always

When In Use承認をリクエストするには、requestWhenInUseAuthorization()メソッドを使用します。

• swift
• objective-c

var locationManager = CLLocationManager()
locationManager.requestWhenInUseAuthorization()

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

デフォルトでは、requestAlwaysAuthorization()はアプリにWhen In Use承認のみを付与し、しばらく経過した後にAlways承認をユーザーに再度リクエストします。

ただし、最初にrequestWhenInUseAuthorization()を呼び出し、初回のWhen In Use承認を受け取った後にrequestAlwaysAuthorization()を呼び出すことで、ユーザーに即座にプロンプトを表示することもできます。

重要

Always承認を求める即時プロンプトを出せるのは一度のみです。

• swift
• objective-c

var locationManager = CLLocationManager()
locationManager.requestAlwaysAuthorization()

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

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

Braze SDKがバックエンドにジオフェンスをリクエストすると、ユーザーの現在位置をレポートし、レポートされた位置に基づいて最適に関連性が高いと判断されたジオフェンスを受け取ります。

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

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

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

• swift
• objective-c

let configuration = Braze.Configuration(
  apiKey: "{BRAZE_API_KEY}",
  endpoint: "{BRAZE_ENDPOINT}"
)
configuration.automaticGeofencesRequest = false
let braze = Braze(configuration: configuration)
AppDelegate.braze = braze

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

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

[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はアプリがバックグラウンドにある間もサービスを実行するための個別の設定を提供していますが、ユーザーからの明示的な承認を得ずに終了されたアプリについては、これらの制限を回避する方法はありません。