構成
utag.js
の挙動を調整する構成について学びます。
動作原理
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 |
ユーザーの同意構成を保持する日数を構成します。 |
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 |
すべてのutag_main クッキーにsecure 属性文字列を構成します。これはPersist Data Values extensionおよびutag.loader.SC メソッドによって構成されます。 |
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;
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
)
このオプションを使用すると、訪問数とセッション数が増加し、すべての訪問が「シングルページセッション」のように見えます。
このオプションは、Persist Data Value extensionで構成されたCookieやセッション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ミリ秒を超えるリソース集約型のタグがあるページでのみ
nonblocking_tags
を使用し、DOMのレンダリングをブロックする必要がない場合に限ります。 - 重要なナビゲーションや退出イベントでのナビゲーション遅延を考慮してください。非ブロッキングタグはページを保持せずにロードされるため、INPスコアが改善されます。
path
公開URLパスを構成
タグテンプレートの公開URLパスを構成し、指定されている場合は公開構成ダイアログの公開URLフィールドを上書きします。公開URLパスの構成は、自己ホスティングおよびFirst Party Domainsの顧客にとって有用です。
window.utag_cfg_ovrd.path = '//tags.example.com/main/prod';
readywait
DOM準備完了まで操作を遅延
ブラウザからDOM準備完了の信号を受け取るまで、すべての操作を停止します。utag.js
のロード時には、Pre Loaderにスコープされた拡張機能が引き続き実行されます。(デフォルト: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にスコープされたすべての拡張機能はページロードごとに1回実行されますが、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;
最終更新日 :: 2025年June月18日