構成 | 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`クッキーを無効にします。
`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）

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

`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スコアを改善する理由です）。