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

動作原理

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

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で新規導入）
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_で始まるシステム定義の属性を上書きするのをブロックします。

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

（デフォルト：false）

window.utag_cfg_ovrd.disable_tealium_attribute_override = true;

`dom_complete`

DOM完了（ロード）ブラウザイベントまでタグを遅延させる
タグをDOM Readyではなくdocument load eventで読み込みます。これにより、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 msを超え、DOMレンダリングをブロックする必要がないページでのみnonblocking_tagsを使用します。
非ブロッキングタグはページを保持せずにロードされるため、重要なナビゲーションや退出イベントの遅延に注意してください（これがINPスコアを改善する理由です）。