ロケーションモジュール

ロケーションモジュールは、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プロジェクトでファイル > パッケージ依存関係を追加を選択します。
2. リポジトリURLを入力します：https://github.com/tealium/tealium-swift
3. バージョンルールを構成します。通常は次のメジャーまでが推奨されます。現在のTealium Swiftライブラリバージョンがリストに表示されない場合は、Swiftパッケージキャッシュをリセットしてください。
4. インストールするモジュールのリストからロケーションモジュールを選択し、Xcodeプロジェクトのフレームワークとライブラリの下にあるアプリターゲットごとに追加します。

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

CocoaPods

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

pod 'tealium-swift/Location'

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

Carthage

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

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

2. 次のフレームワークを組み込みバイナリセクションに追加します：

   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()
      }
  }

ジオフェンシング

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

• ホストされた URL
  自分のホストされたジオフェンスファイルをURLとして提供します。プロパティgeofenceUrlを使用します。
  このオプションは、公開構成の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クラスを参照してください。