ロケーションモジュール

ロケーションモジュールを使用すると、iOSアプリが位置情報を受け取り、ジオフェンスを構成および監視することができます。詳細を学ぶ 位置追跡とジオフェンシングについて。

サポートされているプラットフォーム

以下のプラットフォームがサポートされています：

• iOS

要件

• Tealium for Swift (1.9.0+)

サンプルアプリ

iOSサンプルアプリを探索して、ライブラリ、トラッキング方法、ベストプラクティスの実装に慣れてください。メインのサンプルアプリにはロケーションモジュールが含まれています。

インストール

Swift Package Manager、CocoaPods、またはCarthageを使用してロケーションモジュールをインストールします。

Swift Package Manager (推奨)

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

1. リポジトリ：https://www.github.com/Tealium/tealium-swift を使用してXcodeまたはコマンドラインツール内にSwiftパッケージを追加します。

2. Xcodeを使用している場合は、インストールプロセスで TealiumLocation ターゲットを選択します。コマンドラインを使用している場合は、 Package.swift ファイル内の依存関係リストに TealiumLocation モジュールを追加します。

フレームワークは自動的にインスタンス化されます。 TealiumCore に依存性があり、ディスパッチャー（ TealiumCollect または TealiumTagManagement ）が必要です。追加のインポートステートメントは必要ありません。

詳細を学ぶ iOSのSPMインストールについて。

CocoaPods

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

pod 'tealium-swift/TealiumLocation'

フレームワークは自動的にインスタンス化されます。 TealiumCore ポッドに依存性があり、ディスパッチャー（ TealiumCollect または TealiumTagManagement ）が必要です。詳細を学ぶ iOSのCocoaPodsインストールについて。

Carthage

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

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

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

   TealiumLocation.framework
   

フレームワークは自動的にインスタンス化されます。 TealiumCore に依存性があり、ディスパッチャー（ TealiumCollect または TealiumTagManagement ）が必要です。追加のインポートステートメントは必要ありません。詳細を学ぶ iOSのCarthageインストールについて。

初期化

モジュールがアプリに追加されると、ロケーショントラッキングがデフォルトで有効になります。 位置精度 と ジオフェンシング の構成オプションは、 TealiumConfig のインスタンスのプロパティを使用して構成されます。

権限

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

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

キーが存在しない場合、位置情報のリクエストはすぐに失敗します。 詳細を学ぶ 位置情報サービスの承認をリクエストする方法について。

位置追跡

ロケーションモジュールは連続的な位置追跡を行います。位置の更新は精度と距離の2つの構成に基づいています。

デフォルトでは、重要な位置の更新のみが監視されます。これにより、更新が少なくなり、バッテリーの消費が少なくなります。

より高精度の更新を有効にするには、 useHighAccuracy プロパティを true に構成し、 updateDistance プロパティを更新をトリガーするメートル単位の値に構成します。

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

ジオフェンシング

ジオフェンシングを有効にするには、次のいずれかの方法を使用して、ジオフェンスJSONファイルを提供します：

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

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

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

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

追加の考慮事項

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

ジオフェンスの初期化
ユーザーがジオフェンスの作成時にジオフェンス内にいる場合、 "enter" トランジションイベントは発生しません。これは、 "exit" と "enter" トランジションイベントは、境界を越えるときに発生し、内部に現れるときではないためです。

データレイヤー

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

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

APIリファレンス

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