Tealium Universal Tag (utag.js) リリースノート
utag.jsのテンプレートを更新して、最新の修正と機能エンリッチメントを活用してください。
utag.jsバージョン4.50以降へのアップデート
バージョン4.50以降にアップデートする際には、以下の手順をお勧めします。
- Tealium Collectタグとすべてのアクティブな同意管理テンプレート、特にイベントログ機能を更新してください。
- 同じサイトで複数のiQプロファイルを実行している場合は、次の手順を完了してください。これにより、サイト上のすべての
utag.jsインスタンスが新しいクッキーの動作を同時に使用し、競合や互換性の問題を防ぐことができます。- すべての
utag.jsテンプレートを最新バージョンに更新してください。 - 各プロファイルの
split_cookieオーバーライドをfalseに構成して、レガシーのクッキーの動作を使用し、トランジションの期間中にサイト上でまだ実行されている古いバージョンのutag.jsとの互換性を維持してください。 - すべての
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_idcp.utag_main_v_idクッキー内のTealiumが生成したIDtealium_session_id現在のセッションの開始時のエポックタイムスタンプ(ミリ秒単位)の文字列tealium_accountutag.jsファイルへのパスのアカウント文字列値tealium_profileutag.jsファイルへのパスのプロファイル文字列値tealium_environmentutag.jsファイルへのパスの環境文字列値。たとえば、「dev」または「prod」。tealium_datasourceTealium EventStreamのデータソースキーtealium_randomキャッシュバスティングに使用するランダムな数値(文字列)tealium_library_nameライブラリの名前(utag.js)tealium_library_versionutag.jsのバージョン。たとえば、このリリースの場合は「4.42.0」tealium_timestamp_epoch現在のエポックタイム(秒単位)の整数tealium_timestamp_utcUTCタイムゾーンの現在の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¶m2=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"]などのクエリ文字列データは、ページのロード時に読み取られ、注文イベントをトリ
最終更新日 :: 2024年March月26日