構成 | JavaScript用Tealium (utag.js) | Tealiumドキュメント

動作原理

utag.jsの多くの挙動は、utag.cfgオブジェクト内の構成で制御されます。これらのデフォルトの挙動は、utag_cfg_ovrdという新しいオブジェクトを使用して上書きされます。このオブジェクトを使用するには、utag.jsをロードする前にページコードで構成するか、Pre LoaderにスコープされたJavaScript Code Extension内で以下のように構成します：

window.utag_cfg_ovrd = window.utag_cfg_ovrd || {};

オプションのリスト

以下の表は、利用可能な構成をまとめたものです：

構成	説明
`always_set_v_id`	`utag_main_v_id`クッキーまたは`utag_main`の`v_id`コンポーネントを構成します。デフォルト：`false`
`cmcookiens`	同意管理クッキー名。
`consentPeriod`	ユーザーの同意構成を保持する日数を構成します。
`disable_tealium_attribute_override`	システム定義の属性`tealium_*`が受信データによって上書きされるのを防ぎます。
`dom_complete`	DOM完了（ロード）イベントまでタグの実行を遅延させます。
`domain`	クッキーを構成するドメインを上書きします。
`gdprDLRef`	同意管理者が使用する言語構成を格納するデータレイヤー変数の名前を指定します。
`ignoreLocalStorage`	ローカル保存変数をデータレイヤーに追加しないようにします。
`ignoreSessionStorage`	セッション保存変数をデータレイヤーに追加しないようにします。
`load_rules_ajax`	ページロード後のロードルールを無効にします（レガシー）。
`load_rules_at_wait`	拡張機能の後でロードルールを実行します（レガシー）。
`lowermeta`	メタタグの名前と値を小文字にします（レガシー）。
`lowerqp`	クエリ文字列パラメータの名前と値を小文字にします（レガシー）。
`noload`	すべての機能を無効にします。
`noview`	初回ページロード時の自動トラッキングコールを無効にします。
`nocookie`	`utag_main`クッキーを無効にします。
`noconsole`	`utag.DB`コンソール出力を抑制します。
`nonblocking_tags`	すべてのタグを非ブロッキングにして、極端なケースでのパフォーマンスとInteraction to Next Paint (INP)スコアを向上させます。デフォルト：`false`。
`path`	公開パスを指定します。
`readywait`	DOM-readyブラウザイベントまで操作を停止します。
`secure_cookie`	Persist Data Values extensionおよび`utag.loader.SC`メソッドによって構成されるすべての`utag_main`クッキーの属性文字列を`secure`に構成します。
`session_timeout`	セッションの有効期限（ミリ秒単位）を構成します。
`split_cookie`	`utag_main`クッキーを独立したクッキーに分割します。デフォルト：`true`
`split_cookie_allowlist`	許可された`utag_main`サブクッキーまたは独立したクッキーの配列。
`suppress_before_load_rules_with_uids`	UIDによるトラッキングタグの場合、Before Load Rulesにスコープされた拡張機能をスキップするレガシー動作を強制します。デフォルト：`false`。
`waittimer`	タグのロード前に遅延する時間（ミリ秒単位）を構成します。

`always_set_v_id`

utag.jsにutag_main_v_idクッキーまたはutag_mainのv_idコンポーネントを構成させる
(utag.js 4.50で新規導入)
utag_mainのv_id変数は、データプライバシーと同意目的に準拠するためにTealium Collectタグによって構成されます。これをtrueに構成すると、utag.jsはすべての訪問に対してこのクッキーを構成するように強制します。（デフォルト：false）

window.utag_cfg_ovrd.always_set_v_id = true;

`cmcookiens`

同意管理クッキー名
同意管理クッキー名をカスタマイズします。同じドメイン名で複数のプロファイルを持っている場合は、クッキー間の競合や潜在的なデータ漏洩を防ぐために、各プロファイルに固有の同意管理クッキー名を構成してください。

window.utag_cfg_ovrd.cmcookiens = "CONSENTMGR_NL-CMB-CG1";

`consentPeriod`

同意構成保持期間
GDPRおよびCCPAの同意ステータスを保持する日数を構成します。GDPRの組み込み有効期限は365日、CCPAの有効期限は395日です。

window.utag_cfg_ovrd.consentPeriod = 60;

`disable_tealium_attribute_override`

システム定義の属性の上書きを防ぐ

(utag.js 4.54で新規導入)

trueに構成すると、この構成は受信データがtealium_visitor_idおよびtealium_eventを除くtealium_で始まるシステム定義の属性を上書きするのをブロックします。

utag.jsのバージョン4.52および4.53では、この保護はデフォルトで有効になっており、一部のモバイルWebビュー環境で問題を引き起こしました。バージョン4.54では、保護はオプトインになり、完全な制御が可能です。

（デフォルト：false）

window.utag_cfg_ovrd.disable_tealium_attribute_override = true;

`dom_complete`

DOM完了（ロード）ブラウザイベントまでタグを遅延させる
ドキュメントロードイベントではなく、DOM Readyでタグをロードします。これにより、DOM Readyにスコープされた拡張機能も遅延されます。（デフォルト：false）

window.utag_cfg_ovrd.dom_complete = true;

`domain`

クッキードメインを上書きする
utag_mainクッキーが構成されるドメインを構成します。たとえば、amazonaws.comのようなルートドメインでクッキーを受け入れないサイトに便利です。（デフォルト：location.hostnameのトップレベルドメイン）

window.utag_cfg_ovrd.domain = "mysite.amazonaws.com";

`gdprDLRef`

同意管理者で使用する言語構成を上書きする
同意管理者で使用する言語を格納するデータレイヤー変数の名前を指定します。

たとえば、データレイヤーにsite_languageという変数が含まれている場合：

window.utag_cfg_ovrd = window.utag_cfg_ovrd || {}
window.utag_cfg_ovrd.gdprDLRef = "site_language";

言語コードを直接構成しないでください。この上書き構成は変数名を期待しており、言語コード値ではありません。

`ignoreLocalStorage`

ローカル保存変数を無視する ローカル保存変数を無視します。（デフォルト：false）

window.utag_cfg_ovrd.ignoreLocalStorage = true;

`ignoreSessionStorage`

セッション保存変数を無視する セッション保存変数を無視します。（デフォルト：false）

window.utag_cfg_ovrd.ignoreSessionStorage = true;

`load_rules_ajax`

ページロード後のロードルールを無効にする（レガシー）
同じページロード内でutag.viewおよびutag.linkが呼び出されるたびにロードルールが再処理されるかどうかを制御します。新たにトリガーされたロードルールがページに新しいタグをロードする可能性があります。utag.jsの4.2xより前のバージョンの動作を再現するためにこの構成を使用します。（デフォルト：true）

window.utag_cfg_ovrd.load_rules_ajax = false;

`load_rules_at_wait`

拡張機能の後でロードルールを実行する（レガシー）
拡張機能の後でロードルールを評価します。utag.jsの古いバージョンや、utag.jsのロード後にデータレイヤーオブジェクトが入力されるインストールで使用されます。新しいバージョンのutag.jsでは、この構成の代わりに拡張機能の実行順序を使用します。（デフォルト：false）

window.utag_cfg_ovrd.load_rules_at_wait = true;

`lowermeta`

メタタグデータを小文字にする（レガシー）
すべてのメタデータ変数名と値を小文字にします。utag.jsのバージョン4.2x以前の動作を再現します。（デフォルト：false）

メタタグの例：

<meta content="iQ Tag Management" property="Article:Section">

結果の値：

utag.data['meta.article:section']="iq tag management"

window.utag_cfg_ovrd.lowermeta = true;

`lowerqp`

クエリ文字列パラメータ名と値を小文字にする（レガシー）
すべてのクエリ文字列変数名と値を小文字にします。utag.jsのバージョン4.2x以前の動作を再現します。（デフォルト：false）

クエリ文字列パラメータの例：&RefId=Abc123 結果の値：utag.data['qp.refid']="abc123"

window.utag_cfg_ovrd.lowerqp = true;

`noload`

すべての操作を停止
Pre Loaderにスコープされた拡張機能の後でコードの実行が停止します。DOM Readyにスコープされた拡張機能は実行されます。通常、Prevent Tag Loadの公開構成を使用して調整されます。（デフォルト：0）

window.utag_cfg_ovrd.noload = true;

`noview`

初回ページロード時の自動トラッキングコールを無効にする
初回ページロード時に自動的に発生するトラッキングコールを抑制します。この構成は、シングルページアプリケーションサイトでよく使用されます。（デフォルト：false）

window.utag_cfg_ovrd.noview = true;

`nocookie`

Cookieのオプトアウト
訪問がすべてのCookieの使用を明示的にオプトアウトした場合のみ、このオプションを構成してください。（デフォルト：false）

このオプションを使用すると、訪問数とセッション数が増加し、すべての訪問が「シングルページセッション」のように見えます。

このオプションは、utag.jsによって構成されるすべてのCookieの保存を無効にします。これには、Persist Data Value extensionで構成されるCookieやセッションCookieも含まれます。また、Cookieが利用できない場合には、ut.visitor_id、tealium_visitor_id、cp.utag_main_v_idの変数に新しいタイムスタンプを構成します。

window.utag_cfg_ovrd.nocookie = true

`noconsole`

デバッグコンソール出力を抑制
ブラウザコンソールに表示されるutag.DBデバッグメッセージの出現を防ぎます。デバッグ出力はutag.db_log配列に引き続き書き込まれます。（デフォルト：false）

window.utag_cfg_ovrd.noconsole = true;

`nonblocking_tags`

タグを非同期でロード
（utag.js 4.52で新設）
すべてのタグの非ブロッキング動作を有効にします。これにより、INPスコアと全体的なページパフォーマンスが向上します。リソースを多く消費するタグがユーザーのインタラクションを遅延させ、INPスコアを低下させるページでこの構成を使用してくださいが、退出リンクのトラッキングが正しく機能するか十分にテストしてください。（デフォルト：false）

window.utag_cfg_ovrd.nonblocking_tags = true;

ベストプラクティス

nonblocking_tags構成を使用する際のベストプラクティス：

ページを測定し、監視し、タグの実装を軽量化することを検討してからnonblocking_tags構成を使用してください。
INPスコアが200ミリ秒を超え、DOMレンダリングをブロックする必要がないページでのみnonblocking_tagsを使用してください。
非ブロッキングタグはページを保持せずにロードされるため、重要なナビゲーションや退出イベントの遅延を考慮してください（これがINPスコアを改善する理由です）。