Skip to content


位置情報とジオフェンス

iOS のジオフェンスをサポートするには:

  1. 統合がバックグラウンドプッシュ通知に対応している必要があります。
  2. Braze ジオフェンスを有効にするには、SDK を通じて位置情報の収集を有効にするか (暗示的)、ジオフェンスの収集を有効にする (明示的) 必要があります。これらはデフォルトでは有効になっていません。

ステップ 1:バックグラウンドのプッシュを有効にする

ジオフェンスの同期戦略を最大限に活用するには、標準のプッシュ統合を完了することに加えて、バックグラウンドプッシュを有効にする必要があります。

ステップ 2:ジオフェンスを有効にする

デフォルトでは、ジオフェンスは位置情報の自動収集が有効かどうかに基づいて有効になります。ジオフェンスを有効にするには、Info.plist ファイルを使用します。Braze ディクショナリを Info.plist ファイルに追加します。Braze ディクショナリ内にブール値の EnableGeofences サブエントリを追加し、値を YES に設定します。なお、Braze iOS SDK v4.0.2 より前のバージョンでは、Braze の代わりにディクショナリキー Appboy を使用する必要があります。

startWithApiKey:inApplication:withLaunchOptions:withAppboyOptions メソッドを使用して、アプリの起動時にジオフェンスを有効にすることもできます。appboyOptions ディクショナリで、ABKEnableGeofencesKey を YES に設定します。以下に例を示します。

1
2
3
4

[Appboy startWithApiKey:@"YOUR-API_KEY"
          inApplication:application
      withLaunchOptions:options
      withAppboyOptions:@{ ABKEnableGeofencesKey : @(YES) }];

1
2
3
4

Appboy.start(withApiKey: "YOUR-API-KEY",
                 in:application,
                 withLaunchOptions:launchOptions,
                 withAppboyOptions:[ ABKEnableGeofencesKey : true ])

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

Braze では、バックグラウンドプッシュ通知を使用してジオフェンスがデバイスと同期されます。iOS のカスタマイズに関する記事に従って、Braze のジオフェンス同期通知を受信したときにアプリケーションで不要なアクションが実行されないようにします。

ステップ 4:NSLocationAlwaysUsageDescription を Info.plist に追加する

アプリケーションで位置情報を追跡する必要がある理由の説明を含んだ String 値を使用して、キー NSLocationAlwaysUsageDescription および NSLocationAlwaysAndWhenInUseUsageDescription を info.plist に追加します。iOS 11 以降では両方のキーが必要です。 この説明は、システムの位置情報プロンプトで権限がリクエストされ、ユーザーに位置情報の追跡の利点を明確に説明する必要がある場合に表示されます。

ステップ 5:ユーザーに権限をリクエストする

ジオフェンス機能は、位置情報に対する権限 Always が付与されている場合にのみ機能します。

位置情報権限 Always をリクエストするには、次のコードを使用します。

1
2

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

1
2

var locationManager = CLLocationManager()
locationManager.requestAlwaysAuthorization()

ステップ 6:ダッシュボードでジオフェンスを有効にする

iOS では、1 つのアプリに保存できるジオフェンスは 20 個までとなっています。位置情報を使用すると、これら 20 個の使用可能なジオフェンススロットの一部が使用されます。アプリ内の他のジオフェンス関連機能への偶発的または不要な中断を防ぐため、位置情報ジオフェンスはダッシュボード上で個々のアプリに対して有効にする必要があります。

位置情報が正しく動作するには、アプリが利用可能なジオフェンススポットをすべて使用していないことも確認する必要があります。

場所ページからジオフェンスを有効にする

The geofence options on the Braze locations page.

設定ページからジオフェンスを有効にする

The geofence checkbox located on the Braze settings pages.

自動ジオフェンスリクエストを無効にする

iOS SDK バージョン 3.21.3 以降では、ジオフェンスが自動的にリクエストされないようにすることができます。これを行うには、Info.plist ファイルを使用します。Braze ディクショナリを Info.plist ファイルに追加します。Braze ディクショナリ内にブール値の DisableAutomaticGeofenceRequests サブエントリを追加し、値を YES に設定します。

startWithApiKey:inApplication:withLaunchOptions:withAppboyOptions メソッドを使用して、アプリの起動時に位置情報の自動追跡を有効にすることもできます。appboyOptions ディクショナリで、ABKDisableAutomaticGeofenceRequestsKey を YES に設定します。以下に例を示します。

1
2
3
4

[Appboy startWithApiKey:@"YOUR-API_KEY"
          inApplication:application
      withLaunchOptions:options
      withAppboyOptions:@{ ABKDisableAutomaticGeofenceRequestsKey : @(YES) }];

1
2
3
4

Appboy.start(withApiKey: "YOUR-API-KEY",
                 in:application,
                 withLaunchOptions:launchOptions,
                 withAppboyOptions:[ ABKDisableAutomaticGeofenceRequestsKey : true ])

このオプションの使用を選択した場合、機能が動作するよう、ジオフェンスを手動でリクエストする必要があります。

ジオフェンスの手動リクエスト

Braze SDK からジオフェンスにバックエンドからの監視がリクエストされると、ユーザーの現在の位置情報がレポートされ、レポートされた位置情報に基づいて最も関連性が高いと特定されたジオフェンスが受信されます。ジオフェンスの更新には、各セッションで 1 回というレート制限があります。

SDK でレポートされる位置情報をコントロールして、最も関連性の高いジオフェンスを受信できるようにするため、iOS SDK バージョン 3.21.3 以降では、位置の緯度と経度を指定することでジオフェンスを手動でリクエストできるようになっています。この方法を使用する場合は、自動ジオフェンスリクエストを無効にすることをお勧めします。そのためには、次のコードを使用します。

1
2

[[Appboy sharedInstance] requestGeofencesWithLongitude:longitude
                                              latitude:latitude];

1

Appboy.sharedInstance()?.requestGeofences(withLongitude: longitude, latitude: latitude)
  GitHub でこのページを編集
「このページはどの程度役に立ちましたか?」
New Stuff!