Tealium Universal Tag (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 オーバーライドが設定されている場合、すべてのプロファイルからクッキーオーバーライドを同時に削除できます。

• Tealium Collect タグの Visitor ID (v_id) に依存関係がある場合は、always_set_v_id オプションを true に設定して、その値が適切なタイミングで設定され続けるようにしてください。Visitor ID の使用例は次のとおりです。

  • Cookie 同期タグ。
  • トラブルシューティングおよびダウンストリームデータウェアハウスでの使用のために、tealium_visitor_id を Adobe や GA4 のようなアナリティクスタグにマッピングすること。

詳細については、Settings: always_set_v_idを参照してください。

4.51

(2023年9月)

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

4.50

(2023年9月)

バージョン 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 以降の透明性向上のための新しい設定の詳細については、Enhancing Cookie Transparency with utag 4.51を参照してください。

4.49

(2022年9月)

• localStorage と sessionStorage の値が データレイヤーオブジェクト に自動的に追加されるようになりました。
• ignoreSessionStorage と ignoreLocalStorage のオーバーライドオプションを追加しました。
• ファーストパーティドメインの顧客に対して tealium_environment と ut.env が正しく設定されない問題を修正しました。

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 で再導入されました。

• utag.js がテスト環境（Cypress など）の iframe で実行され、JavaScript の instance of 操作が正しく機能しない問題を修正するために、ビルトインの utag.ut.typeOf 関数を使用して Array 型をチェックするように更新しました。

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 フラグを使用しているページでは、次の点に注意してください：
  • データレイヤーには、tealium_session_event_number の値が ‘1’ になります。これは、utag.js がデータレイヤーを使用してタグをロードし、タグをさらにロードする場合です。
  • クッキーはページのロード時に使用され、初回のページで utag.view 呼び出しが十分に早く行われない場合、ブラウザでページがリフレッシュされると、2 番目のページで行われる最初の utag.view 呼び出しに ‘2’ に移動します。これは、ほとんどの実装が utag.js の実行直後に utag.view を呼び出すため、エッジケースです。
• この更新には、レガシープライバシーマネージャ拡張で使用される “OU” 関数の修正も含まれています。
  • OPTOUTMULTI クッキーは、utag.view/link の各呼び出しで再確認されます（ページのリフレッシュは必要ありません）
  • タグの UID によって直接発火されるタグは、発火する前に OPTOUTMULTI クッキーの設定を確認します

4.45

(2018年1月)

• 1つのタグが複数回 iframe で読み込まれるページで、同じタグを複数回ブラウザの履歴に追加するバグを修正しました。この問題は、iframe ベースのタグベンダーを使用するシングルページアプリケーション（SPA）に影響を与える可能性があります。

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.42

(2016年8月)

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

• tealium_visitor_id
cp.utag_main_v_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 の呼び出しは、不正な形式の Unicode 文字のエンコード時に例外が発生した場合に escape の呼び出しにフォールバックするようになりました。

4.40

(2016年4月)

utag.link と utag.view を使用したシングルページアプリケーション（SPA）サイトの動作の改善。

以前は、現在のデータレイヤーのアイテムが utag.link/view に渡され、utag.data グローバルオブジェクトにマージされていました。これは、各 utag.link/view の呼び出しでロードルールを再評価する必要があったためです。utag.js 4.40 テンプレートでは、この動作はもはや必要ありません。バージョン 4.40 では、utag.data グローバルオブジェクトは各 utag.link または utag.view の呼び出し後に更新されません。

4.39 の動作との後方互換性をテストするために、次の JS 拡張を使用できます。

// JS 拡張（ロードルールの前）にスコープを設定
utag.ut.merge( b, utag.data, 0 );
utag.ut.merge( utag.data, b ,1 );

新しい “noconsole” フラグを追加しました。

utag_cfg_ovrd オブジェクト のこのフラグを true に設定すると、utag.DB の出力が Web コンソールに表示されなくなります。デバッグが有効になっている場合、出力は utag.db_log 配列に残ります。

DOM で utag.ut.loader 関数を使用して DOM に iframe を作成する場合、同じ ID の iframe が既に存在する場合は、iframe が再度追加されず、代わりに iframe の src が更新されます。

utag.view または utag.link の呼び出しで JS ページ変数の値を更新します。utag.view または utag.link の呼び出しのたびに JS ページ変数が現在の値に更新されます。これにより、b["js_page.my_global_var"] には window.my_global_var の最新の値が常に含まれます。

utag.view または utag.link の呼び出しで新しいタグをロードし、タグの UID に基づいて発火するための直接の方法を追加しました。これにより、すべてのロードルールをバイパスします。

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

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

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

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

また、AJAX サイトの場合に変更される可能性のある動的なアイテム（たとえば、b["dom.url"]）が再構築され、現在の値が使用されるようになります。現在の値は、初期の AJAX ページのランディング時の値とは異なる場合があります。

utag.js 4.26 に更新することで、utag.link および utag.view の呼び出しでは、渡したデータだけでなく、b["qp.campaign"] のようなすべての “ビルトイン” データポイントが使用できるようになります。

また、AJAX サイトの場合に変更される可能性のある動的なアイテム（たとえば、b["dom.url"]）が再構築され、現在の値が使用されるようになります。現在の値は、初期の AJAX ページのランディング時の値とは異なる場合があります。

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

utag.link() の呼び出しは新しいタグをロードしません。新しいタグをロードするには utag.view() の呼び出しが必要です。

以前は、utag.view および utag.link の呼び出しは、渡したデータしか知りませんでした。b["qp.campaign"] のようなアイテムは使用できませんでした。現在は、utag.link および utag.view の呼び出しでも、URL、メタタグ、またはクッキーの値などのすべての “ビルトイン” データポイントがデータレイヤーに追加されます。

また、AJAX サイトの場合に変更される可能性のある動的なアイテム（たとえば、b["dom.url"]）が再構築され、現在の値が使用されるようになります。現在の値は、初期の AJAX ページのランディング時の値とは異なる場合があります。

utag.cfg の新しいオプション

Pre Loader スコープの JavaScript Code Extension とグローバル変数 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 の準備が完了したときにロードルールを再評価する場合は、このフラグを true に設定します。これにより、utag.js のロード後にデータが設定された場合に、DOM の準備を待つためにロードルールを使用することができます。
• utag.cfg.lowerqp
  クエリストリングの名前/値ペアを小文字にする場合は、このフラグを true に設定します。これは以前のデフォルトの動作でした。
• utag.cfg.lowermeta
  メタタグの名前を小文字にする場合は、このフラグを true に設定します。メタタグの名前/値ペアの値は小文字になりません。
• utag.cfg.noview
  初期の utag.view 呼び出しが行われるタイミングを制御する場