モジュール
利用可能なモジュールのリストです。
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 |
UIWebview ベースのディスパッチサービスで、ライブラリがTIQ/utag.js を実行することを許可 |
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)
最終更新日 :: 2025年September月11日