JavaScriptを実行するために、レンダリングされないWKWebViewインスタンスを使用するUniversal Tag(utag.js)のクライアント側実装です。
使用方法
TagManagementモジュールは、JavaScriptを実行するために、レンダリングされないWKWebViewインスタンスを使用するUniversal Tag(utag.js)のクライアント側実装です。このモジュールは、タグマネジメントを使用するアプリで必要です。CarthageおよびCocoaPodsのフレームワークビルドには自動的に含まれます。
サポート対象プラットフォーム
- iOS
要件
- WebKit(WKWebView)
インストール
CocoaPodsまたはCarthageを使用してTagManagementモジュールをインストールします。
CocoaPods
CocoaPodsでTagManagementモジュールをインストールするには、Podfileに次のPodを追加します。
pod 'tealium-swift/TealiumTagManagement'
フレームワークは自動的にインスタンス化されます。このフレームワークはTealiumCore Podに依存します。iOS向けのCocoaPodsによるインストールについては、詳細をご覧ください。
Carthage
CarthageでTagManagementモジュールをインストールするには、次の手順に従います。
Xcodeでアプリターゲットの「General」構成ページに移動します。
Embedded Binariesセクションに次のフレームワークを追加します。
TealiumTagManagement.framework
フレームワークは自動的にインスタンス化されます。このフレームワークはTealiumCoreに依存します。追加のimport文は必要ありません。iOS向けのCarthageによるインストールについては、詳細をご覧ください。
データレイヤー
トラッキング呼び出しのたびに、次の変数が送信されます。
| 変数 | 型 | 説明 | 例 |
|---|---|---|---|
dispatch_service | String | トラッキング呼び出しの送信元モジュールを示す静的文字列 | "tagmanagement" |
パブリックAPI
WKWebViewデリゲートに準拠する別のオブジェクトをモジュールのマルチキャストデリゲートに追加することで、WKWebViewプロトコルにアクセスできます。
tealium.tagManagement()?.delegates.add(MY_OBJECT)
WKWebViewについて
バージョン1.7.0より前では、このモジュールはUIWebViewを使用していましたが、現在は非推奨となり、WKWebViewに置き換えられています。OSでは、WKWebViewがレンダリングされない場合でも、常にUIViewにアタッチされている必要があります。UIViewにアタッチされていない場合、OSによってパフォーマンスが大幅に制限され、JavaScriptが最適に実行されません。これに対応するため、Tag Managementモジュールは、レンダリングされないWKWebViewをアプリのルートUIViewにアタッチしようとします。
アプリのビュー階層が複雑で、モジュールがrootViewControllerを検出できない場合は、viewDidLoad、viewWillAppear:、またはviewDidAppear:で、アタッチ先となるビューを指定してTealiumConfigを初期化してください。
リリース1.7.1ではビューの自動検出機能が大幅に改善され、ほとんどの場合、ビューを指定する必要がなくなりました。ただし、トラッキング呼び出しが正しく送信されることを確認するため、アプリでテストする必要があります。詳細については、リリースノートを参照してください。
プッシュ通知の受信時にアプリがUIViewControllerへ遷移し、そのビュー階層がTealiumの初期化時とは異なる場合は、次のAPIメソッドを使用して現在のUIViewを更新する必要があります。
override func viewDidLoad() {
super.viewDidLoad()
// this view does not have a navigation controller
if self.navigationController == nil {
// update the current root UIView on the Tealium instance
tealium?.updateRootView(self.view)
}
// Do any additional setup after loading the view.
}
完全な例については、サンプルアプリのSwift-WKWebViewを参照してください。
WKWebViewとUIWebViewではCookieを保存する方法が異なるため(それぞれWKHTTPCookieStoreとHTTPCookieStorage)、モジュールはWKWebViewの初回起動時にCookieを自動的に同期します。HTTPCookieStorage内のCookieは削除されませんが、最終的には自然に期限切れになります。
shouldAddCookieObserverメソッドを使用すると、Cookieの同期中に独自のCookieオブザーバーを使用できます。この同期では、Cookieの構成後にメインスレッドでCookieを取得するためのCookieオブザーバーが必要です。この問題はWKWebViewのバグによって発生し、独自のオブザーバーが呼び出されなくなります。
最終更新日 :: 2026年November月18日