モジュール
利用可能なモジュールのリスト。
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)
最終更新日 :: 2024年November月6日