Tealium Universal Tag (utag.js) リリースノート | Tealium for JavaScript（utag.js）

utag.jsのテンプレートを更新して、最新の修正と機能エンリッチメントを活用してください。

utag.jsバージョン4.50以降へのアップデート

バージョン4.50以降にアップデートする際には、以下の手順をお勧めします。

Tealium Collectタグとすべてのアクティブな同意管理テンプレート、特にイベントログ機能を更新してください。
同じサイトで複数のiQプロファイルを実行している場合は、次の手順を完了してください。これにより、サイト上のすべてのutag.jsインスタンスが新しいクッキーの動作を同時に使用し、競合や互換性の問題を防ぐことができます。
1. すべてのutag.jsテンプレートを最新バージョンに更新してください。
2. 各プロファイルのsplit_cookieオーバーライドをfalseに構成して、レガシーのクッキーの動作を使用し、トランジションの期間中にサイト上でまだ実行されている古いバージョンのutag.jsとの互換性を維持してください。
3. すべてのutag.jsテンプレートが更新され、レガシーのクッキーの動作を維持するためにsplit_cookieオーバーライドが構成されている場合、すべてのプロファイルからクッキーオーバーライドを同時に削除できます。

2023年9月

4.51

utag.jsバージョン4.50で特定のブラウザとタイムゾーン/地域構成を使用した場合のクッキーの有効期限の問題を修正しました。

4.50

バージョン4.50では、utag.jsによって書き込まれるクッキーについての透明性と制御が向上しています。

以前は、マルチバリュークッキー（マルチクッキー）の使用を推奨していました。しかし、データプライバシーの監査などの透明性とシンプルさへの要求の増加により、推奨事項を見直しました。現在は、utag.jsのデフォルトの動作として、スタンドアロンのクッキーの使用を推奨しています。

このリリースには、以下の更新が含まれています。

単一のマルチバリュークッキーではなく、別々のutag_mainクッキーを書き込みます。複数の値を単一のクッキーに格納する従来の動作を使用するには、split_cookieをfalseに構成してください。
utag_main_v_idの責任をutag.jsからTealium Collectタグに移動します。utag.jsがutag_main_v_idクッキーを構成するようにするには、always_set_v_idをtrueに構成してください。
同意管理クッキーのid要素を追加して、同意のログを記録します。このクッキーが最初に構成されると、見つかったすべてのutag_main_v_idの値と一致しますが、その後は変更されません。この動作は、ユーザーとログのイベントの間のリンクを維持することを優先しますが、すべての場合で一致が保証されるわけではありません。
関連するテンプレートを更新することで簡単にアップグレードできます。
以下のutag構成を追加しました：
- split_cookie - レガシーの単一のマルチバリュークッキーを使用するにはfalseに構成します。
- split_cookie_allowlist - utag_main名前空間を使用して構成できるクッキー名の配列を指定します。
- always_set_v_id - utag.jsがutag_main_v_idクッキーまたはutag_mainのv_idコンポーネントを構成するように強制します。
以下のテンプレートを更新しました：
- utag.js（loader）をバージョン4.50に更新して、クッキーの動作を更新します。
- cmGeneralをバージョン3.0.12に更新して、同意ログテンプレートからデバイスIDを生成または取得するための集中ロジックを追加します。
- cmDoNotSellをバージョン1.4.0に更新して、集中ロジックを呼び出します。
- fullConsentEventHandlerをバージョン1.0.3に更新して、集中ロジックを呼び出します。
- partialConsentEventHandlerをバージョン1.0.3に更新して、集中ロジックを呼び出します。
- Collectをバージョンtv:20064.20230519（2023年5月にリリース）に更新します。

utag 4.50以降の透明性向上のための新しい構成の詳細については、utag 4.51によるクッキーの透明性の向上を参照してください。

2022年9月

4.49

localStorageとsessionStorageからの値をデータレイヤーオブジェクトに自動的に追加しました。
ignoreSessionStorageとignoreLocalStorageのオーバーライドオプションを追加しました。
ファーストパーティドメインの顧客の場合、tealium_environmentとut.envが正しく構成されない問題を修正しました。

4.45 - 4.48

4.48（2021年4月）

utag.jsバージョン4.48テンプレートをsecure_cookie構成で更新しました。

4.47（2021年1月）

潜在的なjQueryの脆弱性に対する防御コードを追加しました。JavaScriptファイルのsrcが直接構成され、侵害されたObject.prototypeから継承されないことを確認します。この問題はjQuery 3.5.0で修正されましたが、3.5.1で再導入されました。
instance ofを使用せずに組み込みのutag.ut.typeOf関数でArray型をサポートするように更新しました。これにより、utag.jsがテスト環境（Cypressなど）のiframeで実行され、JavaScriptのinstance of操作が正しく機能しない問題が修正されます。

4.46（2018年6月）

次の新しい組み込み変数をサポートしました：
- tealium_session_number - 既存のutag.data['cp.utag_main__sn']の値の複製
- tealium_session_event_number - 現在のセッション（訪問）でのトラッキングコール（utag.view()、utag.link()）の数をカウントするutag.data['cp.utag_main__se']のクッキー値。これは、1つのページロードに多くのトラッキングイベントがあるシングルページアプリ（SPA）で有用です。noviewフラグを使用しているページでは、ページロード（ロードルール評価）とutag.view()への最初の呼び出しの両方に対して値が「1」になります。
utag.link、utag.view、またはutag.trackの呼び出し時に空のパラメータリストを渡すことをサポートしました。以前のバージョンでは、utag.link()またはutag.view()の呼び出しは正常に機能しますが、データレイヤーに「cfg」オブジェクトが追加されます。utag.track()の呼び出しは以前のバージョンでは例外が発生します。
noviewフラグを使用しているページでは、次の2つのことに注意してください：
- データレイヤーには、tealium_session_event_numberの値があります。ページロード（utag.jsはデータレイヤーを使用してタグをロードします）と最初のutag.viewへの呼び出し（タグを発火させ、または他のタグをロードします）の両方に対して、tealium_session_event_numberの値は「1」です。
- クッキーはページのロード時に使用され、初期ページでutag.view呼び出しが十分に早く発生しない場合、ブラウザでページが更新されると、2番目のページで発生する最初のutag.view呼び出しのために「2」に移動します。これは、ほとんどの実装がutag.jsの実行直後にutag.viewを呼び出すため、エッジケースです。
このアップデートには、レガシープライバシーマネージャーエクステンションで使用される「OU」関数の修正も含まれています。
- utag.view/linkの各呼び出しでOPTOUTMULTIクッキーを再確認します（ページのリフレッシュは必要ありません）
- タグのUIDによって直接発火されるタグは、発火前にOPTOUTMULTIクッキーの構成を確認します

4.45（2018年1月）

4.40バージョンで導入されたバグを修正しました。このバグにより、同じタグを複数回iframeでロードするページにおいて、ブラウザの履歴に余分なエントリが追加されました。この問題は、主にiframeベースのタグベンダーを使用するシングルページアプリ（SPA）に影響を与えました。

4.43 - 4.44

4.44（2017年6月）

“tags.tiqcdn.cn”（中国）でホストされているutag.jsの訪問セッションカウントをサポートしました。
デフォルトのutag_mainクッキードメインロジックを更新しました。example.XX.jp（XX.jpドメインにクッキーを構成できないドメイン）に従うドメインの場合、example.XX.jpドメインにクッキーが構成されます。

4.43（2017年6月）

グローバル変数iの使用を削除しました。以前は、グローバル変数utag_cfg_ovrd（構成オーバーライドオブジェクト）をループするために使用されていました。
レガシーのs2sサポートを削除しました（これは以前にTealium iQから削除されていました）。Cloud DeliveryはTealium Customer Data Hubでサポートされています。
utag.ut.loaderユーティリティ関数に渡されたエラーハンドラ関数のサポートを追加しました。これはモダンなブラウザのみで機能します（古いブラウザでは標準のコールバック関数「cb」が使用されます）。

utag.ut.loader({
        "src"   : "https://www.example.com/path/file.js",
        "cb"    : function(){console.log("CALLBACK")},
        "error" : function(){console.log("ERROR IN LOADING")}
        });

4.40 - 4.42

4.42（2016年8月）

新しい組み込みのTealiumイベント属性を追加しました。これらの新しい属性は、Tealiumビューやリンクイベントごとにデータレイヤーに追加されます。

tealium_visitor_id cp.utag_main_v_idクッキー内のTealiumが生成したID
tealium_session_id 現在のセッションの開始時のエポックタイムスタンプ（ミリ秒単位）の文字列
tealium_account utag.jsファイルへのパスのアカウント文字列値
tealium_profile utag.jsファイルへのパスのプロファイル文字列値
tealium_environment utag.jsファイルへのパスの環境文字列値。たとえば、「dev」または「prod」。
tealium_datasource Tealium EventStreamのデータソースキー
tealium_random キャッシュバスティングに使用するランダムな数値（文字列）
tealium_library_name ライブラリの名前（utag.js）
tealium_library_version utag.jsのバージョン。たとえば、このリリースの場合は「4.42.0」
tealium_timestamp_epoch 現在のエポックタイム（秒単位）の整数
tealium_timestamp_utc UTCタイムゾーンの現在のISO文字列タイムスタンプ（古いブラウザでは使用できません）
tealium_timestamp_local ブラウザのタイムゾーンの現在のISO文字列タイムスタンプ（古いブラウザでは使用できません）

4.41

utag.ut.encodeのフォールバック関数のタイポを修正するためのマイナーアップデート。

encodeURIComponent呼び出しは、encodeURIComponentで例外が発生した場合にescape呼び出しを使用するようにフォールバックします。

4.40（2016年4月）

シングルページアプリ（SPA）サイトでutag.linkおよびutag.viewを使用して新しいタグをロードできるようになりました。

以前は、utag.viewの呼び出しでは新しいタグはロードされませんでした。この機能は、データがutag.jsのロード後に構成され、このデータを使用してDOM Readyに待機するタグを発火させたい場合に有効になります。

この機能を無効にするには、現在の動作を維持します。詳細については、以下のutag.cfg.load_rules_ajaxフラグの詳細を参照してください。

utag.link()の呼び出しは新しいタグをロードしません。utag.view()の呼び出しだけがこれを行います。

UIDによってタグを直接ロードするためのutag.viewおよびutag.trackの呼び出しの更新。

高度な実装、特にAJAXを使用している場合は、utag.view()呼び出しを使用して新しいタグをロードし、タグのUID（Tealium iQのTagsタブで表示される）に基づいて発火させることができます。これにより、すべてのロードルールをバイパスします。

utag.view({page_name : "New Page"}, null, [5]);

パラメータ1：データレイヤー
パラメータ2：コールバック関数（またはnull）
パラメータ3：ロードおよび発火するUIDの配列

ページトラッキングについては、こちらをご覧ください。

新しい「メタ」タグを自動的に読み取ります。

<meta name="keywords" content="Apple,Tab" />

utag.js 4.26では、次のようなproperty=を持つメタタグ（「Open Graph」メタタグ）も読み取ります。

<meta property="og:type" content="video.movie" />

デフォルトでは、これらのメタタグの名前は小文字になります。

デフォルトでは、クエリ文字列パラメータとメタタグの名前は小文字になりません。以前のバージョンのutag.jsの動作との後方互換性を維持するには、utag.cfg.lowerqpフラグをtrueに構成します。

utag.cfg.lowermetaフラグをtrueに構成すると、メタタグの名前が小文字になります。メタタグの名前/値のペアの値は小文字になりません。

utag_mainクッキーに新しい名前/値のペアが追加されました。

utag_main_vid
訪問を一意に識別するための長い文字列（例：013efdc67183001adeec0eef13010a051001b00f0093c）
utag_main__ss
セッション開始フラグ。新しいセッションの最初のページビューには「1」が構成されます。デフォルトのセッション時間は、アクティビティがない状態で経過する30分です。

（以前のutag_main__stとutag_main_ses_idのクッキーの値も構成されます。）

セッション開始のトラッキングについては、以下の空のファイルutag.v.jsのリクエストがセッションの開始時に1回行われます。これはTealium内部でセッション数を記録するために使用されます。HTTPリクエストのURLは次のようになります。

http://tags.tiqcdn.com/utag/tiqapp/utag.v.js?a=tealium/main/201306012057&cb=1370276499302

新しいクッキー値utag_main__ssは、発火するタイミングを決定するために使用されます。これはセッションの最初のイベントのみに送信されます。このリクエストは、すべてのタグが発火した後に最後に送信されます。

新しいクッキー値がデータレイヤータブで識別されることに注意してください。

utag_main_ses_idクッキー内のセッションID値
utag_main_v_idクッキー内の訪問ID値
utag_main__ssクッキー内のセッション開始フラグ（0または1）

URLフラグメントパラメータ

以前は、?の後にあるURLの名前/値ペアがutag.dataにqp.値として読み取られ、格納されました。これに加えて、ハッシュ/フラグメント#の後にある項目も同様に読み取られます。これにより、AJAXサイトに重要な機能が追加されます。

例のドメインURL：（http://www.example.com?param1=value1&param2=value2#hash1=value3）`

以前：

utag.data = { "qp.param1" : "value1", "qp.param2" : "value2"}

新しい：

utag.data = { "qp.param1" : "value1", "qp.param2" : "value2", "qp.hash1"  : "value3"}

utag.viewおよびutag.linkの呼び出しでは、すべての「ビルトイン」データポイント（URL、メタタグ、クッキーの値など）がデータレイヤーに追加されます。

また、AJAXサイトの場合に変更される可能性のある動的な項目（b["dom.url"]など）は、現在の値を使用して再構築され、初期のAJAXページへの着陸時の値とは異なる場合があります。

新しいutag.cfgオプション

Pre LoaderスコープのJavaScriptコードエクステンションとグローバル変数window.utag_cfg_ovrdを使用します。

// Preloader Extension内のJSコード
window.utag_cfg_ovrd = {
    "noview"          : true,
    "lowerqp"         : true,
    "load_rules_ajax" : false
};

以下の新しいオプションが利用可能です。

utag.cfg.load_rules_ajax
utag.viewおよびutag.linkの各呼び出しのたびにロードルールを「再評価」する場合は、このフラグをfalseに構成します。utag.viewの場合、これにより、初期ページビュー時にロードされなかった場合に新しいutag.X.jsファイルがロードされる場合があります。
utag.udoname
データオブジェクトの名前。utag.jsのコードは、データオブジェクトがグローバル変数であることを前提としています。たとえば、別のオブジェクト内のオブジェクトではありません。デフォルトでは、utag_dataに構成されています。
utag.cfg.load_rules_at_wait
DOM Ready（待機）時にロードルールを再評価する場合は、このフラグをtrueに構成します。これにより、utag.jsのロード後にデータが構成され、DOM Readyに待機するタグを発火させるためにこのデータを使用する場合に、以前のサポートが有効になります。
utag.cfg.lowerqp
クエリ文字列の名前/値ペアを小文字にする場合は、このフラグをtrueに構成します。これは以前のデフォルトの動作でした。
utag.cfg.lowermeta
メタタグの名前を小文字にする場合は、このフラグをtrueに構成します。メタタグの名前/値のペアの値は小文字になりません。
utag.cfg.noview
初期のutag.view呼び出しが行われるタイミングを制御する場合は、このフラグをtrueに構成します。これは、アプリケーションがページビューイベントを制御する場合（初期のページロードアクションではない場合）に一般的です。

考慮事項

誤って複数の注文を発火する可能性があります。utag.linkおよびutag.viewの呼び出しでは、すべての「DOM」タイプのデータポイントがすべての呼び出しで利用可能です。たとえば、b["qp.order_id"]などのクエリ文字列データは、ページのロード時に読み取られ、注文イベントをトリ