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を参照してください。

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 以降の透明性向上のための新しい設定の詳細については、Enhancing Cookie Transparency with 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 フラグを使用しているページでは、次の点に注意してください。
  • データレイヤーには、ページロード（utag.js はデータレイヤーを使用してタグを読み込みます）と utag.view の最初の呼び出しの両方に対して ‘1’ の値があります。
  • クッキーはページのロード時に使用され、初期化されるため、最初のページで utag.view 呼び出しが十分に早く行われず、ブラウザでページが更新される場合、2 番目のページで行われる最初の utag.view 呼び出しに ‘2’ に移動します。これは、ほとんどの実装が utag.js の実行直後に utag.view を呼び出すため、エッジケースです。
• この更新には、レガシープライバシーマネージャーエクステンションで使用される “OU” 関数の修正も含まれています。
  • OPTOUTMULTI クッキーは、utag.view/link の各呼び出しで再確認されます（ページの再読み込みは必要ありません）
  • タグの 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 クッキーのデフォルトの 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.view の呼び出しによって新しいタグがロードされるようになりました。

この機能は、デフォルトで有効になっており、utag.view によって新しい utag.X.js ファイルがロードされなかった場合にもロードルールが再評価されます。

この機能を無効にするには、現在の動作を維持するために utag.cfg.load_rules_ajax フラグを false に設定してください。

utag.link() の呼び出しは新しいタグをロードしません。新しいタグをロードするには utag.view() の呼び出しを使用してください。

UID でタグを直接ロード

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

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

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

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

新しい “Meta” タグの自動読み取り

以前のバージョンの utag.js では、name= のメタタグが読み取られ、utag.data に qp. の値として格納されました。

新しい utag.js 4.26 では、property=（“Open Graph” メタタグを参照）を持つメタタグも読み取ります。

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

デフォルトで “qp."（クエリストリング）および “meta.” 変数の小文字化を削除

これは、utag.data のデフォルトの動作のロジック変更です。小文字化するには、utag.cfg.lowerqp フラグ を true に設定します。ただし、デフォルトの設定では大文字と小文字が混在したままです。

前の utag.js の動作との後方互換性のために、utag.cfg.lowerqp フラグを true に設定してください。

utag.cfg.lowermeta フラグを true に設定すると、メタタグの名前を小文字化できます。メタタグの名前/値のペアの値は小文字化されません。

大文字と小文字が混在するクエリストリングパラメータがある場合は、データソースの名前をデータソースタブで正確に一致するように更新する必要があります。このクエリストリングタイプのデータソースを参照するコードも更新する必要があります。

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 の各呼び出しのたびにロードルールを「再評価」するかどうかを設定します。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 呼び出しが行われるタイミングを制御する場合は、このフラグを true に設定します。これは、初期ページのロードアクションではなく、アプリケーションがページビューイベントを制御する AJAX サイトで一般的です。

考慮事項

• 誤って複数の注文が発生する可能性があります。utag.link および utag.view の呼び出しでは、すべての “DOM” タイプのデータポイントがすべての呼び出しで利用可能です。たとえば、b["qp.order_id"] のようなクエリストリングデータはページの読み込み時に読み取られ、注文イベントをトリガーします。ただし、同じ注文ページで utag.link 呼び出しを発行すると、b["qp.order_id"] データが設定され、2 回目の注文イベントがトリガーされる可能性があります。
• 最も直感的な動作をするためには、utag.js ファイルを読み込む前にすべての utag_data の値を設定し、utag.cfg.load_rules_at_wait を “false” のままにして、初期の utag.view 呼び出しのタイミングを制御します。
• utag.js 4.26 に更新すると、クエリストリングパラメータを小文字化するデフォルトの動作が変更されることに注意してください