モジュール | Tealium for iOS (Swift) バージョン 1.x

Tealium Swiftライブラリはモジュール型アーキテクチャを基に設計されています。モジュールは存在する場合は自動的にインスタンス化され、その構成はTealiumConfigインスタンスから取得します。

すべてのモジュールはTealiumCoreに依存しています。これは、任意のモジュールをインストールするとTealiumCoreもインストールされることを意味します。

モジュールリスト

以下にモジュールを自動インスタンス化が行われる内部順序（優先順位）でリスト化しています。

モジュール名	モジュールID	説明	対応プラットフォーム
AppData	`appdata`	トラックデータに`app_uuid`を追加	iOS, macOS, tvOS, watchOS
Attribution	`attribution`	トラックデータにIDFAを追加	iOS
AutoTracking	`autotracking`	`viewDidAppear`イベントを含むほとんどのUIに対してディスパッチを準備・送信	iOS, tvOS
Collect	`collect`	Tealium Collectまたは他のカスタムURLエンドポイントへのトラックコールをパッケージ化して配信	iOS, macOS, tvOS, watchOS
ConsentManager	`consentmanager`	GDPR/プライバシー準拠を支援	iOS, macOS, tvOS, watchOS
Connectivity	connectivity	接続性の喪失による遅延配信のためのトラックメッセージにフラグを追加する機能を追加	iOS, macOS, tvOS, watchOS
CrashReporter	`crashreporter`	アプリ内のクラッシュを自動的にトラックします。モジュールが有効化され、関連するフレームワークがインストールされると、アプリでクラッシュが発生した場合にクラッシュイベントがトリガーされます。	iOS
DataSource	`datasource`	データソースIDのための追加の構成初期化オプションを追加。Swift 1.8.0+でCoreに含まれています。	iOS, macOS, tvOS, watchOS
DefaultStorage	`defaultstorage`	任意のモジュールに対する一般的な永続性能力を追加（UserDefaultsによってバックアップ）。Swift 1.8.0+でCoreに含まれています。	iOS, tvOS, watchOS, macOS
Delegate	`delegate`	トラックディスパッチの監視または抑制のためのマルチキャストデリゲートを追加	iOS, macOS, tvOS, watchOS
DeviceData	`devicedata`	すべてのトラックデータに追加のデバイス情報を追加	iOS, macOS, tvOS, watchOS
DispatchQueue	`dispatchqueue`	キューに入れられたディスパッチの永続的な保存を追加し、有効化された場合のイベントバッチングを管理	iOS, macOS, tvOS, watchOS
FileStorage	`filestorage`	任意のモジュールに対する一般的な永続性能力を追加 - Defaults Storageモジュールを置き換えます（`NSKeyedArchiver`によってバックアップ）。Swift 1.8.0+でCoreに含まれています。	iOS, macOS, watchOS, tvOS
Lifecycle	`lifecycle`	起動、ウェイク、スリープ、クラッシュインスタンスをトラック（自動または手動）	iOS, tvOS, watchOS
Location	`location`	イベントのデバイス位置データを提供し、興味のあるポイント周辺にジオフェンスを追加する能力を提供	iOS, Mac Catalyst, macOS, tvOS, watchOS
Logger	`logger`	デバッグログ	iOS, macOS, tvOS, watchOs
PersistentData	`persistentdata`	すべてのトラックデータに永続的なデータを追加する能力を追加	iOS, macOS, tvOS, watchOS
RemoteCommands	`remotecommands`	`URLScheme`、`UIWebView`、または`TagManagement`を介した構成可能なリモートコードブロックの実行を許可	iOS
TagManagement	`tagmanagement`	ライブラリがTIQ/`utag.js`を実行できるようにする`UIWebview`ベースのディスパッチサービス	iOS
Visitor Service	`visitorservice`	ビジターサービスから更新されたビジタープロファイルを取得	iOS, macOS, tvOS, watchOS
Volatile Data	`volatiledata`	すべてのトラックデータにセッション永続データを追加する能力を追加（アプリの終了/クローズ時にクリア）	iOS, macOS, tvOS, watchOS

推奨モジュール

以下のセクションでは、推奨モジュールをリスト化しています。

基本実装

これは基本実装のための推奨モジュールリストです。

Core
Attribution
AppData
Connectivity
Delegate
DeviceData
DispatchQueue
Lifecycle
Logger
PersistentData
VolatileData

タグ管理

基本モジュールに加えて、タグ管理インストールにはこれらのモジュールが必要です。

Consent Manager
RemoteCommands
TagManagement

Tealium EventStream/AudienceStream

基本モジュールに加えて、EventStream/ AudienceStreamインストールにはこれらのモジュールが必要です。

Collect
Consent Manager

モジュールのインストール

CocoaPodsまたはCarthageでモジュールをインストールします。

CocoaPods

特定のモジュールを含める/除外する方法については、CocoaPodsでのインストールを参照してください。

Carthage

Carthageでインストールする場合、必要なモジュールを明示的にインポートする必要があります。すべてのモジュールをインポートすることも可能で、前述のようにモジュールリストを使用しますが、必要なモジュールのみをインポートするとアプリが軽量化されます。特定のモジュールを含める/除外する方法については、Carthageでのインストールを参照してください。

モジュールの無効化

Tealium Swift SDKのバージョン1.6.5以前では、CocoaPodsまたはCarthageを使用していて不要なモジュールを無効化する唯一の方法は、TealiumConfigオブジェクトを使用して有効/無効のモジュールの配列（ホワイトリスト/ブラックリスト）を構成することでした。このシナリオでは、すべてのコードが最終的なアプリバンドルにコンパイルされましたが、無効化されたモジュールは非活性化されました。

この方法はまだサポートされていますが、アプリバンドルにコードを少なくコンパイルすることによるパフォーマンス向上を享受するために、以下の他の方法に移行することをお勧めします。TealiumConfigオブジェクト上でモジュールリストを有効にし、同時に不要なモジュールを削除します。モジュールを有効化しようとするが、そのコードがアプリバンドルに存在しない場合、それは何の不都合も引き起こさず、単に何の効果もありません。

以下の例は、自動トラッキングモジュールをブラックリストに登録します：

let modulesList = TealiumModulesList(isWhitelist: false, moduleNames: ["autotracking"])
config.setModulesList(modulesList)