ロケーションモジュール

ロケーションモジュールは、iOSアプリが位置情報を受け取り、ジオフェンスを構成および監視する機能を有効にします。詳細はこちらで位置追跡とジオフェンシングについて学びましょう。

対応プラットフォーム

以下のプラットフォームが対応しています：

• iOS

要件

• Tealium for Swift (1.9.0+)

サンプルアプリ

IOSのサンプルアプリを探索して、当社のライブラリ、追跡方法、およびベストプラクティスの実装に慣れましょう。メインのサンプルアプリにはロケーションモジュールとジオフェンシング機能の例が含まれています。

インストール

Swift Package Manager、CocoaPods、またはCarthageでロケーションモジュールをインストールします。ロケーションモジュールは、位置イベントを送信するためのディスパッチャー（TealiumCollectまたはTealiumTagManagement）を必要とします。

Swift Package Manager（推奨）

バージョン1.9.0+でサポートされているSwift Package Managerは、Tealium Swiftライブラリをインストールするための推奨される最も簡単な方法です：

1. XcodeプロジェクトでFile > Add Package Dependenciesを選択します。
2. リポジトリURLを入力します：https://github.com/tealium/tealium-swift
3. バージョンルールを構成します。通常はUp to next majorが推奨されます。現在のTealium Swiftライブラリバージョンがリストに表示されない場合は、Swiftパッケージキャッシュをリセットしてください。
4. インストールするモジュールのリストからLocationモジュールを選択し、XcodeプロジェクトのアプリターゲットのFrameworks and Librariesの下に追加します。

iOSのSwift Package Managerインストールについてもっと学ぶ。

CocoaPods

CocoaPodsでロケーションモジュールをインストールするには、Podfileに次のポッドを追加します：

pod 'tealium-swift/Location'

iOSのCocoaPodsインストールについてもっと学ぶ。

Carthage

Carthageでロケーションモジュールをインストールするには：

1. XcodeでアプリターゲットのGeneral構成ページに移動します。

2. 次のフレームワークをEmbedded Binariesセクションに追加します：

   TealiumLocation.framework
   

iOSのCarthageインストールについてもっと学ぶ。

初期化

モジュールを初期化するには、TealiumConfigのcollectorsプロパティに指定されていることを確認してください。

config.collectors = [Collectors.Location]

TealiumConfigインスタンスの位置精度とジオフェンシングの追加オプションも構成可能です。

Collectorsのドキュメントを確認して、必要なコレクターを正しく指定する方法を理解してください。

認証

アプリが位置情報を収集するための認証を行うには、アプリのInfo.plistファイルに次のキーを追加します：

• Privacy - Location When In Use Usage Description
• Privacy - Location Always and When In Use Usage Description

キーが存在しない場合、位置情報のリクエストは即座に失敗します。位置情報サービスの認証リクエストについてもっと学ぶ。

現在の実装内で位置情報の認証をすでにリクエストしていない場合、Tealiumの完了コールバックでロケーションモジュールのAPIメソッドrequestAuthorization()を使用することができます：

func start() {
      //...
      tealium = Tealium(config: config) { _ in
      		self.tealium?.location?.requestAuthorization()
      }
  }

近似位置追跡（iOS 14+）

Apple iOS 14+は、正確な位置ではなく近似位置を共有するためのアプリ構成を提供します。この方法は、アプリが正確な位置を必要とし、ユーザーが当初デバイス構成を通じて正確な位置追跡を無効にした場合に推奨されます。

コードベースで一時的な完全な認証をすでにリクエストしていない場合、次の例に示すTealiumのヘルパーメソッドrequestTemporaryFullAccuracyAuthorizationを使用してください。これは一時的な完全な精度のリクエストを行います。

func start() {
    //...
    tealium = Tealium(config: config) { _ in
      guard let location = self.tealium?.location else {
          return
      }
      if location.isAuthorized {
          location.requestTemporaryFullAccuracyAuthorization(purposeKey: "NearStore")
      } else {
          location.requestAuthorization()
      }
    }
}

StringパラメータpurposeKeyは、アプリのInfo.plistファイルのNSLocationTemporaryUsageDescriptionDictionary辞書のキーに対応します。次の例に示します：

    <key>NSLocationTemporaryUsageDescriptionDictionary</key>
    <dict>
        <key>NearStore</key>
        <string>店舗の近くにいるときに割引を送信するため</string>
    </dict>

一時的な完全な認証のリクエストについてもっと学ぶ。

位置追跡

ユーザーが位置情報サービスを承認すると、ロケーションモジュールは連続的な位置追跡を実行します。位置更新は、精度と距離の構成に基づいています。

ジオフェンス機能を無効にすると、AppleのstartMonitoringSignificantLocationChanges()メソッドによってのみ重要な位置更新が監視され、更新が少なくなり、バッテリーの消費も少なくなります。この方法は、プロパティconfig.geofencesTrackingEnabledまたはconfig.useHighAccuracyのいずれかがfalseに構成されている場合に呼び出されます。それ以外の場合は、AppleのstartUpdatingLocationメソッドが呼び出されます。

ジオフェンス機能はデフォルトで有効になっており、位置更新はより頻繁に行われ、精度が向上します。より頻繁な位置更新を有効または無効にするには、プロパティuseHighAccuracyを構成します。

より正確な位置と距離の構成を希望する場合は、更新をトリガーするメートル単位の値でプロパティupdateDistanceを構成します。

また、アプリが受け取りたい精度レベルを指定する拡張精度構成、desiredAccuracyもあります。これはCLLocationManager desiredAccuracyプロパティと同様です。iOS 14+ではデフォルト値は.reducedで、以前のバージョンでは.nearestHundredMetersです。

func start() {
      let config = TealiumConfig(account: "ACCOUNT",
                                 profile: "PROFILE",
                                 environment: "ENVIRONMENT",
                                 datasource: "DATASOURCE",
                                 optionalData: nil)
      config.useHighAccuracy = false
      config.updateDistance = 150
      config.desiredAccuracy = .nearestThreeKilometers
  }

ジオフェンシング

ジオフェンシングはデフォルトで有効になっており、ジオフェンスを構成するには、以下の方法のいずれかを使用してジオフェンス JSON ファイルを提供します：

• ホストされた URL
  自分のホストされたジオフェンスファイルを、プロパティgeofenceUrlにURLとして提供します。
  このオプションは、公開構成のURLを上書きした場合やホストされたデータレイヤーを使用したい場合に推奨されます。

config.geofenceUrl = "https://example.com/geofences.json"

• ローカルファイル
  アプリに保存されているジオフェンスファイルを使用するには、プロパティgeofenceFileNameを構成します。ファイル拡張子は省略します。

config.geofenceFileName = "geofences" // geofences.json

ジオフェンシングを無効にするには、プロパティgeofenceTrackingEnabledを構成します：

config.geofenceTrackingEnabled = false

追加の考慮事項

アクティブなジオフェンスの数
ジオフェンスは動的に追加および削除され、できるだけ少ないリソースを使用します。定義されるジオフェンスの数に制限はありませんが、アクティブなジオフェンスの数はデバイスユーザーごとにアプリケーション全体で20に制限されています。

ジオフェンスの初期化
作成時にユーザーがジオフェンス内にいる場合、enter遷移イベントは発生しません。これは、境界を越えるときにexitおよびenter遷移イベントが発生するためであり、内部に実体化したときではありません。

データレイヤー

以下の変数は、モバイルデータレイヤーの一部としてロケーションモジュールによって構成されます。これらの変数はライブラリからの各トラッキングコールに自動的に含まれます。

ジオフェンシング中、ユーザーの遷移状態が変化すると、位置データを含むトラッキングコールが送信されます。遷移状態の変化には、ユーザーがジオフェンスに入るか出ることが含まれます。データレイヤーに送信される追加の変数は以下の通りです：

API リファレンス

ロケーションモジュールで使用されるメソッドのリファレンスについては、iOS APIのTealium SDKのLocationModuleクラスを参照してください。