構成

動作原理

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

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

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

path

公開URLパスを構成
タグテンプレートの公開URLパスを構成し、指定されている場合は公開構成ダイアログの公開URLフィールドを上書きします。公開URLパスの構成は、自己ホスティングおよびFirst Party Domainsの顧客にとって有用です。

window.utag_cfg_ovrd.path = '//tags.example.com/main/prod';

readywait

DOM-readyまで操作を遅延
ブラウザからDOM-ready信号を受信するまで、すべての操作を停止します。Pre Loader にスコープされた拡張機能は、utag.js がロードされたときに実行されます。（デフォルト：0）

window.utag_cfg_ovrd.readywait = true;

secure_cookie

セキュアCookie
(utag.js 4.48で新規導入)
Persist Data Values extensionおよびSC()関数によって構成されるすべてのutag_mainクッキーに対して、属性文字列をsecureに構成します。セキュアクッキーはHTTPSページでのみ構成およびアクセスが可能です。（デフォルト：false）

window.utag_cfg_ovrd.secure_cookie = true;

session_timeout

セッションタイムアウト 現在のセッションが期限切れになるまでの待ち時間をミリ秒単位で構成します。これは通常、セッションタイムアウトの公開構成を使用して調整されます。（デフォルト：1800000 (30分)）

タイムアウトを900000ミリ秒（15分）に構成する例：

window.utag_cfg_ovrd.session_timeout = 900000;

split_cookie

スタンドアロンクッキー
(utag.js 4.50で新規導入)
utag_名前空間のクッキー（組み込みのutag_mainクッキーなど）がマルチバリュークッキーとして書き込まれるか、utag.loader.SCによってスタンドアロンクッキーとして書き込まれるかを決定します。（デフォルト：true）

window.utag_cfg_ovrd.split_cookie = false;

split_cookie_allowlist

utag_mainサブクッキー
(utag.js 4.50で新規導入)
許可されたutag_mainサブクッキーの配列を指定します。許可リストは、split_cookieがtrueに構成されている場合にのみ適用されます。これは、バージョン4.50以降のデフォルト構成です。

split_cookie_allowlistが定義されており、アクティブである場合、以下が適用されます：

• utag.loader.SCはutag_mainクッキーのみを構成します。
• このリストにあるサブクッキーのみがutag_main名前空間で構成されます。

split_cookie_allowlistが定義されていない場合、またはsplit_cookieがtrueでない場合、すべてのutag_名前空間のクッキーが許可されます。

ses_id、_st、_ssを許可せずにこのオプションを使用すると、訪問とセッションのカウントが増加し、すべての訪問がシングルページセッションのように見えるようになります。

window.utag_cfg_ovrd.split_cookie_allowlist = ["v_id", "_ss", "_st", "ses_id"];

suppress_before_load_rules_with_uids

UIDによるトラッキングタグの場合、Before Load Rules拡張機能をスキップ
(utag.js 4.52で新規導入)

デフォルトでは、Before Load Rulesにスコープされた拡張機能は、UIDによるトラッキングタグの場合でもすべてのトラッキングコールに対して実行されます。以前は、UIDによるトラッキングタグの場合、これらの拡張機能は実行されませんでした。

このオプションをtrueに構成すると、UIDによるトラッキングタグの場合、Before Load Rulesにスコープされた拡張機能をスキップします（レガシー動作）。（デフォルト：false）

window.utag_cfg_ovrd.suppress_before_load_rules_with_uids = true;

waittimer

タイマーでタグを遅延 DOM Readyイベントの後、タグのロードを待つ時間をミリ秒単位で構成します。（デフォルト：構成なし）

window.utag_cfg_ovrd.waittimer = 1000;