構成

仕組み

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 Cookie、または utag_main の v_id コンポーネントを強制的に構成させる
（utag.js 4.50 で追加）
utag_main の v_id 変数は、データプライバシーおよび同意の目的に準拠するよう、Tealium Collectタグによって構成されます。この構成を true にすると、utag.js はすべての訪問に対してこのCookieを強制的に構成します。（デフォルト：false）

window.utag_cfg_ovrd.always_set_v_id = true;

cmcookiens

同意管理Cookieの名前
同意管理Cookieの名前をカスタマイズします。同じドメイン名で複数のプロファイルを使用している場合は、Cookie間の競合や潜在的なデータ漏洩を防ぐため、各プロファイルに一意の同意管理Cookie名を指定してください。

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では、この保護がデフォルトで有効になっていたため、一部のモバイルWebView環境で問題が発生していました。バージョン4.54では、この保護はオプトイン方式になり、完全に制御できるようになりました。

（デフォルト：false）

window.utag_cfg_ovrd.disable_tealium_attribute_override = true;

dom_complete

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

window.utag_cfg_ovrd.dom_complete = true;

domain

Cookieドメインを上書きする
utag_main Cookieを構成するドメインを指定します。Cookieを受け付けないルートドメイン上のサイトで役立ちます。たとえば、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 が呼び出されるたびに、ロードルールを再処理するかどうかを制御します。新たにトリガーされたロードルールによって、新しいタグがページに読み込まれる場合があります。この構成は、4.2xより前のバージョンの utag.js の動作を再現するために使用します。（デフォルト：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

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

メタタグの例：

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

結果の値：

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

window.utag_cfg_ovrd.lowermeta = true;

lowerqp

クエリ文字列のパラメータ名と値を小文字に変換（レガシー）
すべてのクエリ文字列変数名と値を小文字に変換します。4.2xより前のバージョンのutag.jsの動作を再現します。（デフォルト：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）

このオプションを使用すると訪問数とセッション数が実際より多くなり、すべての訪問が「単一ページセッション」のように見えます。

このオプションは、Persist Data Value拡張機能で構成されたCookieやセッションCookieを含め、utag.jsによる_すべての_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構成の使用を検討する前に、ページを測定および監視し、タグ実装を軽量化してください。
• nonblocking_tagsは、INPが200ミリ秒を超える原因となるリソース負荷の高いタグを含み、DOMのレンダリングをブロックする必要がないページでのみ使用してください。
• ノンブロッキングタグはトラッキングのためにページを停止させずに読み込まれるため、重要なナビゲーションイベントや離脱イベントで発生するナビゲーションの遅延を考慮してください（これがINPスコアを改善できる理由です）。

path

パブリッシュURLのパス
タグテンプレートのパブリッシュURLパスを構成し、指定されている場合はPublish ConfigurationダイアログのPublish URLsフィールドを上書きします。パブリッシュ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拡張機能およびSC()関数によって構成されるすべてのutag_main Cookieで、属性文字列をsecureに構成します。セキュアCookieは、HTTPSページでのみ構成およびアクセスできます。（デフォルト：false）

window.utag_cfg_ovrd.secure_cookie = true;

session_timeout

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

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

window.utag_cfg_ovrd.session_timeout = 900000;

split_cookie

スタンドアロンCookie
（utag.js 4.50で新しく追加）
utag_名前空間のCookie（組み込みのutag_main Cookieなど）を、utag.loader.SCによって複数値Cookieとして書き込むか、スタンドアロンCookieとして書き込むかを指定します。（デフォルト：true）

window.utag_cfg_ovrd.split_cookie = false;

split_cookie_allowlist

utag_mainサブCookie
（utag.js 4.50で新しく追加）
許可するutag_mainサブCookieの配列を指定します。許可リストは、split_cookieがtrueに構成されている場合にのみ適用されます。これはバージョン4.50以降のデフォルト構成です。

split_cookie_allowlistが定義され、有効になっている場合は、以下が適用されます。

• utag.loader.SCはutag_main Cookieのみを構成します。
• このリストに含まれるサブCookieのみがutag_main名前空間に構成されます。

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

このオプションで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によるタグのトラッキング時にこれらの拡張機能は実行されませんでした。

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

window.utag_cfg_ovrd.suppress_before_load_rules_with_uids = true;

waittimer

タイマーを使用してタグを遅延
DOM Readyイベントの後、タグを読み込むまでの待機時間をミリ秒単位で構成します。（デフォルト：未構成）

window.utag_cfg_ovrd.waittimer = 1000;